Skip to content

natiginfo/Checkpoint

Repository files navigation

CodeFactor Snapshot CI

Checkpoint

Multipurpose and customizable validation library.

Getting started

Download

Maven:

<dependency>
  <groupId>com.natigbabayev.checkpoint</groupId>
  <artifactId>checkpoint-core</artifactId>
  <version>0.6.0</version>
</dependency>
<!-- Optional RxJava 2 support: -->
<dependency>
  <groupId>com.natigbabayev.checkpoint</groupId>
  <artifactId>checkpoint-rxjava2</artifactId>
  <version>0.6.0</version>
</dependency>

Gradle:

Core:

implementation 'com.natigbabayev.checkpoint:checkpoint-core:0.6.0'
// Optional RxJava 2 support:
implementation 'com.natigbabayev.checkpoint:checkpoint-rxjava2:0.6.0'

Snapshots of the development version are available in Sonatype's snapshots repository.

Usage

Checkpoint allows you to perform validation checks for given input. Checkpoint is generic collection of rules with boolean output. You can create a new instance of Checkpoint either by using builder or DSL:

DSL

fun main() {
    val pinCheckpoint = checkpoint<CharSequence> {
        addRule(
            lengthRangeRule(minLength = 4, maxLength = 6) {
                println("Must contain min. 4, max 6 characters")
            }
        )
        addRule {
            isValid { it.contains("@") || it.contains("!") }
            whenInvalid { println("Must contain at least one of the @ or ! characters.") }
        }
    }

    pinCheckpoint.canPass("123") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234@6!") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234@6") // returns true
}

Builder

fun main() {
    val pinCheckpoint = Checkpoint.Builder<CharSequence>()
        .addRule(
            LengthRangeRule.Builder()
                .minLength(4)
                .maxLength(6)
                .whenInvalid { println("Must contain min. 4, max 6 characters") }
                .build()
        )
        .addRule(
            DefaultRuleBuilder<CharSequence>()
                .isValid { it.contains("@") || it.contains("!") }
                .whenInvalid { println("Must contain at least one of the @ or ! characters.") }
                .build()
        )
        .build()

    pinCheckpoint.canPass("123") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234@6!") // returns false and invokes whenInvalid()
    pinCheckpoint.canPass("1234@6") // returns true
}

Base classes

Checkpoint has several base classes which can be used for creating custom checkpoints and rules:

Creating new rule:

class NotEmpty(override val callback: Callback<String>) : DefaultRule<String>() {
    override fun isValid(input: String): Boolean {
        return input.isNotEmpty()
    }
}

fun main() {
    val rule = NotEmpty(
        Rule.Callback { println("Cannot be empty") }
    )
    
    val checkpoint = Checkpoint.Builder()
        .addRule(rule)
        .build()
}

License

Copyright 2020 Natig Babayev

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.