MIT licensed by Felix Paulusma
Maintained by [email protected]
This version can be pinned in stack with:safe-json-0.1.0@sha256:001093e9673b094729f6bf86b2bfec1515a6e0ee0236d89299318101e657979f,3536

Module documentation for 0.1.0

This library aims to make the updating of JSON formats or contents, while keeping backward compatibility, as painless as possible. The way this is achieved is through versioning and defined migration functions to migrate older (or newer) versions to the one used.

The library mainly consists of two classes:

  • SafeJSON a: Defines the version of a and if (and how) it is migratable.

  • Migrate a: Defines the data type (MigrateFrom a) that can be migrated to a and how to migrate from that type.

Using these two classes, JSON serialized data types will stay parsable, even after format changes.

For a more in-depth explanation and examples, please see the README at


Changelog for safe-json


  • First release. Includes:
    • Data.Aeson.Safe
    • Data.SafeJSON
    • Data.SafeJSON.Instances
    • Data.SafeJSON.Internal
    • Data.SafeJSON.Test