diff cut.xml @ 0:631dfde45073 draft default tip

First tool-shed public version

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/cut.xml	Tue Oct 09 18:48:06 2012 -0400
@@ -0,0 +1,85 @@
+<tool id="cshl_cut_tool" name="cut" version="0.1.1">
+  <description>columns from files</description>
+  <command>
+	cut $complement $cutwhat '$list' '$input1' &gt; '$output'
+  </command>
+
+  <inputs>
+	<param format="txt" name="input1" type="data" label="file to cut" />
+
+	<param name="complement" type="select" label="Operation">
+	      <option value="">Keep</option>
+	      <option value="--complement">Discard</option>
+	</param>
+
+	<param name="cutwhat" type="select" label="Cut by">
+	      <option value="-f">fields</option>
+	      <option value="-c">characters</option>
+	      <option value="-b">bytes</option>
+	</param>
+
+	<param name="list" type="text" size="20" label="List of Fields/Characters/Bytes" help="These will be kept/discarded (depending on 'operation'). &lt;BR /&gt; Examples: 1,3,4 or 2-5" value = "">
+		<sanitizer>
+		    <valid initial="string.printable">
+			    <remove value="&apos;"/>
+		    </valid>
+	    </sanitizer>
+	</param>
+  </inputs>
+
+  <outputs>
+    <data format="input" name="output" metadata_source="input1"
+	/>
+  </outputs>
+  <help>
+
+**What it does**
+
+This tool runs the **cut** unix command, which extract or delete columns from a file.
+
+-----
+
+Field List Example:
+
+**1,3,7** - Cut specific fields/characters.
+
+**3-**    - Cut from the third field/character to the end of the line.
+
+**2-5**   - Cut from the second to the fifth field/character.
+
+**-8**    - Cut from the first to the eight field/characters.
+
+
+
+
+Input Example::
+
+    fruit	color	price	weight
+    apple	red	1.4	0.5
+    orange	orange	1.5	0.3
+    banana	yellow	0.9	0.3
+
+
+Output Example ( **Keeping fields 1,3,4** )::
+
+    fruit	price	weight
+    apple	1.4	0.5
+    orange	1.5	0.3
+    banana	0.9	0.3
+
+Output Example ( **Discarding field 2** )::
+
+    fruit	price	weight
+    apple	1.4	0.5
+    orange	1.5	0.3
+    banana	0.9	0.3
+
+Output Example ( **Keeping 3 characters** )::
+
+    fru
+    app
+    ora
+    ban
+
+  </help>
+</tool>