Skip to content

v0.1.0: Clean Namespace API and Production-Ready Features

Choose a tag to compare

@darth-veitcher darth-veitcher released this 01 Oct 10:30
· 21 commits to main since this release

πŸŽ‰ 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.py with 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