jeffersonlab/python-devcontainer repository overview

⁠python-devcontainer

A Python devcontainer⁠.

⁠Overview

The 1.x version series uses the following:

• Python 3.10.x
• Ubuntu "jammy"
• Docker outside of Docker⁠ (sibling container). Use a bind mount of the form /var/run/docker.sock:/var/run/docker.sock. We don't use Docker in Docker⁠, because it appears to be the less good option⁠.

⁠Quick Start with Compose

1. Grab project

git clone https://github.com/JeffersonLab/python-devcontainer
cd python-devcontainer

1. Launch Compose⁠

docker compose up

⁠Install

Add a .devcontainer⁠ directory to your project and launch it with Compose or your favorite devcontainer launcher (GitHub Codespaces⁠, JetBrains Gateway⁠, VSCode devcontainer extension⁠).

⁠Build / Release

Make changes to the Dockerfile, test them, then bump the version in the VERSION file and commit it. The CD GitHub Action should take care of the rest.

⁠See Also

• Python workflows⁠
• Other devcontainers⁠