Uses Dart Build System builders for generating boilerplate code.

So far this generator generates code when it encounters classes annotated with adeptannotations.

Clone Generator

This generator creates a function that returns a new instance of the annotated ClassType by creating a copy of the currentData and replacing its fields with the newData

Notes:

1. The function will use the values from newData, in case of null then currentData values will be used.
2. If mergeParam is true then currentData will mirror the new instance returned.
3. If @CloneKey(ignore: true) annotation is used in some field, then that specific field will not be taking into account when cloning
4. If @CloneKey(forceCurrentData: true) annotation is used in some field, then currentData value will be forced for the specified field no matter it's nullability
5. If @CloneKey(forceNewData: true) annotation is used in some field, then newData value will be forced for the specified field no matter it's nullability

Diff Generator

This generator creates a function that returns a new instance of the annotated ClassType with the fields that are different different between currentData and newData

Notes:

1. Each field should implement a proper (==) function to ensure that every field is properly compared, this will be specially necessary for Object fields.
2. newData takes precedence over currentData, this means that when comparing if a field is different then the newData field will be the one in the resulting instance
3. If no field are different then resulting instance will be null, this means no difference at all.
4. If @DiffKey(ignore: true) annotation is used in some field, then that specific field will be null in the resulting instance
5. If @DiffKey(forceCurrentData: true) annotation is used in some field, then currentData value will be forced for the specified field no matter it's nullability
6. If @DiffKey(forceNewData: true) annotation is used in some field, then newData value will be forced for the specified field no matter it's nullability

Example:

import 'package:adeptannotations/adeptannotations.dart';

part 'sample.g.dart';

@Cloneable()
@Differentiable()
class Sample implements ICloneable<Sample>, IDifferentiable<Sample?> {
  static int aStaticMutableField = 0;
  static final int aStaticImmutableField = 0;
  static const int aConstField = 0;

  num? aPublicField;
  num? _aPrivateField;
  @CloneKey(ignore: true)
  String? aCloneIgnoreField;
  @CloneKey(forceCurrentData: true)
  String? aCloneForceCurrentDataField;
  @CloneKey(forceNewData: true)
  String? aCloneForceNewDataField;

  @DiffKey(ignore: true)
  String? aDiffIgnoreField;
  @DiffKey(forceCurrentData: true)
  String? aDiffForceCurrentDataField;
  @DiffKey(forceNewData: true)
  String? aDiffForceNewDataField;

  @CloneKey(ignore: true)
  @DiffKey(ignore: true)
  String? aCombinationIgnoreField;
  @CloneKey(forceCurrentData: true)
  @DiffKey(forceCurrentData: true)
  String? aCombinationForceCurrentDataField;
  @CloneKey(forceNewData: true)
  @DiffKey(forceNewData: true)
  String? aCombinationForceNewDataField;

  Sample(
      {this.aPublicField,
      num? aPrivateField,
      this.aCloneIgnoreField,
      this.aCloneForceCurrentDataField,
      this.aCloneForceNewDataField,
      this.aDiffIgnoreField,
      this.aDiffForceCurrentDataField,
      this.aDiffForceNewDataField,
      this.aCombinationIgnoreField,
      this.aCombinationForceCurrentDataField,
      this.aCombinationForceNewDataField})
      : this._aPrivateField = aPrivateField;

  int get aPublicGetWithoutSet => 0;

  set aPublicSetWithoutGet(double size) {}

  String get someFunctionField => "";

  set someFunctionField(String? value) {}

  @override
  Sample clone({Sample? data, bool merge = false}) =>
      $SampleClone(currentData: this, newData: data, merge: merge);

  @override
  Sample? diff({Sample? data}) => $SampleDiff(currentData: this, newData: data);
}

After running: flutter pub run build_runner build

// GENERATED CODE - DO NOT MODIFY BY HAND

part of 'sample.dart';

// **************************************************************************
// CloneGenerator
// **************************************************************************

