refactor: adjust indentation across project files for consistency and readability

- Standardize alignment in function parameters, method definitions, and docstrings
- Correct inconsistent use of spaces in YAML files and Markdown lists
- Improve readability and structure throughout backend services, tests, Alembic migrations, and configuration files

Author: Pdzly

.github/workflows/test-backend.yml

@@ -0,0 +1,53 @@
+name: Backend Tests
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: postgres
+          POSTGRES_PASSWORD: postgres
+          POSTGRES_DB: devbin_test
+        ports:
+          - 5433:5432
+        options: >-
+          --health-cmd "pg_isready -U postgres"
+          --health-interval 5s
+          --health-timeout 5s
+          --health-retries 5
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Install dependencies
+        run: uv sync --extra test --extra migration
+
+      - name: Run tests
+        env:
+          APP_DATABASE_URL: postgresql+asyncpg://postgres:postgres@localhost:5433/devbin_test
+          APP_BASE_FOLDER_PATH: /tmp/devbin_test_files
+          APP_DEBUG: "true"
+          APP_CORS_DOMAINS: '["http://test"]'
+          APP_ALLOW_CORS_WILDCARD: "false"
+        run: uv run pytest

README.md

@@ -140,6 +140,22 @@ APP_RELOAD=true
 APP_SQLALCHEMY_ECHO=true
 ```
 
+### Tests
+
+### Backend Tests
+
+Run tests with:
+
+```bash
+cd backend
+uv run pytest
+```
+
+> If you modified any of the core API endpoints, make sure to run the tests to ensure they still work as expected. Or if
+> you are committing breaking changes, please adjust them and add a note why this breaking change is necessary.
+
+See [Testing](/backend/TESTING.md)
+
 ### API Endpoints
 
 - `GET /health` – Health check

backend/TESTING.md

@@ -18,6 +18,7 @@ uv sync --extra test
 ```
 
 This will:
+
 - Start PostgreSQL 16 in Docker on port 5433
 - Create the `devbin_test` database
 - Wait for the database to be ready
@@ -83,10 +84,10 @@ docker-compose -f docker-compose.test.yml logs -f
 Tests use environment variables from `pytest.ini` by default:
 
 ```ini
-APP_DATABASE_URL=postgresql+asyncpg://postgres:postgres@localhost:5433/devbin_test
-APP_BASE_FOLDER_PATH=/tmp/devbin_test_files
-APP_DEBUG=true
-APP_ALLOW_CORS_WILDCARD=true
+APP_DATABASE_URL = postgresql+asyncpg://postgres:postgres@localhost:5433/devbin_test
+APP_BASE_FOLDER_PATH = /tmp/devbin_test_files
+APP_DEBUG = true
+APP_ALLOW_CORS_WILDCARD = true
 ```
 
 You can override these by setting environment variables before running tests:
@@ -172,9 +173,9 @@ open htmlcov/index.html  # or xdg-open on Linux
 
 - Overall: 80%+ (enforced in CI)
 - Critical modules: 90%+
-  - `app/services/paste_service.py`
-  - `app/utils/token_utils.py`
-  - `app/api/subroutes/pastes.py`
+    - `app/services/paste_service.py`
+    - `app/utils/token_utils.py`
+    - `app/api/subroutes/pastes.py`
 
 ## Troubleshooting
 
@@ -183,6 +184,7 @@ open htmlcov/index.html  # or xdg-open on Linux
 **Problem**: `connection refused` or `could not connect to server`
 
 **Solution**:
+
 1. Check if test database is running: `docker ps | grep devbin_test`
 2. Start database: `./scripts/setup_test_db.sh`
 3. Check database logs: `docker-compose -f docker-compose.test.yml logs`
@@ -192,6 +194,7 @@ open htmlcov/index.html  # or xdg-open on Linux
 **Problem**: Port 5433 is already in use
 
 **Solution**:
+
 1. Change port in `docker-compose.test.yml`
 2. Update `pytest.ini` to match
 3. Restart database
@@ -201,6 +204,7 @@ open htmlcov/index.html  # or xdg-open on Linux
 **Problem**: Tests pass sometimes, fail other times (flaky tests)
 
 **Solution**:
+
 1. Check if tests are properly isolated (no shared state)
 2. Verify database cleanup between tests
 3. Check for timing issues (use `freezegun` for time-based tests)
