X-Git-Url: http://source.jalview.org/gitweb/?a=blobdiff_plain;f=doc%2FAddingGroovySupport.html;h=e3e453f89a51bcc1286a7f9c6f52e3af2b15492d;hb=5022579ec6cc4eecfabd9df69e0fb039e3186a0a;hp=ff9af0722e4d41090d1797792e1edd3bb13cfad8;hpb=797df64fa2a0a30773d0f48f5494d4155e5a8be3;p=jalview.git diff --git a/doc/AddingGroovySupport.html b/doc/AddingGroovySupport.html index ff9af07..e3e453f 100644 --- a/doc/AddingGroovySupport.html +++ b/doc/AddingGroovySupport.html @@ -1,54 +1,41 @@ Adding Groovy Support to Jalview

-Adding Groovy Support to Jalview +Groovy Support in Jalview

-There is currently no scripting language -extension within Jalview, in part because a -scripting API has not yet been developed. -

It is, however, really easy to embed scripting -engines like groovy. If groovy is detected on the -classpath, a new menu entry on the Desktop's Tools -menu will open the GroovyShell. + Groovy has been bundled with the Jalview desktop since circa 2012. The program supports interactive execution of groovy scripts via the Groovy Console, and command line execution via the '-groovy' option. The main source for documentation about Groovy in Jalview is the online help pages.

Here are some scripts to get you started:

Getting the title, alignment and first sequence from the current alignFrame

-def alf = Jalview.getAlignframes();
+def alf = Jalview.getAlignFrames();
 print alf[0].getTitle();
 def alignment = alf[0].viewport.alignment;
 def seq = alignment.getSequenceAt(0);

Getting Groovy...

-You need the core groovy jars which include the GroovyShell. The easiest way of doing -this is to add the groovy-all-*.jar to the lib directory whose path is given in the java.ext.dirs property.

The is obtained from the embedded directory within the groovy distribution). -

TODO

Using Java class methods from Groovy is straightforward, but currently, there isn't a set of easy to use methods for the jalview objects. A Jalview Scripting API needs to be developed to make this easier.