This tool automatically collects a table of all available Galaxy tools including their metadata. Therefore, various sources are parsed to collect the metadata, such as:
- github (parsing each tool wrapper)
- bio.tools
- bioconda
- Galaxy instances (availability, statistics)
The created table can be filtered to only show the tools relevant for a specific community.
Any Galaxy community can be added to this project and benefit from a dedicated interactive table that can be embedded into subdomains and website via an iframe. Learn how to add your community in the dedicated GTN toturial.
The interactive table benefits from EDAM annotations of the tools, this requires, that the tools are annotation via bio.tools. Learn how to improve metadata for Galaxy tools using the bio.tools registry.
The tool performs the following steps:
- Parse tool GitHub repository from Planemo monitor listed
- Check in each repo, their
.shed.yaml
file and filter for categories, such as metagenomics - Extract metadata from the
.shed.yaml
- Extract the requirements in the macros or xml to get version supported in Galaxy
- Check available against conda version
- Extract bio.tools information if available in the macros or xml
- Check available on the 3 main galaxy instances (usegalaxy.eu, usegalaxy.org, usegalaxy.org.au)
- Get usage statistics form usegalaxy.eu
- Creates an interactive table for all tools: All tools
- Creates an interactive table for all registered communities, e.g. microGalaxy
-
Install virtualenv (if not already there)
$ python3 -m pip install --user virtualenv
-
Create virtual environment
$ python3 -m venv env
-
Activate virtual environment
$ source env/bin/activate
-
Install requirements
$ python3 -m pip install -r requirements.txt
-
Get an API key (personal token) for GitHub
-
Export the GitHub API key as an environment variable:
$ export GITHUB_API_KEY=<your GitHub API key>
-
Run the script
$ python bin/extract_all_tools.sh
The script will generate a TSV file with each tool found in the list of GitHub repositories and metadata for these tools:
- Galaxy wrapper id
- Description
- bio.tool id
- bio.tool name
- bio.tool description
- EDAM operation
- EDAM topic
- Status
- Source
- ToolShed categories
- ToolShed id
- Galaxy wrapper owner
- Galaxy wrapper source
- Galaxy wrapper version
- Conda id
- Conda version
-
Run the extraction as explained before
-
(Optional) Create a text file with ToolShed categories for which tools need to be extracted: 1 ToolShed category per row (example for microbial data analysis)
-
(Optional) Create a TSV (tabular) file with tool status (1 tool suite per row) as 3 columns:
- ToolShed ids of tool suites (one per line)
- Boolean with True to keep and False to exclude
- Boolean with True if deprecated and False if not
-
Run the tool extractor script
$ python bin/extract_galaxy_tools.py \ --tools <Path to JSON file with all extracted tools> \ --ts-filtered-tools <Path to output TSV with tools filtered based on ToolShed category> --filtered-tools <Path to output TSV with filtered tools based on ToolShed category and manual curation> \ [--categories <Path to ToolShed category file>] \ [--status <Path to a TSV file with tool status - 3 columns: ToolShed ids of tool suites, Boolean with True to keep and False to exclude, Boolean with True if deprecated and False if not>]
-
Get an API key (personal token) for Plausible
-
Export the Plausible API key as an environment variable:
$ export PLAUSIBLE_API_KEY=<your GitHub API key>
-
Run the script
$ python bin/extract_all_tutorials.sh
-
Run the extraction as explained before
-
Create a file named
tutorial_tags
in your communitydata
folder with the list of tutorial tags to keep -
Run the following command
$ python bin/extract_gtn_tutorials.py \ filtertutorials \ --all_tutorials "results/all_tutorials.json" \ --filtered_tutorials "results/<your community>/tutorials.tsv" \ --tags "data/communities/<your community>/tutorial_tags"
To make a test run of the tool to check its functionalities follow Usage to set-up the environnement and the API key, then run
bash ./bin/extract_all_tools_test.sh test.list
This runs the tool, but only parses the test repository Galaxy-Tool-Metadata-Extractor-Test-Wrapper