kylemmkay/py-runner repository overview

⁠py-runner

A minimal, extensible Python 3.11 (Slim Bullseye) base image with common CLI tools, designed for use as a pre-built environment in my Forgejo Actions pipelines.

⁠Features

• Base Image: python:3.11-slim-bullseye
• Pre-installed Tools:
  • Python 3.11, pip, venv, dev headers
  • curl, wget, jq, git, ripgrep, fzf, gnupg, unzip, sqlite3
  • build-essential, lsb-release, ca-certificates, software-properties-common
  • Docker CLI (docker-ce-cli)
  • pytest, coverage, wheel, setuptools (for Python testing)
  • Java JDK 21 (LTS)

⁠Intended Use

• As a base image for CI/CD pipelines and development containers
• For projects needing Python 3.11 and common CLI tools
• Supports source-based Python testing out of the box

⁠Usage

⁠Build the Image

docker build -t py-runner:dev .

⁠Run with an Interactive Terminal

docker run --rm -it py-runner:dev bash

⁠Bind Mount a Host Directory

docker run --rm -it -v "$(pwd):/workspace" py-runner:dev bash

⁠Use Docker CLI Inside the Container

To access the host Docker daemon:

docker run --rm -it \
  -v "$(pwd):/workspace" \
  -v "/var/run/docker.sock:/var/run/docker.sock" \
  py-runner:dev bash