Add CodSpeed performance benchmarks

[codspeed-hq]

Summary

This PR sets up continuous performance benchmarking for tldpy using CodSpeed with pytest-codspeed.

What changed

New dev dependency

• pytest-codspeed added to the [dependency-groups] dev section of pyproject.toml (lockfile updated accordingly).

Benchmark suite (tests/test_benchmarks.py)

12 benchmarks covering the core view utility functions that handle HTML processing and data lookups:

Function	Benchmarks	What it measures
decode_content	bytes input, string passthrough	Content decoding path for S3 responses
extract_title	small HTML, large HTML, missing title	Regex-based <title> extraction at different document sizes
extract_breadcrumbs	small HTML, large HTML	Regex-based <h1> extraction for navigation breadcrumbs
get_category_for_key	early match, late match, miss	Category lookup across the full LDP document index
render_search_results	50 results, empty results	HTML generation for the search results page

External services (S3, PostgreSQL) are mocked so benchmarks run in isolation without infrastructure dependencies.

CI workflow (.github/workflows/codspeed.yml)

• Triggers on pushes to main, pull requests, and workflow_dispatch (for CodSpeed backtesting).
• Uses OIDC authentication (no token needed).
• Runs in simulation mode for deterministic, low-variance measurements.
• Sets up Python 3.14 via uv to match the project requirements.

README

• Added CodSpeed performance badge.

Next steps

• Once this PR is merged, CodSpeed will start tracking performance on every push to main and on pull requests.
• To add more benchmarks, create new test_bench_* functions in tests/test_benchmarks.py using the benchmark fixture.
• Visit the CodSpeed dashboard to view results and configure performance checks.

[codspeed-hq]

Congrats! CodSpeed is installed 🎉

🆕 12 new benchmarks were detected.

You will start to see performance impacts in the reports once the benchmarks are run from your default branch.

Detected benchmarks

• test_bench_decode_content_str: 15 µs
• test_bench_decode_content_bytes: 141.3 µs
• test_bench_extract_title_missing: 37.1 µs
• test_bench_get_category_miss: 109.7 µs
• test_bench_extract_breadcrumbs_small: 66 µs
• test_bench_extract_breadcrumbs_large: 160.3 µs
• test_bench_render_search_results_many: 158.5 µs
• test_bench_get_category_last_match: 110.4 µs
• test_bench_render_search_results_empty: 13.5 µs
• test_bench_extract_title_large: 41.5 µs
• test_bench_get_category_first_match: 80.7 µs
• test_bench_extract_title_small: 46.2 µs

---