aviumlabs/python repository overview

⁠Avium Labs Python Docker Image

This is a Python Docker image based on the Python Alpine Linux docker image.

⁠Recent Updates

2026-09-07

• Updated stack:
  • Python 3.14.7

2026-07-01

• Updated stack:
  • Alpine Linux 3.24
  • PostgreSQL client 18.4

2026-06-14

• Updated stack:
  • Python 3.14.6

2026-05-16

• Updated stack:
  • Python 3.14.5

2026-04-17

• Updated stack:
  • Python 3.14.4
  • PostgreSQL client 18.3
  • Alpine Linux 3.23.4

⁠Build an Image

⁠Build Default - APP_NAME=app

export APP_NAME=app

Regular build

docker build --pull --no-cache -t aviumlabs/python:3.14-alpine .

Build with sbom and provenance

docker build --pull --no-cache -t aviumlabs/python:3.14-alpine --provenance=mode=max --sbom=true .

⁠Build Specified - APP_NAME=

export APP_NAME=myapp

Regular build

docker build --pull --no-cache -t aviumlabs/python:3.14-alpine --build-arg APP_NAME=$APP_NAME .

Build with sbom and provenance

docker build --pull --no-cache -t aviumlabs/python:3.14-alpine --build-arg APP_NAME=$APP_NAME --provenance=mode=max --sbom=true .

⁠Run

Run container in the foreground:

docker run --name $APP_NAME -it -e APP_NAME=$APP_NAME --rm -w "/opt/python/$APP_NAME" --mount type=bind,src="$(pwd)/src",target="/opt/python/$APP_NAME" --mount type=bind,src="$(pwd)/tests",target="/opt/python/tests" --mount type=bind,src="$(pwd)/dist",target="/opt/python/dist" aviumlabs/python:3.14-alpine

docker run --name $APP_NAME -it -e APP_NAME=$APP_NAME --rm -w "/opt/python/$APP_NAME" --mount type=bind,src="$(pwd)/src",target="/opt/python/$APP_NAME" --mount type=bind,src="$(pwd)/tests",target="/opt/python/tests" --mount type=bind,src="$(pwd)/dist",target="/opt/python/dist" aviumlabs/python:3.14-alpine

Open an additional container shell:

docker exec -it app /bin/ash

⁠Design

The src directory is bind mounted into the Docker container and the container provides the Python runtime environment.

There are two supporting scripts that provide aliases for running python commands in the docker container:

• .appdev - supports macOS and Linux
• .appdev.ps1 - supports Windows

The three aliases are:

• pip
• python
• pytest

If you need to run pip, python, or pytest in the container, source the alias file prior to running the command:

. ./.appdev

. .\.appdev.ps1

The included requirements.txt file installs the following python packages and their dependencies:

• build
• hatchling
• loguru
• pytest
• python-dateuitl

This file may be deleted and recreated with project specific requirements.

There are two methods for adding additional packages.

1. Directly editing requirements.txt.
2. Running pip install.

To install Python packages with pip:

• Source the included .appdev file in a shell session
• Run pip install
• Run pip freeze to export application requirements
• Continue with coding

. ./.appdev

pip install <package>

pip freeze > requirements.txt

The appdev PowerShell script has not been tested. Please file an issue if it does not work.

. .\.appdev.ps1

pip install <package>

pip freeze > requirements.txt

⁠Development Environment

Modify the pyproject.toml file to meet your requirements.

Recommendation is to not use spaces or special characters in the name and keep it short.

⁠Coding

All of the code for the application is in the src/ directory and it is stored on your computer's local filesystem and not in the docker container.

Use your favorite editor to write your application code.

⁠Build a Package

The environment has built in support for building a package. The dist directory is bind mounted into the container, and running build will create a python package in the dist directory on your local filesystem.

. ./.appdev

python -m build

⁠Pytest Integrated

The environment has integrated support for pytest. Create your test files in the tests directory and run pytest in the docker container.

. ./.appdev

Run standard pytest:

pytest 

Run pytest and print output:

pytest -s

To run specific test file with output:

pytest -s tests/test_<file_name>.py

⁠Interal

⁠Push Docker Image

docker push aviumlabs/python:3.14-alpine