Repository navigation
v0.1.0: Clean Namespace API and Production-Ready Features
π First Stable Release!
β¨ Major Features
π― Clean Namespace Class:
- Simple domain-to-UUID conversion:
Namespace('domain.com') - Eliminates complex import patterns:
uuid5(NAMESPACE_DNS, ...) - Clean equality, hashing, and string representation
- Full backward compatibility with existing UUID namespaces
π Comprehensive Documentation:
- Enhanced README with OO patterns and configuration examples
- Repository, Factory, and Dependency Injection patterns
- Multi-tenant configuration examples
- All code examples automatically validated
π§ͺ Complete Test Coverage:
test_readme_examples.pywith 18 test classes- Every README code example automatically validated
- 150+ tests with 85%+ coverage
- Prevents documentation regression
π§ Self-Contained Imports:
- Re-export UUID, uuid5, NAMESPACE_DNS from main package
- Eliminates need for separate uuid module imports
- Clean developer experience:
from uuid_forge import UUID
π Production Ready
- β All tests passing with comprehensive coverage
- β Type checking clean (mypy)
- β Backward compatibility preserved
- β Zero-coordination UUID generation across storage systems
- β Secure cryptographic salt support
- β CLI included for salt generation and configuration
π¦ Installation
pip install uuid-forgeπ― Perfect For
- Microservices architectures needing consistent IDs
- Multi-storage systems (Postgres + S3 + Redis + QDrant + MinIO)
- Zero-coordination design patterns
- Deterministic testing scenarios
- Data migration with consistent IDs
Made with β€οΈ for developers who value simplicity and determinism