Releases: Taiizor/UUID
UUID v1.1.0
UUID v1.1.0 - MessagePack Integration & Multi-Format Serialization ⚡
Modern UUID Generator for .NET - Now with comprehensive MessagePack support and enhanced serialization capabilities
About This Release
UUID v1.1.0 introduces full MessagePack serialization support, complementing existing System.Text.Json and Newtonsoft.Json integrations. This release focuses on high-performance binary serialization while maintaining our commitment to security and efficiency.
Major Improvements
-
📦 MessagePack Integration:
- Full MessagePack serialization support
- Efficient binary format representation
- Thread-safe implementation
- Comprehensive error handling
-
🚀 Performance Features:
- Optimized binary serialization
- Minimal memory allocations
- Efficient byte array handling
- Compact data representation
-
🔄 Serialization Architecture:
- Custom UUIDFormatter implementation
- Seamless MessagePack resolver integration
- Consistent cross-platform behavior
- Robust error handling
Technical Improvements
- 🛧 Format Implementation:
- 16-byte compact binary representation
- Efficient timestamp and random value handling
- Zero-allocation deserialization path
- Comprehensive format validation
Installation
Install-Package UUID.Serialization.MessagePack
Key Features (Maintained)
- 🛡️ True Cryptographic Security: Using secure random generation
- 🚀 High Performance: Optimized with batched operations
- 🔐 Thread Safe: Enhanced thread isolation
- 🐾 Memory Efficient: Optimized buffer usage
- 🔘 Comprehensive Documentation: Detailed security and performance guidelines
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Special thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
UUID v1.0.9
UUID v1.0.9 - Advanced Security Comparison & Parallel Generation 📐
Modern UUID Generator for .NET - Now featuring secure equality comparisons and efficient parallel UUID generation capabilities
About This Release
UUID v1.0.9 introduces secure equality comparison methods and powerful parallel UUID generation features, enhancing both security and performance for bulk UUID operations.
Major Improvements
-
📐 Secure Equality Comparisons:
- New
SecureEquals
methods for timing-attack resistant comparisons - Multiple overloads for flexible usage
- Constant-time implementation for enhanced security
- Added
UUID.Empty
for null-object pattern support
- New
-
⚄ Parallel Generation Features:
- New
GenerateOrdered
methods for bulk UUID creation - Parallel filling of UUID arrays with configurable threshold
- Optional start time specification for ordered generation
- Thread-safe implementation for concurrent operations
- New
-
🖧 Array Operations:
- Efficient bulk UUID generation
- Ordered sequence generation with timestamp support
- Parallel processing for large arrays
- Optimized memory usage
Technical Improvements
- 📐 Security Features:
- Constant-time comparison methods
- Protected against timing attacks
- Thread-safe parallel operations
- Secure ordered generation
Installation
Install-Package UUID
Key Features (Maintained)
- 🛡️ True Cryptographic Security: Using secure random generation
- 🚀 High Performance: Optimized with batched operations
- 🔐 Thread Safe: Enhanced thread isolation
- 🐾 Memory Efficient: Optimized buffer usage
- 🔘 Comprehensive Documentation: Detailed security and performance guidelines
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Special thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
UUID v1.0.8
UUID v1.0.8 - Enhanced Cryptographic Security & Performance 🛡️
Modern UUID Generator for .NET - Now with improved cryptographic security and optimized performance through batched random generation
About This Release
UUID v1.0.8 introduces significant security and performance improvements in random number generation, ensuring both cryptographic security and high performance through an innovative batched buffer approach.
Major Improvements
-
🛡️ Enhanced Cryptographic Security:
- Replaced PRNG with true cryptographic random generation
- Direct use of RandomNumberGenerator for all UUID components
- Improved random value distribution
- Maintained full cryptographic security
-
🚀 Performance Optimizations:
- Implemented efficient batched random generation
- Reduced cryptographic operation calls by 128x
- Thread-local buffer optimization
- Minimized memory allocations
-
🔒 Security Architecture:
- Thread-safe buffer management
- Secure random byte generation
- Optimized variant bit handling
- Enhanced thread isolation
Technical Improvements
- 📊 Buffer Management:
- 1024-byte thread-local secure random buffer
- Efficient buffer position tracking
- Optimized memory reuse
- Improved thread safety
Installation
Install-Package UUID
Key Features (Maintained)
- 🛡️ True Cryptographic Security: Using secure random generation
- 🚀 High Performance: Optimized with batched operations
- 🔐 Thread Safe: Enhanced thread isolation
- 🐾 Memory Efficient: Optimized buffer usage
- 🔘 Comprehensive Documentation: Detailed security and performance guidelines
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Special thanks to our community for security feedback and performance optimization suggestions! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
UUID v1.0.7
UUID v1.0.7 - Compact UUIDs 🍯
Modern UUID Generator for .NET - Now with enhanced compact UUID generation and improved performance
About This Release
UUID v1.0.7 introduces enhanced compact UUID generation capabilities, offering better uniqueness guarantees and improved performance. This release focuses on providing more efficient UUID representations while maintaining security and reliability.
New Features
- 🍯 Enhanced Compact UUIDs:
- New
NewCompact()
method for 12-character UUIDs - Time-based ordering with
NewCompactWithTime()
- Improved uniqueness guarantees
- Better sortability support
- New
- 🚀 Performance Improvements:
- Optimized bit manipulation operations
- Improved memory usage efficiency
- Enhanced thread synchronization
- Reduced memory allocations
- 🔈 Security Enhancements:
- Enhanced random value generation
- Improved thread-safety implementations
- Additional input validation
- Better error handling
Documentation Updates
- 🔈 Added detailed compact UUID usage examples
- 🍯 Added uniqueness guarantees documentation
- 🚀 Updated performance recommendations
- 📊 Improved code organization and readability
- 🔞 Enhanced XML documentation coverage
- 💡 More descriptive error messages
- 🔚 Updated API reference documentation
Installation
Install-Package UUID
Quick Example
// Generate compact UUID (12 characters)
var compactId = UUID.NewCompact();
Console.WriteLine(compactId.ToString()); // Compact format
// Generate time-based compact UUID
var timestamp = DateTimeOffset.UtcNow.ToUnixTimeMilliseconds();
var timeBasedId = UUID.NewCompactWithTime(timestamp);
Console.WriteLine(timeBasedId.ToString()); // Time-based compact format
Key Features (Maintained)
- 🚀 High Performance: Optimized for speed with zero-allocation operations
- 🔈 Secure by Default: Cryptographically secure random number generation
- 🔐 Thread Safe: Safe for concurrent operations
- 🐾 Memory Efficient: Optimized memory usage
- 🔘 Comprehensive Documentation: Detailed API reference and examples
- 🔘 Easy Integration: Simple to integrate with existing .NET projects
Documentation
The documentation is available at https://uuid.soferity.com featuring:
- New compact UUID generation guides
- Updated API reference
- Performance optimization guidelines
- Best practices for UUID generation
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Thank you to all contributors who helped make this release possible! 🎉
For bug reports and feature requests, please use our GitHub Issues page.
UUID v1.0.5
UUID v1.0.5 - Serialization Support 📄
Modern UUID Generator for .NET - Now with comprehensive serialization support for both System.Text.Json and Newtonsoft.Json
About This Release
UUID v1.0.5 introduces robust serialization support through two dedicated packages, making it even easier to integrate UUID with your JSON serialization needs. This release maintains our commitment to high performance and security while adding seamless serialization capabilities.
New Features
- 📄 Serialization Support:
- System.Text.Json integration via
UUID.Serialization.System
- Newtonsoft.Json integration via
UUID.Serialization.Newtonsoft
- System.Text.Json integration via
- 🌈 Performance Benchmarks: New benchmark projects for serialization performance testing
- 📈 Enhanced Documentation: Comprehensive serialization guides and examples
- 🧧 Easy Integration: Simple converter setup for both serialization libraries
Key Features (Maintained)
- 🌠 High Performance: Optimized for speed with zero-allocation operations
- 🛷 Secure by Default: Cryptographically secure random number generation
- 📄 Thread Safe: Safe for concurrent operations in multi-threaded environments
- 🐆 Memory Efficient: Zero-allocation options for high-throughput scenarios
-0📈 Comprehensive Documentation: Detailed API reference and examples - 🛷 Easy Integration: Simple to integrate with existing .NET projects
Documentation Updates
- 📡 Added complete serialization documentation
- 📘 Added serialization examples and best practices
- 🌈 Added serialization performance benchmarks
- 🛰 Added implementation guides for both serialization packages
- 📈 Updated API reference with serialization converters
- 🧧 Added examples for common serialization scenarios
Installation
Core Package
Install-Package UUID
Serialization Packages
# For System.Text.Json support
Install-Package UUID.Serialization.System
# For Newtonsoft.Json support
Install-Package UUID.Serialization.Newtonsoft
Quick Example
// System.Text.Json
var options = new JsonSerializerOptions();
options.Converters.Add(new UUIDConverter());
var uuid = UUID.New();
string json = JsonSerializer.Serialize(uuid, options);
// Newtonsoft.Json
var settings = new JsonSerializerSettings();
settings.Converters.Add(new UUIDConverter());
string json = JsonConvert.SerializeObject(uuid, settings);
Documentation
The documentation is available at https://uuid.soferity.com featuring:
- New serialization guides and examples
- Updated API reference with serialization support
- Performance benchmarks including serialization
- Best practices for JSON integration
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Thank you to all contributors who helped make this release possible! 👌
For bug reports and feature requests, please use our GitHub Issues page.
UUID v1.0.2
UUID v1.0.2 - Initial Release 🎉
Modern UUID Generator for .NET - High-performance, secure, and thread-safe UUID implementation
About UUID
UUID is a modern, high-performance UUID (Universally Unique Identifier) generator designed specifically for the .NET ecosystem. It provides a robust implementation focusing on security, performance, and thread safety, making it ideal for distributed systems and high-throughput applications.
Key Features
- 🎠 High Performance: Optimized for speed with zero-allocation operations
- 🛧 Secure by Default: Cryptographically secure random number generation
- 🔄 Thread Safe: Safe for concurrent operations in multi-threaded environments
- 💆 > Memory Efficient: Zero-allocation options for high-throughput scenarios
- 📘 Comprehensive Documentation: Detailed API reference and examples
- 🛧 Easy Integration: Simple to integrate with existing .NET projects
Documentation Updates
- 📱 Added responsive mobile-friendly documentation
- 🏈 Improved documentation UI/UX with consistent styling
- 📒 Added comprehensive code examples and API reference
- 💎 @ted search functionality in documentation
- 📘 Added performance metrics and benchmarks
- 🛧 Added security guidelines and best practices
⚠️ Added FAQ section for common questions
Technical Documentation
The documentation is now available at https://uuid.soferity.com featuring:
- Detailed getting started guide
- API reference documentation
- Code examples and usage patterns
- Performance benchmarks
- Security considerations
- Frequently asked questions
Installation
Install-Package UUID
Quick Example
var id = new UUID();
// Different string formats
Console.WriteLine(id.ToString()); // Standard format
Console.WriteLine(id.ToBase32()); // Base32 format
Console.WriteLine(id.ToBase64()); // Base64 format
// Get raw bytes
byte[] bytes = id.ToByteArray();
Connect With Us
- Discord: Join our community
- Stack Overflow: #uuid
Thank you to all contributors who helped make this initial release possible! 👉
For bug reports and feature requests, please use our GitHub Issues page.