fastuuidv7 0.1.4__tar.gz

fastuuidv7-0.1.4/.github/workflows/benchmark-python.yml

@@ -0,0 +1,196 @@
+name: Python Benchmark
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'python/**'
+      - 'src/**'
+      - '.github/workflows/benchmark-python.yml'
+  pull_request:
+    branches: [main]
+    paths:
+      - 'python/**'
+      - 'src/**'
+  workflow_dispatch:
+
+jobs:
+  benchmark:
+    name: Benchmark on ${{ matrix.platform.name }}
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          # Linux x86_64
+          - name: Linux x86_64
+            runner: ubuntu-latest
+            target: x86_64
+          # Windows x86_64
+          - name: Windows x86_64
+            runner: windows-latest
+            target: x86_64
+          # macOS ARM (Apple Silicon)
+          - name: macOS ARM64
+            runner: macos-latest
+            target: aarch64
+    
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Build Python package (optimized)
+        uses: PyO3/maturin-action@v1
+        with:
+          working-directory: python
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+          manylinux: auto
+
+      - name: Install built package
+        shell: bash
+        run: |
+          pip install --find-links python/dist fastuuidv7
+
+      - name: Install comparison packages
+        shell: bash
+        run: |
+          pip install uuid6 || true
+          pip install uuid7 || true
+          pip install fastuuid7 || true
+
+      - name: Display system information
+        shell: bash
+        run: |
+          echo "=== System Information ==="
+          python --version
+          python -c "import platform; print(f'Platform: {platform.platform()}')"
+          python -c "import platform; print(f'Processor: {platform.processor()}')"
+          python -c "import platform; print(f'Machine: {platform.machine()}')"
+          echo ""
+
+      - name: Run benchmark
+        shell: bash
+        run: |
+          echo "=== Running Benchmark ==="
+          python python/bench/bench.py
+          echo ""
+
+      - name: Run extended performance test
+        shell: bash
+        run: |
+          echo "=== Extended Performance Test ==="
+          python -c "
+          import fastuuidv7
+          import time
+          
+          # Warm up
+          for _ in range(10000):
+              fastuuidv7.gen_id_str()
+          
+          # Benchmark different call counts
+          for count in [100_000, 1_000_000, 10_000_000]:
+              start = time.perf_counter()
+              for _ in range(count):
+                  fastuuidv7.gen_id_str()
+              elapsed = time.perf_counter() - start
+              ops_per_sec = count / elapsed
+              ns_per_call = elapsed * 1e9 / count
+              print(f'{count:>10,} calls: {ops_per_sec:>15,.0f} ops/s  ({ns_per_call:>6.1f} ns/call)')
+          "
+          echo ""
+
+      - name: Memory efficiency test
+        shell: bash
+        run: |
+          echo "=== Memory Efficiency Test ==="
+          python -c "
+          import fastuuidv7
+          import sys
+          
+          # Test that we're not leaking memory
+          ids = []
+          for _ in range(100_000):
+              ids.append(fastuuidv7.gen_id_str())
+          
+          # Check string size
+          sample = ids[0]
+          print(f'UUID string length: {len(sample)} chars')
+          print(f'UUID string size: {sys.getsizeof(sample)} bytes')
+          print(f'Sample UUID: {sample}')
+          print(f'Generated {len(ids):,} UUIDs successfully')
+          "
+          echo ""
+
+      - name: Comparison with uuid.uuid4
+        shell: bash
+        run: |
+          echo "=== Comparison with uuid.uuid4() ==="
+          python -c "
+          import fastuuidv7
+          import uuid
+          import time
+          
+          count = 1_000_000
+          
+          # Benchmark fastuuidv7
+          start = time.perf_counter()
+          for _ in range(count):
+              fastuuidv7.gen_id_str()
+          elapsed_v7 = time.perf_counter() - start
+          
+          # Benchmark uuid.uuid4
+          start = time.perf_counter()
+          for _ in range(count):
+              str(uuid.uuid4())
+          elapsed_v4 = time.perf_counter() - start
+          
+          speedup = elapsed_v4 / elapsed_v7
+          
+          print(f'fastuuidv7.gen_id_str(): {count/elapsed_v7:>15,.0f} ops/s')
+          print(f'uuid.uuid4() + str():   {count/elapsed_v4:>15,.0f} ops/s')
+          print(f'Speedup: {speedup:.2f}x faster')
+          "
+          echo ""
+
+      - name: Upload benchmark results
+        if: always()
+        uses: actions/upload-artifact@v4
+        with:
+          name: benchmark-results-${{ matrix.platform.name }}
+          path: |
+            python/bench/
+          retention-days: 30
+
+  summary:
+    name: Benchmark Summary
+    runs-on: ubuntu-latest
+    needs: benchmark
+    if: always()
+    steps:
+      - name: Download all benchmark results
+        uses: actions/download-artifact@v4
+        with:
+          path: results
+
+      - name: Create summary
+        run: |
+          echo "# Python Benchmark Results" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Benchmarks completed for:" >> $GITHUB_STEP_SUMMARY
+          echo "- Linux x86_64" >> $GITHUB_STEP_SUMMARY
+          echo "- Windows x86_64" >> $GITHUB_STEP_SUMMARY
+          echo "- macOS ARM64 (Apple Silicon)" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "See individual job logs for detailed performance metrics." >> $GITHUB_STEP_SUMMARY
+
+# Made with Bob