Sample $SampleClone(
    {required Sample currentData, Sample? newData, bool merge = false}) {
  final clone = Sample()
    ..aPublicField = newData?.aPublicField ?? currentData.aPublicField
    .._aPrivateField = newData?._aPrivateField ?? currentData._aPrivateField
    ..aCloneForceCurrentDataField = currentData.aCloneForceCurrentDataField
    ..aCloneForceNewDataField = newData?.aCloneForceNewDataField
    ..aDiffIgnoreField =
        newData?.aDiffIgnoreField ?? currentData.aDiffIgnoreField
    ..aDiffForceCurrentDataField = newData?.aDiffForceCurrentDataField ??
        currentData.aDiffForceCurrentDataField
    ..aDiffForceNewDataField =
        newData?.aDiffForceNewDataField ?? currentData.aDiffForceNewDataField
    ..aCombinationForceCurrentDataField =
        currentData.aCombinationForceCurrentDataField
    ..aCombinationForceNewDataField = newData?.aCombinationForceNewDataField
    ..someFunctionField =
        newData?.someFunctionField ?? currentData.someFunctionField;

  if (merge) {
    currentData.aPublicField = clone.aPublicField;
    currentData._aPrivateField = clone._aPrivateField;
    currentData.aCloneForceCurrentDataField = clone.aCloneForceCurrentDataField;
    currentData.aCloneForceNewDataField = clone.aCloneForceNewDataField;
    currentData.aDiffIgnoreField = clone.aDiffIgnoreField;
    currentData.aDiffForceCurrentDataField = clone.aDiffForceCurrentDataField;
    currentData.aDiffForceNewDataField = clone.aDiffForceNewDataField;
    currentData.aCombinationForceCurrentDataField =
        clone.aCombinationForceCurrentDataField;
    currentData.aCombinationForceNewDataField =
        clone.aCombinationForceNewDataField;
    currentData.someFunctionField = clone.someFunctionField;
  }

  return clone;
}

// **************************************************************************
// DiffGenerator
// **************************************************************************

Sample? $SampleDiff({Sample? currentData, Sample? newData}) {
  if (newData == null) return currentData;
  if (currentData == null) return newData;

  final diff = Sample()
    ..aPublicField = newData.aPublicField != currentData.aPublicField
        ? newData.aPublicField
        : null
    .._aPrivateField = newData._aPrivateField != currentData._aPrivateField
        ? newData._aPrivateField
        : null
    ..aCloneIgnoreField =
        newData.aCloneIgnoreField != currentData.aCloneIgnoreField
            ? newData.aCloneIgnoreField
            : null
    ..aCloneForceCurrentDataField = newData.aCloneForceCurrentDataField !=
            currentData.aCloneForceCurrentDataField
        ? newData.aCloneForceCurrentDataField
        : null
    ..aCloneForceNewDataField =
        newData.aCloneForceNewDataField != currentData.aCloneForceNewDataField
            ? newData.aCloneForceNewDataField
            : null
    ..aDiffForceCurrentDataField = currentData.aDiffForceCurrentDataField
    ..aDiffForceNewDataField = newData.aDiffForceNewDataField
    ..aCombinationForceCurrentDataField =
        currentData.aCombinationForceCurrentDataField
    ..aCombinationForceNewDataField = newData.aCombinationForceNewDataField
    ..someFunctionField =
        newData.someFunctionField != currentData.someFunctionField
            ? newData.someFunctionField
            : null;

  bool isDiff = false;
  isDiff |= diff.aPublicField != null;
  isDiff |= diff._aPrivateField != null;
  isDiff |= diff.aCloneIgnoreField != null;
  isDiff |= diff.aCloneForceCurrentDataField != null;
  isDiff |= diff.aCloneForceNewDataField != null;
  isDiff |= diff.aDiffIgnoreField != null;
  isDiff |= diff.aDiffForceCurrentDataField != null;
  isDiff |= diff.aDiffForceNewDataField != null;
  isDiff |= diff.aCombinationIgnoreField != null;
  isDiff |= diff.aCombinationForceCurrentDataField != null;
  isDiff |= diff.aCombinationForceNewDataField != null;
  isDiff |= diff.someFunctionField != null;

  return isDiff ? diff : null;
}