Migrate to uv and upgrade python to 3.13 (#130)

Author: devinmatte

.flake8

@@ -14,6 +14,7 @@ jobs:
     strategy:
       matrix:
         node-version: ['22']
+        python-version: ['3.13']
     env:
       AWS_PROFILE: transitmatters
       AWS_DEFAULT_REGION: us-east-1
@@ -27,12 +28,11 @@ jobs:
       - name: Checkout repo
         uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@v2
+        uses: actions/setup-python@v5
         with:
-          python-version: 3.12
-      - name: Install Poetry
-        run: |
-          curl -sSL https://install.python-poetry.org | python3 -
+          python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
       - name: Set up Node ${{ matrix.node-version }}.x
         uses: actions/setup-node@v4
         with:

.github/workflows/deploy.yml

@@ -12,14 +12,16 @@ jobs:
     strategy:
       matrix:
         node-version: ['20', '22']
-        python-version: ['3.12']
+        python-version: ['3.13']
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
       - name: Set up Node ${{ matrix.node-version }}.x
         uses: actions/setup-node@v4
         with:
@@ -29,7 +31,6 @@ jobs:
           npx --yes package-lock-utd@1.1.0
       - name: Lint frontend code with ESLint
         run: |
-          curl -sSL https://install.python-poetry.org | python3 -
           npm ci
           npm run lint-frontend
 
@@ -38,23 +39,24 @@ jobs:
     strategy:
       matrix:
         node-version: ['20', '22']
-        python-version: ['3.12']
+        python-version: ['3.13']
     steps:
       - name: Checkout repo
         uses: actions/checkout@v4
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
       - name: Set up Node ${{ matrix.node-version }}.x
         uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
       - name: Check if package-lock.json is up to date
         run: |
           npx --yes package-lock-utd@1.1.0
-      - name: Lint backend code with Flake8
+      - name: Lint backend code with Ruff
         run: |
-          curl -sSL https://install.python-poetry.org | python3 -
           npm ci
           npm run lint-backend

.github/workflows/lint.yml

@@ -0,0 +1,11 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.3
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [--fix]
+        types_or: [python, pyi]
+      # Run the formatter
+      - id: ruff-format
+        types_or: [python, pyi]

.pre-commit-config.yaml

@@ -2,6 +2,7 @@
   "recommendations": [
     "dbaeumer.vscode-eslint",
     "esbenp.prettier-vscode",
-    "bradlc.vscode-tailwindcss"
+    "bradlc.vscode-tailwindcss",
+    "charliermarsh.ruff"
   ]
 }

.vscode/extensions.json

@@ -9,8 +9,13 @@
   "typescript.enablePromptUseWorkspaceTsdk": true,
   "editor.formatOnSave": true,
   "python.analysis.typeCheckingMode": "off",
-  "python.formatting.provider": "black",
   "[python]": {
-    "editor.defaultFormatter": "ms-python.black-formatter"
-  }
+    "editor.defaultFormatter": "charliermarsh.ruff",
+    "editor.codeActionsOnSave": {
+      "source.fixAll.ruff": "explicit",
+      "source.organizeImports.ruff": "explicit"
+    }
+  },
+  "ruff.enable": true,
+  "cSpell.words": ["chartjs", "MASSDOT", "MBTA", "slowzones"]
 }

.vscode/settings.json

@@ -7,10 +7,9 @@ This is the repository for the TransitMatters Shutdown Tracker. Client code is w
 - node 22.x and npm 10+ required
   - With `nvm` installed, use `nvm install && nvm use`
   - verify with `node -v`
-- Python 3.12 with recent poetry (2.0.0 or later)
-  - Verify with `python --version && poetry --version`
-  - `poetry self update` to update poetry
-  - If using `pyenv`, `pyenv install 3.12.0`
+- Python 3.13 with recent uv
+  - [`uv`](https://docs.astral.sh/uv/)
+    - Ensure `uv` is using the correct Python version by running `uv venv --python 3.13`
 
 ## Development Instructions
 

README.md

@@ -36,8 +36,8 @@ npm run build
 
 # Deploy to cloudformation
 pushd server/ > /dev/null
-poetry export --without-hashes --output requirements.txt
-poetry run chalice package --stage $CHALICE_STAGE --merge-template cloudformation.json cfn/
+uv export --no-hashes --output-file requirements.txt
+uv run chalice package --stage $CHALICE_STAGE --merge-template cloudformation.json cfn/
 aws cloudformation package --template-file cfn/sam.json --s3-bucket $BACKEND_BUCKET --output-template-file cfn/packaged.yaml
 aws cloudformation deploy --template-file cfn/packaged.yaml --stack-name $STACK_NAME --capabilities CAPABILITY_IAM --no-fail-on-empty-changeset \
     --tags service=shutdown-tracker env=prod \

deploy.sh

@@ -5,14 +5,14 @@
   "type": "module",
   "scripts": {
     "start": "concurrently npm:start-python npm:dev",
-    "start-python": "cd server && poetry run chalice local --port=5555",
+    "start-python": "cd server && uv run chalice local --port=5555",
     "dev": "vite",
     "build": "tsc && vite build",
-    "lint-frontend": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 10 && poetry run python sort-shutdowns.py --check",
-    "lint-backend": "cd server && poetry run flake8 && poetry run black . --check",
+    "lint-frontend": "eslint . --ext ts,tsx --report-unused-disable-directives --max-warnings 10 && uv run python sort-shutdowns.py --check",
+    "lint-backend": "cd server && uv run ruff check .",
     "lint": "concurrently npm:lint-frontend npm:lint-backend",
-    "sort-shutdowns": "poetry run python sort-shutdowns.py",
-    "postinstall": "cd server && poetry install",
+    "sort-shutdowns": "uv run python sort-shutdowns.py",
+    "postinstall": "cd server && uv sync",
     "preview": "vite preview"
   },
   "engines": {