Skip to content

UUID v1.0.5

Latest
Compare
Choose a tag to compare
@Taiizor Taiizor released this 18 Dec 17:00
· 1 commit to develop since this release

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
  • 🌈 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


Thank you to all contributors who helped make this release possible! 👌

For bug reports and feature requests, please use our GitHub Issues page.