Skip to main content

PyPI release Downloads Coverage Linting Coding Style Documentation Status

Python toolbox of Beyonder Deutschland containing an abundance of useful tools and gadgets.

PyPIGitHubFull documentation

Creator & Maintainer: Beyonder Deutschland

Features

  • Useful classes and mixins for Django admin
  • Coverage script for GitLab
  • Extensions for DRF and GraphQL
  • Mailing backends for Django
  • Management commands for validating a projects test structure
  • Object ownership tracking with timestamping
  • Pattern for improved workflow with Django ORM
  • Helper and util functions for many different use-cases
  • Sentry plugins
  • django-scrubber wrapper class
  • Mixins and test classes for django (class-based) views

Migration from "ai_django_core"

This package was previously known as ai_django_core. Due to the misleading nature of the name, we chose to rename it with something more meaningful.

The migration is really simple, just:

  • Install ambient-toolbox and remove the dependency to ai-django-core
  • Search and replace all usages of from ai_django_core... to from ambient_toolbox...
  • The class-based mail functionality was moved to a separate package called django-pony-express.

Installation

  • Install the package via pip:

    pip install ambient-toolbox

    or via uv:

    uv add ambient-toolbox

  • Add module to INSTALLED_APPS within the main django settings.py:

INSTALLED_APPS = (
    # ...
    "ambient_toolbox",
)
  • Apply migrations by running:

    python ./manage.py migrate

Releasing a new version

Releases are fully automated. Push a version tag and the pipeline will build, sign with Sigstore, publish to PyPI via Trusted Publishing, and create a GitHub Release — no API tokens needed.

git tag v<version>          # e.g. git tag v1.2.3
git push origin v<version>

Tags must start with v. Tags without the prefix won't trigger the pipeline.

First-time setup

Before the pipeline can run for the first time, an admin must:

  1. Create GitHub Environment pypi

    • Go to Settings → Environments → New environment, name it exactly pypi
    • Under Deployment branches and tags, add a tag rule with pattern v*
    • Optionally add required reviewers for a manual approval gate
  2. Configure PyPI Trusted Publisher

    • Go to PyPI → Project settings → Publishing → Add a new publisher
    • Fill in: Owner ambient-innovation, Repository ambient-toolbox, Workflow release.yml, Environment pypi

Publish to ReadTheDocs.io

  • Fetch the latest changes in GitHub mirror and push them
  • Trigger new build at ReadTheDocs.io (follow instructions in admin panel at RTD) if the GitHub webhook is not yet set up.

Maintenance

Please note that this package supports the ambient-package-update. So you don't have to worry about the maintenance of this package. This updater is rendering all important configuration and setup files. It works similar to well-known updaters like pyupgrade or django-upgrade.

To run an update, refer to the documentation page of the "ambient-package-update".

Download files

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

Source Distribution

ambient_toolbox-12.11.1.tar.gz (278.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ambient_toolbox-12.11.1-py3-none-any.whl (90.9 kB view details)

Uploaded Python 3

File details

Details for the file ambient_toolbox-12.11.1.tar.gz.

File metadata

  • Download URL: ambient_toolbox-12.11.1.tar.gz
  • Upload date:
  • Size: 278.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for ambient_toolbox-12.11.1.tar.gz
Algorithm Hash digest
SHA256 f20dc362566a068da9f413b6baf30ec3a26ae30b0d00fd84c06da638c5326cc7
MD5 34154688bad0ea478a1942fb3fd1b404
BLAKE2b-256 92587afb0146e13322f2f120fa92df7d1087aa83da9134230b29da633203a9c6

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambient_toolbox-12.11.1.tar.gz:

Publisher: release.yml on ambient-innovation/ambient-toolbox

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

File details

Details for the file ambient_toolbox-12.11.1-py3-none-any.whl.

File metadata

File hashes

Hashes for ambient_toolbox-12.11.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a2b93d5e0694649d162ba6c8f629f5f057b7021c65a25ddd883c79d4165a164d
MD5 6e4de6facaa3aef2e396c6ecf30b08a3
BLAKE2b-256 0296809adc02838c9e945742947f5ac42bfcfffe770d5329856656b5add5549b

See more details on using hashes here.

Provenance

The following attestation bundles were made for ambient_toolbox-12.11.1-py3-none-any.whl:

Publisher: release.yml on ambient-innovation/ambient-toolbox

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

Release history Release notifications | RSS feed

Supported by

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