nbitk: Naturalis Biodiversity Informatics ToolKit
This project is intended as a foundational toolkit for biodiversity data research at Naturalis Biodiversity Center. The toolkit is written in Python and is designed to be easy to use and easy to extend.
Who is this for?
The principal users and developers of this toolkit are the bioinformaticians at Naturalis Biodiversity Center. In addition, developers and data engineers of Naturalis's BioCloud use some of the functionality to enact service calls for data validation. Lastly, researchers may find this toolkit useful for operating on biodiversity data, access remote services, and run command line tools via wrappers. Design changes and feature requests should therefore be discussed with the bioinformatics team.
Installation from PyPI
The toolkit and its python dependencies can be installed from PyPI. This results in a lightweight installation that has only the python stack but not any command line tools. This is typically what you need when running service clients. The install is as follows:
pip install nbitk
Installation from BioConda
In addition, there is a release on BioConda, that additionally includes any command line tools for which the toolkit contains wrappers. That release can also be installed directly, resulting in both the core python toolkit as well as command line tools (i.e. you do NOT have to do both pip and conda, just one or the other depending on whether you need to run command line tools, for which you would use the conda release). This is installed as follows:
conda install nbitk
NOTE: the environment.yml is here for the unit testing pipeline so that tool wrappers can be tested as well. Its only other use is to help prepare an updated release on BioConda. Otherwise there is no end-user function for it.
Preparing releases
PyPI
To release on PyPI, all that needs to happen is to tag a version, and then the release is pushed out automatically. Things to keep in mind:
- Ensure that the release is of sufficient quality (coding style, comments, pydoc, all tests pass)
- Use semantic versioning to tag the release
BioConda
To release on BioConda, an overview of the steps involved is as follows:
Note that this is typically not needed as BioConda automatically picks up new releases on PyPI.
- Fork the BioConda recipes repo
- Update the recipes/nbitk/meta.yml in your fork, specifically:
- Update the version number
- Update the run requirements to include everything from the pyproject.toml and environment.yml
- Update the SHA256 hash to match that version. The easiest way to obtain this is to go to https://pypi.org/project/nbitk/#files and click on 'view details' for the release.
- Post a pull request to BioConda, with 'Update nbitk' in the title
- Address any problems detected by BioConda's CI tools
- If all is fine, tag the PR thread for review by a human, and wait
- Once a human shows up, address their feedback (be nice: they're volunteers!)
- When the human is happy, they will merge the update into BioConda
Usage
The toolkit is meant for programmatic use. It is not intended to be used as a command line tool. Consult the
various modules and classes for documentation on how to use the toolkit. In addition, the scripts in the
tests directory provide examples of how to use the toolkit.
License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nbitk-0.7.4.tar.gz.
File metadata
- Download URL: nbitk-0.7.4.tar.gz
- Upload date:
- Size: 22.9 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1afcec3bc0506db5d10367208d0a723d92030c130639b4e102bfe915d642d09a
|
|
| MD5 |
15eb80e94206a8b4e4a63c11f4ea5a51
|
|
| BLAKE2b-256 |
844d16802b62bb926a358f50c335bc632c8103864563c449ad496fb805e58fb0
|
File details
Details for the file nbitk-0.7.4-py3-none-any.whl.
File metadata
- Download URL: nbitk-0.7.4-py3-none-any.whl
- Upload date:
- Size: 23.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
18590cc1a228f49361092acf8d17bc2b643ad8d3ec4338be6fda6826c5ca9b21
|
|
| MD5 |
58a9eac23a8640cbcb1700e161e70244
|
|
| BLAKE2b-256 |
76b1125ef0945f8ee1c81e750a434aa9dcd888856dcfab5eceb4cba8034a2554
|
