Add CodSpeed for continuous performance monitoring

- Add pytest-codspeed 4.2.0 to requirements.txt
- Create comprehensive benchmarks in tests/test_benchmarks.py
- Add GitHub Actions workflow for CodSpeed integration
- Add CodSpeed badge to README

Author: codspeed-hq[bot]

.github/workflows/codspeed.yml

@@ -0,0 +1,42 @@
+name: CodSpeed
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  id-token: write
+
+env:
+  RUSTFLAGS: "--cfg uuid_unstable"
+
+jobs:
+  codspeed:
+    name: Run benchmarks
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Build Python package with maturin
+        uses: PyO3/maturin-action@v1
+        with:
+          command: develop
+          args: --release
+
+      - name: Install test dependencies
+        run: pip install -r requirements.txt
+
+      - name: Run benchmarks
+        uses: CodSpeedHQ/action@v4.5.2
+        with:
+          mode: simulation
+          run: pytest tests/test_benchmarks.py --codspeed

README.md

@@ -4,6 +4,7 @@
 
 [![Package version](https://badge.fury.io/py/uuid-utils.svg)](https://pypi.org/project/uuid-utils/)
 [![Supported Python versions](https://img.shields.io/pypi/pyversions/uuid-utils.svg?color=%2334D058)](https://pypi.org/project/uuid-utils)
+[![CodSpeed](https://img.shields.io/endpoint?url=https://codspeed.io/badge.json)](https://codspeed.io/aminalaee/uuid-utils?utm_source=badge)
 
 </div>
 
@@ -93,7 +94,7 @@ os.register_at_fork(uuid_utils.reseed_rng)
 ## Benchmarks
 
 |        Benchmark | Min     | Max     | Mean    | Min (+)         | Max (+)         | Mean (+)        |
-|------------------|---------|---------|---------|-----------------|-----------------|-----------------|
+|------------------|---------|---------|---------|-----------------|-----------------|--------------------|
 |          UUID v1 | 0.061   | 0.299   | 0.194   | 0.019 (3.3x)    | 0.019 (15.4x)   | 0.019 (10.1x)   |
 |          UUID v3 | 0.267   | 0.307   | 0.293   | 0.035 (7.6x)    | 0.041 (7.5x)    | 0.039 (7.5x)    |
 |          UUID v4 | 0.073   | 0.119   | 0.083   | 0.005 (15.2x)   | 0.005 (24.6x)   | 0.005 (17.1x)   |

requirements.txt

@@ -2,4 +2,5 @@ mkdocs==1.6.1
 mkdocs-material==9.5.34
 mypy==1.19.0
 pytest==9.0.1
+pytest-codspeed==4.2.0
 ruff==0.14.7

tests/test_benchmarks.py

@@ -0,0 +1,110 @@
+"""CodSpeed benchmarks for uuid-utils"""
+import uuid
+
+import pytest
+
+import uuid_utils
+
+node = uuid.getnode()
+
+
+# UUID Generation Benchmarks
+@pytest.mark.benchmark
+def test_uuid1_stdlib(benchmark):
+    """Benchmark stdlib UUID v1 generation"""
+    benchmark(lambda: uuid.uuid1(node))
+
+
+@pytest.mark.benchmark
+def test_uuid1_utils(benchmark):
+    """Benchmark uuid_utils UUID v1 generation"""
+    benchmark(lambda: uuid_utils.uuid1(node))
+
+
+@pytest.mark.benchmark
+def test_uuid3_stdlib(benchmark):
+    """Benchmark stdlib UUID v3 generation"""
+    benchmark(lambda: uuid.uuid3(namespace=uuid.NAMESPACE_DNS, name="python.org"))
+
+
+@pytest.mark.benchmark
+def test_uuid3_utils(benchmark):
+    """Benchmark uuid_utils UUID v3 generation"""
+    benchmark(lambda: uuid_utils.uuid3(namespace=uuid_utils.NAMESPACE_DNS, name="python.org"))
+
+
+@pytest.mark.benchmark
+def test_uuid4_stdlib(benchmark):
+    """Benchmark stdlib UUID v4 generation"""
+    benchmark(lambda: uuid.uuid4())
+
+
+@pytest.mark.benchmark
+def test_uuid4_utils(benchmark):
+    """Benchmark uuid_utils UUID v4 generation"""
+    benchmark(lambda: uuid_utils.uuid4())
+
+
+@pytest.mark.benchmark
+def test_uuid5_stdlib(benchmark):
+    """Benchmark stdlib UUID v5 generation"""
+    benchmark(lambda: uuid.uuid5(namespace=uuid.NAMESPACE_DNS, name="python.org"))
+
+
+@pytest.mark.benchmark
+def test_uuid5_utils(benchmark):
+    """Benchmark uuid_utils UUID v5 generation"""
+    benchmark(lambda: uuid_utils.uuid5(namespace=uuid_utils.NAMESPACE_DNS, name="python.org"))
+
+
+# UUID Parsing Benchmarks
+@pytest.mark.benchmark
+def test_uuid_from_hex_stdlib(benchmark):
+    """Benchmark stdlib UUID from hex string"""
+    benchmark(lambda: uuid.UUID("a8098c1a-f86e-11da-bd1a-00112444be1e"))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_hex_utils(benchmark):
+    """Benchmark uuid_utils UUID from hex string"""
+    benchmark(lambda: uuid_utils.UUID("a8098c1a-f86e-11da-bd1a-00112444be1e"))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_bytes_stdlib(benchmark):
+    """Benchmark stdlib UUID from bytes"""
+    hex_bytes = bytes.fromhex("a8098c1af86e11dabd1a00112444be1e")
+    benchmark(lambda: uuid.UUID(bytes=hex_bytes))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_bytes_utils(benchmark):
+    """Benchmark uuid_utils UUID from bytes"""
+    hex_bytes = bytes.fromhex("a8098c1af86e11dabd1a00112444be1e")
+    benchmark(lambda: uuid_utils.UUID(bytes=hex_bytes))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_int_stdlib(benchmark):
+    """Benchmark stdlib UUID from int"""
+    int_value = 223338299594506624080436508043913872926
+    benchmark(lambda: uuid.UUID(int=int_value))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_int_utils(benchmark):
+    """Benchmark uuid_utils UUID from int"""
+    int_value = 223338299594506624080436508043913872926
+    benchmark(lambda: uuid_utils.UUID(int=int_value))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_fields_stdlib(benchmark):
+    """Benchmark stdlib UUID from fields"""
+    benchmark(lambda: uuid.UUID(fields=(2819197978, 63598, 4570, 189, 26, 73622928926)))
+
+
+@pytest.mark.benchmark
+def test_uuid_from_fields_utils(benchmark):
+    """Benchmark uuid_utils UUID from fields"""
+    benchmark(lambda: uuid_utils.UUID(fields=(2819197978, 63598, 4570, 189, 26, 73622928926)))