63
|
1 <tool id="rgtf2" name="toolfactory" version="2.00" profile="16.04" >
|
62
|
2 <description>Scripts into tools v2.0</description>
|
48
|
3 <macros>
|
50
|
4 <xml name="tool_metadata">
|
49
|
5 <param name="tool_version" label="Tool Version - bump this to warn users trying to redo old analyses" type="text" value="0.01"
|
|
6 help="If you change your script and regenerate the 'same' tool, you should inform Galaxy (and users) by changing (bumping is traditional) this number"/>
|
|
7 <param name="tool_desc" label="Tool Description" type="text" value=""
|
|
8 help="Supply a brief tool description for the Galaxy tool menu entry (optional - appears after the tool name)" />
|
|
9 <param name="help_text" label="Tool form documentation and help text for users" type="text" area="true"
|
|
10 value="**What it Does**"
|
|
11 help="Supply user documentation to appear on the new tool form as reStructured text - http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html" >
|
|
12 <sanitizer>
|
|
13 <valid initial="string.printable">
|
|
14 </valid>
|
|
15 <mapping initial="none"/>
|
|
16 </sanitizer>
|
|
17 </param>
|
|
18 <repeat name="citations" title="Citation">
|
|
19 <conditional name="citation_type">
|
|
20 <param name="type" type="select" display="radio" label="Citation Type">
|
|
21 <option value="doi">DOI</option>
|
|
22 <option value="bibtex">BibTeX</option>
|
|
23 </param>
|
|
24 <when value="doi">
|
|
25 <param name="doi" label="DOI" type="text" value=""
|
64
|
26 help="Supply a DOI (e.g. doi: 10.1111/j.1740-9713.2007.00258.x) to be cited when this tool is used in published research." />
|
49
|
27 </when>
|
|
28 <when value="bibtex">
|
|
29 <param name="bibtex" label="BibTex" type="text" area="true"
|
|
30 help="Supply a BibTex entry that should be cited when this tool is used in published research." value="" >
|
|
31 <sanitizer>
|
|
32 <valid initial="string.printable">
|
|
33 </valid>
|
|
34 <mapping initial="none"/>
|
|
35 </sanitizer>
|
|
36 </param>
|
|
37 </when>
|
|
38 </conditional>
|
|
39 </repeat>
|
|
40 </xml>
|
48
|
41 <xml name="io">
|
113
|
42 <repeat name="history_inputs" title="zero or more input data file parameters to appear on the tool form to be passed to the executable"
|
49
|
43 help="USE SMALL SAMPLES for the new tool's test. Prompts will form a history item selector as input for users of this new tool">
|
48
|
44 <param name="input_files" type="data" format="data" label="Select an input file from your history" optional="true" multiple="false"
|
|
45 help=""/>
|
|
46 <param name="input_formats" type="select" multiple="true" label="Select the datatype(s) that your tool/script accepts as input"
|
|
47 help="If your datatype is not listed here, it has to be added in galaxy's datatypes_conf.xml" value="tabular">
|
|
48 <options from_parameter="tool.app.datatypes_registry.upload_file_formats">
|
|
49 <column name="value" index="0"/>
|
|
50 </options>
|
|
51 </param>
|
|
52 <param name="input_label" type="text" value="" label="This will become the user prompt for the form so please make it informative"
|
|
53 help="Note that '~~~' is an internal delimiter so must not appear in this text field - please work around this technical limitation" >
|
|
54 <sanitizer invalid_char="">
|
|
55 <valid initial="string.printable"> <remove value='~~~'/> </valid>
|
|
56 <mapping initial="none"/>
|
|
57 </sanitizer>
|
|
58 </param>
|
63
|
59 <param name="input_help" type="text" value="" label="This will become help text on the form."
|
48
|
60 help="Note that three consecutive ~ cannot be used in this text field - please work around this technical limitation">
|
|
61 <sanitizer invalid_char="">
|
|
62 <valid initial="string.printable"> <remove value='~~~'/> </valid>
|
|
63 <mapping initial="none"/>
|
|
64 </sanitizer>
|
|
65 </param>
|
|
66 <param name="input_CL" type="text" label="Positional: ordinal integer. Argparse: argument name. STDIN if the executable/script expects it"
|
|
67 help="If you will pass positional parameters, enter the integer ordinal for this parameter. If Argparse style, '--' will be prepended or '-' if single character" value="">
|
|
68 </param>
|
|
69 </repeat>
|
113
|
70 <repeat name="history_outputs" title="one or more output file parameters generated by the tool to be added to the user history"
|
48
|
71 help="The name will become a history item for users of the new tool you are making containing one of it's outputs">
|
111
|
72 <param name="history_name" type="text" label="Name for this output to appear in new history" optional="false" help="Argparse will also use this name as --[name]"/>
|
48
|
73 <param name="history_format" type="select" multiple="false" label="Select the datatype for this output"
|
|
74 help="If your datatype is not listed here, it has to be added in galaxy's datatypes_conf.xml" value="tabular">
|
|
75 <options from_parameter="tool.app.datatypes_registry.upload_file_formats">
|
|
76 <column name="value" index="0"/>
|
|
77 </options>
|
|
78 </param>
|
111
|
79 <param name="history_CL" type="text" label="Positional: ordinal integer. Use STDOUT if '>' required. Otherwise ignored if argparse because name is used"
|
|
80 help="If positional parameters, enter the integer ordinal expected for this parameter. If argparse, ignore unless STDOUT needed" value=""/>
|
49
|
81 <param name="history_test" type="text" label="Test pass decision criterion for this output compared to test generation"
|
108
|
82 help="Available options are diff:[lines], sim_size:[delta (integer) or delta_frac (float)" value="sim_size:0.01"/>
|
48
|
83 </repeat>
|
|
84 </xml>
|
|
85 <xml name="additparam">
|
113
|
86 <param name="edit_params" type="select" display="radio" label="Make parameters on the generated tool form user editable?"
|
48
|
87 help="If no (default), users will NOT be able to alter any additional parameters. If yes, these will appear on the tool form as text fields with no validation or sanitizing">
|
63
|
88 <option value="yes" selected="true">Yes, allow user to edit all additional parameters on the generated tool form</option>
|
|
89 <option value="no">No - use the fixed values for all additional parameters - no user editing</option>
|
48
|
90 </param>
|
|
91
|
113
|
92 <repeat name="additional_parameters" title="zero or more user supplied parameter fields to the tool form for the executable"
|
48
|
93 help="See examples below to see how these can be parsed by scripts in the various languages">
|
63
|
94 <param name="param_name" type="text" value="" label="Choose the name for this parameter - MUST not be blank!">
|
48
|
95 <sanitizer invalid_char="">
|
|
96 <valid initial="string.letters,string.digits"/>
|
|
97 <mapping initial="none"/>
|
|
98 </sanitizer>
|
|
99 </param>
|
|
100 <param name="param_type" type="select" label="Select the type for this parameter">
|
|
101 <option value="text" selected="true">text</option>
|
|
102 <option value="integer">integer</option>
|
|
103 <option value="float">float</option>
|
|
104 </param>
|
|
105 <param name="param_value" type="text" value="" label="Enter this parameter's default value"
|
|
106 help="Note that '~~~' is an internal delimiter must not appear in this text field - please work around this technical limitation" >
|
|
107 <sanitizer invalid_char="">
|
|
108 <valid initial="string.printable"> <remove value='~~~'/> </valid>
|
|
109 <mapping initial="none"/>
|
|
110 </sanitizer>
|
|
111 </param>
|
63
|
112 <param name="param_label" type="text" value="" label="Enter this parameter's label for the form"
|
48
|
113 help="Note that '~~~' is an internal delimiter so must not appear in this text field - please work around this technical limitation" >
|
|
114 <sanitizer invalid_char="">
|
|
115 <valid initial="string.printable"> <remove value='~~~'/> </valid>
|
|
116 <mapping initial="none"/>
|
|
117 </sanitizer>
|
|
118 </param>
|
63
|
119 <param name="param_help" type="text" value="" label="Help for this parameter"
|
48
|
120 help="Note that three consecutive ~ cannot be used in this text field - please work around this technical limitation" >
|
|
121 <sanitizer invalid_char="">
|
|
122 <valid initial="string.printable"> <remove value='~~~'/> </valid>
|
|
123 <mapping initial="none"/>
|
|
124 </sanitizer>
|
|
125 </param>
|
49
|
126 <param name="param_CL" type="text" label="Positional ordinal | argparse argument name"
|
48
|
127 help="Using positional parameters, enter the integer ordinal for this parameter on the command line. Using Argparse style, '--' will be prepended on the CL" value="" />
|
|
128 <param name="param_CLprefixed" type="text" label="Override the generated default argparse name prefix if not empty - eg ----foo if needed"
|
49
|
129 help="Some targets like Planemo expect an unadorned action like 'test' before --galaxy_root." value="" />
|
48
|
130 </repeat>
|
|
131 </xml>
|
|
132 </macros>
|
56
|
133
|
93
|
134 <requirements>
|
94
|
135 <requirement type="package" version="0.4.11">galaxyxml</requirement>
|
|
136 <requirement type="package" version="0.14.0">bioblend</requirement>
|
|
137 <requirement type="package" version="0.10.6">ephemeris</requirement>
|
116
|
138 <requirement type="package" version="4.4.0">docker-py</requirement>
|
|
139 <!-- <requirement type="package" version="0.72.0">planemo</requirement> -->
|
|
140 <container type="docker">quay.io/fubar2/planemo-biocontainer:latest</container>
|
79
|
141 </requirements>
|
63
|
142
|
50
|
143 <command ><![CDATA[
|
48
|
144 #import os
|
|
145 #set dev_env = os.environ.get('GALAXY_DEVELOPMENT_ENVIRONMENT', '0') == '1'
|
|
146 #if not $dev_env and ( $__user_email__ not in $__admin_users__ ):
|
76
|
147 python3 $__tool_directory__/rgToolFactory2.py --bad_user $__user_email__
|
48
|
148 #else:
|
76
|
149 python3 $__tool_directory__/rgToolFactory2.py
|
49
|
150 #if len(str($cl_prefix)) > 3:
|
|
151 --cl_prefix "$cl_prefix"
|
|
152 #end if
|
|
153 #if $cover.commover == "yes":
|
|
154 #if len(str($cover.command_override)) > 10:
|
|
155 --command_override "$commandoverride"
|
|
156 #end if
|
|
157 #if len(str($cover.test_override)) > 10:
|
|
158 --test_override "$testoverride"
|
|
159 #end if
|
48
|
160 #end if
|
63
|
161 --packages "$packages"
|
|
162 #if $usescript.choosescript == "yes":
|
|
163 --script_path "$runme"
|
|
164 --sysexe "$usescript.scriptrunner"
|
49
|
165 #end if
|
85
|
166 --tool_name "$tool_name" --user_email "$__user_email__" --citations "$citeme" --parampass "$ppass.parampass"
|
63
|
167
|
49
|
168 #if str($makeMode.make_Tool)!="runonly":
|
85
|
169 --make_Tool "$makeMode.make_Tool"
|
|
170 --tool_desc "$makeMode.tool_desc"
|
|
171 --tool_version "$makeMode.tool_version"
|
|
172 --help_text "$helpme"
|
|
173 --new_tool "$new_tool"
|
|
174 --toolshed_api_key "$makeMode.toolshed_apikey"
|
|
175 --galaxy_api_key "$makeMode.galaxy_apikey"
|
|
176 --toolshed_url "$makeMode.toolshed_url"
|
|
177 --galaxy_url "$makeMode.galaxy_url"
|
48
|
178 #end if
|
|
179 #if $ppass.parampass != '0':
|
|
180 #if str($ppass.edit_params) == "yes":
|
|
181 --edit_additional_parameters
|
|
182 #end if
|
|
183 #for apar in $ppass.additional_parameters:
|
85
|
184 --additional_parameters "$apar.param_name~~~$apar.param_value~~~$apar.param_label~~~$apar.param_help~~~$apar.param_type~~~$apar.param_CL~~~$apar.param_CLprefixed"
|
48
|
185 #end for
|
|
186 #end if
|
|
187 #for $intab in $ppass.history_inputs:
|
85
|
188 --input_files "$intab.input_files~~~$intab.input_CL~~~$intab.input_formats~~~$intab.input_label~~~$intab.input_help"
|
48
|
189 #end for
|
|
190 #for $otab in $ppass.history_outputs:
|
49
|
191 --output_files "$otab.history_name~~~$otab.history_format~~~$otab.history_CL~~~$otab.history_test"
|
48
|
192 #end for
|
63
|
193 --galaxy_root "$__root_dir__"
|
73
|
194 --tool_dir "$__tool_directory__"
|
48
|
195 #end if
|
|
196 ]]></command>
|
|
197 <configfiles>
|
|
198 <configfile name="runme">
|
49
|
199 $usescript.dynScript
|
48
|
200 </configfile>
|
49
|
201 <configfile name="commandoverride">
|
|
202 #if $cover.commover == "yes" and len(str($cover.command_override).strip()) > 1:
|
|
203 $cover.command_override
|
|
204 #end if
|
63
|
205 </configfile>
|
49
|
206 <configfile name="testoverride">
|
|
207 #if $cover.commover == "yes" and len(str($cover.test_override).strip()) > 1:
|
|
208 $cover.test_override
|
|
209 #end if
|
63
|
210 </configfile>
|
48
|
211 <configfile name="helpme">
|
49
|
212 #if $makeMode.make_Tool != "runonly":
|
48
|
213 ${makeMode.help_text}
|
|
214 #else
|
|
215 $tool_name help goes here
|
|
216 #end if
|
|
217 </configfile>
|
|
218 <configfile name="citeme">
|
49
|
219 #if $makeMode.make_Tool != "runonly":
|
48
|
220 #for $citation in $makeMode.citations:
|
|
221 #if $citation.citation_type.type == "bibtex":
|
|
222 **ENTRY**bibtex
|
|
223 ${citation.citation_type.bibtex}
|
|
224 #else
|
|
225 **ENTRY**doi
|
|
226 ${citation.citation_type.doi}
|
|
227 #end if
|
|
228 #end for
|
|
229 #end if
|
|
230 </configfile>
|
|
231 </configfiles>
|
|
232 <inputs>
|
|
233 <param name="tool_name" type="text" value="tool1" label="New tool ID and title for outputs"
|
49
|
234 help="Toolshed repository name. Choose thoughtfully to avoid namespace clashes with other tool writers. Lower case, digits and underscores only">
|
48
|
235 <sanitizer invalid_char="">
|
108
|
236 <valid initial="string.ascii_lowercase,string.digits">
|
48
|
237 <add value="_"/>
|
|
238 </valid>
|
|
239 </sanitizer>
|
|
240 </param>
|
63
|
241 <param name="packages" type="text" value="" label="Conda dependencies as package name[:version, name:version...]. These will always be available when this tool executes"
|
113
|
242 optional="false" help="Use =[ver] or :[ver] for specific version - 'bwa=0.17.0'. Default is latest. Will be used every time the tool is (re)run. Only Conda is currently supported" />
|
63
|
243
|
|
244 <conditional name="usescript">
|
112
|
245 <param name="choosescript" type="select" display="radio" label="Supply a script for a dependency (e.g. python/R/bash) or a system executable such as Bash"
|
|
246 help = "For script interpreters like Python or bash, parameters and i/o specified below must match script's expectations - if you pass parameters, the script must deal with them">
|
108
|
247 <option value="no">No script required for this tool - just pass parameters on the command line to the first dependency listed above</option>
|
|
248 <option value="yes" selected="true">Yes, a script is ready to be pasted below</option>
|
48
|
249 </param>
|
49
|
250 <when value="no">
|
|
251 <param name="dynScript" type="hidden" value="" />
|
63
|
252 <param name="scriptrunner" type="hidden" value="" />
|
49
|
253 </when>
|
|
254 <when value="yes">
|
112
|
255 <param name="scriptrunner" type="text" value="" label="Interpreter for the script - eg bash or python. Can be one of the dependencies named above or a system executable"
|
63
|
256 help="Scripts are interpreted by the executable named here. Use bash for bash scripts, or a conda dependency such as R or Python for those scripts">
|
|
257 <sanitizer invalid_char="">
|
|
258 <valid initial="string.letters,string.digits">
|
|
259 <add value="_"/>
|
|
260 </valid>
|
|
261 </sanitizer>
|
|
262 </param>
|
112
|
263 <param name="dynScript" type="text" area="True" value="" label="Script for executable above to interpret. It can be one of the Conda dependency names "
|
50
|
264 help="Script must handle all i/o and parameters as specified below using the parameters and passing method chosen below">
|
49
|
265 <sanitizer>
|
|
266 <valid initial="string.printable">
|
|
267 </valid>
|
|
268 <mapping initial="none"/>
|
|
269 </sanitizer>
|
|
270 </param>
|
|
271 </when>
|
|
272 </conditional>
|
63
|
273
|
49
|
274 <conditional name="ppass">
|
48
|
275 <param name="parampass" type="select" display="radio" label="Command line parameter passing method to use">
|
50
|
276 <option value="argparse" selected="true">Argparse: passed in the form of --clname value</option>
|
49
|
277 <option value="positional">Positional: Passed in the order of positional ordinals ...foo.bam bar.idx zot.xls</option>
|
50
|
278 <option value="0">Tool reads selected input file from STDIN and writes STDOUT with no parameters</option>
|
48
|
279 </param>
|
49
|
280 <when value="argparse">
|
48
|
281 <expand macro="io" />
|
|
282 <expand macro="additparam" />
|
|
283 </when>
|
49
|
284 <when value="positional">
|
48
|
285 <expand macro="io" />
|
|
286 <expand macro="additparam" />
|
|
287 </when>
|
49
|
288 <when value="0">
|
48
|
289 <expand macro="io"/>
|
|
290 </when>
|
|
291 </conditional>
|
49
|
292 <param name="cl_prefix" type="text" value="" label="Prefix for generated command line. Prepends generated i/o and parameter CL. Use override below to replace completely"
|
|
293 help="Text will replace generated executable/script elements. Sometimes required before i/o and parameters in the generated command line." />
|
|
294 <conditional name="cover">
|
|
295 <param name="commover" type="select" display="radio" label="Add Human wrought code to override the generated XML command and/or test section - DIY"
|
|
296 help = "For arbitrary and artfull command lines. All i/o and parameters must be passed. Choose No unless needed. Not for the faint of heart">
|
50
|
297 <option value="no" selected="true">No. Use automatically generated command/test XML </option>
|
|
298 <option value="yes">Yes. XML needed to override autogenerated command and/or test segments will be pasted below</option>
|
63
|
299 </param>
|
49
|
300 <when value="no">
|
|
301 <param name="command_override" type="hidden" value="" />
|
|
302 <param name="test_override" type="hidden" value="" />
|
48
|
303 </when>
|
49
|
304 <when value="yes">
|
|
305 <param name="command_override" type="text" area="True" value="" label="Optional. Human wrought command element override XML/template - e.g. for bwa"
|
|
306 help="For arbitrary and artfull command lines. All i/o and parameters must be passed. Leave blank unless needed. Not for the faint of heart">
|
|
307 <sanitizer>
|
|
308 <valid initial="string.printable">
|
|
309 </valid>
|
|
310 <mapping initial="none"/>
|
|
311 </sanitizer>
|
|
312 </param>
|
|
313 <param name="test_override" type="text" area="True" value="" label="Optional. Human wrought test element override XML/template - e.g. for bwa"
|
|
314 help="For arbitrary and artfull scripts. Leave blank unless needed. Not for the faint of heart">
|
|
315 <sanitizer>
|
|
316 <valid initial="string.printable">
|
|
317 </valid>
|
|
318 <mapping initial="none"/>
|
|
319 </sanitizer>
|
63
|
320 </param>
|
48
|
321 </when>
|
|
322 </conditional>
|
49
|
323
|
|
324 <conditional name="makeMode">
|
50
|
325 <param name="make_Tool" type="select" display="radio" label="Choose the steps you want to run. The TF Docker container is recommended for local installation"
|
63
|
326 help="Installation in this Galaxy is optional" >
|
66
|
327 <option value="generate" >Run to generate tests only. Should fail if dependencies needed.</option>
|
108
|
328 <option value="gentest">Test with planemo after generating.</option>
|
|
329 <option value="gentestinstall" selected="true">Install in this Galaxy after generation and testing. Must have local ToolShed as in the TF Docker container</option>
|
49
|
330 </param>
|
66
|
331 <when value="generate">
|
|
332 <param name="galaxy_apikey" value="" type="hidden" ></param>
|
|
333 <param name="toolshed_apikey" value="" type="hidden" ></param>
|
|
334 <param name="galaxy_url" value="" type="hidden" ></param>
|
|
335 <param name="toolshed_url" value="" type="hidden" ></param>
|
|
336 <expand macro="tool_metadata" />
|
|
337 </when>
|
62
|
338 <when value="gentest">
|
63
|
339 <param name="galaxy_apikey" value="" type="hidden" ></param>
|
|
340 <param name="toolshed_apikey" value="" type="hidden" ></param>
|
|
341 <param name="galaxy_url" value="" type="hidden" ></param>
|
|
342 <param name="toolshed_url" value="" type="hidden" ></param>
|
50
|
343 <expand macro="tool_metadata" />
|
49
|
344 </when>
|
|
345 <when value="gentestinstall">
|
63
|
346 <param name="galaxy_url" type="text" value="http://localhost:8080" label="URL for the Galaxy server where the new tool should be installed"
|
|
347 help="Default is localhost">
|
|
348 <sanitizer>
|
|
349 <valid initial="string.printable">
|
|
350 </valid>
|
|
351 <mapping initial="none"/>
|
|
352 </sanitizer>
|
|
353 </param>
|
64
|
354 <param name="galaxy_apikey" type="text" value="fakekey" label="API key for the Galaxy to install the new tool"
|
63
|
355 help="Cut and paste from the admin user properties screen">
|
|
356 <sanitizer>
|
|
357 <valid initial="string.letters,string.digits">
|
|
358 </valid>
|
|
359 <mapping initial="none"/>
|
|
360 </sanitizer>
|
|
361 </param>
|
|
362 <param name="toolshed_url" type="text" value="http://localhost:9009" label="URL for the Toolshed where the new tool should be installed"
|
|
363 help="Default value is localhost:9009">
|
|
364 <sanitizer>
|
|
365 <valid initial="string.printable">
|
|
366 </valid>
|
|
367 <mapping initial="none"/>
|
|
368 </sanitizer>
|
|
369 </param>
|
64
|
370 <param name="toolshed_apikey" type="text" value="fakekey" label="API key for the local toolshed to use when installing the tool"
|
63
|
371 help="Cut and paste from the admin user properties screen">
|
|
372 <sanitizer>
|
|
373 <valid initial="string.letters,string.digits">
|
|
374 </valid>
|
|
375 <mapping initial="none"/>
|
|
376 </sanitizer>
|
|
377 </param>
|
|
378
|
50
|
379 <expand macro="tool_metadata" />
|
49
|
380 </when>
|
|
381 </conditional>
|
|
382
|
48
|
383 </inputs>
|
|
384 <outputs>
|
|
385
|
|
386 <data format="tgz" name="new_tool" label="${tool_name}_toolshed.tgz" >
|
49
|
387 <filter>makeMode['make_Tool'] != "runonly"</filter>
|
48
|
388 </data>
|
|
389
|
|
390 <collection name="TF_run_report" type="list" label="${tool_name} outputs">
|
|
391 <discover_datasets pattern="__name_and_ext__" directory="TF_run_report_tempdir" />
|
|
392 </collection>
|
|
393 </outputs>
|
|
394 <tests>
|
|
395 <test>
|
50
|
396 <param name="user_email" value="admin@galaxy.org"/>
|
48
|
397 <param name="input_files" value="input1_sample" />
|
|
398 <param name="input_CL" value="1" />
|
|
399 <param name="input_formats" value="txt" />
|
|
400 <param name="input_label" value="input" />
|
|
401 <param name="input_help" value="help" />
|
|
402 <param name="tool_name" value="pyrevpos" />
|
|
403 <param name="parampass" value="positional" />
|
49
|
404 <param name="make_Tool" value="generate" />
|
48
|
405 <param name="tool_version" value="0.01" />
|
|
406 <param name="tool_desc" value="positional reverse" />
|
|
407 <param name="help_text" value="help text goes here" />
|
50
|
408 <param name="packages" value="python"/>
|
|
409 <param name="history_name" value="output2" />
|
48
|
410 <param name="history_format" value="txt" />
|
|
411 <param name="history_CL" value="2" />
|
|
412 <param name="dynScript" value="import sys; inp = sys.argv[1]; outp = sys.argv[2]; inlist = open(inp,'r').readlines(); o = open(outp,'w'); rs = [''.join(list(reversed(x.rstrip()))) for x in inlist]; o.write('\n'.join(rs)); o.close()"/>
|
50
|
413 <param name="choosescript" value="yes" />
|
|
414 <param name="script_path" value="$runme"/>
|
48
|
415 <output name="new_tool" file="toolfactory_pyrevpos_tgz_sample" compare="sim_size" delta="6000" />
|
|
416 </test>
|
|
417 </tests>
|
|
418 <help>
|
|
419
|
|
420 .. class:: warningmark
|
|
421
|
|
422 **Details and attribution**
|
|
423 (see GTF_)
|
|
424
|
|
425 **Local Admins ONLY**
|
|
426 Only users whose IDs found in the local admin_user configuration setting in universe_wsgi.ini can run this tool.
|
|
427
|
|
428 **If you find a bug**
|
|
429 Please raise an issue, or even better, submit a pull request fixing it, on the github repository GTF_
|
|
430
|
|
431 **What it does**
|
|
432 This tool optionally generates normal workflow compatible first class Galaxy tools
|
|
433
|
|
434 Generated tools can run existing binary packages that become requirements, existing scripts, or new scripts pasted into this tool form.
|
|
435 Pasted scripts are written so they are part of the new tool and cannot be adjusted by the downstream user.
|
|
436 Binary packages are managed by the dependency subsystem - conda usually, so anything in bioconda or conda_forge is available for example.
|
|
437
|
|
438 Any number of parameters can be built into the new tool form for passing in to the script or executable at runtime.
|
|
439 These can be editable by the downstream user or baked in.
|
|
440
|
|
441 When you run this tool, your executable or script and supplied parameter values will be run to produce a canonical
|
|
442 set of outputs - these are used to construct a test for the new tool.
|
|
443
|
|
444 If tool generation is required, a new tarball compatible with any Galaxy toolshed is created.
|
|
445 It can be unpacked in your galaxy/tools directory and manually added to tool_conf.xml, or
|
|
446 installed into any toolshed from where it can be installed into your Galaxy.
|
|
447
|
|
448
|
|
449 .. class:: warningmark
|
|
450
|
|
451 **Note to system administrators**
|
|
452 This tool offers *NO* built in protection against malicious scripts. It should only be installed on private/personnal Galaxy instances.
|
|
453 Admin_users will have the power to do anything they want as the Galaxy user if you install this tool.
|
|
454
|
|
455 .. class:: warningmark
|
|
456
|
|
457 **Use on public servers** is STRONGLY discouraged for obvious reasons
|
|
458
|
|
459 The tools generated by this tool will run just as securely as any other normal installed Galaxy tool but like any other new tools, should always be checked carefully before installation.
|
|
460 We recommend that you follow the good code hygiene practices associated with safe toolshed practices.
|
|
461
|
|
462 Here's a sample python script that can be cut and pasted into the tool form, suitable for positional parameter passing:
|
|
463
|
|
464 ::
|
|
465
|
|
466 # reverse order of text by row
|
|
467 import sys
|
|
468 inp = sys.argv[1]
|
|
469 outp = sys.argv[2]
|
|
470 i = open(inp,'r').readlines()
|
|
471 o = open(outp,'w')
|
|
472 for row in i:
|
|
473 rs = row.rstrip()
|
|
474 rs = list(rs)
|
|
475 rs.reverse()
|
|
476 o.write(''.join(rs))
|
|
477 o.write('\n')
|
|
478 o.close()
|
|
479
|
|
480 With argparse style parameters:
|
|
481
|
|
482 ::
|
|
483
|
|
484 # reverse order of text by row
|
|
485 import argparse
|
|
486 parser = argparse.ArgumentParser()
|
|
487 a = parser.add_argument
|
|
488 a('--infile',default='')
|
|
489 a('--outfile',default=None)
|
|
490 args = parser.parse_args()
|
|
491 inp = args.infile
|
|
492 outp = args.outfile
|
|
493 i = open(inp,'r').readlines()
|
|
494 o = open(outp,'w')
|
|
495 for row in i:
|
|
496 rs = row.rstrip()
|
|
497 rs = list(rs)
|
|
498 rs.reverse()
|
|
499 o.write(''.join(rs))
|
|
500 o.write('\n')
|
|
501 o.close()
|
|
502
|
|
503
|
|
504
|
63
|
505 Paper_
|
48
|
506
|
50
|
507 *Licensing*
|
48
|
508
|
|
509 Copyright Ross Lazarus (ross period lazarus at gmail period com) May 2012
|
|
510 All rights reserved.
|
|
511 Licensed under the LGPL_
|
|
512
|
|
513 .. _LGPL: http://www.gnu.org/copyleft/lesser.html
|
|
514 .. _GTF: https://github.com/fubar2/toolfactory
|
|
515 .. _Paper: http://bioinformatics.oxfordjournals.org/cgi/reprint/bts573
|
|
516
|
|
517
|
|
518 </help>
|
|
519 <citations>
|
|
520 <citation type="doi">10.1093/bioinformatics/bts573</citation>
|
|
521 </citations>
|
|
522 </tool>
|
|
523
|
|
524
|