Setup CodSpeed

[codspeed-hq]

Summary

This PR integrates CodSpeed for continuous performance monitoring of the uuid-utils library. CodSpeed provides accurate, reproducible performance measurements in CI environments using specialized instrumentation.

Changes Made

• Added pytest-codspeed (v4.2.0) to project dependencies in requirements.txt
• Created comprehensive benchmarks in tests/test_benchmarks.py covering:
  • UUID generation (v1, v3, v4, v5) for both stdlib and uuid-utils
  • UUID parsing from hex, bytes, int, and fields for both implementations
• Added GitHub Actions workflow .github/workflows/codspeed.yml with:
  • Triggers on pushes to main, pull requests, and manual dispatch
  • OIDC authentication for secure run submission
  • Proper build setup using PyO3/maturin-action
  • Simulation mode for consistent measurements
• Added CodSpeed badge to README for tracking performance trends

How It Works

The new benchmark suite uses pytest-codspeed's @pytest.mark.benchmark decorator to measure individual operations. Each benchmark compares stdlib UUID operations against uuid-utils implementations, allowing CodSpeed to track performance differences over time.

The GitHub Actions workflow builds the Rust extension using maturin, installs dependencies, and runs the benchmarks with CodSpeed's instrumentation to generate performance profiles.

Next Steps

After merging this PR:

1. Visit the CodSpeed dashboard to view initial benchmark results
2. Enable CodSpeed performance checks to get automatic feedback on PRs
3. Review the flame graphs and execution profiles to identify optimization opportunities
4. Consider adding more benchmarks for uuid6, uuid7, and uuid8 operations

The CodSpeed badge in the README will automatically update to show the latest performance status.

[codspeed-hq]

CodSpeed Performance Report

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_uuid3: 87.2 µs
• test_uuid1_: 83.3 µs
• test_getnode: 91.8 µs
• test_uuid8: 82.9 µs
• test_uuid5: 88.5 µs
• test_uuid6: 82.6 µs
• test_uuid_from_int: 84.7 µs
• test_uuid_from_fields_utils: 85.6 µs
• test_uuid_from_bytes: 23.3 µs
• test_uuid4: 80.9 µs
• test_uuid7: 81.8 µs
• test_uuid_from_hex: 82.9 µs