fastuuidv7-0.1.4/.github/workflows/ci.yml

@@ -0,0 +1,49 @@
+name: CI
+
+on:
+  push:
+    branches: [ "main", "master" ]
+  pull_request:
+    branches: [ "main", "master" ]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  test:
+    name: Test ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install Rust toolchain
+      uses: dtolnay/rust-toolchain@stable
+    - name: Build
+      run: cargo build --verbose
+    - name: Run tests
+      run: cargo test --verbose
+    - name: Run bench
+      run: cargo bench
+
+  test-fallback:
+    name: Test Fallback (i686)
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v4
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y gcc-multilib
+    - name: Install Rust toolchain
+      uses: dtolnay/rust-toolchain@stable
+      with:
+        targets: i686-unknown-linux-gnu
+    - name: Build
+      run: cargo build --verbose --target i686-unknown-linux-gnu
+    - name: Run tests
+      run: cargo test --verbose --target i686-unknown-linux-gnu
+    - name: Run bench
+      run: cargo bench

fastuuidv7-0.1.4/.github/workflows/publish-python.yml

@@ -0,0 +1,149 @@
+name: Publish Python Package
+
+on:
+  release:
+    types:
+      - published
+  workflow_dispatch:
+    inputs:
+      target:
+        description: "Where to publish the package"
+        required: true
+        default: "testpypi"
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+jobs:
+  build-wheels:
+    name: Build wheels on ${{ matrix.platform.os }} (${{ matrix.platform.target }})
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          # Linux x86_64
+          - runner: ubuntu-latest
+            os: linux
+            target: x86_64
+          # Linux aarch64 (ARM64)
+          - runner: ubuntu-latest
+            os: linux
+            target: aarch64
+          # Linux armv7
+          - runner: ubuntu-latest
+            os: linux
+            target: armv7
+          # macOS x86_64 (Intel)
+          - runner: macos-15-intel
+            os: macos
+            target: x86_64
+          # macOS aarch64 (Apple Silicon)
+          - runner: macos-latest
+            os: macos
+            target: aarch64
+          # Windows x86_64
+          - runner: windows-latest
+            os: windows
+            target: x86_64
+          # Windows aarch64 (ARM64) - Disabled due to lack of Python dev libraries in CI
+          # Cross-compiling Python extensions for Windows ARM64 is not currently supported
+          # - runner: windows-latest
+          #   os: windows
+          #   target: aarch64
+    
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Build wheels
+        uses: PyO3/maturin-action@v1
+        with:
+          working-directory: python
+          target: ${{ matrix.platform.target }}
+          args: --release --out dist --find-interpreter
+          sccache: 'true'
+          manylinux: auto
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform.os }}-${{ matrix.platform.target }}
+          path: python/dist
+
+  build-sdist:
+    name: Build source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Build sdist
+        uses: PyO3/maturin-action@v1
+        with:
+          working-directory: python
+          command: sdist
+          args: --out dist
+
+      - name: Upload sdist
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: python/dist
+
+  publish:
+    name: Publish to ${{ github.event_name == 'release' && 'PyPI' || inputs.target }}
+    runs-on: ubuntu-latest
+    needs: [build-wheels, build-sdist]
+    permissions:
+      contents: read
+      id-token: write
+    environment:
+      name: ${{ github.event_name == 'release' && 'pypi' || inputs.target }}
+
+    steps:
+      - name: Download all artifacts
+        uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+
+      - name: List distribution files
+        run: ls -lh dist/
+
+      - name: Check package metadata
+        run: |
+          pip install twine
+          twine check dist/*
+
+      - name: Publish to TestPyPI
+        if: github.event_name == 'workflow_dispatch' && inputs.target == 'testpypi'
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+          packages-dir: dist/
+
+      - name: Publish to PyPI
+        if: github.event_name == 'release' || (github.event_name == 'workflow_dispatch' && inputs.target == 'pypi')
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+
+# Made with Bob

fastuuidv7-0.1.4/.github/workflows/release.yml

@@ -0,0 +1,62 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  release:
+    name: Release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Cache cargo registry
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+      
+      - name: Build release
+        run: cargo build --release 
+      
+      - name: Run tests
+        run: cargo test --release
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          generate_release_notes: true
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+  publish-crates-io:
+    name: Publish to crates.io
+    runs-on: ubuntu-latest
+    needs: release
+    environment: release
+    steps:
+      - uses: actions/checkout@v4
+      
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+      
+      - name: Publish to crates.io
+        run: cargo publish --allow-dirty
+        env:
+          CARGO_REGISTRY_TOKEN: ${{ secrets.CRATES_IO_TOKEN }}

fastuuidv7-0.1.4/.gitignore

@@ -0,0 +1,27 @@
+# Generated by Cargo
+# will have compiled files and executables
+debug
+target
+
+# These are backup files generated by rustfmt
+**/*.rs.bk
+
+# MSVC Windows builds of rustc generate these, which store debugging information
+*.pdb
+
+# Generated by cargo mutants
+# Contains mutation testing data
+**/mutants.out*/
+
+# RustRover
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+.serena
+
+# Added by cargo
+
+/target