diff README.md @ 0:bbdc3fdf5298 draft default tip

"planemo upload commit 79f62a93f1c45ae643ce01ff3dcf9662c304c11b-dirty"
author gene
date Mon, 04 Oct 2021 09:54:45 +0000
parents
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README.md	Mon Oct 04 09:54:45 2021 +0000
@@ -0,0 +1,40 @@
+# raptor-galaxy
+
+This readme explains how to add a tool to bioconda and galaxy (by using planemo).
+
+## Bioconda
+Bioconda has so called recipes for every available tool which are saved in their git repo https://github.com/bioconda/bioconda-recipes .
+To get your tool into bioconda you have to create a PR with a recipe for your tool.
+You can use the recipe of raptor as a template: https://github.com/bioconda/bioconda-recipes/tree/master/recipes/raptor
+
+## Install and setup of planemo
+The next 3 steps will install planemo into the directory `.venv-planemo`.
+```
+$ virtualenv .venv-planemo; source .venv-planemo/bin/activate
+$ pip install "pip>=7"
+$ pip install planemo
+```
+Each time you open a new console and want to use planemo, it is needed to activate the planemo environment:
+```
+$ source .venv-planemo/bin/activate
+```
+For more information on how to install planemo checkout the project https://github.com/galaxyproject/planemo .
+
+
+## Account on the toolshed
+There exists the normal toolshed at https://toolshed.g2.bx.psu.edu/ and the test toolshed at https://testtoolshed.g2.bx.psu.edu/.
+The steps for both are the same. We will show here how to use the testtoolshed.
+- create an account on https://testtoolshed.g2.bx.psu.edu
+- run `$ planemo config_init` to create a planemo config
+- insert shed_username and api key into ~/.planemo.yml
+
+## Creating a new description for a tool
+Lets assume you want to add a new subcommand to raptor called `newsubcommand`.
+- copy raptor-build.xml to raptor-newsubcommand.xml
+- adjust the xml file to own needs
+- run `$ planemo test raptor-newsubcommand.xml` to check tests
+- run `$ planemo lint raptor-newsubcommand.xml` to lint
+
+## Publishing your tool
+Make sure to bump the version number of the tool for every new release (see xml tag  <tool version="..."> ).
+- run `$ planemo shed_update --shed_target testtoolshed path/to/this/repo` to publish the tools of this repository