Python project setup using a Devcontainer and uv.

• Devcontainer running Python 3.13
• uv for dependency management and virtual environment management
• ruff for formatting and linting
• pytest for testing
• GitHub Actions for CI/CD
• Dockerfile for easy deployment

Getting started is easy. Follow these steps:

1. Use this template

   

   Create a new repository based on this template.

2. Clone repo

   

   Open the repo in VSCode.

3. Reopen in Container

   Click the button in the popup upon opening the repo:

   

   Alternatively, enter Ctrl+Shift+P and select Dev Containers: Reopen in Container.

4. Wait for setup to finish

   Upon opening the Devcontainer, setup will start. Wait for the setup to finish before continuing.

   

5. Select Python interpreter

   Enter Ctrl+Shift+P and select Python: Select Interpreter.

   

   Select the venv (./.venv/bin/python).

6. Enjoy 🫶

   You now have a fully configured Python development environment!

   

   with uv:

   

   and pytest:

   UI	Terminal

   ... and ruff:

   

   all readily available 🎉

• CI/CD with GitHub Actions

  A workflow is already set up for you.

  

  This workflow runs tests using pytest and formatting + linting using ruff. Dependencies are set up with uv.

• Dockerfile

  A Dockerfile is provided for easy deployment. This Dockerfile uses the same base image as the Devcontainer, so you can be sure it will work in production.

Provided to you with ♡ by Jeroen Overschie.