annotate README.md @ 10:db0138e42c19 draft

planemo upload commit be50878b7e90467860bbe85aac55ea8e3507d1e5
author tduigou
date Thu, 20 Apr 2023 08:14:22 +0000
parents c31a74a5595c
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
7
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
1 # RetroPath2-wrapper -- Build a reaction network from a set of source compounds to a set of sink compounds.
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
2
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
3 The open-source software package RetroPath2-wrapper is available here : https://github.com/brsynth/RetroPath2-wrapper
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
4
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
5 ## How to run RetroPath2 wrapper tests
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
6
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
7 In order to execute tests on RetroPath2 wrapper, you need to:
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
8
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
9 - Connect to your galaxy instance in interactive mode:
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
10
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
11 ```bash
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
12 docker exec -it -u root galaxy_galaxy_1 bash
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
13 ```
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
14 - Copy all the contents of `test-data` folder into your own test-data directory which is located in your local galaxy instance : `/galaxy/test-data`. It contains all the input files and expected output files needed for the tests.
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
15
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
16 - Install Planemo:
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
17 You can see here the documentation for Planemo Installation : https://planemo.readthedocs.io/en/latest/installation.html
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
18 Note that they recommand to install Planemo by setting up a virtual environment:
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
19
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
20 ```bash
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
21 python3 -m venv planemo
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
22 . planemo/bin/activate
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
23 pip install -U planemo
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
24 ```
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
25
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
26 - run the tests:
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
27
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
28 ```bash
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
29 planemo test --conda_channels conda-forge,brsynth --conda_debug tools/BRSynthTools/RetroPath2-wrapper/wrap.xml
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
30 ```
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
31
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
32 IMPORTANT: Maybe you will need to remove CONDA from your PATH for the command `planemo test` to run correctly. To do that, you can edit this file `~/.bashrc`, comment this line `PATH="/root/anaconda3/bin:$PATH"` and save changes.
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
33
c31a74a5595c planemo upload commit 7b62e9fb3271d06909bfad1918fcffc9255562cd
tduigou
parents:
diff changeset
34 Planemo will output an html test summary `tool_test_output.html`.