Skip to content

VSCode python dev environment using uv and ruff

uv is a fast Python package manager

install

1
curl -Ls https://astral.sh/uv/install.sh | sh

basic usage

Create project with venv automatically

1
uv init

Add dependency

1
uv add numpy

add dev dependency

1
uv add --dev pytest

Run script inside project env

1
uv run python app.py

no need to activate venv manually

Install from lock file

Reproducible install.

1
uv sync

Lock file

A lock file freezes the exact versions of all dependencies — including transitive dependencies.

It guarantees:

“Everyone installs exactly the same environment.”

File Purpose
pyproject.toml What you WANT
uv.lock What you ACTUALLY GET

install exactly locked versions

1
uv sync

Transitive Dependencies

for example install uv add fastapi it install many depend packages

Lock file records ALL of them

VSCode

Extensions

  • ruff: Python linter and formatter .

Settings

VSCode python autocomplete

1
2
3
"python.analysis.extraPaths": [
    "${workspaceFolder}/src"
]

ruff

disabled python ext linting
1
"python.linting.enabled": false,

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
"ruff.importStrategy": "fromEnvironment",
"editor.defaultFormatter": "charliermarsh.ruff",
"editor.formatOnPaste": true,
"editor.formatOnSave": true,
"editor.formatOnSaveMode": "file",
"editor.codeActionsOnSave": {
    "source.organizeImports": "always",
    "source.fixAll": "always"
},
"python.linting.enabled": false,

type checking

1
"python.analysis.typeCheckingMode": "strict"

ruff settings

ruff.toml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
line-length = 88
indent-width = 4

[format]
quote-style = "double"
indent-style = "space"
skip-magic-trailing-comma = false
line-ending = "auto"
docstring-code-format = true
docstring-code-line-length = "dynamic"

vscode settings.json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
{
    // -----------------------------
    // 🧹 Formatting (Ruff)
    // -----------------------------
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.formatOnSave": true,
    "editor.formatOnPaste": true,
    "editor.formatOnSaveMode": "file",

    "editor.codeActionsOnSave": {
        "source.organizeImports": "always",
        "source.fixAll": "always"
    },

    "ruff.importStrategy": "fromEnvironment",
    "ruff.lint.enable": true,
    "ruff.format.enable": true,

    // -----------------------------
    // 🧠 Type Checking (Pyright)
    // -----------------------------
    "python.analysis.typeCheckingMode": "strict",
    "python.analysis.autoImportCompletions": true,
    "python.analysis.inlayHints.variableTypes": true,
    "python.analysis.inlayHints.functionReturnTypes": true,

    // -----------------------------
    // 🐍 Python Behavior
    // -----------------------------
    "python.linting.enabled": false,
    "python.testing.pytestEnabled": true,
    "python.testing.unittestEnabled": false,

    // -----------------------------
    // 🔍 Editor Quality of Life
    // -----------------------------
    "files.trimTrailingWhitespace": true,
    "files.insertFinalNewline": true,
    "editor.rulers": [100],
    "editor.minimap.enabled": false,
    "editor.renderWhitespace": "boundary",

    // -----------------------------
    // 🧪 Optional: pytest auto-discovery
    // -----------------------------
    "python.testing.pytestArgs": [
        "tests"
    ]
}

pre-commit

pre-commit runs checks automatically before git commit.

If checks fail → commit is blocked.

It prevents:

  • Broken formatting
  • Unused imports
  • Simple lint errors
  • Bad whitespace
  • Committing junk

install

1
uv add --dev pre-commit

config

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
repos:
  - repo: https://github.com/astral-sh/ruff-pre-commit
    rev: v0.4.7   # use latest
    hooks:
      - id: ruff
        args: ["--fix"]
      - id: ruff-format

  - repo: https://github.com/pre-commit/pre-commit-hooks
    rev: v4.6.0
    hooks:
      - id: trailing-whitespace
      - id: end-of-file-fixer
      - id: check-yaml
      - id: check-toml

Activate and usage

1
uv run pre-commit install

Now it run the pre-commit script every git commit

Run manually

1
uv run pre-commit run --all-files