[tooling] Migrate to uv (#279)

# Exercise Review

## Exercise Discussion

Fixes #278 

## Checklist

- [ ] If you require a new remote repository on the `Git-Mastery`
organization, have you [created a
request](https://github.com/git-mastery/exercises/issues/new?template=request_exercise_repository.yaml)
for it?
- [ ] Have you written unit tests using
[`repo-smith`](https://github.com/git-mastery/repo-smith) to validate
the exercise grading scheme?
- [ ] Have you tested your changes using the instructions posted?
- [ ] Have you verified that this exercise does not already exist or is
not currently in review?
- [ ] Did you introduce a new grading mechanism that should belong to
[`git-autograder`](https://github.com/git-mastery/git-autograder)?
- [ ] Did you introduce a new dependency that should belong to
[`app`](https://github.com/git-mastery/app)?

Author: jovnc

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: "uv"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

.github/workflows/ci.yml

@@ -15,56 +15,54 @@ jobs:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Setup Python
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.13"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
 
       - name: Run validation script
         run: |
-          python scripts/validate-exercise-config.py
+          uv run python scripts/validate-exercise-config.py
 
   unit_tests:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-      - name: Setup Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.13"
+          enable-cache: true
       - name: Install dependencies
         run: |
-          pip install -r requirements.txt
+          uv sync --locked --group test
       - name: Set up Git
         run: |
           git config --global user.name "github-actions"
           git config --global user.email "github-actions@github.com"
           git config --global init.defaultBranch main
       - name: Run unit tests
         run: |
-          python -m pytest -s -vv
+          uv run pytest -s -vv
 
   mypy:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-      - name: Setup Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.13"
+          enable-cache: true
       - name: Install dependencies
         run: |
-          pip install -r requirements.txt
+          uv sync --locked --group dev --group test
       - name: Set up Git
         run: |
           git config --global user.name "github-actions"
           git config --global user.email "github-actions@github.com"
           git config --global init.defaultBranch main
       - name: Run mypy
         run: |
-          python -m mypy .
+          uv run mypy .
 
   format:
     runs-on: ubuntu-latest
@@ -75,17 +73,17 @@ jobs:
         with:
           ref: main
           fetch-depth: 0
-      - name: Setup Python
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
         with:
-          python-version: "3.13"
+          enable-cache: true
       - name: Install dependencies
         run: |
-          pip install -r requirements.txt
+          uv sync --locked --group dev
       - name: Run formatter using ruff
         run: |
-          ruff check --fix
-          ruff format
+          uv run ruff check --fix
+          uv run ruff format
       - name: Saving changes
         run: |
           git config --global user.name "github-actions"

.github/workflows/publish.yml

@@ -10,16 +10,14 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
 
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.11"
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
 
       - name: Generate exercise-directory.md
         run: |
-          python scripts/create-exercise-directory.py
+          uv run python scripts/create-exercise-directory.py
           mv exercise-directory.md index.md
 
       - name: Deploy to gh-pages

lefthook.yml

@@ -3,14 +3,14 @@ pre-commit:
   commands:
     ruff-lint:
       glob: "*.py"
-      run: ruff check --fix {staged_files}
+      run: uv run ruff check --fix {staged_files}
       stage_fixed: true
 
     ruff-format:
       glob: "*.py"
-      run: ruff format {staged_files}
+      run: uv run ruff format {staged_files}
       stage_fixed: true
 
     mypy:
       glob: "*.py"
-      run: mypy .
+      run: uv run mypy .

new.sh

@@ -5,10 +5,10 @@ read choice
 
 case "$choice" in
 "hands-on" | "h" | "H")
-  python scripts/new-hands-on.py
+  uv run python scripts/new-hands-on.py
   ;;
 "exercise" | "e" | "E")
-  python scripts/new-exercise.py
+  uv run python scripts/new-exercise.py
   ;;
 *)
   echo "Invalid choice. Please enter 'hands-on' (h) or 'exercise' (e)."

pyproject.toml

@@ -0,0 +1,20 @@
+[project]
+name = "cs3281-exercises"
+version = "0.1.0"
+requires-python = ">=3.13"
+dependencies = [
+    "git-autograder",
+    "PyYAML",
+    "PyGithub",
+    "requests",
+    "repo-smith"
+]
+
+[dependency-groups]
+test = ["pytest"]
+dev = [
+    "lefthook",
+    "ruff",
+    "mypy",
+    "types-requests",
+]

requirements.txt

@@ -1,15 +1,4 @@
 #!/bin/bash
 
-if [ ! -d venv/ ]; then
-  python -m venv venv
-fi
-
-source venv/bin/activate
-
-pip install -r requirements.txt -U --no-cache-dir
-
-if command -v lefthook  >/dev/null 2>&1; then
-  lefthook install
-else
-  echo "LeftHook not installed, failed to set up LeftHook for Git Hooks."
-fi
+uv sync --all-groups
+uv run lefthook install

setup.sh

@@ -1,4 +1,3 @@
 #!/bin/bash
 
-# PYTHONPATH tells python to look for modules in the current directory
-PYTHONPATH="." python scripts/test-download.py $1
+PYTHONPATH=. uv run python scripts/test-download.py "$1"

test-download.sh

@@ -1,16 +1,4 @@
 #!/bin/bash
 set -e
 
-if [ -f "venv/bin/activate" ]; then
-  # Linux / macOS
-  source venv/bin/activate
-elif [ -f "venv/Scripts/activate" ]; then
-  # Windows (Git Bash, Cygwin, or WSL)
-  source venv/Scripts/activate
-else
-  echo "Error: Could not find Python virtual environment activation script."
-  echo "Please create one with: python -m venv venv"
-  exit 1
-fi
-
-python -m pytest $1/test_verify.py -s -vv
+uv run pytest "$1/test_verify.py" -s -vv