implement isAfter validator

Author: ArturAssisComp

lib/new_api_prototype/datetime_validators.dart

@@ -0,0 +1,21 @@
+import 'constants.dart';
+
+String tmpIsAfterErrorMsg(DateTime reference) =>
+    'The date must be after $reference';
+
+/// This function returns a validator that checks if the user [DateTime] input is
+/// after (or equal, if `inclusive` is true) to `reference`. If the checking results
+/// true, the validators returns `null`. Otherwise, it returns `isAfterMsg`, if
+/// provided, or `FormBuilderLocalizations.current.isAfterErrorText`.
+Validator<DateTime> isAfter(
+  DateTime reference, {
+  String Function(DateTime)? isAfterMsg,
+  bool inclusive = false,
+}) {
+  return (DateTime value) {
+    return value.isAfter(reference) ||
+            (inclusive ? value.isAtSameMomentAs(reference) : false)
+        ? null
+        : isAfterMsg?.call(reference) ?? tmpIsAfterErrorMsg(reference);
+  };
+}

test/new_api_testing/datetime_validators/is_after_validator_test.dart

@@ -0,0 +1,111 @@
+import 'package:flutter_test/flutter_test.dart';
+import 'package:form_builder_validators/new_api_prototype/constants.dart';
+import 'package:form_builder_validators/new_api_prototype/datetime_validators.dart';
+
+void main() {
+  group('Validator: isAfter', () {
+    test('Validation for the year 1994', () {
+      final DateTime reference = DateTime(1994);
+      final DateTime eq = reference.copyWith();
+      final DateTime after10Years = DateTime(2004);
+      final DateTime after1Ms = reference.add(const Duration(milliseconds: 1));
+      final DateTime before1Year = DateTime(1993);
+      final DateTime before1Sec =
+          reference.subtract(const Duration(seconds: 1));
+      final Validator<DateTime> v = isAfter(reference);
+      final String errorMsg = tmpIsAfterErrorMsg(reference);
+
+      expect(
+        v(eq),
+        errorMsg,
+        reason: 'Should return error against 1994',
+      );
+      expect(
+        v(after10Years),
+        isNull,
+        reason: 'Should return null against 2004',
+      );
+      expect(
+        v(after1Ms),
+        isNull,
+        reason: 'Should return null against 1994 + 1ms',
+      );
+      expect(
+        v(before1Year),
+        errorMsg,
+        reason: 'Should return errorMsg against 1993',
+      );
+      expect(
+        v(before1Sec),
+        errorMsg,
+        reason: 'Should return errorMsg against 1994 - 1s',
+      );
+    });
+    test(
+        'Inclusive validation for datetime 2089, month 3, day 23, h 3, min 46, s 12, 233 ms',
+        () {
+      final DateTime reference = DateTime(2089, 3, 23, 3, 46, 12, 233);
+      final DateTime eq = reference.copyWith();
+      final DateTime after10Years = reference.copyWith(year: 2099);
+      final DateTime after1Ms = reference.add(const Duration(milliseconds: 1));
+      final DateTime before1Year = reference.copyWith(year: 2088);
+      final DateTime before1Sec =
+          reference.subtract(const Duration(seconds: 1));
+      final Validator<DateTime> v = isAfter(reference, inclusive: true);
+      final String errorMsg = tmpIsAfterErrorMsg(reference);
+
+      expect(
+        v(eq),
+        isNull,
+        reason: 'Should return null against the same datetime',
+      );
+      expect(
+        v(after10Years),
+        isNull,
+        reason: 'Should return null against the reference shifted +10 years',
+      );
+      expect(
+        v(after1Ms),
+        isNull,
+        reason: 'Should return null against the reference shifted +1 ms',
+      );
+      expect(
+        v(before1Year),
+        errorMsg,
+        reason:
+            'Should return errorMsg against a datetime 1 year before the reference',
+      );
+      expect(
+        v(before1Sec),
+        errorMsg,
+        reason:
+            'Should return errorMsg against a datetime 1 sec before the reference',
+      );
+    });
+
+    test('Should return a custom message after validating', () {
+      const String errorMsg = 'error msg';
+      final DateTime reference = DateTime(2);
+      final Validator<DateTime> v =
+          isAfter(reference, isAfterMsg: (_) => errorMsg);
+
+      expect(
+        v(reference.copyWith()),
+        errorMsg,
+        reason:
+            'Should return custom message when input is equal to the reference',
+      );
+      expect(
+        v(reference.subtract(const Duration(microseconds: 1))),
+        errorMsg,
+        reason:
+            'Should return custom message when input is before the reference',
+      );
+      expect(
+        v(reference.add(const Duration(days: 1))),
+        isNull,
+        reason: 'Should return null when the input is after the reference',
+      );
+    });
+  });
+}