Skip to content

Releases: Taiizor/UUID

UUID v1.1.0

08 Jan 13:21
Compare
Choose a tag to compare

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


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

07 Jan 17:48
Compare
Choose a tag to compare

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


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

04 Jan 00:02
Compare
Choose a tag to compare

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


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

23 Dec 02:30
Compare
Choose a tag to compare

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


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

18 Dec 17:00
Compare
Choose a tag to compare

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://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


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

18 Dec 06:11
Compare
Choose a tag to compare

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


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

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