Aus öffentlichen Paketdaten erstellte Orientierung.
Verify ist ein Flutter/Dart-Paket, das die Formular- und Zustandsvalidierung durch eine intuitive, erweiterungsbasierte DSL vereinfacht. Es ermöglicht Entwicklern, Validierungsregeln mithilfe einer fließenden Syntax direkt auf Datentypen präzise zu definieren. Das Paket unterstützt anpassbare Validierungslogik und integriert sich nahtlos in bestehende Arbeitsabläufe, ohne Boilerplate-Code zu erfordern. Für einfache Handhabung konzipiert, verbessert es die Lesbarkeit und Wartbarkeit der Validierungslogik über mehrere Plattformen hinweg.
Anwendungsfälle
Formularingabvalidierung
Zustandsüberprüfung in Benutzeroberflächenkomponenten
Echtzeit-Nutzerfeedback
Benutzerdefinierte Validierungsregeln
Plattformübergreifende Überprüfung
Komplexe Überprüfungslogik vereinfachen
Hauptmerkmale
Erweiterungs-basiertes DSL
Minimales Boilerplate
Kettenbare Validierungsmethoden
Unterstützt benutzerdefinierte Validatoren
Funktioniert auf allen Flutter-Plattformen
Einfache Integration in bestehenden Code
Geeignet für
Entwickler, die einfache Überprüfung suchen
Teams, die sauberen Code priorisieren
Apps mit umfangreichen Formulareingaben
Projekte für mehrere Plattformen
Frontend-orientierte Flutter-Anwendungen
Hinweise
Beschränkt auf grundlegende Validierungsmuster
Keine integrierte Internationalisierung
Kenntnis über Dart-Erweiterungen erforderlich
Nicht ideal für hochdynamische Validierungslogik
Für komplexe Szenarien ist möglicherweise zusätzliche Einrichtung erforderlich
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
Validations made simple
A fp inspired validation DSL. For Dart and Flutter projects.
Features
Completely extensible (create your own combinators, validator primitives, etc)
Flexible Verify is an extension based API (There is not single class created its all pure functions)
Customizable (Define you own error types if required) organize validators how ever you want
Bloc friendly (See examples for a concrete implementation)
Null safe (as a prerelease)
Usage
Creating validators
A Validator is just a simple function alias:
// One of 2 variats depending on wether the validated subject will be transformed into another type or nottypedefValidatorT<S, T> = Either<List<dynamic>, T> Function(S subject);
typedefValidator<S> = Either<List<dynamic>, S> Function(S subject);
So you can create your own validator by just specifying a function for example:
Note: The difference between check and checkField is that the later ignore the verification when the value is null,
this will likely change in next version supporting null safety.
Run a validator
Running a validator is a simple as passing in a parameter since its just a function.
To be a bit more eloquent a verify method is provided, this method is special because besides
forwarding the argument to the calling validator it can also be used to filter the error list and
have it cast to a specific error type. Just supply a specific type parameter.
final signUpValidation = Verify.subject<SignUpState>();
final errors = signUpValidation
.verify<SignUpError>(newState); // Either<List<SignUpError>, SignUpState>
Built in validators
Verify doesn't come with many built in validators, because they are so simple to create.
It does come with some regex shorthands.
final validator = Verify.fromRegex(RegExp(r"(^\d+$)", error: Error('not just digits')) // Validator<String, int>
Form validation
Often times you will have modeled your error type similar to: