Skip to main content

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.

  1. Fork the BioConda recipes repo
  2. 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.
  3. Post a pull request to BioConda, with 'Update nbitk' in the title
  4. Address any problems detected by BioConda's CI tools
  5. If all is fine, tag the PR thread for review by a human, and wait
  6. Once a human shows up, address their feedback (be nice: they're volunteers!)
  7. 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)

Source distribution for nbitk 0.7.4
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)

Table of built distributions (wheels) for nbitk 0.7.4
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.7.4 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page