|
4
|
1 <tool id="rgtf2" name="toolfactory" version="2.00" profile="16.04" >
|
|
|
2 <description>Scripts into tools v2.0</description>
|
|
|
3 <macros>
|
|
|
4 <xml name="singleText">
|
|
|
5 <param name="param_value" type="text" value="" label="Enter this parameter's default text value">
|
|
|
6 </param>
|
|
|
7 </xml>
|
|
|
8 <xml name="singleInt">
|
|
|
9 <param name="param_value" type="integer" value="" label="Enter this parameter's default integer value" >
|
|
|
10 </param>
|
|
|
11 </xml>
|
|
|
12 <xml name="singleFloat">
|
|
|
13 <param name="param_value" type="float" value="" label="Enter this parameter's default value">
|
|
|
14 </param>
|
|
|
15 </xml>
|
|
|
16 <xml name="singleBoolean">
|
|
|
17 <param name="param_value" type="boolean" value="" label="Enter this parameter's default value" />
|
|
|
18 <param name="truevalue" type="text" value="True" label="Command line value to emit when True" />
|
|
|
19 <param name="falsevalue" type="boolean" value="True" label="Command line value to emit when False" />
|
|
|
20 </xml>
|
|
|
21 <xml name="selectText">
|
|
|
22 <repeat name="selectTexts" title="Add each option to be presented in a text select box" min="2" default="2"
|
|
|
23 help="Each text added here will also have a value to be emitted on the command line when the text is chosen">
|
|
|
24 <param name="select_text" type="text" value="" label="Enter the explanatory text the user will see for this choice" >
|
|
|
25 </param>
|
|
|
26 <param name="select_value" type="text" value="" label="Enter the value for the command line when the user selects this option">
|
|
|
27 </param>
|
|
|
28 </repeat>
|
|
|
29 </xml>
|
|
|
30 <xml name="tool_metadata">
|
|
|
31 <param name="tool_version" label="Tool Version - bump this to warn users trying to redo old analyses" type="text" value="0.01"
|
|
|
32 help="If you change your script and regenerate the 'same' tool, you should inform Galaxy (and users) by changing (bumping is traditional) this number"/>
|
|
|
33 <param name="tool_desc" label="Tool Synopsis" type="text" value=""
|
|
|
34 help="Supply a brief tool description for the Galaxy tool menu entry" />
|
|
|
35 <param name="install" label="Attempt to install in the host Galaxy"
|
|
|
36 help="This will fail unless running in a very unusual configuration such as a specialised Docker container"
|
|
|
37 type="boolean" checked="True" truevalue="1" falsevalue="0" />
|
|
|
38 <conditional name="do_test">
|
|
|
39 <param name="run_test" label="Run planemo test on the new archive to add test outputs making a proper tool - takes time"
|
|
|
40 help="Archives must be run and updated using planemo to populate all the test outputs. Will be very quick if no dependencies (eg a bash script). May take a very long time depending on dependencies"
|
|
|
41 type="boolean" checked="False" truevalue="1" falsevalue="0" />
|
|
|
42 <when value="0">
|
|
|
43 <param name="tail" type="hidden" value="not_tested"/>
|
|
|
44 </when>
|
|
|
45 <when value="1">
|
|
|
46 <param name="tail" type="hidden" value="tested"/>
|
|
|
47 </when>
|
|
|
48 </conditional>
|
|
|
49 <param name="help_text" label="Tool form documentation and help text for users" type="text" area="true"
|
|
|
50 value="**What it Does**"
|
|
|
51 help="Supply user documentation to appear on the new tool form as reStructured text - http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html" >
|
|
|
52 <sanitizer>
|
|
|
53 <valid initial="string.printable" />
|
|
|
54 <mapping initial="none"/>
|
|
|
55 </sanitizer>
|
|
|
56 </param>
|
|
|
57 <repeat name="citations" title="Citation">
|
|
|
58 <conditional name="citation_type">
|
|
|
59 <param name="type" type="select" display="radio" label="Citation Type">
|
|
|
60 <option value="doi">DOI</option>
|
|
|
61 <option value="bibtex">BibTeX</option>
|
|
|
62 </param>
|
|
|
63 <when value="doi">
|
|
|
64 <param name="doi" label="DOI" type="text" value=""
|
|
|
65 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." />
|
|
|
66 </when>
|
|
|
67 <when value="bibtex">
|
|
|
68 <param name="bibtex" label="BibTex" type="text" area="true"
|
|
|
69 help="Supply a BibTex entry that should be cited when this tool is used in published research." value="" >
|
|
|
70 <sanitizer>
|
|
|
71 <valid initial="string.printable" />
|
|
|
72 <mapping initial="none"/>
|
|
|
73 </sanitizer>
|
|
|
74 </param>
|
|
|
75 </when>
|
|
|
76 </conditional>
|
|
|
77 </repeat>
|
|
|
78 </xml>
|
|
|
79 <xml name="io">
|
|
|
80 <section name="io" title="Input and output files" expanded="true">
|
|
|
81 <repeat name="history_inputs" title="Inputs" min="0"
|
|
|
82 help="Input data files to pass on the command line to the executable. USE SMALL SAMPLES for the new tool's test. Prompts will form a history item selector as input for users of this new tool">
|
|
|
83 <param name="input_files" type="data" format="data" label="Select an input file from your history" multiple="false"
|
|
|
84 help=""/>
|
|
|
85 <param name="input_formats" type="select" multiple="true" label="Select the datatype(s) that your tool/script accepts as input"
|
|
|
86 help="If your datatype is not listed here, it has to be added in galaxy's datatypes_conf.xml" value="tabular">
|
|
|
87 <options from_parameter="tool.app.datatypes_registry.upload_file_formats">
|
|
|
88 <column name="value" index="0"/>
|
|
|
89 </options>
|
|
|
90 </param>
|
|
|
91 <param name="input_label" type="text" value="" label="This will become the user prompt for the form so please make it informative" >
|
|
|
92 </param>
|
|
|
93 <param name="input_help" type="text" value="" label="This will become help text on the form." >
|
|
|
94 </param>
|
|
|
95 <param name="input_CL" type="text" label="Positional: ordinal integer. Argparse: argument name. STDIN if the executable/script expects it"
|
|
|
96 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="">
|
|
|
97 </param>
|
|
|
98 <param name="input_repeat" type="boolean" checked="False" truevalue="1" falsevalue="0" label="Allow user to repeat this input as many times as wanted - script/executable must parse these."/>
|
|
|
99 </repeat>
|
|
|
100 <repeat name="history_outputs" min="0" title="Outputs"
|
|
|
101 help="New history items output by the executable to appear in the user history after the tool runs. The name will become a history item for users of the new tool you are making containing one of it's outputs">
|
|
|
102 <param name="history_name" type="text" label="Output Name" optional="false"
|
|
|
103 help="Name used for this output in history. No spaces! Argparse will also use this name as --[name]">
|
|
|
104 <sanitizer invalid_char=" ">
|
|
|
105 <valid initial="string.ascii_letters,string.digits" >
|
|
|
106 <add value="_" />
|
|
|
107 </valid>
|
|
|
108 </sanitizer>
|
|
|
109 </param>
|
|
|
110 <param name="history_format" type="select" multiple="false" label="Select the datatype for this output"
|
|
|
111 help="If your datatype is not listed here, it has to be added in galaxy's datatypes_conf.xml" value="tabular">
|
|
|
112 <options from_parameter="tool.app.datatypes_registry.upload_file_formats">
|
|
|
113 <column name="value" index="0"/>
|
|
|
114 </options>
|
|
|
115 </param>
|
|
|
116 <param name="history_CL" type="text" label="Position"
|
|
|
117 help="Positional: ordinal integer or 'STDOUT' if '>' required. Otherwise ignored if argparse because name is used. If positional parameters, enter the integer ordinal expected for this parameter. If argparse, ignore unless STDOUT needed" value=""/>
|
|
|
118 <param name="history_test" type="text" label="Output test criteria"
|
|
|
119 help="Pass/fail decision criterion for this output compared to test generation. Available options are diff:[lines], sim_size:[delta (integer) or delta_frac (float)" value="diff:0"/>
|
|
|
120 </repeat>
|
|
|
121 <repeat name="collection_outputs" title="Output Collections" min="0"
|
|
|
122 help="New history collections to appear in the user history after the tool runs. Hides outputs not needed for downstream tools such as images and intermediate reports." default="0">
|
|
|
123 <param name="name" type="text" label="Name"
|
|
|
124 help="for new collection with all outputs not individually passed to history outputs. No spaces! Script MUST create and fill a directory with the same name and the tool test MUST be overwritten - see the plotter example for hints">
|
|
|
125 <sanitizer invalid_char="_">
|
|
|
126 <valid initial="string.ascii_letters,string.digits" >
|
|
|
127 <add value="_" />
|
|
|
128 </valid>
|
|
|
129 </sanitizer>
|
|
|
130 </param>
|
|
|
131 <param name="kind" type="select" multiple="false" label="Select the kind of collection for this output"
|
|
|
132 help="">
|
|
|
133 <option value="list" selected="true">List</option>
|
|
|
134 <option value="paired">Paired</option>
|
|
|
135 <option value="list:paired">List of paired</option>
|
|
|
136 </param>
|
|
|
137 <param name="label" type="text" label="Label for this collection" help="" value=""/>
|
|
|
138 <param name="discover" type="text" label="Discover datasets expression" help="__name_and_ext__ should catch all filenames with extensions" value="__name_and_ext__"/>
|
|
|
139 </repeat>
|
|
|
140
|
|
|
141 </section>
|
|
|
142 </xml>
|
|
|
143 <xml name="additparam">
|
|
|
144 <section name="addparam" title="Arguments" help="Executable or script settings passed on the command line other than I/O files" expanded="true">
|
|
|
145 <param name="edit_params" type="select" display="radio" label="Make these settings on the generated tool form user editable?"
|
|
|
146 help="If no, 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">
|
|
|
147 <option value="yes" selected="true">Yes, allow user to edit all additional parameters on the generated tool form</option>
|
|
|
148 <option value="no">No - use the fixed values for all additional parameters - no user editing</option>
|
|
|
149 </param>
|
|
|
150 <repeat name="additional_parameters" title="Command Line Paramters" min="0"
|
|
|
151 help="Command line settings for the user to pass to the executable. See examples below to see how these can be parsed by scripts in the various languages">
|
|
|
152 <param name="param_name" type="text" value="" label="Choose the name for this parameter - MUST not be blank!">
|
|
|
153 <sanitizer invalid_char="">
|
|
|
154 <valid initial="string.ascii_letters,string.digits"/>
|
|
|
155 <mapping initial="none"/>
|
|
|
156 </sanitizer>
|
|
|
157 </param>
|
|
|
158 <conditional name="ap_type">
|
|
|
159 <param name="param_type" type="select" label="Select the type for this parameter">
|
|
|
160 <option value="text" selected="true">Text string</option>
|
|
|
161 <option value="integer">Integer</option>
|
|
|
162 <option value="float">Float</option>
|
|
|
163 <option value="boolean">Boolean</option>
|
|
|
164 <option value="selecttext">Select text string</option>
|
|
|
165 </param>
|
|
|
166 <when value = "text">
|
|
|
167 <expand macro="singleText" />
|
|
|
168 </when>
|
|
|
169 <when value = "integer">
|
|
|
170 <expand macro="singleInt" />
|
|
|
171 </when>
|
|
|
172 <when value = "float">
|
|
|
173 <expand macro="singleFloat" />
|
|
|
174 </when>
|
|
|
175 <when value = "boolean">
|
|
|
176 <expand macro="singleBoolean" />
|
|
|
177 </when>
|
|
|
178 <when value = "selecttext">
|
|
|
179 <expand macro="selectText" />
|
|
|
180 </when>
|
|
|
181 </conditional>
|
|
|
182 <param name="param_label" type="text" value="" label="Enter this parameter's label for the form">
|
|
|
183 </param>
|
|
|
184 <param name="param_help" type="text" value="" label="Help for this parameter">
|
|
|
185 </param>
|
|
|
186 <param name="param_CL" type="text" label="Positional ordinal | argparse argument name"
|
|
|
187 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="" />
|
|
|
188 <param name="param_CLprefixed" type="text" label="Override the generated default argparse name prefix if not empty - eg ----foo if needed"
|
|
|
189 help="Some targets like Planemo expect an unadorned action like 'test' before --galaxy_root." value="" />
|
|
|
190 <param name="param_repeat" type="boolean" checked="False" truevalue="1" falsevalue="0" label="Allow user to repeat this as many times as needed." />
|
|
|
191 </repeat>
|
|
|
192 </section>
|
|
|
193 </xml>
|
|
|
194 </macros>
|
|
|
195
|
|
|
196 <requirements>
|
|
|
197 <requirement type="package" version="0.4.14">galaxyxml</requirement>
|
|
|
198 <requirement type="package" version="0.15.0">bioblend</requirement>
|
|
|
199 </requirements>
|
|
|
200
|
|
|
201 <command detect_errors="exit_code"><![CDATA[
|
|
|
202 #import os
|
|
|
203 #set dev_env = os.environ.get('GALAXY_DEVELOPMENT_ENVIRONMENT', '0') == '1'
|
|
|
204 #if not $dev_env and ( $__user_email__ not in $__admin_users__ ):
|
|
|
205 python3 $__tool_directory__/rgToolFactory2.py --bad_user $__user_email__
|
|
|
206 #else:
|
|
|
207 python3 $__tool_directory__/ToolFactory.py
|
|
|
208 #if len(str($cl_suffix)) > 0:
|
|
|
209 --cl_user_suffix "$cl_suffix"
|
|
|
210 #end if
|
|
|
211 #if $cover.commover == "yes":
|
|
|
212 #if len(str($cover.command_override)) > 10:
|
|
|
213 --command_override "$commandoverride"
|
|
|
214 #end if
|
|
|
215 #if len(str($cover.test_override)) > 10:
|
|
|
216 --test_override "$testoverride"
|
|
|
217 #end if
|
|
|
218 #end if
|
|
|
219 #if $deps.packages > "":
|
|
|
220 --packages "$deps.packages"
|
|
|
221 #end if
|
|
|
222 #if $deps.usescript.choosescript == "yes":
|
|
|
223 --script_path "$runme"
|
|
|
224 --sysexe "$deps.usescript.scriptrunner"
|
|
|
225 #end if
|
|
|
226 --tool_name "$tool_name" --user_email "$__user_email__" --citations "$citeme" --parampass "$io_param.ppass.parampass"
|
|
|
227 --tool_desc "$tool_desc"
|
|
|
228 --tool_version "$tool_version"
|
|
|
229 --help_text "$helpme"
|
|
|
230 --new_tool "$new_tool"
|
|
|
231 #if $install:
|
|
|
232 --install
|
|
|
233 #end if
|
|
|
234 #if $do_test.run_test:
|
|
|
235 --run_test
|
|
|
236 #end if
|
|
|
237 #if $io_param.ppass.parampass != '0':
|
|
|
238 #if str($io_param.ppass.addparam.edit_params) == "yes":
|
|
|
239 --edit_additional_parameters
|
|
|
240 #end if
|
|
|
241 #for $apar in $io_param.ppass.addparam.additional_parameters:
|
|
|
242 #if $apar.ap_type.param_type=="selecttext":
|
|
|
243 --selecttext_parameters '{"name":"$apar.param_name", "label":"$apar.param_label", "help":"$apar.param_help",
|
|
|
244 "type":"$apar.ap_type.param_type","CL":"$apar.param_CL","override":"$apar.param_CLprefixed","value": [
|
|
|
245 #for $i,$st in enumerate($apar.ap_type.selectTexts):
|
|
|
246 "$st.select_value"
|
|
|
247 #if ($i < (len($apar.ap_type.selectTexts)-1)):
|
|
|
248 ,
|
|
|
249 #end if
|
|
|
250 #end for
|
|
|
251 ], "texts": [
|
|
|
252 #for $i,$st in enumerate($apar.ap_type.selectTexts):
|
|
|
253 "$st.select_text"
|
|
|
254 #if ($i < (len($apar.ap_type.selectTexts)-1)):
|
|
|
255 ,
|
|
|
256 #end if
|
|
|
257
|
|
|
258 #end for
|
|
|
259 ]
|
|
|
260 }'
|
|
|
261 #else:
|
|
|
262 --additional_parameters '{"name": "$apar.param_name", "value": "$apar.ap_type.param_value", "label": "$apar.param_label", "help": "$apar.param_help",
|
|
|
263 "type": "$apar.ap_type.param_type","CL": "$apar.param_CL","override": "$apar.param_CLprefixed", "repeat": "$apar.param_repeat"}'
|
|
|
264 #end if
|
|
|
265 #end for
|
|
|
266 #end if
|
|
|
267 #for $intab in $io_param.ppass.io.history_inputs:
|
|
|
268 --input_files '{"name": "$intab.input_files", "CL": "$intab.input_CL", "format": "$intab.input_formats", "label": "$intab.input_label", "help": "$intab.input_help", "repeat": "$intab.input_repeat"}'
|
|
|
269 #end for
|
|
|
270 #for $otab in $io_param.ppass.io.history_outputs:
|
|
|
271 --output_files '{"name": "$otab.history_name", "format": "$otab.history_format", "CL": "$otab.history_CL", "test": "$otab.history_test"}'
|
|
|
272 #end for
|
|
|
273 #for $collect in $io_param.ppass.io.collection_outputs:
|
|
|
274 --collection '{"name": "$collect.name", "kind": "$collect.kind", "discover": "$collect.discover", "label": "$collect.label"}'
|
|
|
275 #end for
|
|
|
276 --galaxy_root "$__root_dir__"
|
|
|
277 --tool_dir "$__tool_directory__"
|
|
|
278 #end if
|
|
|
279 ]]></command>
|
|
|
280 <configfiles>
|
|
|
281 <configfile name="runme">
|
|
|
282 $deps.usescript.dynScript
|
|
|
283 </configfile>
|
|
|
284 <configfile name="commandoverride">
|
|
|
285 #if $cover.commover == "yes" and len(str($cover.command_override).strip()) > 1:
|
|
|
286 $cover.command_override
|
|
|
287 #end if
|
|
|
288 </configfile>
|
|
|
289 <configfile name="testoverride">
|
|
|
290 #if $cover.commover == "yes" and len(str($cover.test_override).strip()) > 1:
|
|
|
291 $cover.test_override
|
|
|
292 #end if
|
|
|
293 </configfile>
|
|
|
294 <configfile name="helpme">
|
|
|
295 ${help_text}
|
|
|
296 </configfile>
|
|
|
297 <configfile name="citeme">
|
|
|
298
|
|
|
299 #for $citation in $citations:
|
|
|
300 #if $citation.citation_type.type == "bibtex":
|
|
|
301 **ENTRY**bibtex
|
|
|
302 ${citation.citation_type.bibtex}
|
|
|
303 #else
|
|
|
304 **ENTRY**doi
|
|
|
305 ${citation.citation_type.doi}
|
|
|
306 #end if
|
|
|
307 #end for
|
|
|
308
|
|
|
309 </configfile>
|
|
|
310 </configfiles>
|
|
|
311 <inputs>
|
|
|
312 <param name="tool_name" type="text" value="tool1" label="New tool ID and title for outputs"
|
|
|
313 help="Toolshed repository name. Choose thoughtfully to avoid namespace clashes with other tool writers. Lower case, digits and underscores only">
|
|
|
314 <sanitizer invalid_char="">
|
|
|
315 <valid initial="string.ascii_lowercase,string.digits">
|
|
|
316 <add value="_"/>
|
|
|
317 </valid>
|
|
|
318 </sanitizer>
|
|
|
319 </param>
|
|
|
320
|
|
|
321 <section name="deps" title="Dependencies, optional script and script interpreter" expanded="true">
|
|
|
322
|
|
|
323 <param name="packages" type="text" value="" label="Conda dependencies as package name[:version, name:version...]. These will always be available when this tool executes"
|
|
|
324 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" />
|
|
|
325
|
|
|
326 <conditional name="usescript">
|
|
|
327 <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"
|
|
|
328 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">
|
|
|
329 <option value="no">No script required for this tool - just pass parameters on the command line to the first dependency listed above</option>
|
|
|
330 <option value="yes" selected="true">Yes, a script is ready to be pasted below</option>
|
|
|
331 </param>
|
|
|
332 <when value="no">
|
|
|
333 <param name="dynScript" type="hidden" value="" />
|
|
|
334 <param name="scriptrunner" type="hidden" value="" />
|
|
|
335 </when>
|
|
|
336 <when value="yes">
|
|
|
337 <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"
|
|
|
338 help="Scripts are interpreted by the executable named here. For conda r-base, 'Rscript --vanilla' or for conda planemo, 'planemo test' for example">
|
|
|
339 </param>
|
|
|
340 <param name="dynScript" type="text" area="True" value="" label="Script for executable above to interpret. It can be one of the Conda dependency names "
|
|
|
341 help="Script must handle all i/o and parameters as specified below using the parameters and passing method chosen below">
|
|
|
342 <sanitizer>
|
|
|
343 <valid initial="string.printable"/>
|
|
|
344 <mapping initial="none"/>
|
|
|
345 </sanitizer>
|
|
|
346 </param>
|
|
|
347 </when>
|
|
|
348 </conditional>
|
|
|
349 </section>
|
|
|
350 <section name="io_param" title="Data file input, output and settings forming the executable or script command line" expanded="true">
|
|
|
351 <conditional name="ppass">
|
|
|
352 <param name="parampass" type="select" display="radio" label="Command line parameter passing method to use">
|
|
|
353 <option value="argparse" selected="true">Argparse: passed in the form of --clname value</option>
|
|
|
354 <option value="positional">Positional: Passed in the order of positional ordinals ...foo.bam bar.idx zot.xls</option>
|
|
|
355 <option value="0">Tool reads selected input file from STDIN and writes STDOUT with no parameters</option>
|
|
|
356 </param>
|
|
|
357 <when value="argparse">
|
|
|
358 <expand macro="io" />
|
|
|
359 <expand macro="additparam" />
|
|
|
360 </when>
|
|
|
361 <when value="positional">
|
|
|
362 <expand macro="io" />
|
|
|
363 <expand macro="additparam" />
|
|
|
364 </when>
|
|
|
365 <when value="0">
|
|
|
366 <expand macro="io"/>
|
|
|
367 </when>
|
|
|
368 </conditional>
|
|
|
369 </section>
|
|
|
370 <param name="cl_suffix" type="text" value="" label="Suffix for generated command line. Useful for bash post processing. Use override below to replace completely"
|
|
|
371 help="';' separated bash commands can be used here for post processing - added at end of autogenerated command line">
|
|
|
372 <sanitizer>
|
|
|
373 <valid initial="string.printable" />
|
|
|
374 <mapping initial="none"/>
|
|
|
375 </sanitizer>
|
|
|
376 </param>
|
|
|
377 <conditional name="cover">
|
|
|
378 <param name="commover" type="select" display="radio" label="Add Human wrought code to override the generated XML command and/or test section - DIY"
|
|
|
379 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">
|
|
|
380 <option value="no" selected="true">No. Use automatically generated command/test XML </option>
|
|
|
381 <option value="yes">Yes. XML needed to override autogenerated command and/or test segments will be pasted below</option>
|
|
|
382 </param>
|
|
|
383 <when value="no">
|
|
|
384 <param name="command_override" type="hidden" value="" />
|
|
|
385 <param name="test_override" type="hidden" value="" />
|
|
|
386 </when>
|
|
|
387 <when value="yes">
|
|
|
388 <param name="command_override" type="text" area="True" value="" label="Optional. Human wrought command element override XML/template - e.g. for bwa"
|
|
|
389 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">
|
|
|
390 <sanitizer>
|
|
|
391 <valid initial="string.printable"/>
|
|
|
392 <mapping initial="none"/>
|
|
|
393 </sanitizer>
|
|
|
394 </param>
|
|
|
395 <param name="test_override" type="text" area="True" value="" label="Optional. Human wrought test element override XML/template - e.g. for bwa"
|
|
|
396 help="For arbitrary and artfull scripts. Leave blank unless needed. Not for the faint of heart">
|
|
|
397 <sanitizer>
|
|
|
398 <valid initial="string.printable" />
|
|
|
399 <mapping initial="none"/>
|
|
|
400 </sanitizer>
|
|
|
401 </param>
|
|
|
402 </when>
|
|
|
403 </conditional>
|
|
|
404 <expand macro="tool_metadata" />
|
|
|
405 </inputs>
|
|
|
406 <outputs>
|
|
|
407 <data format="toolshed.gz" name="new_tool" label="${tool_name}_${do_test.tail}_toolshed.gz" />
|
|
|
408 <collection name="TF_run_report" type="list" label="${tool_name} test run outputs">
|
|
|
409 <filter>do_test['run_test']</filter>
|
|
|
410 <discover_datasets pattern="__name_and_ext__" directory="TF_run_report" />
|
|
|
411 </collection>
|
|
|
412 </outputs>
|
|
|
413 <tests>
|
|
|
414 <test>
|
|
|
415 <param name="user_email" value="admin@galaxy.org"/>
|
|
|
416 <param name="input_files" value="input1_sample" />
|
|
|
417 <param name="input_CL" value="1" />
|
|
|
418 <param name="input_formats" value="txt" />
|
|
|
419 <param name="input_label" value="input" />
|
|
|
420 <param name="input_help" value="help" />
|
|
|
421 <param name="tool_name" value="pyrevpos" />
|
|
|
422 <param name="parampass" value="positional" />
|
|
|
423 <param name="tool_version" value="0.01" />
|
|
|
424 <param name="tool_desc" value="positional reverse" />
|
|
|
425 <param name="help_text" value="help text goes here" />
|
|
|
426 <param name="packages" value="python"/>
|
|
|
427 <param name="history_name" value="output2" />
|
|
|
428 <param name="history_format" value="txt" />
|
|
|
429 <param name="history_CL" value="2" />
|
|
|
430 <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()"/>
|
|
|
431 <param name="choosescript" value="yes" />
|
|
|
432 <param name="script_path" value="$runme"/>
|
|
|
433 <param name="install" value="0"/>
|
|
|
434 <param name="run_test" value="1"/>
|
|
|
435 <output name="new_tool" file="toolfactory_pyrevpos_tgz_sample" compare="sim_size" delta="6000" />
|
|
|
436 </test>
|
|
|
437 </tests>
|
|
|
438 <help>
|
|
|
439
|
|
|
440 .. class:: warningmark
|
|
|
441
|
|
|
442 **Details and attribution**
|
|
|
443 (see GTF_)
|
|
|
444
|
|
|
445 **Local Admins ONLY**
|
|
|
446 Only users whose IDs found in the local admin_user configuration setting in universe_wsgi.ini can run this tool.
|
|
|
447
|
|
|
448 **If you find a bug**
|
|
|
449 Please raise an issue, or even better, submit a pull request fixing it, on the github repository GTF_
|
|
|
450
|
|
|
451 **What it does**
|
|
|
452 This tool optionally generates normal workflow compatible first class Galaxy tools
|
|
|
453
|
|
|
454 Generated tools can run existing binary packages that become requirements, existing scripts, or new scripts pasted into this tool form.
|
|
|
455 Pasted scripts are written so they are part of the new tool and cannot be adjusted by the downstream user.
|
|
|
456 Binary packages are managed by the dependency subsystem - conda usually, so anything in bioconda or conda_forge is available for example.
|
|
|
457
|
|
|
458 Any number of parameters can be built into the new tool form for passing in to the script or executable at runtime.
|
|
|
459 These can be editable by the downstream user or baked in.
|
|
|
460
|
|
|
461 A new tarball compatible with any Galaxy toolshed is created in your history, however, it does not have the test prepared.
|
|
|
462 There is a separate tool you can run to update the archive after testing with Planemo
|
|
|
463
|
|
|
464 If the configuration in job_conf.xml allows tools to write to [galaxy_root]/tools, the new tool will be installed so you can view and test it locally.
|
|
|
465
|
|
|
466 .. class:: warningmark
|
|
|
467
|
|
|
468 **Note to system administrators**
|
|
|
469 This tool offers *NO* built in protection against malicious scripts. It should only be installed on private/personnal Galaxy instances.
|
|
|
470 Admin_users will have the power to do anything they want as the Galaxy user if you install this tool.
|
|
|
471
|
|
|
472 .. class:: warningmark
|
|
|
473
|
|
|
474 **Use on public servers** is STRONGLY discouraged for obvious reasons
|
|
|
475
|
|
|
476 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.
|
|
|
477 We recommend that you follow the good code hygiene practices associated with safe toolshed practices.
|
|
|
478
|
|
|
479 Here's a sample python script that can be cut and pasted into the tool form, suitable for positional parameter passing:
|
|
|
480
|
|
|
481 ::
|
|
|
482
|
|
|
483 # reverse order of text by row
|
|
|
484 import sys
|
|
|
485 inp = sys.argv[1]
|
|
|
486 outp = sys.argv[2]
|
|
|
487 i = open(inp,'r').readlines()
|
|
|
488 o = open(outp,'w')
|
|
|
489 for row in i:
|
|
|
490 rs = row.rstrip()
|
|
|
491 rs = list(rs)
|
|
|
492 rs.reverse()
|
|
|
493 o.write(''.join(rs))
|
|
|
494 o.write('\n')
|
|
|
495 o.close()
|
|
|
496
|
|
|
497 With argparse style parameters:
|
|
|
498
|
|
|
499 ::
|
|
|
500
|
|
|
501 # reverse order of text by row
|
|
|
502 import argparse
|
|
|
503 parser = argparse.ArgumentParser()
|
|
|
504 a = parser.add_argument
|
|
|
505 a('--infile',default='')
|
|
|
506 a('--outfile',default=None)
|
|
|
507 args = parser.parse_args()
|
|
|
508 inp = args.infile
|
|
|
509 outp = args.outfile
|
|
|
510 i = open(inp,'r').readlines()
|
|
|
511 o = open(outp,'w')
|
|
|
512 for row in i:
|
|
|
513 rs = row.rstrip()
|
|
|
514 rs = list(rs)
|
|
|
515 rs.reverse()
|
|
|
516 o.write(''.join(rs))
|
|
|
517 o.write('\n')
|
|
|
518 o.close()
|
|
|
519
|
|
|
520 R script to draw some plots - use a collection.
|
|
|
521
|
|
|
522 ::
|
|
|
523
|
|
|
524
|
|
|
525 \# note this script takes NO input because it generates random data
|
|
|
526 dir.create('plots')
|
|
|
527 for (i in 1:10) {
|
|
|
528 foo = runif(100)
|
|
|
529 bar = rnorm(100)
|
|
|
530 bar = foo + 0.05*bar
|
|
|
531 pdf(paste('plots/yet',i,"anotherplot.pdf",sep='_'))
|
|
|
532 plot(foo,bar,main=paste("Foo by Bar plot \#",i),col="maroon", pch=3,cex=0.6)
|
|
|
533 dev.off()
|
|
|
534 foo = data.frame(a=runif(100),b=runif(100),c=runif(100),d=runif(100),e=runif(100),f=runif(100))
|
|
|
535 bar = as.matrix(foo)
|
|
|
536 pdf(paste('plots/yet',i,"anotherheatmap.pdf",sep='_'))
|
|
|
537 heatmap(bar,main='Random Heatmap')
|
|
|
538 dev.off()
|
|
|
539 }
|
|
|
540
|
|
|
541
|
|
|
542
|
|
|
543 Paper_
|
|
|
544
|
|
|
545 *Licensing*
|
|
|
546
|
|
|
547 Copyright Ross Lazarus (ross period lazarus at gmail period com) May 2012
|
|
|
548 All rights reserved.
|
|
|
549 Licensed under the LGPL_
|
|
|
550
|
|
|
551 .. _LGPL: http://www.gnu.org/copyleft/lesser.html
|
|
|
552 .. _GTF: https://github.com/fubar2/toolfactory
|
|
|
553 .. _Paper: https://academic.oup.com/bioinformatics/article/28/23/3139/192853
|
|
|
554
|
|
|
555
|
|
|
556 </help>
|
|
|
557 <citations>
|
|
|
558 <citation type="doi">10.1093/bioinformatics/bts573</citation>
|
|
|
559 </citations>
|
|
|
560 </tool>
|
|
|
561
|
|
|
562
|
