feat: uv (#305)

Author: joshuarli

.envrc

@@ -4,13 +4,13 @@ if [[ -f .env ]]; then
     dotenv .env
 fi
 
+PATH_add "$PWD/.venv/bin"
+export VIRTUAL_ENV="$PWD/.venv"
+
 if [ ! -d .venv ]; then
-    echo "warning: creating virtualenv for the first time"
-    python3 -m venv .venv
-    source .venv/bin/activate
-    pip install -r requirements.txt
-    pip install -r requirements-dev.txt
-else
-    source .venv/bin/activate
-    unset PS1
+    uv sync
+fi
+
+if [[ ! -f .git/hooks/pre-commit ]] || ! grep -q pre-commit .git/hooks/pre-commit 2>/dev/null; then
+    pre-commit install --install-hooks
 fi

.github/workflows/build.yml

@@ -9,20 +9,15 @@ on:
 jobs:
   dist:
     name: Create Distribution
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     timeout-minutes: 10
     steps:
       - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
 
-      - uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
-        with:
-          python-version: 3.12
-
-      - name: Install dev requirements
-        run: pip install -r requirements-dev.txt
+      - uses: astral-sh/setup-uv@e06108dd0aef18192324c70427afc47652e63a82 # v7.5.0
 
       - name: "Prepare Artifacts"
-        run: python -m build
+        run: uv build
 
       - name: Cache dist
         uses: actions/cache@1bd1e32a3bdc45362d1e726936510720a7c30a57 # v4.2.0
@@ -35,31 +30,27 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [ubuntu-22.04, macos-14]
+        os: [ubuntu-24.04, macos-15]
         include:
-          - os: ubuntu-22.04
+          - os: ubuntu-24.04
             asset_name: devservices-linux
-          - os: macos-14
+          - os: macos-15
             asset_name: devservices-darwin
 
     steps:
       - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
 
-      - uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
-        with:
-          python-version: 3.12
-
-      - name: Install pyoxidizer
-        run: pip install pyoxidizer==0.24.0
-
-      - name: Install dev requirements
-        run: pip install -r requirements-dev.txt
+      - uses: astral-sh/setup-uv@e06108dd0aef18192324c70427afc47652e63a82 # v7.5.0
 
       - name: Generate metadata
-        run: python -m build --sdist --no-isolation
+        run: |
+          uv sync
+          uv pip install pyoxidizer==0.24.0
+          uv export --no-dev --no-hashes --no-emit-project -o requirements.txt
+          uv run python -m build --sdist --no-isolation
 
       - name: Build binary
-        run: pyoxidizer build --release
+        run: uv run pyoxidizer build --release
 
       - name: Locate binary
         id: locate_binary
@@ -78,7 +69,7 @@ jobs:
 
   upload-artifacts:
     name: Upload build artifacts
-    runs-on: ubuntu-22.04
+    runs-on: ubuntu-24.04
     needs: [dist, binary]
     if: github.event_name != 'pull_request'
     steps:

.github/workflows/lint.yml

@@ -16,9 +16,9 @@ jobs:
     steps:
       - name: Checkout repo
         uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
-      - name: Set up Python
-        uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
-        with:
-          python-version: 3.12
+      - name: Set up uv
+        uses: astral-sh/setup-uv@e06108dd0aef18192324c70427afc47652e63a82 # v7.5.0
+      - name: Install dependencies
+        run: uv sync
       - name: Pre-commit
-        uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
+        run: uv run pre-commit run --all-files

.github/workflows/test.yml

@@ -16,26 +16,20 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-          python-version: ["3.11", "3.12"]
+          python-version: ["3.11.14", "3.12.13"]
     steps:
       - name: Configure git
         run: |
           git config --global user.email "test@example.com"
           git config --global user.name "test"
       - name: Checkout repo
         uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
-      - name: Set up Python
-        uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
-        with:
-          python-version: ${{ matrix.python-version }}
+      - name: Set up uv
+        uses: astral-sh/setup-uv@e06108dd0aef18192324c70427afc47652e63a82 # v7.5.0
       - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r requirements.txt
-          pip install -r requirements-dev.txt
-          pip install -e .
+        run: uv sync --python ${{ matrix.python-version }}
       - name: Run tests
-        run: pytest --cov --junitxml=junit.xml -o junit_family=legacy
+        run: uv run pytest --cov --junitxml=junit.xml -o junit_family=legacy
       - name: Upload results to Codecov
         uses: codecov/codecov-action@e28ff129e5465c2c0dcc6f003fc735cb6ae0c673 # v4.5.0
         with:

.pre-commit-config.yaml

@@ -1,33 +1,27 @@
 repos:
-  - repo: https://github.com/asottile/reorder-python-imports
-    rev: v3.12.0
-    hooks:
-      - id: reorder-python-imports
-        args: [--py311-plus, --add-import, "from __future__ import annotations"]
-  - repo: https://github.com/psf/black
-    rev: 23.10.0
-    hooks:
-      - id: black
-        language_version: python3.12
-  - repo: https://github.com/PyCQA/flake8
-    rev: 6.1.0
-    hooks:
-      - id: flake8
-        language_version: python3.12
-  - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.6.1
+  - repo: local
     hooks:
+      - id: ruff-check
+        name: ruff check
+        entry: .venv/bin/ruff check --fix
+        language: system
+        types: [python]
+      - id: ruff-format
+        name: ruff format
+        entry: .venv/bin/ruff format
+        language: system
+        types: [python]
       - id: mypy
-        additional_dependencies:
-          - "pytest"
-          - "types-PyYAML"
-        language_version: python3.12
-  - repo: https://github.com/shellcheck-py/shellcheck-py
-    rev: v0.9.0.6
-    hooks:
+        name: mypy
+        entry: .venv/bin/mypy
+        language: system
+        types: [python]
       - id: shellcheck
+        name: shellcheck
+        entry: .venv/bin/shellcheck
+        language: system
+        types: [shell]
         args: [--norc]
-        language_version: python3.12
   - repo: https://github.com/pre-commit/pre-commit-hooks
     rev: v4.6.0
     hooks:

.python-version

@@ -0,0 +1 @@
+3.12.13

README.md

@@ -167,3 +167,11 @@ networks:
     name: devservices
     external: true
 ```
+
+## Dev
+
+```sh
+uv sync
+direnv allow
+pytest
+```

devservices/__init__.py

@@ -1,4 +1,5 @@
 """
 DevServices CLI tool for managing Docker Compose services.
 """
+
 from __future__ import annotations

devservices/commands/down.py

@@ -3,19 +3,19 @@
 import concurrent.futures
 import os
 import subprocess
-from argparse import _SubParsersAction
 from argparse import ArgumentParser
 from argparse import Namespace
+from argparse import _SubParsersAction
 
 from sentry_sdk import capture_exception
 from sentry_sdk import logger as sentry_logger
 
 from devservices.constants import CONFIG_FILE_NAME
 from devservices.constants import DEPENDENCY_CONFIG_VERSION
-from devservices.constants import DependencyType
 from devservices.constants import DEVSERVICES_DEPENDENCIES_CACHE_DIR
 from devservices.constants import DEVSERVICES_DEPENDENCIES_CACHE_DIR_KEY
 from devservices.constants import DEVSERVICES_DIR_NAME
+from devservices.constants import DependencyType
 from devservices.exceptions import ConfigError
 from devservices.exceptions import ConfigNotFoundError
 from devservices.exceptions import DependencyError
@@ -25,17 +25,17 @@
 from devservices.exceptions import SupervisorError
 from devservices.utils.console import Console
 from devservices.utils.console import Status
-from devservices.utils.dependencies import construct_dependency_graph
 from devservices.utils.dependencies import DependencyNode
+from devservices.utils.dependencies import InstalledRemoteDependency
+from devservices.utils.dependencies import construct_dependency_graph
 from devservices.utils.dependencies import get_non_shared_remote_dependencies
 from devservices.utils.dependencies import install_and_verify_dependencies
-from devservices.utils.dependencies import InstalledRemoteDependency
 from devservices.utils.docker_compose import DockerComposeCommand
 from devservices.utils.docker_compose import get_docker_compose_commands_to_run
 from devservices.utils.docker_compose import run_cmd
+from devservices.utils.services import Service
 from devservices.utils.services import find_matching_service
 from devservices.utils.services import get_active_service_names
-from devservices.utils.services import Service
 from devservices.utils.state import ServiceRuntime
 from devservices.utils.state import State
 from devservices.utils.state import StateTables
@@ -231,9 +231,9 @@ def bring_down_service(
 
     # Set the environment variable for the local dependencies directory to be used by docker compose
     current_env = os.environ.copy()
-    current_env[
-        DEVSERVICES_DEPENDENCIES_CACHE_DIR_KEY
-    ] = relative_local_dependency_directory
+    current_env[DEVSERVICES_DEPENDENCIES_CACHE_DIR_KEY] = (
+        relative_local_dependency_directory
+    )
     state = State()
 
     # We want to ignore any dependencies that are set to run locally if we are excluding local dependencies

devservices/commands/foreground.py

@@ -3,15 +3,15 @@
 import os
 import pty
 import shlex
-from argparse import _SubParsersAction
 from argparse import ArgumentParser
 from argparse import Namespace
+from argparse import _SubParsersAction
 
 from sentry_sdk import capture_exception
 
 from devservices.constants import CONFIG_FILE_NAME
-from devservices.constants import DependencyType
 from devservices.constants import DEVSERVICES_DIR_NAME
+from devservices.constants import DependencyType
 from devservices.exceptions import ConfigError
 from devservices.exceptions import ConfigNotFoundError
 from devservices.exceptions import ServiceNotFoundError