@@ -210,6 +214,7 @@ open htmlcov/index.html  # or xdg-open on Linux
 **Problem**: Tests take too long to run
 
 **Solution**:
+
 1. Run tests in parallel: `pytest -n auto`
 2. Run only unit tests: `pytest tests/unit/`
 3. Run specific test file instead of entire suite
@@ -240,6 +245,7 @@ open htmlcov/index.html  # or xdg-open on Linux
 ## Continuous Integration
 
 Tests run automatically on:
+
 - Push to `master` or `develop`
 - Pull requests
 

backend/Taskfile.yml

@@ -3,11 +3,17 @@
 version: '3'
 
 tasks:
+  api:setup_test:
+    cmds:
+      - uv sync --extra test
+      - ./scripts/setup_test_db.sh
   api:start:
     env:
       APP_DEBUG: true
     cmd: uv run main.py
   api:migrate:
     cmd: alembic upgrade head
   api:downmigrate:
-    cmd: alembic downgrade -1
+    cmd: alembic downgrade -1
+  api:test:
+    cmd: uv run pytest

backend/alembic/env.py

@@ -1,10 +1,9 @@
 import os
 from logging.config import fileConfig
 
+from alembic import context
 from sqlalchemy import engine_from_config, pool
 
-from alembic import context
-from app.db.base import Base
 from app.db.models import *
 
 # this is the Alembic Config object, which provides

backend/alembic/versions/08393764144d_add_delete_edit_tokens_and_deleted_at.py

@@ -7,9 +7,8 @@
 """
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
-
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '08393764144d'

backend/alembic/versions/7c45e2617d61_updated_created_at_and_expires_at_types.py

@@ -9,9 +9,8 @@
 from typing import Sequence, Union
 
 import sqlalchemy as sa
-from sqlalchemy.dialects import postgresql
-
 from alembic import op
+from sqlalchemy.dialects import postgresql
 
 # revision identifiers, used by Alembic.
 revision: str = "7c45e2617d61"

backend/alembic/versions/9e8ceaeba260_initial_migration.py

@@ -7,8 +7,8 @@
 """
 from typing import Sequence, Union
 
-from alembic import op
 import sqlalchemy as sa
+from alembic import op
 
 # revision identifiers, used by Alembic.
 revision: str = '9e8ceaeba260'

backend/app/api/dto/paste_dto.py

@@ -1,6 +1,5 @@
 from datetime import datetime, timezone
 from enum import Enum
-from uuid import UUID
 
 from pydantic import UUID4, BaseModel, Field, field_validator
 

backend/app/api/middlewares.py

@@ -12,17 +12,17 @@
 
 class UserMetadataMiddleware(BaseHTTPMiddleware):
     def get_ip_address(
-        self, request: Request
+            self, request: Request
     ) -> ipaddress.IPv4Address | ipaddress.IPv6Address | Literal["unknown"]:
         # Try X-Forwarded-For first (proxy headers)
         forwarded = request.headers.get("X-Forwarded-For")
         ip = "unknown"
 
         if (
-            forwarded
-            and request.client
-            and request.client.host
-            and request.client.host in config.TRUSTED_HOSTS
+                forwarded
+                and request.client
+                and request.client.host
+                and request.client.host in config.TRUSTED_HOSTS
         ):
             # Get first IP in the list (original client)
             split_ip = forwarded.split(",")[0].strip()
@@ -121,8 +121,8 @@ async def dispatch(self, request: Request, call_next):
         # Check if request came over HTTPS
         # Note: In production behind proxy, check X-Forwarded-Proto header
         is_https = (
-            request.url.scheme == "https"
-            or request.headers.get("X-Forwarded-Proto") == "https"
+                request.url.scheme == "https"
+                or request.headers.get("X-Forwarded-Proto") == "https"
         )
 
         if is_https:
@@ -145,8 +145,8 @@ class HTTPSRedirectMiddleware(BaseHTTPMiddleware):
     async def dispatch(self, request: Request, call_next):
         # Check if request is over HTTPS
         is_https = (
-            request.url.scheme == "https"
-            or request.headers.get("X-Forwarded-Proto") == "https"
+                request.url.scheme == "https"
+                or request.headers.get("X-Forwarded-Proto") == "https"
         )
 
         if not is_https: