👁 Image
OutWit.Common.MemoryPack 1.1.4

OutWit.Common.MemoryPack

OutWit.Common.MemoryPack is a .NET library that provides a collection of helper methods and pre-configured, serializable types to simplify and accelerate development with the MemoryPack serialization library. It offers extension methods for common tasks, custom formatters, and a suite of ready-to-use data structures for various domain needs.

Key Features

• Fluent Extension Methods: Simplifies serializing, deserializing, and cloning objects.
• File I/O Helpers: Easily export and load collections of objects to and from files, both synchronously and asynchronously.
• Custom Formatter for PropertyChangedEventArgs: Includes a built-in formatter for System.ComponentModel.PropertyChangedEventArgs, which is automatically registered and essential for MVVM applications.
• Serializable-Ready Types: A collection of [MemoryPackable] types designed to be used directly in your data models:
  • Collections: MemoryPackMap<TKey, TValue> and MemoryPackSet<TValue> for serializable, read-only collections.
  • Messaging: MemoryPackMessage and MemoryPackMessageWith<TData> for creating standardized DTOs.
  • Domain Primitives: Includes MemoryPackRange<TValue>, MemoryPackRangeSet<TValue>, and MemoryPackValueInSet<TValue> for representing common data constraints.
• Easy Configuration: A simple registration pattern to add your own custom formatters.
• Cross-Platform Support: Targets .NET 6, 7, 8, and 9.

Installation

Install the package from NuGet using the .NET CLI:

dotnet add package OutWit.Common.MemoryPack

Usage

Basic Serialization and Deserialization

The MemoryPackUtils class provides convenient extension methods.

using OutWit.Common.MemoryPack;
using MemoryPack;

[MemoryPackable]
public partial class User
{
 public string Name { get; set; }
 public int Age { get; set; }
}

var user = new User { Name = "John Doe", Age = 30 };

// Serialize the object to bytes
byte[] bytes = user.ToMemoryPackBytes();

// Deserialize the bytes back to an object
User deserializedUser = bytes.FromMemoryPackBytes<User>();

Cloning an Object

You can easily create a deep clone of any [MemoryPackable] object.

// Clone the user object
[cite_start]User clonedUser = user.MemoryPackClone();

Exporting and Loading Collections

Save a collection to a file and load it back.

using OutWit.Common.MemoryPack.Ranges;

var ranges = new List<MemoryPackRange<int>>
{
 new(1, 10),
 new(20, 30)
};

// Export the list to a file
await ranges.ExportAsMemoryPackAsync("ranges.bin"); 

// Load the list from the file
IReadOnlyList<MemoryPackRange<int>> loadedRanges = await MemoryPackUtils.LoadAsMemoryPackAsync<MemoryPackRange<int>>("ranges.bin");

Registering a Custom Formatter

You can register your own custom MemoryPackFormatter during application startup.

// Your custom formatter
public class MyCustomTypeFormatter : MemoryPackFormatter<MyCustomType>
{
 // ... implementation
}

// Register it
MemoryPackUtils.Register(options => 
{
 options.Register(new MyCustomTypeFormatter());
});

License

Licensed under the Apache License, Version 2.0. See LICENSE.

Attribution (optional)

If you use OutWit.Common.MemoryPack in a product, a mention is appreciated (but not required), for example: "Powered by OutWit.Common.MemoryPack (https://ratner.io/)"_.

Trademark / Project name

"OutWit" and the OutWit logo are used to identify the official project by Dmitry Ratner.

You may:

• refer to the project name in a factual way (e.g., "built with OutWit.Common.MemoryPack");
• use the name to indicate compatibility (e.g., "OutWit.Common.MemoryPack-compatible").

You may not:

• use "OutWit.Common.MemoryPack" as the name of a fork or a derived product in a way that implies it is the official project;
• use the OutWit.Common.MemoryPack logo to promote forks or derived products without permission.