Common Workflow Language testing framework
Project description
This is a testing tool for checking the output of Tools and Workflows described with the Common Workflow Language. Among other uses, it is used to run the CWL conformance tests.
This is written and tested for Python 3.8, 3.9, 3.10, 3.11, 3.12, and 3.13.
Install
Installing the official package from PyPi
pip install cwltest
Or from bioconda
conda install -c bioconda cwltest
Or from source
git clone https://github.com/common-workflow-language/cwltest.git
cd cwltest && pip install .
Run on the command line
Simple command:
cwltest --test test-descriptions.yml --tool cwl-runner
Generate conformance badges using cwltest
To make badges that show the results of the conformance test, you can generate JSON files for https://badgen.net by using –badgedir option
To generate JSON files:
cwltest --test test-descriptions.yml --tool cwl-runner --badgedir badges ... $ cat badges/command_line_tool.json | jq . { "subject": "command_line_tool", "status": "100%", "color": "green" }
Once you upload JSON file to a server, you make a badge by using a link like https://badgen.net/https/path/to/generated/json or https://flat.badgen.net/https/path/to/generated/json (for flat badges).
Here is an example of markdown to add a badge:
![test result](https://flat.badgen.net/https/path/to/generated/json?icon=commonwl)
Custom file access module
If your CWL implementation does not write output files to a local file system location but instead to some other remote storage system, you can provide an alternate implementation of the StdFsAccess object that is able to access your storage system.
Step 1:
Implement your own class with the same public interface of the StdFsAccess object in cwltest/stdfsaccess.py (as of this writing, the methods are open, size, isfile and isdir). These methods should expect to be called with URIs from the location field of the outputs of test cases.
Define a function that, when called, returns a new instance of your object.
Step 2:
Create a Python package containing your class (or add it to an existing one).
In the package metadata, add an entry point that declares the module (in this example, my_cwl_runner.fsaccess) containing the function (in this example, get_fsaccess) that cwltest will invoke to get an object implementing the StdFsAccess interface.
In setup.py this looks like:
setup(
...
entry_points={"cwltest.fsaccess": ["fsaccess=my_cwl_runner.fsaccess:get_fsaccess"]}},
...
)
In pyproject.toml it looks like:
[project.entry-points.'cwltest.fsaccess']
fsaccess = 'my_cwl_runner.fsaccess:get_fsaccess'
Step 3:
Install your package in the same Python environemnt as the installation of cwltest. When invoked, cwltest will query Python package metadata for a package with the cwltest.fsaccess entry point and call it to get back a custom filesystem access object.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file cwltest-2.5.20241122133319.tar.gz
.
File metadata
- Download URL: cwltest-2.5.20241122133319.tar.gz
- Upload date:
- Size: 73.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 711a7f1e04fc12e7d7cae0802112b45092dde7f284a098a68dc0e8e7a34f00bf |
|
MD5 | 8b65bb7c87b3c61c9a60cf63999a9b96 |
|
BLAKE2b-256 | 5ade29cad6be90c4b086b9562ff09c96724a34799f3570bbac61c2b9e43326a5 |
File details
Details for the file cwltest-2.5.20241122133319-py3-none-any.whl
.
File metadata
- Download URL: cwltest-2.5.20241122133319-py3-none-any.whl
- Upload date:
- Size: 47.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.11.8
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | d4fc5d5f399045c1e74ca337f9dc6519e392118aa57e8b548e721f8446bac27f |
|
MD5 | bd05fea57eb7b0f0eeaf12ff6e31c86f |
|
BLAKE2b-256 | f0c4b0060787e86fda54b3a5029db75ea9cea4def275e9f964ec3ee4c79ce355 |