Multipurpose and customizable validation library.
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.
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:
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
}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
}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()
}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.