Kida
Unofficial Concurrent Kotlin Multiplatform NIDA API
Usage
val api: NidaApi = NidaApi()
api.info(nin = "19900101000000000001").then {
println(it.name) // John Makongoro Doe
println(it.dateOfBirth) // 1990-01-01
// . . .
println(it.nationality) // Tanzanian
}.catch {
println("Oops!, Error: ${it.message}")
}
Setup
dependencies {
implementation("tz.co.asoft:kida-core:<version>")
}
Coroutines Support
This api has been made in a non-blocking but still easily usable from other platforms i.e. Swift, Java and even Javascript/Typescript
It comes with a suspending method await that can be called in
suspend functions
val info = api.info(nin = "<nin-goes-here>").await() // << suspends on await
with(info) {
println(name) // John Makongoro Doe
println(dateOfBirth) // 1990-01-01
// . . .
println(nationality) // Tanzanian
}
Testing
To make it easy to write tests for your logic, we have integrated a NidaApiFake implementation
Usage
val api: NidaApi = NidaApiFake()
api.info("19900101000000000001")
Setup
Just add the kida-fake implementation on your tests
dependencies {
implementation("tz.co.asoft:kida-fake:<version>")
}
Test Subjects
You can use these two nin to test if you have everything wired up correctly
- John Makongoro Doe (nin: 19900101000000000001)
- Jane Makukuru Doe (nin: 19900101000000000002)
Support
There are multiple ways you can support this project
Start It
If you found it useful, just give it a star
Contribute
You can help by submitting pull request to available open tickets on the issues section
Report Issues
This makes it easier to catch bugs and offer enhancements required
Credits
- andylamax – The author
- koncurrent-later – Non blocking kotlin multiplatform library
- nida – The python equivalent library
- laravel-nida The php equivalent library
