vanguard's Introduction

VanGuard

An easy-to-use, real-time UI form validation library for Android.

Installation

1 Add the JitPack repository to your root build.gradle:

     allprojects {
         repositories {
             ...
             maven { url 'https://jitpack.io' }
         }
     }

2 Add VanGuard dependency to your app build file

     implementation 'com.github.baianat:VanGuard:0.1.0'

Quick Guide

Define a set of validation cases, each of which must include:

A validaion rule based on which the validation status of the view can be determined as true or false.
The view on which the validaion rule is tested.

      val emailValidationCase = CasesFactory
          .watch(emailEditText)
          .forRule(IsEmail(errorMsg = "Please enter a valid e-mail!"))
          .create()
          
      val passwordValidationCase = CasesFactory
          .watch(passwordEditText)
          .forRule(IsLengthGreaterThan(length = 5,errorMsg = "Password can't be less than 6 chars!"))
          .create()
          
      val notificationValidationCase = CasesFactory
          .watch(notificationsCheckBox)
          .forRule(IsChecked())
          .create()

Initialize VanGuard in the Activity or Frament of interest, and link it to the validation cases.

      VanGuard.of(this)
          ?.validate(emailValidationCase, passwordValidationCase, notificationValidationCase)

Listen to the Callback for form status changes between being true and false (optional).

      VanGuard.of(this)
          ....
          .doOnFormStatusChange {isFormValid ->
              // isFormValid : true or false, based on the state of the form!
          }