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://taiizor.github.io/UUID 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.