Skip to main content

Common utilities and tools maintained by Greenbone Networks

Project description

Greenbone Logo

Pontos - Greenbone Python Utilities and Tools

GitHub releases PyPI release code test coverage Build and test

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.9 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 install command 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-2024 Greenbone AG

Licensed under the GNU General Public License v3.0 or later.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pontos-25.4.0.tar.gz (331.6 kB view details)

Uploaded Source

Built Distribution

pontos-25.4.0-py3-none-any.whl (248.7 kB view details)

Uploaded Python 3

File details

Details for the file pontos-25.4.0.tar.gz.

File metadata

  • Download URL: pontos-25.4.0.tar.gz
  • Upload date:
  • Size: 331.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pontos-25.4.0.tar.gz
Algorithm Hash digest
SHA256 04f19a044fba60c6a72116b463de1d8fba17e688763b52b2fce3b3a935515fef
MD5 2ac7f2818614759b23763c8688e72bce
BLAKE2b-256 379e65576998bf2abc18ff3d2635dc49e75ac4be6dd37e66cee1ed5969b88ee9

See more details on using hashes here.

Provenance

The following attestation bundles were made for pontos-25.4.0.tar.gz:

Publisher: deploy-pypi.yml on greenbone/pontos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pontos-25.4.0-py3-none-any.whl.

File metadata

  • Download URL: pontos-25.4.0-py3-none-any.whl
  • Upload date:
  • Size: 248.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for pontos-25.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3559c2066bd8c8dda1360cbe05b29af41ac2e949e684a0196f4ca040a192e912
MD5 0d347eccf8dfc3e92fad5fb09e68b74f
BLAKE2b-256 8ee2d1e6313b31de419fc6b3ab7261df280ecd9440da27dd8e2059456fcc9bca

See more details on using hashes here.

Provenance

The following attestation bundles were made for pontos-25.4.0-py3-none-any.whl:

Publisher: deploy-pypi.yml on greenbone/pontos

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page