jsonut 0.3.0

jsonut: ^0.3.0 copied to clipboard

Breaking change: Removed JsonAny.tryFrom, which was at best, confusing as it accepted a nullable value and returned a nullable value. Either use JsonAny.from or as JsonAny.

Breaking change: <JsonAny>.as<T>() no longer is bound to JsonValue. This avoids cases where the type would be inferred as Never because it was something like int, which should be fine.

Added <JsonObject>.deepGet to get nested values:

final object = JsonObject.parse('{"name": {"first": "John", "last": "Doe"}}');
final firstName = object.deepGet(['name', 'first']).string();

Improved some error messages.

Added .as and .asOrNull methods to JsonAny for inference casting:

final class Employee {
  const Employee({required this.name});
  final String name;
}

final object = JsonObject.parse('{"name": "John Doe"}');
final employee = Employee(name: object['name'].as());

Breaking change: <JsonAny>.{type}Or renamed to <JsonAny>.{type}OrNull to better reflect the behavior of the method, and be idiomatic with other Dart APIs:

- print(any.stringOr('name'));
+ print(any.stringOrNull('name'));

Breaking change: <JsonType>.parse only throws a FormatException if the input is not valid JSON, and an ArgumentError if the input is not the expected type. This makes the behavior more consistent with other Dart APIs.

Breaking change: Reduced the API of JsonObject to remove .{type}() methods in favor of just providing a custom [] operator tht returns JsonAny instances.

- print(person.string('name'));
+ print(person['name'].string());

Saving roughly ~2 characters per call wasn't worth the additional complexity.