v0.3.5

[akhundMurad]

Release v0.3.5 — Performance, Reliability, and CI Improvements

This release is a major step forward in performance, robustness, and release automation for typeid-python. It introduces optional Rust acceleration, reproducible benchmarks, and a significantly improved CI/CD pipeline—while maintaining full backward compatibility and a pure-Python fallback.

---

Highlights

Optional Rust Acceleration

• New opt-in Rust backend for Base32 encode/decode and UUIDv7 generation.

• Automatically used when available; pure Python fallback remains the default guarantee.

• Enabled via:

  pip install typeid-python[rust]

Measurable Performance Gains

• ~5× faster TypeID generation
• ~1.6× faster parsing
• ~2.5× faster end-to-end workflows
• Benchmarks are reproducible, committed as raw JSON, and documented in detail.

Reproducible Benchmark Suite

• New bench/ directory with:

  • pytest-benchmark-based tests
  • versioned benchmark snapshots
  • clear comparison methodology

• Performance claims are now fully auditable.

Smarter Internals

• Lazy UUID materialization (decode only when needed)
• Single-pass suffix validation and decode
• Cached string representations
• Cleaner UUID backend abstraction with explicit override support

Improved Semantics

• New created_at property for UUIDv7-backed TypeIDs

• Correct handling of:

  • nil UUIDs
  • non-v7 UUIDs
  • unexpected UUID backends

• typeid explain now accurately reflects sortability and timestamps

CI / Release Pipeline Overhaul

• Docs and PyPI publishing now run only on version tags

• New multi-platform wheel builds (Linux, macOS, Windows)

• Rust wheels built automatically when applicable

• Tests and docs are required gates before publishing

• Clear separation between:

  • PR checks
  • tests
  • docs
  • release publishing

Documentation Improvements

• New Performance documentation section
• Expanded Rust acceleration guidance
• Clear benchmark philosophy and methodology
• Updated Quickstart and Explain docs
• Improved CONTRIBUTING guide with explicit Rust-optional guarantees

Compatibility & Safety

• No breaking API changes
• Existing users are unaffected unless opting into extras
• Python-only environments remain fully supported
• Lockfile discipline and validation tightened

---

As always, feedback, benchmarks, and PRs are welcome.
This release focuses on making performance improvements transparent, measurable, and optional—without compromising safety or clarity.

Full Changelog: v0.3.4...v0.3.5

---

This discussion was created from the release v0.3.5.

[akhundMurad]

This version has been yanked. Please use v0.3.7.