python-uv-devcontainer

Python project setup using a Devcontainer and uv.

Features

• 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

Setup

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 🎉

Extras

• 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.

About

Provided to you with ♡ by Jeroen Overschie.