Pontos - Greenbone Python Utilities and Tools
The pontos Python package is a collection of utilities, tools, classes and functions maintained by Greenbone.
Pontos is the German name of the Greek titan Pontus, the titan of the sea.
Table of Contents
Documentation
The documentation for pontos can be found at https://greenbone.github.io/pontos/. Please refer to the documentation for more details as this README just gives a short overview.
Installation
Requirements
Python 3.10 and later is supported.
Install using pipx
You can install the latest stable release of pontos from the Python Package Index (pypi) using pipx
python3 -m pipx install pontos
Install using pip
[!NOTE] The
pip installcommand does no longer work out-of-the-box in newer distributions like Ubuntu 23.04 because of PEP 668. Please use the installation via pipx instead.
You can install the latest stable release of pontos from the Python Package Index (pypi) using pip
python3 -m pip install --user pontos
Install using poetry
Because pontos is a Python library you most likely need a tool to handle Python package dependencies and Python environments. Therefore we strongly recommend using poetry.
You can install the latest stable release of pontos and add it as a dependency for your current project using poetry
poetry add pontos
Command Completion
pontos comes with support for command line completion in bash and zsh. All
pontos CLI commands support shell completion. As examples the following sections
explain how to set up the completion for pontos-release with bash and zsh.
Setup for bash
echo "source ~/.pontos-release-complete.bash" >> ~/.bashrc
pontos-release --print-completion bash > ~/.pontos-release-complete.bash
Alternatively, you can use the result of the completion command directly with the eval function of your bash shell:
eval "$(pontos-release --print-completion bash)"
Setup for zsh
echo 'fpath=("$HOME/.zsh.d" $fpath)' >> ~/.zsh
mkdir -p ~/.zsh.d/
pontos-release --print-completion zsh > ~/.zsh.d/_pontos_release
Alternatively, you can use the result of the completion command directly with the eval function of your zsh shell:
eval "$(pontos-release --print-completion zsh)"
Development
pontos uses poetry for its own dependency management and build process.
First install poetry via pipx
python3 -m pipx install poetry
Afterwards run
poetry install
in the checkout directory of pontos (the directory containing the
pyproject.toml file) to install all dependencies including the packages only
required for development.
Afterwards activate the git hooks for auto-formatting and linting via autohooks.
poetry run autohooks activate
Validate the activated git hooks by running
poetry run autohooks check
Maintainer
This project is maintained by Greenbone AG
Contributing
Your contributions are highly appreciated. Please create a pull request on GitHub. Bigger changes need to be discussed with the development team via the issues section at GitHub first.
License
Copyright (C) 2020-2026 Greenbone AG
Licensed under the GNU General Public License v3.0 or later.
Release files for pontos 26.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| pontos-26.8.1.tar.gz | 474.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| pontos-26.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 727.9 kB
Release files / pontos-26.8.1.tar.gz
| Download URL | pontos-26.8.1.tar.gz |
|---|---|
| Size | 474.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f3db4de7183e8d56b5963179bc4a89828634d41660b7ef923ced88ed7a7b38a7
|
|
BLAKE2b-256 checksum How to use checksums |
0d0084ddb53de10118d42d91d75023336cccda9c4873df55d78933458c98f202
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency logRelease files / pontos-26.8.1-py3-none-any.whl
| Download URL | pontos-26.8.1-py3-none-any.whl |
|---|---|
| Size | 253.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
fe3129e5b3e474268172a01eb1d4b90b20a758ca20f958afc53c9bb0d7d9177b
|
|
BLAKE2b-256 checksum How to use checksums |
1338e01e88ebcfa0bb1a83ed9f7933463a01d0d5dd692e03345e6d81a69b1dc2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Aug 25, 2026.
Transparency log
