Shardis.Migration 0.1.0-prerelease0086

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher.
This is a prerelease version of Shardis.Migration.
There is a newer version of this package available.
See the version list below for details. 
dotnet add package Shardis.Migration --version 0.1.0-prerelease0086
                    


                    

                
NuGet\Install-Package Shardis.Migration -Version 0.1.0-prerelease0086
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="Shardis.Migration" Version="0.1.0-prerelease0086" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Shardis.Migration" Version="0.1.0-prerelease0086" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Shardis.Migration" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add Shardis.Migration --version 0.1.0-prerelease0086
                    


                    

                
#r "nuget: Shardis.Migration, 0.1.0-prerelease0086"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#:package Shardis.Migration@0.1.0-prerelease0086
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package. 
#addin nuget:?package=Shardis.Migration&version=0.1.0-prerelease0086&prerelease
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Shardis.Migration&version=0.1.0-prerelease0086&prerelease
                    


                            Install as a Cake Tool

Shardis.Migration

Key migration execution primitives for Shardis. This package contains the executor, planner abstractions, checkpoint store contracts, and reference in-memory implementations used for tests and prototypes.

NuGet Downloads License

Install

dotnet add package Shardis.Migration --version 0.1.*

When to use

  • You need a deterministic, idempotent migration executor for moving keys between topologies.
  • You want reference ICheckpointStore implementations for tests and local runs.

What’s included

  • Planner models: MigrationPlan<TKey>, SegmentMove<TKey> and related helpers.
  • ShardMigrationExecutor<TKey> — orchestrates copy → verify → swap with checkpoints and metrics hooks.
  • ICheckpointStore and InMemoryCheckpointStore reference implementation.

Quick start

// register migration runtime
services.AddShardisMigration<string>();

var planner = services.GetRequiredService<IShardMigrationPlanner<string>>();
var executor = services.GetRequiredService<ShardMigrationExecutor<string>>();

var plan = await planner.CreatePlanAsync(fromSnapshot, toSnapshot, CancellationToken.None);
var result = await executor.ExecuteAsync(plan, progress: null, CancellationToken.None);

Integration notes

  • For long-running migrations prefer segmented plans and a durable ICheckpointStore (SQL/Cosmos/Redis) to bound memory and enable resume.

Samples & tests

Contributing

License

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on Shardis.Migration:

Package Downloads
Shardis.Migration.Marten

Marten migration provider for Shardis (document data mover + checksum verification).
Shardis.Migration.EntityFrameworkCore

Entity Framework Core migration provider for Shardis (data mover + verification strategies).
Shardis.Migration.Sql

Durable SQL-backed components (checkpoint store, shard map + history) for Shardis migration.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.2.2 269 9/11/2025
0.2.2-prerelease0001 266 9/11/2025
0.2.1 254 9/10/2025
0.2.1-prerelease0001 255 9/9/2025
0.2.0 241 9/8/2025
0.1.0-prerelease0098 141 4/13/2026
0.1.0-prerelease0097 151 1/15/2026
0.1.0-prerelease0094 322 12/15/2025
0.1.0-prerelease0093 297 12/15/2025
0.1.0-prerelease0092 308 12/15/2025
0.1.0-prerelease0091 232 12/14/2025
0.1.0-prerelease0090 514 12/9/2025
0.1.0-prerelease0086 222 9/7/2025
0.1.0-prerelease0085 231 9/7/2025
0.1.0-prerelease0084 223 8/31/2025
0.1.0-prerelease0083 219 8/31/2025
0.1.0-prerelease0082 266 8/28/2025
0.1.0-prerelease0075 279 8/28/2025
0.1.0-prerelease0067 273 8/27/2025

Initial release. Full notes: https://github.com/veggerby/shardis/blob/main/CHANGELOG.md#010---2025-08-25