MarcusMedina.JsonFileWrapper 2.0.1

MarcusMedina.JsonFileWrapper

JSON file wrapper with Save and load functions for .NET 10+

Back in 2009, I wanted my students to truly understand the power of OOP — not just the theory, but the feeling of writing a helper class that quietly does the heavy lifting so the rest of your code can breathe. I created JsonFileWrapper in that classroom: a simple wrapper that hides all the boilerplate of reading and writing JSON files behind a clean API. What started as a teaching example has since grown into a proper NuGet package, upgraded through the years from Newtonsoft.Json to the built-in System.Text.Json. No external dependencies. Just good OOP.

Installation

dotnet add package JsonFileWrapper

Breaking Changes (v1.1.0)

.NET 10.0 Minimum Required

This version upgrades the target framework from .NET 8.0 to .NET 10.0.

Old:

<TargetFramework>net8.0</TargetFramework>

New:

<TargetFramework>net10.0</TargetFramework>

Namespace (unchanged):

using MarcusMedinaPro.JsonFileWrapper;

See CHANGELOG.md for complete migration guide.

Status

This package is under active development.

Documentation

• Getting Started
• API Overview
• Advanced Usage

Development

cd csharp
dotnet build -c Release

Package integrity

All releases are signed with cosign (Sigstore keyless signing).

To verify a downloaded package, download both the .nupkg and its .sigstore.json bundle from the GitHub Release, then run:

cosign verify-blob <package.nupkg> \
  --bundle <package.nupkg.sigstore.json> \
  --certificate-identity-regexp "https://github.com/MarcusMedinaPro/.*/release.yml" \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Expected output: Verified OK

Made for Curious Minds

This library was built with students in mind — not as a black box to copy and paste, but as a real-world example of how clean, purposeful code is written and shared.

Whether you're discovering C# for the first time, need a reliable helper for your school project, or are simply trying to fall in love with writing code — you're exactly who this was made for.

The source is open. Read it, fork it, break it, improve it. That's the whole point.

And if this library saved you an afternoon, or made something click that didn't before — that's everything.

Non-students are equally welcome. Good code doesn't care about your diploma.

⭐ If this helped you, consider starring the project on GitHub — it helps other students find it too.

💬 Have an idea, a feature request, or just want to say hi? Open an issue on GitHub — I'd love to hear from you.