Incrementele migraties voor uw JSON-bestanden

Werk JSON-configuratiebestanden veilig bij zonder installatiespecifieke waarden te overschrijven. Schrijf migraties in C# en voer ze uit in de juiste volgorde.

dotnet add package JsonMigrations
Bekijk op GitHub Bekijk op NuGet

.NET 6.0 of hoger vereist

JsonMigrations

.NET 6+

Platform

MIT

Open source licentie

NuGet

Pakketbeheer

v3.0

Laatste versie

Hoe werkt het?

Drie stappen om uw JSON-bestanden veilig bij te werken.

Stap 1

Configureer

Stel het gedrag in bij fouten, ongeldige JSON of ontbrekende bestanden. Standaardwaarden werken direct uit de doos.

Stap 2

Schrijf migraties

Maak C#-klassen die IJsonMigration implementeren. Elke migratie heeft een volgorde en een sleutel om gerelateerde migraties te groeperen.

Stap 3

Voer uit

Roep Migrate() aan met een sleutel en bestandspaden. Alleen nieuwe migraties worden uitgevoerd — eerder toegepaste migraties worden automatisch overgeslagen.

Waarom JsonMigrations?

Incrementele updates

Migraties worden in volgorde uitgevoerd en bijgehouden. Bij een volgende run worden alleen nieuwe migraties toegepast, zodat bestaande wijzigingen behouden blijven.

Foutafhandeling

Kies per situatie: negeer fouten, gooi een uitzondering, of herstel het bestand naar de originele staat. U bepaalt het gedrag.

Flexibele configuratie

Configureer serialisatie-opties, gedrag bij ongeldige JSON en acties voor ontbrekende bestanden. Alles is optioneel met verstandige standaardwaarden.

Automatische detectie

Registreer migraties per assembly of namespace. De bibliotheek vindt en ordent alle migraties automatisch.

Behoudt bestaande waarden

Installatie-specifieke waarden zoals connection strings en API-sleutels blijven onaangetast. Alleen de wijzigingen uit uw migraties worden toegepast.

Open source

Volledig open source onder de MIT-licentie. Bekijk de broncode, draag bij of pas het aan voor uw eigen behoeften.

Snel aan de slag

In drie stappen van installatie tot werkende migraties.

1. Installeer het NuGet-pakket

dotnet add package JsonMigrations

2. Schrijf een migratie

public class AddConnectionString : IJsonMigration
{
    public int Order => 0;
    public string MigrationKey => "AppSettings";

    public void Up(JsonObject jsonObject, JsonSerializerOptions options)
    {
        jsonObject.TryAdd("ConnectionString", "Server=localhost");
    }
}

3. Voer de migraties uit

JsonMigrator.AddJsonMigrations(typeof(AddConnectionString).Assembly);
JsonMigrator.Migrate("AppSettings", "appsettings.json");

Klaar om uw JSON-bestanden te beheren?

Installeer JsonMigrations via NuGet en schrijf uw eerste migratie in enkele minuten.

dotnet add package JsonMigrations
Bekijk op NuGet Bekijk broncode op GitHub