dart_mappable_builder 2.0.0-dev.4

dart_mappable_builder: ^2.0.0-dev.4 copied to clipboard

Fixed various issues with the copyWith implementation for inherited classes.

CopyWith now works on a wider range of parameters and is completely subtype-safe. Specifically a parameter of static type A but concrete type B extends A keeps it concrete type through any .copyWith call, including lists and maps.

Added support for inherited copyWith implementations.

When using polymorphism or any inheritance, you will now be able to call .copyWith on the superclass to change any field that is inherited by all sub-classes. The concrete subclass types will be retained through such a .copyWith call and also respects generics.

  // with `class A` and `class B extends A`
  A a = B(); // static type A, dynamic type B
  
  // signature will be `A copyWith()`, so static type A
  A a2 = a.copyWith(); 
  
  // this will still resolve to a dynamic type of B
  assert(a2 is B);

Classes using this must mixin the newly generated <MyClass>Mixin. More details here.

Depend on analyzer: ^5.0.0

Imports in the generated code are now prefixed to allow for same names in different libs.

Improved encoding of generic instances.

Any encoding method (Mapper.toValue, Mapper.toMap, Mapper.toJson) now also takes a generic type argument T, which must be an assignable type for the passed value. When T and the values runtimeType match exactly, it is encoded as normal. If not, a __type property is added with the specific type of value. This can then be used to decode the value without specifying a target type.

  // this will encode normal without '__type'
  Mapper.toValue<MyClass>>(myClassInstance);
  Mapper.toValue(MyClass()); // works because of type inference
  Mapper.toValue<MyGenericClass<int>>(myGenericClassInstance);
  
  // this will add the '__type' property
  Mapper.toValue<dynamic>(myClassInstance);
  Mapper.toValue(someDynamicVariable); // where type inference does not work
  Mapper.toValue<MyGenericClass>(myGenericClassInstance); // because the instance has a specific type

• Choose between ValuesMode.named and ValuesMode.indexed for automatic generation of encoded values
• Use @MappableValue(myCustomValue) on an enum value to specify a custom encoded value
• Deprecated the String toStringValue() extension method in favor of the more general dynamic toValue()