ci: update workflows for the uv workspace + cli

Author: igorbenav

.github/workflows/linting.yml

@@ -5,25 +5,23 @@ on: [push, pull_request]
 jobs:
   lint:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: backend
     steps:
-    - uses: actions/checkout@v4
-    
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.11
+      - uses: actions/checkout@v4
 
-    - name: Install uv
-      run: pip install uv
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
 
-    - name: Create venv
-      run: uv venv
+      - name: Install uv
+        run: pip install uv
 
-    - name: Install package with dev dependencies
-      run: uv pip install -e ".[dev]"
+      - name: Sync workspace
+        # --all-packages is required to include extras from workspace members
+        # (backend's dev extra holds ruff itself).
+        run: uv sync --all-packages --all-extras
 
-    - name: Run Ruff
-      run: uv run ruff check src
+      - name: Ruff check (backend + cli)
+        # --no-sync prevents uv run's implicit re-sync from dropping member
+        # extras (it defaults to no extras and would remove ruff).
+        run: uv run --no-sync ruff check backend/src cli/src

.github/workflows/tests.yml

@@ -5,29 +5,25 @@ on: [push, pull_request]
 jobs:
   tests:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: backend
-
     steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.11
-
-    - name: Install uv
-      run: pip install uv
-
-    - name: Create venv
-      run: uv venv
-
-    - name: Install package with dev dependencies
-      run: uv pip install -e ".[dev]"
-
-    - name: Run tests
-      run: uv run pytest
-      env:
-        ENVIRONMENT: local
-        SECRET_KEY: test-secret-key-for-testing-only
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Sync workspace
+        run: uv sync --all-packages --all-extras
+
+      # Tests live in backend/ today; cli/ has no tests yet.
+      - name: Pytest (backend)
+        # --no-sync prevents uv run's implicit re-sync from dropping member
+        # extras (it defaults to no extras and would remove pytest).
+        run: cd backend && uv run --no-sync pytest
+        env:
+          ENVIRONMENT: local
+          SECRET_KEY: test-secret-key-for-testing-only

.github/workflows/type-checking.yml

@@ -5,29 +5,28 @@ on: [push, pull_request]
 jobs:
   type-check:
     runs-on: ubuntu-latest
-    defaults:
-      run:
-        working-directory: backend
-
     steps:
-    - uses: actions/checkout@v4
-
-    - name: Set up Python
-      uses: actions/setup-python@v5
-      with:
-        python-version: 3.11
-
-    - name: Install uv
-      run: pip install uv
-
-    - name: Create venv
-      run: uv venv
-
-    - name: Install package with dev dependencies
-      run: uv pip install -e ".[dev]"
-
-    - name: Run mypy
-      run: uv run mypy src --config-file pyproject.toml
-      env:
-        ENVIRONMENT: local
-        SECRET_KEY: test-secret-key-for-testing-only
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install uv
+        run: pip install uv
+
+      - name: Sync workspace
+        run: uv sync --all-packages --all-extras
+
+      - name: Mypy (backend)
+        run: cd backend && uv run --no-sync mypy src --config-file pyproject.toml
+        env:
+          ENVIRONMENT: local
+          SECRET_KEY: test-secret-key-for-testing-only
+
+      - name: Mypy (cli)
+        run: cd cli && uv run --no-sync mypy src/cli
+        env:
+          ENVIRONMENT: local
+          SECRET_KEY: test-secret-key-for-testing-only

README.md

@@ -86,7 +86,7 @@ fastapi-boilerplate/
 ```bash
 git clone https://github.com/<you>/FastAPI-boilerplate
 cd FastAPI-boilerplate
-uv sync --all-extras                          # one venv at the root, both members installed
+uv sync --all-packages --all-extras           # one venv at the root, both members installed
 ```
 
 Generate a compose file for the deployment shape you want:

backend/src/infrastructure/cache/backends/redis.py

@@ -143,7 +143,7 @@ async def ping(self) -> bool:
             True if the cache is available, False otherwise.
         """
         try:
-            result = await self.client.ping()
+            result = await self.client.ping()  # type: ignore[misc]
             return bool(result)
         except Exception:
             return False

backend/src/infrastructure/rate_limit/backends/redis.py

@@ -185,7 +185,7 @@ async def ping(self) -> bool:
             True if the backend is available, False otherwise.
         """
         try:
-            result = await self.client.ping()
+            result = await self.client.ping()  # type: ignore[misc]
             return bool(result)
         except Exception as e:
             logger.error(f"Failed to ping Redis server: {e}")

backend/src/interfaces/admin/views/tiers.py

@@ -10,7 +10,7 @@
 from ..mixins import DataclassModelMixin
 
 
-class TierAdmin(DataclassModelMixin, ModelView, model=Tier):  # type: ignore[call-arg]
+class TierAdmin(DataclassModelMixin, ModelView, model=Tier):
     """Admin view for Tier model."""
 
     name = "Tier"

backend/src/interfaces/admin/views/users.py

@@ -15,7 +15,7 @@
 OAUTH_PROVIDER_CHOICES = [("", "None")] + [(p.value, p.value.title()) for p in OAuthProvider]
 
 
-class UserAdmin(DataclassModelMixin, ModelView, model=User):  # type: ignore[call-arg]
+class UserAdmin(DataclassModelMixin, ModelView, model=User):
     """Admin view for User model with password hashing."""
 
     name = "User"

docs/getting-started/installation.md

@@ -114,7 +114,7 @@ For development on your host machine. You provide PostgreSQL and Redis yourself.
 2. **Install Python dependencies**:
 
     ```bash
-    uv sync --all-extras
+    uv sync --all-packages --all-extras
     ```
 
     This syncs the whole workspace — backend, CLI, and dev tools — into one `.venv/` at the repo root. From here on, `uv run <cmd>` works from any subdirectory.
@@ -186,7 +186,7 @@ For contributors and anyone modifying the boilerplate itself.
 2. **Install dev dependencies**:
 
     ```bash
-    uv sync --all-extras
+    uv sync --all-packages --all-extras
     ```
 
 3. **Set up pre-commit hooks** (from the repo root):