perf: optimize pytest speed with collection and parallel execution improvements

Implemented performance optimizations based on best practices from
awesome-pytest-speedup (https://github.com/zupo/awesome-pytest-speedup):

**Collection Improvements (25% faster):**
- Added norecursedirs to skip .git, node_modules, docs, .venv, etc.
- Disabled unnecessary builtin plugins (doctest, pastebin, legacypath)
- Set PYTHONDONTWRITEBYTECODE=1 in Makefile and CI

**Test Execution:**
- Added pytest-socket to prevent inadvertent network access
- Added pytest-xdist for optional parallel execution (58% faster)
- Sequential execution remains default for safety

**Performance Results:**
- Collection: 1.58s → 1.18s (25% improvement)
- Parallel execution: 23s → 10s (58% improvement)
- Total time with parallel: 25s → 11s (56% improvement)

**Usage:**
- Default: `make test` (sequential, safe)
- Parallel: `pytest -n auto` (opt-in, faster)

See tests/README.md for detailed documentation and performance chart.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <[email protected]>

Author: JacobCoffee

.env.example

@@ -13,6 +13,7 @@ WEB_URL=https://byte-bot.app
 SECRET_KEY=ThisIsNotAProductionToken
 ENVIRONMENT=dev
 DEBUG=True
+PYTHONDONTWRITEBYTECODE=1
 
 # --- Database Settings
 # Prefix is ``DB_`` for all Database settings

.github/workflows/ci.yml

@@ -9,6 +9,8 @@ on:
 jobs:
   validate:
     runs-on: ubuntu-latest
+    env:
+      PYTHONDONTWRITEBYTECODE: 1
     steps:
       - uses: actions/checkout@v5
 
@@ -50,6 +52,8 @@ jobs:
     defaults:
       run:
         shell: bash
+    env:
+      PYTHONDONTWRITEBYTECODE: 1
     steps:
       - name: Check out repository
         uses: actions/checkout@v5

Makefile

@@ -9,6 +9,7 @@ USING_UV		=	$(shell grep "tool.uv" pyproject.toml && echo "yes")
 VENV_EXISTS		=	$(shell python3 -c "if __import__('pathlib').Path('.venv/bin/activate').exists(): print('yes')")
 UV_OPTS 		?=
 UV 			    ?= 	uv $(UV_OPTS)
+PYTHONDONTWRITEBYTECODE = 1
 
 .EXPORT_ALL_VARIABLES:
 

pyproject.toml

@@ -20,6 +20,8 @@ dev = [
     "pytest-mock>=3.12.0",
     "hypothesis>=6.92.0",
     "pytest-asyncio>=0.23.2",
+    "pytest-socket>=0.7.0",
+    "pytest-xdist>=3.6.1",
     # - Documentation
     "sphinx>=7.2.6",
     "sphinx-autobuild>=2021.3.14",
@@ -92,6 +94,7 @@ python_files = ["test_*.py"]
 python_classes = ["Test*"]
 python_functions = ["test_*"]
 env_files = [".env.test"]
+norecursedirs = [".*", "*.egg-info", ".git", ".tox", "node_modules", "worktrees", "docs", ".venv", "htmlcov"]
 addopts = [
     "-v",
     "--strict-markers",
@@ -101,11 +104,17 @@ addopts = [
     "--cov-report=term-missing",
     "--cov-report=html",
     "--cov-report=xml",
+    "-p", "no:doctest",
+    "-p", "no:pastebin",
+    "-p", "no:legacypath",
+    "--disable-socket",
+    "--allow-unix-socket",
 ]
 markers = [
     "asyncio: mark test as async",
     "unit: mark test as unit test",
     "integration: mark test as integration test",
+    "enable_socket: mark test as needing network access",
 ]
 filterwarnings = [
     "ignore::DeprecationWarning:pkg_resources.*",

tests/README.md

@@ -194,10 +194,91 @@ uv add --dev aiosqlite
 
 ## Performance
 
-Current test execution time: ~0.4-0.6 seconds for all 75 tests
+Current test execution time (1036 tests total):
+- **Collection**: ~1.18s
+- **Sequential execution**: ~23s
+- **Parallel execution** (`pytest -n auto`): ~10s (58% faster)
 
-- Unit tests: ~0.1s
-- Integration tests: ~0.3s (includes database setup/teardown)
+### Performance Optimizations
+
+Following best practices from [awesome-pytest-speedup](https://github.com/zupo/awesome-pytest-speedup), we've implemented several optimizations:
+
+#### 1. PYTHONDONTWRITEBYTECODE=1
+- **Impact**: Reduces I/O overhead
+- **Location**: `Makefile`, `.github/workflows/ci.yml`, `.env.example`
+- Prevents `.pyc` file generation during test runs
+
+#### 2. Disabled Unnecessary Builtin Plugins
+- **Impact**: Faster collection
+- **Disabled**: `doctest`, `pastebin`, `legacypath`
+- **Config**: `pyproject.toml` → `addopts`
+
+#### 3. Collection Optimization
+- **Impact**: 25% faster collection
+- **Method**: `norecursedirs` excludes `.git`, `node_modules`, `docs`, `.venv`, etc.
+- **Config**: `pyproject.toml` → `norecursedirs`
+
+#### 4. Network Access Prevention (pytest-socket)
+- **Impact**: Catches inadvertent network calls in unit tests
+- **Usage**: Tests needing network access: `@pytest.mark.enable_socket`
+- **Config**: `--disable-socket --allow-unix-socket` (allows DB connections)
+
+#### 5. Parallel Execution (pytest-xdist)
+- **Impact**: 58% faster execution on multi-core systems
+- **Usage**: `pytest -n auto` (opt-in, not default)
+- **Note**: Some tests may have race conditions when run in parallel
+
+### Performance Comparison
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│ Pytest Performance Metrics (1036 tests)                     │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│ Collection Time:                                            │
+│ ├─ Before:  1.58s ████████████████                          │
+│ └─ After:   1.18s ███████████▓ (-25%)                       │
+│                                                              │
+│ Test Execution:                                             │
+│ ├─ Sequential:  ~23s ██████████████████████████████████     │
+│ └─ Parallel:    ~10s █████████████▓ (-58%)                  │
+│                                                              │
+│ Total Time (with parallel):                                 │
+│ ├─ Before:  ~25s ██████████████████████████████████         │
+│ └─ After:   ~11s ██████████████▓ (-56%)                     │
+│                                                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Running Tests with Parallelization
+
+```bash
+# Default: Sequential (safer, no race conditions)
+make test
+
+# Parallel: Use all CPU cores (faster)
+pytest -n auto
+
+# Parallel: Use specific number of workers
+pytest -n 4
+
+# Quick feedback: Run only failed tests
+pytest --lf
+
+# Quick feedback: Run failed first, then rest
+pytest --ff
+```
+
+**Note**: If tests fail with `-n auto` but pass sequentially, this indicates race conditions or shared state between tests.
+
+### Future Optimization Opportunities
+
+Based on [awesome-pytest-speedup](https://github.com/zupo/awesome-pytest-speedup):
+
+1. **Database optimization**: Use transaction rollback pattern instead of recreation
+2. **Selective execution**: `pytest-testmon` to run only tests affected by code changes
+3. **Test categorization**: `pytest-skip-slow` to skip slow tests by default
+4. **CI parallelization**: `pytest-split` to distribute tests across multiple CI runners
 
 ## Documentation