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.
Metadata
Release files for nbitk 0.7.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| nbitk-0.7.4.tar.gz | 22.9 MB | Without provenance | Details for nbitk-0.7.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| nbitk-0.7.4-py3-none-any.whl | Python 3 | none | any | Details for nbitk-0.7.4-py3-none-any.whl |
Total release size: 46.2 MB
Release files / nbitk-0.7.4.tar.gz
| Download URL | nbitk-0.7.4.tar.gz |
|---|---|
| Size | 22.9 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1afcec3bc0506db5d10367208d0a723d92030c130639b4e102bfe915d642d09a
|
|
BLAKE2b-256 checksum How to use checksums |
844d16802b62bb926a358f50c335bc632c8103864563c449ad496fb805e58fb0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / nbitk-0.7.4-py3-none-any.whl
| Download URL | nbitk-0.7.4-py3-none-any.whl |
|---|---|
| Size | 23.4 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
18590cc1a228f49361092acf8d17bc2b643ad8d3ec4338be6fda6826c5ca9b21
|
|
BLAKE2b-256 checksum How to use checksums |
76b1125ef0945f8ee1c81e750a434aa9dcd888856dcfab5eceb4cba8034a2554
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Security for nbitk 0.7.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.