VSCode Dev Container: Python Development with Rye, uv, and Ruff

Overview

This repository contains configurations to set up a Python development environment using VSCode's Dev Container feature. The environment includes Rye, uv, and Ruff.

If the Ruff format does not work, try reloading the VS Code window. Specifically, you can solve this problem by following the steps below.

1. Type ⌘+⇧+P to open the command palette
2. Type Developer: Reload Window in the command palette to reload the window

Contents

• VSCode Dev Container: Python Development with Rye, uv, and Ruff
  • Overview
    • Contents
  • Branches
  • Dev Container
  • GitHub Actions
  • Ruff
  • pre-commit
  • Appendix
    • Install libraries
    • The structure of this repository

Branches

• main
• jupyter

Dev Container

• devcontainer.json
  • settings
    • formatOnSave by Ruff
  • features
    • pre-commit
  • extentions
    • charliermarsh.ruff
    • codezombiech.gitignore
    • eamodio.gitlens
    • kevinrose.vsc-python-indent
    • mosapride.zenkaku
    • ms-azuretools.vscode-docker
    • ms-python.python
    • njpwerner.autodocstring
    • oderwat.indent-rainbow
    • pkief.material-icon-theme
    • shardulm94.trailing-spaces
    • usernamehw.errorlens
    • yzhang.markdown-all-in-one
• Dockerfile
  • Rye
    • rye config --set-bool behavior.global-python=true
    • rye config --set-bool behavior.use-uv=true
  • Only Dev dependencies
    • pre-commit
    • pytest
    • ruff

GitHub Actions

• docker.yml
  • Workflow to check if you can build with Docker
• test.yml
  • Workflow to check if all the described tests can be passed with pytest
• ruff.yml
  • Workflow to check if you can go through Formatter and Linter with Ruff

Ruff

Ruff can be used to replace Flake8, Black, isort, pydocstyle, pyupgrade, autoflake, etc., and yet run tens to hundreds of times faster than the individual tools.

To change the configuration, it is necessary to rewrite ruff.toml, and it is recommended to set it to ignore conflicts such as the following:

ignore = [
    "COM812", "COM819",
    "D100", "D203", "D213", "D300",
    "E111", "E114", "E117",
    "ISC001", "ISC002",
    "Q000", "Q001", "Q002", "Q003",
    "W191",
]

pre-commit

The .pre-commit-config.yaml file can contain scripts to be executed before commit.

# Python Formatter
rye run ruff format .

# Python Linter
rye run ruff check . --fix

# Docker Linter
hodolint Dockerfile

Appendix

Install libraries

Only sync based on the production lockfile (requirements.lock) instead of the development lockfile (requirements-dev.lock).

# Install also include develop dependencies
rye sync

# If you do not want dev dependencies to be installed
rye sync --no-dev

# Use the add command to add dependencies to your project
rye add {libraries}

The structure of this repository

.
├── .devcontainer
│   ├── devcontainer.json
│   └── Dockerfile
├── Dockerfile
├── .github
│   ├── actions
│   │   └── setup-python-with-rye
│   │       └── action.yml
│   ├── dependabot.yml
│   └── workflows
│       ├── docker.yml
│       ├── ruff.yml
│       └── test.yml
├── .gitignore
├── LICENSE
├── .pre-commit-config.yaml
├── pyproject.toml
├── .python-version
├── README.md
├── requirements-dev.lock
├── requirements.lock
├── ruff.toml
└── .vscode
    ├── extensions.json
    └── settings.json