Mercurial > repos > abaizan > kodoja
diff README.rst @ 0:18fe33eb7775 draft
Uploaded kodoja_search.py v0.0.3 wrapper.
https://github.com/abaizan/kodoja_galaxy/commit/55004d41a9c0750b2543f394594ee58cc4426609
author | peterjc |
---|---|
date | Wed, 14 Mar 2018 12:46:57 -0400 |
parents | |
children | 4554fcd4ef6d |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/README.rst Wed Mar 14 12:46:57 2018 -0400 @@ -0,0 +1,115 @@ +.. image:: https://travis-ci.org/abaizan/kodoja_galaxy.svg?branch=master + :alt: Linux testing with TravisCI + :target: https://travis-ci.org/abaizan/kodoja_galaxy/branches + +This is a Galaxy wrapper for the tool Kodoja, which is available to install in +conda from bioconda. + +https://github.com/abaizan/kodoja + +Galaxy wrappers for Kodoja +========================== + +These wrappers are copyright 2018 by Amanda Baizan Edge (University of +St Andrews, and The James Hutton Institute) and Peter Cock (The James +Hutton Institute). They are released under the MIT licence. + +These wrappers are available from the Galaxy Tool Shed at: +http://toolshed.g2.bx.psu.edu/view/abaizan/kodoja + +In-development test releases are available from the Test Tool Shed at: +http://testtoolshed.g2.bx.psu.edu/view/abaizan/kodoja + + +Citation +======== + +Please refer to the main Kodoja citation instructions. + + +Automated Installation +====================== + +Galaxy should be able to automatically install the dependencies, namely +``kodoja`` and its dependencies like ``kraken`` and ``kaiju``, using the +conda and the bioconda recipes. + +See the configuration notes below. + + +Configuration +============= + +You must tell Galaxy about any Kraken and Kaiju databases using configuration +files ``kraken_databases.loc`` and ``kaiju_databases.loc`` which are located +in the ``tool-data/`` folder. Sample files are included which explain the +tab-based format to use. + + +History +======= + +======= ====================================================================== +Version Changes +------- ---------------------------------------------------------------------- +v0.0.0 - Initial release covering ``kodoja_search.py`` v0.0.3. +======= ====================================================================== + + +Bug Reports +=========== + +File a Galaxy wrapper issue at https://github.com/abaizan/kodoja_galaxy/issues + +For issues with Kodoja itself, use https://github.com/abaizan/kodoja/issues + + +Developers +========== + +For pushing a release to the test or main "Galaxy Tool Shed", use the +following Planemo commands (which requires you have set your Tool Shed access +details in ``~/.planemo.yml`` and that you have access rights on the Tool +Shed):: + + $ planemo shed_update -t testtoolshed --check_diff . + ... + +or:: + + $ planemo shed_update -t toolshed --check_diff . + ... + +To just build and check the tar ball, use:: + + $ planemo shed_upload -t testtoolshed --tar_only . + ... + $ tar -tzf shed_upload.tar.gz + LICENSE + README.rst + ... + +This simplifies ensuring a consistent set of files is bundled each time, +including all the relevant test files. + + +Licence (MIT) +============= + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in +all copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN +THE SOFTWARE.