Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nicolashaan/resultat
Resultat is kotlin.Result with a loading state
https://github.com/nicolashaan/resultat
Last synced: 3 months ago
JSON representation
Resultat is kotlin.Result with a loading state
- Host: GitHub
- URL: https://github.com/nicolashaan/resultat
- Owner: nicolashaan
- License: apache-2.0
- Created: 2022-07-11T08:46:37.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2022-07-27T16:10:54.000Z (almost 2 years ago)
- Last Synced: 2024-01-16T19:27:27.277Z (5 months ago)
- Language: Kotlin
- Size: 397 KB
- Stars: 49
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Lists
- awesome-kotlin-multiplatform - Résultat - A fork of Kotlin Result with a loading state. (Libraries / Utility)
- awesome-list - nicolashaan/resultat - Resultat is kotlin.Result with a loading state (Kotlin)
README
[](https://repo1.maven.org/maven2/fr/haan/resultat/resultat/)
## What is Résultat?
Résultat is a fork of Kotlin [Result](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-result/) with a loading state.
## Why?
Because sometimes you start a project based on Kotlin Result and you realise you need a loading state. This library can
be used as a drop-in replacement, with the same API and convenient conversion utility functions.
## Integration
### Manual integration
The recommended way to integrate it is to copy the [Resultat.kt](resultat/src/commonMain/kotlin/Resultat.kt) into you
project,
because it doesn't depend on any other library and you shouldn't add a dependency for such a small and critical piece of
software.
It also allows to rename it to whatever you want including *Result*, to ease migration and usage.
### Using Gradle
Résultat is available on MavenCentral.
```kotlin
implementation("fr.haan.resultat:resultat:1.0.0")
```
## Usage
The usage of this class is the same as kotlin Result. You may take a look
at [this article](https://medium.com/@jcamilorada/arrow-try-is-dead-long-live-kotlin-result-5b086892a71e)
if you are not already familiar with it.
*Resultat* keep the exact same behaviour, and add similar helper and *side effect* methods to handle the
loading state.
For instance:
```kotlin
val resulat: Resultat
resultat
.onFailure { exception ->
println("Error: ${exception.message}")
}
.onLoading { println("Loading customer with ID: $id...") }
.onSuccess { customer ->
println("Hello, ${customer.firstName} ${customer.lastName} !")
}
```
Similarly, the [fold](https://nicolashaan.github.io/resultat/resultat/fr.haan.resultat/fold.html) method have a third `loading`
parameter:
```kotlin
val resulat: Resultat
resultat.fold(
onSuccess = {
Resultat.success(it)
},
onLoading = {
Resultat.success(defaultCustomer)
},
onFailure = {
Resultat.success(defaultCustomer)
},
)
```
### Interoperability with Kotlin Result
Convenient methods are provided to convert a [Kotlin Result](https://nicolashaan.github.io/resultat/resultat/fr.haan.resultat/to-result.html) to a Resultat and
[vice versa](https://nicolashaan.github.io/resultat/resultat/fr.haan.resultat/to-resultat.html).
```kotlin
val resultat: Resultat = Resultat.success("Hello")
val result: Result = resultat.toResult()
// Notice the nullable type because loading state is mapped to null
val newResultat: Resultat? = result.ToResultat()
```
## API Reference
See [API documentation](https://nicolashaan.github.io/resultat/resultat/fr.haan.resultat/-resultat/index.html)
Made with ❤️ at [](https://www.bam.tech)