The Python package of Tenzir provides a flexible control plane to integrate Tenzir with other security tools.

Note The Python effort is still highly experimental and subject to rapid change. Please do not consider it for production use.

To get started, clone the Tenzir repository and install the Python package via Poetry:

git clone https://github.com/tenzir/tenzir.git
cd tenzir/python
poetry install -E module

We recommend that you work with an editable installation, which is the default for poetry install.

Run the unit tests via pytest:

poetry run pytest

Run the integrations tests via Docker Compose and pytest:

./docker-poetry-run.sh pytest -v

The following instructions concern maintainers who want to publish the Python package to PyPI.

Note Our releasing scripts and CI run these steps automatically. You do not need to intervene anywhere. The instructions below merely document the steps taken.

Prior to releasing a new version, bump the version, e.g.:

poetry version 2.3.1

This updates the pyproject.toml file.

1. Add a Test PyPi repository:

   poetry config repositories.test-pypi https://test.pypi.org/legacy/

2. Get the token from https://test.pypi.org/manage/account/token/.

3. Store the token:

poetry config pypi-token.test-pypi pypi-XXXXXXXX

4. Publish:

   poetry publish --build -r test-pypi

1. Get the token from https://pypi.org/manage/account/token/.

2. Store the token:

poetry config pypi-token.pypi pypi-XXXXXXXX

3. Publish

   poetry publish --build