# json_serializable 0.5.1 Generates utilities to aid in serializing to/from JSON. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.ir flutter pub add 'json_serializable:0.5.1' ``` Published: 2018-05-10T15:21:12.178838Z Expected archive SHA-256: 555278a03b1beb4ef188f8ce71de6dfc5c9b9e6ae561ebecd03ef2136931b474 Available in cache; verification: upstream_checksum ## Direct dependencies - analyzer: >=0.29.10 <0.32.0 - build: >=0.9.0 <0.13.0 - build_config: ^0.2.6 - json_annotation: >=0.2.4 <0.2.5 - meta: ^1.1.0 - path: ^1.3.2 - source_gen: >=0.8.1 <0.9.0 ## Package README (untrusted upstream documentation) [![Build Status](https://travis-ci.org/dart-lang/json_serializable.svg?branch=master)](https://travis-ci.org/dart-lang/json_serializable) Provides [source_gen] `Generator`s to create code for JSON serialization and deserialization. See the [example] package to understand how to configure your project. ## User defined and generated code Given a library `example.dart` with an `Person` class annotated with `@JsonSerializable()`: ```dart import 'package:json_annotation/json_annotation.dart'; part 'example.g.dart'; @JsonSerializable() class Person extends Object with _$PersonSerializerMixin { final String firstName; final String lastName; final DateTime dateOfBirth; Person({this.firstName, this.lastName, this.dateOfBirth}); factory Person.fromJson(Map json) => _$PersonFromJson(json); } ``` Building creates the corresponding part `example.g.dart`: ```dart part of 'example.dart'; Person _$PersonFromJson(Map json) => new Person( firstName: json['firstName'] as String, lastName: json['lastName'] as String, dateOfBirth: json['dateOfBirth'] == null ? null : DateTime.parse(json['dateOfBirth'] as String)); abstract class _$PersonSerializerMixin { String get firstName; String get lastName; DateTime get dateOfBirth; Map toJson() => { 'firstName': firstName, 'lastName': lastName, 'dateOfBirth': dateOfBirth?.toIso8601String() }; } ``` [example]: https://github.com/dart-lang/json_serializable/blob/master/example [source_gen]: https://pub.dartlang.org/packages/source_gen ## Changelog ## 0.5.1 * Support new `fromJson` and `toJson` fields on `JsonKey`. * Use `log` exposed by `package:build`. This requires end-users to have at least `package:build_runner` `^0.8.2`. * Updated minimum `package:source_gen` dependency to `0.8.1` which includes improved error messages. ## 0.5.0 * **BREAKING** Removed deprecated support for `require_library_directive` / `requireLibraryDirective` in `build_runner` configuration. * **BREAKING** Removed the deprecated `generators.dart` library. * **BREAKING** Removed `jsonPartBuilder` function from public API. * Support the latest `package:source_gen`. * Private and ignored fields are now excluded when generating serialization and deserialization code by using `@JsonKey(ignore: true)`. * Throw an exception if a private field or an ignored field is referenced by a required constructor argument. * More comprehensive escaping of string literals. ### `package:json_serializable/type_helper.dart` * **Breaking** The `nullable` parameter on `TypeHelper.serialize` and `.deserialize` has been removed. It is now exposed in `SerializeContext` and `DeserializeContext` abstract classes as a read-only property. * **Potentially Breaking** The `metadata` property on `SerializeContext` and `DeserializeContext` is now readonly. This would potentially break code that extends these classes – which is not expected. ## 0.4.0 * **Potentially Breaking** Inherited fields are now processed and used when generating serialization and deserialization code. There is a possibility that the generated code may change in undesired ways for classes annotated for `v0.3`. * Avoid unnecessary braces in string escapes. * Use single quotes when generating code. ## 0.3.2 * The `require_library_directive` option now defaults to `false`. The option will be removed entirely in `0.4.0`. ## 0.3.1+2 * Support the latest version of the `analyzer` package. ## 0.3.1+1 * Expanded `package:build` support to allow version `0.12.0`. ## 0.3.1 * Add a `build.yaml` so the builder can be consumed by users of `build_runner` version 0.7.0. * Now requires a Dart `2.0.0-dev` release. ## 0.3.0 * **NEW** top-level library `json_serializable.dart`. * Replaces now deprecated `generators.dart` to access `JsonSerializableGenerator` and `JsonLiteralGenerator`. * Adds the `jsonPartBuilder` function to make it easy to create a `PartBuilder`, without creating an explicit dependency on `source_gen`. * **BREAKING** `UnsupportedTypeError` added a new required constructor argument: `reason`. * **BREAKING** The deprecated `annotations.dart` library has been removed. Use `package:json_annotation` instead. * **BREAKING** The arguments to `TypeHelper` `serialize` and `deserialize` have changed. * `SerializeContext` and `DeserializeContext` (new classes) are now passed instead of the `TypeHelperGenerator` typedef (which has been deleted). * `JsonSerializableGenerator` now supports an optional `useWrappers` argument when generates and uses wrapper classes to (hopefully) improve the speed and memory usage of serialization – at the cost of more code. **NOTE**: `useWrappers` is not guaranteed to improve the performance of serialization. Benchmarking is recommended. * Make `null` field handling smarter. If a field is classified as not `nullable`, then use this knowledge when generating serialization code – even if `includeIfNull` is `false`. ## 0.2.5 * Throw an exception if a duplicate JSON key is detected. * Support the `nullable` field on the `JsonSerializable` class annotation. ## 0.2.4+1 * Throw a more helpful error when a constructor is missing. ## 0.2.4 * Moved the annotations in `annotations.dart` to `package:json_annotations`. * Allows package authors to release code that has the corresponding annotations without requiring package users to inherit all of the transitive dependencies. * Deprecated `annotations.dart`. ## 0.2.3 * Write out `toJson` methods more efficiently when the first fields written are not intercepted by the null-checking method. ## 0.2.2+1 * Simplify the serialization of `Map` instances when no conversion is required for `values`. * Handle `int` literals in JSON being assigned to `double` fields. ## 0.2.2 * Enable support for `enum` values. * Added `asConst` to `JsonLiteral`. * Improved the handling of Dart-specific characters in JSON strings. ## 0.2.1 * Upgrade to `package:source_gen` v0.7.0 ## 0.2.0+1 * When serializing classes that implement their own `fromJson` constructor, honor their constructor parameter type. ## 0.2.0 * **BREAKING** Types are now segmented into their own libraries. * `package:json_serializable/generators.dart` contains `Generator` implementations. * `package:json_serializable/annotations.dart` contains annotations. This library should be imported with your target classes. * `package:json_serializable/type_helpers.dart` contains `TypeHelper` classes and related helpers which allow custom generation for specific types. * **BREAKING** Generation fails for types that are not a JSON primitive or that do not explicitly supports JSON serialization. * **BREAKING** `TypeHelper`: * Removed `can` methods. Return `null` from `(de)serialize` if the provided type is not supported. * Added `(de)serializeNested` arguments to `(de)serialize` methods allowing generic types. This is how support for `Iterable`, `List`, and `Map` is implemented. * **BREAKING** `JsonKey.jsonName` was renamed to `name` and is now a named parameter. * Added support for optional, non-nullable fields. * Added support for excluding `null` values when generating JSON. * Eliminated all implicit casts in generated code. These would end up being runtime checks in most cases. * Provide a helpful error when generation fails due to undefined types. ## 0.1.0+1 * Fix homepage in `pubspec.yaml`. ## 0.1.0 * Split off from [source_gen](https://pub.dartlang.org/packages/source_gen). * Add `/* unsafe */` comments to generated output likely to be unsafe. * Support (de)serializing values in `Map`. * Fix ordering of fields when they are initialized via constructor. * Don't use static members when calculating fields to (de)serialize.