Mercurial > repos > peterjc > samtools_depad
annotate tools/samtools_depad/README.rst @ 3:588c6ce25867 draft default tip
v0.0.5 Python 3 compatible print function.
author | peterjc |
---|---|
date | Wed, 17 May 2017 09:15:32 -0400 |
parents | 02572789ef6c |
children |
rev | line source |
---|---|
0 | 1 Galaxy wrapper for samtools depad |
2 ================================= | |
3 | |
2 | 4 This wrapper is copyright 2014-2017 by Peter Cock, The James Hutton Institute |
0 | 5 (formerly SCRI, Scottish Crop Research Institute), UK. All rights reserved. |
6 See the licence text below. | |
7 | |
8 This is a wrapper for part of the command line samtools suite, v0.1.19 | |
9 | |
10 This wrapper is available from the Galaxy Tool Shed at: | |
2 | 11 http://toolshed.g2.bx.psu.edu/view/peterjc/samtools_depad |
0 | 12 |
13 | |
14 Automated Installation | |
15 ====================== | |
16 | |
17 This should be straightforward, Galaxy should automatically download and install | |
18 samtools 0.1.19 if required. | |
19 | |
20 | |
21 Manual Installation | |
22 =================== | |
23 | |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
24 This expects samtools to be on the ``$PATH``, and was tested using v0.1.19. |
0 | 25 |
26 To install the wrapper copy or move the following files under the Galaxy tools | |
27 folder, e.g. in a ``tools/samtools_depad`` folder: | |
28 | |
29 * ``samtools_depad.xml`` (the Galaxy tool definition) | |
30 * ``samtools_depad.py`` (the Python wrapper script) | |
31 * ``README.rst`` (this file) | |
32 | |
33 You will also need to modify the ``tools_conf.xml`` file to tell Galaxy to offer | |
34 the tool. Just add the line, perhaps under the NGS tools section:: | |
35 | |
36 <tool file="samtools_depad/samtools_depad.xml" /> | |
37 | |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
38 If you wish to run the unit tests, also move/copy the ``test-data/`` files |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
39 under Galaxy's ``test-data/`` folder. Then:: |
0 | 40 |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
41 $ ./run_tests.sh -id samtools_depad |
0 | 42 |
43 That's it. | |
44 | |
45 | |
46 History | |
47 ======= | |
48 | |
49 ======= ====================================================================== | |
50 Version Changes | |
51 ------- ---------------------------------------------------------------------- | |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
52 v0.0.1 - Initial public release. |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
53 v0.0.2 - Embed samtools citation in the tool XML. |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
54 - Removed unused imports from Python wrapper script. |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
55 v0.0.3 - Reorder XML elements (internal change only). |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
56 - Planemo for Tool Shed upload (``.shed.yml``, internal change only). |
2 | 57 v0.0.4 - Use ``<command detect_errors="aggressive">`` (internal change only). |
58 - Single quote command line arguments (internal change only). | |
3 | 59 v0.0.5 - Python 3 compatible print function. |
0 | 60 ======= ====================================================================== |
61 | |
62 | |
63 Developers | |
64 ========== | |
65 | |
66 Development is on this GitHub repository: | |
67 https://github.com/peterjc/pico_galaxy/tree/master/tools/samtools_depad | |
68 | |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
69 For pushing a release to the test or main "Galaxy Tool Shed", use the following |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
70 Planemo commands (which requires you have set your Tool Shed access details in |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
71 ``~/.planemo.yml`` and that you have access rights on the Tool Shed):: |
0 | 72 |
2 | 73 $ planemo shed_update -t testtoolshed --check_diff tools/samtools_depad/ |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
74 ... |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
75 |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
76 or:: |
0 | 77 |
2 | 78 $ planemo shed_update -t toolshed --check_diff tools/samtools_depad/ |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
79 ... |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
80 |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
81 To just build and check the tar ball, use:: |
0 | 82 |
2 | 83 $ planemo shed_upload --tar_only tools/samtools_depad/ |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
84 ... |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
85 $ tar -tzf shed_upload.tar.gz |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
86 test-data/sam_spec_padded.bam |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
87 test-data/sam_spec_padded.depad.bam |
0 | 88 test-data/sam_spec_padded.fasta |
89 test-data/sam_spec_padded.sam | |
1
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
90 tools/samtools_depad/README.rst |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
91 tools/samtools_depad/samtools_depad.py |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
92 tools/samtools_depad/samtools_depad.xml |
01f8967ce1e0
v0.0.3; internal changes to help packaging with planemo
peterjc
parents:
0
diff
changeset
|
93 tools/samtools_depad/tool_dependencies.xml |
0 | 94 |
95 | |
96 Licence (MIT) | |
97 ============= | |
98 | |
99 Permission is hereby granted, free of charge, to any person obtaining a copy | |
100 of this software and associated documentation files (the "Software"), to deal | |
101 in the Software without restriction, including without limitation the rights | |
102 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell | |
103 copies of the Software, and to permit persons to whom the Software is | |
104 furnished to do so, subject to the following conditions: | |
105 | |
106 The above copyright notice and this permission notice shall be included in | |
107 all copies or substantial portions of the Software. | |
108 | |
109 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | |
110 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | |
111 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE | |
112 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | |
113 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | |
114 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | |
115 THE SOFTWARE. | |
116 | |
117 NOTE: This is the licence for the Galaxy Wrapper only. | |
118 samtools is available and licenced separately. |