annotate README.txt @ 30:fb3fa6a2874d draft

Citations added (thanks John!) and a few more output formats for Alistair Chilcott
author fubar
date Thu, 28 Aug 2014 02:22:39 -0400
parents bff4c9bfabc7
children 117a5ada6a6a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
29
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
1 # WARNING before you start
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
2 # Install this tool on a private Galaxy ONLY
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
3 # Please NEVER on a public or production instance
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
4 # updated august 8 2014 to fix bugs reported by Marius van den Beek
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
5 Please cite:
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
6 http://bioinformatics.oxfordjournals.org/cgi/reprint/bts573?ijkey=lczQh1sWrMwdYWJ&keytype=ref
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
7 if you use this tool in your published work.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
8
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
9 *Short Story*
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
10
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
11 This is an unusual Galaxy tool that exposes unrestricted and therefore extremely dangerous
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
12 scripting to designated administrative users of a Galaxy server, allowing them to run scripts
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
13 in R, python, sh and perl over a single input data set, writing a single new data set as output.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
14
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
15 In addition, this tool optionally generates very simple new Galaxy tools, that effectively
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
16 freeze the supplied script into a new, ordinary Galaxy tool that runs it over a single input file,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
17 working just like any other Galaxy tool for your users.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
18
30
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
19 If you use the Html output option, please ensure that sanitize_all_html is set to False and
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
20 uncommented in universe_wsgi.ini - it should show:
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
21
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
22 # By default, all tool output served as 'text/html' will be sanitized
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
23 sanitize_all_html = False
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
24
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
25
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
26 *More Detail*
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
27
29
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
28 To use the ToolFactory, you should have prepared a script to paste into a text box,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
29 and a small test input example ready to select from your history to test your new script.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
30 There is an example in each scripting language on the Tool Factory form. You can just
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
31 cut and paste these to try it out - remember to select the right interpreter please. You'll
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
32 also need to create a small test data set using the Galaxy history add new data tool.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
33
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
34 If the script fails somehow, use the "redo" button on the tool output in your history to
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
35 recreate the form complete with broken script. Fix the bug and execute again. Rinse, wash, repeat.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
36
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
37 Once the script runs sucessfully, a new Galaxy tool that runs your script can be generated.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
38 Select the "generate" option and supply some help text and names. The new tool will be
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
39 generated in the form of a new Galaxy datatype - toolshed.gz - as the name suggests,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
40 it's an archive ready to upload to a Galaxy ToolShed as a new tool repository.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
41
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
42 Once it's in a ToolShed, it can be installed into any local Galaxy server from
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
43 the server administrative interface.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
44
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
45 Once the new tool is installed, local users can run it - each time, the script that was supplied
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
46 when it was built will be executed with the input chosen from the user's history. In other words,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
47 the tools you generate with the ToolFactory run just like any other Galaxy tool,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
48 but run your script every time.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
49
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
50 Tool factory tools are perfect for workflow components. One input, one output, no variables.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
51
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
52 *To fully and safely exploit the awesome power* of this tool, Galaxy and the ToolShed,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
53 you should be a developer installing this tool on a private/personal/scratch local instance where you
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
54 are an admin_user. Then, if you break it, you get to keep all the pieces
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
55 see https://bitbucket.org/fubar/galaxytoolfactory/wiki/Home
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
56
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
57 ** Installation **
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
58 This is a Galaxy tool. You can install it most conveniently using the administrative "Search and browse tool sheds" link.
30
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
59 Find the Galaxy Main toolshed at https://toolshed.g2.bx.psu.edu/ and search for the toolfactory repository.
29
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
60 Open it and review the code and select the option to install it.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
61
30
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
62 (
29
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
63 If you can't get the tool that way, the xml and py files here need to be copied into a new tools
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
64 subdirectory such as tools/toolfactory Your tool_conf.xml needs a new entry pointing to the xml
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
65 file - something like::
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
66
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
67 <section name="Tool building tools" id="toolbuilders">
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
68 <tool file="toolfactory/rgToolFactory.xml"/>
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
69 </section>
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
70
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
71 If not already there (I just added it to datatypes_conf.xml.sample), please add:
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
72 <datatype extension="toolshed.gz" type="galaxy.datatypes.binary:Binary" mimetype="multipart/x-gzip" subclass="True" />
30
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
73 to your local data_types_conf.xml.
fb3fa6a2874d Citations added (thanks John!) and a few more output formats for Alistair Chilcott
fubar
parents: 29
diff changeset
74 )
29
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
75
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
76 Of course, R, python, perl etc are needed on your path if you want to test scripts using those interpreters.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
77 Adding new ones to this tool code should be easy enough. Please make suggestions as bitbucket issues and code.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
78 The HTML file code automatically shrinks R's bloated pdfs, and depends on ghostscript. The thumbnails require imagemagick .
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
79
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
80 * Restricted execution *
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
81 The new tool factory tool will then be usable ONLY by admin users - people with IDs in admin_users in universe_wsgi.ini
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
82 **Yes, that's right. ONLY admin_users can run this tool** Think about it for a moment. If allowed to run any
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
83 arbitrary script on your Galaxy server, the only thing that would impede a miscreant bent on destroying all your
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
84 Galaxy data would probably be lack of appropriate technical skills.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
85
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
86 *What it does* This is a tool factory for simple scripts in python, R and perl currently.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
87 Functional tests are automatically generated. How cool is that.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
88
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
89 LIMITED to simple scripts that read one input from the history.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
90 Optionally can write one new history dataset,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
91 and optionally collect any number of outputs into links on an autogenerated HTML
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
92 index page for the user to navigate - useful if the script writes images and output files - pdf outputs
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
93 are shown as thumbnails and R's bloated pdf's are shrunk with ghostscript so that and imagemagik need to
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
94 be avaailable.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
95
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
96 Generated tools can be edited and enhanced like any Galaxy tool, so start small and build up since
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
97 a generated script gets you a serious leg up to a more complex one.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
98
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
99 *What you do* You paste and run your script
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
100 you fix the syntax errors and eventually it runs
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
101 You can use the redo button and edit the script before
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
102 trying to rerun it as you debug - it works pretty well.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
103
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
104 Once the script works on some test data, you can
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
105 generate a toolshed compatible gzip file
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
106 containing your script ready to run as an ordinary Galaxy tool in a
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
107 repository on your local toolshed. That means safe and largely automated installation in any
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
108 production Galaxy configured to use your toolshed.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
109
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
110 *Generated tool Security* Once you install a generated tool, it's just
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
111 another tool - assuming the script is safe. They just run normally and their user cannot do anything unusually insecure
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
112 but please, practice safe toolshed.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
113 Read the fucking code before you install any tool.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
114 Especially this one - it is really scary.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
115
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
116 If you opt for an HTML output, you get all the script outputs arranged
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
117 as a single Html history item - all output files are linked, thumbnails for all the pdfs.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
118 Ugly but really inexpensive.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
119
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
120 Patches and suggestions welcome as bitbucket issues please?
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
121
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
122 copyright ross lazarus (ross stop lazarus at gmail stop com) May 2012
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
123
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
124 all rights reserved
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
125 Licensed under the LGPL if you want to improve it, feel free https://bitbucket.org/fubar/galaxytoolfactory/wiki/Home
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
126
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
127 Material for our more enthusiastic and voracious readers continues below - we salute you.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
128
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
129 **Motivation** Simple transformation, filtering or reporting scripts get written, run and lost every day in most busy labs
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
130 - even ours where Galaxy is in use. This 'dark script matter' is pervasive and generally not reproducible.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
131
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
132 **Benefits** For our group, this allows Galaxy to fill that important dark script gap - all those "small" bioinformatics
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
133 tasks. Once a user has a working R (or python or perl) script that does something Galaxy cannot currently do (eg transpose a
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
134 tabular file) and takes parameters the way Galaxy supplies them (see example below), they:
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
135
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
136 1. Install the tool factory on a personal private instance
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
137
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
138 2. Upload a small test data set
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
139
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
140 3. Paste the script into the 'script' text box and iteratively run the insecure tool on test data until it works right -
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
141 there is absolutely no reason to do this anywhere other than on a personal private instance.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
142
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
143 4. Once it works right, set the 'Generate toolshed gzip' option and run it again.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
144
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
145 5. A toolshed style gzip appears ready to upload and install like any other Toolshed entry.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
146
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
147 6. Upload the new tool to the toolshed
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
148
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
149 7. Ask the local admin to check the new tool to confirm it's not evil and install it in the local production galaxy
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
150
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
151 **Simple examples on the tool form**
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
152
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
153 A simple Rscript "filter" showing how the command line parameters can be handled, takes an input file,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
154 does something (transpose in this case) and writes the results to a new tabular file::
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
155
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
156 # transpose a tabular input file and write as a tabular output file
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
157 ourargs = commandArgs(TRUE)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
158 inf = ourargs[1]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
159 outf = ourargs[2]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
160 inp = read.table(inf,head=F,row.names=NULL,sep='\t')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
161 outp = t(inp)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
162 write.table(outp,outf, quote=FALSE, sep="\t",row.names=F,col.names=F)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
163
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
164 Calculate a multiple test adjusted p value from a column of p values - for this script to be useful,
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
165 it needs the right column for the input to be specified in the code for the
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
166 given input file type(s) specified when the tool is generated ::
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
167
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
168 # use p.adjust - assumes a HEADER row and column 1 - please fix for any real use
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
169 column = 1 # adjust if necessary for some other kind of input
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
170 fdrmeth = 'BH'
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
171 ourargs = commandArgs(TRUE)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
172 inf = ourargs[1]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
173 outf = ourargs[2]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
174 inp = read.table(inf,head=T,row.names=NULL,sep='\t')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
175 p = inp[,column]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
176 q = p.adjust(p,method=fdrmeth)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
177 newval = paste(fdrmeth,'p-value',sep='_')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
178 q = data.frame(q)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
179 names(q) = newval
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
180 outp = cbind(inp,newval=q)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
181 write.table(outp,outf, quote=FALSE, sep="\t",row.names=F,col.names=T)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
182
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
183
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
184
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
185 Another Rscript example without any input file - generates a random heatmap pdf - you must make sure the option to create an HTML output file is
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
186 turned on for this to work. The heatmap will be presented as a thumbnail linked to the pdf in the resulting HTML page::
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
187
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
188 # note this script takes NO input or output because it generates random data
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
189 foo = data.frame(a=runif(100),b=runif(100),c=runif(100),d=runif(100),e=runif(100),f=runif(100))
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
190 bar = as.matrix(foo)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
191 pdf( "heattest.pdf" )
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
192 heatmap(bar,main='Random Heatmap')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
193 dev.off()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
194
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
195 A Python example that reverses each row of a tabular file. You'll need to remove the leading spaces for this to work if cut
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
196 and pasted into the script box. Note that you can already do this in Galaxy by setting up the cut columns tool with the
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
197 correct number of columns in reverse order,but this script will work for any number of columns so is completely generic::
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
198
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
199 # reverse order of columns in a tabular file
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
200 import sys
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
201 inp = sys.argv[1]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
202 outp = sys.argv[2]
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
203 i = open(inp,'r')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
204 o = open(outp,'w')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
205 for row in i:
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
206 rs = row.rstrip().split('\t')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
207 rs.reverse()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
208 o.write('\t'.join(rs))
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
209 o.write('\n')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
210 i.close()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
211 o.close()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
212
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
213
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
214 Galaxy as an IDE for developing API scripts
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
215 If you need to develop Galaxy API scripts and you like to live dangerously, please read on.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
216
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
217 Galaxy as an IDE?
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
218 Amazingly enough, blend-lib API scripts run perfectly well *inside* Galaxy when pasted into a Tool Factory form. No need to generate a new tool. Galaxy+Tool_Factory = IDE I think we need a new t-shirt. Seriously, it is actually quite useable.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
219
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
220 Why bother - what's wrong with Eclipse
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
221 Nothing. But, compared with developing API scripts in the usual way outside Galaxy, you get persistence and other framework benefits plus at absolutely no extra charge, a ginormous security problem if you share the history or any outputs because they contain the api script with key so development servers only please!
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
222
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
223 Workflow
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
224 Fire up the Tool Factory in Galaxy.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
225
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
226 Leave the input box empty, set the interpreter to python, paste and run an api script - eg working example (substitute the url and key) below.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
227
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
228 It took me a few iterations to develop the example below because I know almost nothing about the API. I started with very simple code from one of the samples and after each run, the (edited..) api script is conveniently recreated using the redo button on the history output item. So each successive version of the developing api script you run is persisted - ready to be edited and rerun easily. It is ''very'' handy to be able to add a line of code to the script and run it, then view the output to (eg) inspect dicts returned by API calls to help move progressively deeper iteratively.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
229
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
230 Give the below a whirl on a private clone (install the tool factory from the main toolshed) and try adding complexity with few rerun/edit/rerun cycles.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
231
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
232 Eg tool factory api script
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
233 import sys
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
234 from blend.galaxy import GalaxyInstance
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
235 ourGal = 'http://x.x.x.x:xxxx'
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
236 ourKey = 'xxx'
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
237 gi = GalaxyInstance(ourGal, key=ourKey)
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
238 libs = gi.libraries.get_libraries()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
239 res = []
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
240 # libs looks like
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
241 # u'url': u'/galaxy/api/libraries/441d8112651dc2f3', u'id': u'441d8112651dc2f3', u'name':.... u'Demonstration sample RNA data',
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
242 for lib in libs:
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
243 res.append('%s:\n' % lib['name'])
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
244 res.append(str(gi.libraries.show_library(lib['id'],contents=True)))
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
245 outf=open(sys.argv[2],'w')
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
246 outf.write('\n'.join(res))
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
247 outf.close()
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
248
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
249 **Attribution**
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
250 Creating re-usable tools from scripts: The Galaxy Tool Factory
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
251 Ross Lazarus; Antony Kaspi; Mark Ziemann; The Galaxy Team
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
252 Bioinformatics 2012; doi: 10.1093/bioinformatics/bts573
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
253
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
254 http://bioinformatics.oxfordjournals.org/cgi/reprint/bts573?ijkey=lczQh1sWrMwdYWJ&keytype=ref
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
255
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
256 **Licensing**
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
257 Copyright Ross Lazarus 2010
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
258 ross lazarus at g mail period com
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
259
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
260 All rights reserved.
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
261
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
262 Licensed under the LGPL
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
263
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
264 **Obligatory screenshot**
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
265
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
266 http://bitbucket.org/fubar/galaxytoolmaker/src/fda8032fe989/images/dynamicScriptTool.png
bff4c9bfabc7 Fixes for escaping all xml characters in help and code - thanks to Marius van den Beek for pointing these out
fubar
parents:
diff changeset
267