HamKrest

A Result type for Kotlin

License	Apache 2.0
GroupId	com.natpryce
ArtifactId	result4k
Last Version	2.0.0
Release Date	Oct 9, 2018
Type	jar
Description	HamKrest A Result type for Kotlin
Project URL	https://github.com/npryce/result4k
Source Code Management	https://github.com/npryce/result4k

Download result4k

Filename	Size
result4k-2.0.0.pom
result4k-2.0.0.jar	12 KB
result4k-2.0.0-sources.jar	2 KB
result4k-2.0.0-javadoc.jar	33 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.natpryce/result4k/ -->
<dependency>
    <groupId>com.natpryce</groupId>
    <artifactId>result4k</artifactId>
    <version>2.0.0</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.natpryce/result4k/
implementation 'com.natpryce:result4k:2.0.0'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.natpryce/result4k/
implementation ("com.natpryce:result4k:2.0.0")

Apache Buildr

'com.natpryce:result4k:jar:2.0.0'

Apache Ivy

<dependency org="com.natpryce" name="result4k" rev="2.0.0">
  <artifact name="result4k" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.natpryce', module='result4k', version='2.0.0')
)

Scala SBT

libraryDependencies += "com.natpryce" % "result4k" % "2.0.0"

Leiningen

[com.natpryce/result4k "2.0.0"]

Dependencies

test (3)

Group / Artifact	Type	Version
org.jetbrains.kotlin : kotlin-stdlib	jar	1.1.51
org.jetbrains.kotlin : kotlin-test	jar	1.1.51
junit : junit	jar	4.12

Project Modules

There are no modules declared in this project.

Result4K

NB Result4K is moving - please migrate to https://github.com/fork-handles/forkhandles/tree/trunk/result4k

Type safe error handling in Kotlin.

Motivation

Kotlin does not type-check exceptions. Result4k lets you type-check code that reports and recovers from errors.

A Result<T,E> represents the result of a calculation of a T value that might fail with an error of type E.

You can use a when expression to determine if a Result represents a success or a failure, but most of the time you don't need to. Result4k type provides many useful operations for handling success or failure without explicit conditionals.

Result4k works with the grain of the Kotlin language. Kotlin does not have language support for monads (known as "do notation" or "for comprehensions" in other languages). A pure monadic approach becomes verbose and awkward. Therefore, Result4k lets you use early returns to avoid deep nesting when propagating errors.

Versions

Version
2.0.0 Oct 9, 2018
1.4.1 Nov 3, 2017
1.4.0 Nov 3, 2017
1.3.0 Nov 2, 2017
1.2.0 Oct 20, 2017
1.1.0 Aug 24, 2017
1.0.0 Aug 23, 2017