EitherNet Versions Save

• Fix: (hopefully) fix kdocs publishing for test fixtures.
• Update to Kotlin 1.9.22.

What's Changed

• Update misc repo infra by @ZacSweers in https://github.com/slackhq/EitherNet/pull/75
• Try fixing doc publishing for test fixtures by @ZacSweers in https://github.com/slackhq/EitherNet/pull/73

Full Changelog: https://github.com/slackhq/EitherNet/compare/1.8.0...1.8.1

• Fix: Deprecate old fold() functions and introduce new ones that use the underlying value rather than Success. This was an oversight in the previous implementation. Binary compatibility is preserved.
• Enhancement: Mark functions inline where possible to allow carried over context (i.e. in suspend functions, etc)
• Enhancement: Use contracts to inform the compiler about possible calls to lambdas.
• New: Add fluent onSuccess and onFailure* functional extension APIs to ApiResult.

What's Changed

• Misc extensions improvements by @ZacSweers in https://github.com/slackhq/EitherNet/pull/71

Full Changelog: https://github.com/slackhq/EitherNet/compare/1.7.0...1.8.0

• Enhancement: Add new ApiResult<*, *>.successOrNothing() and ApiResult.Failure<*>.exceptionOrNull() functional extension APIs.
• Update to Kotlin 1.9.20.

What's Changed

• Prepare for Kotlin 1.9.20 by @ZacSweers in https://github.com/slackhq/EitherNet/pull/67
• Add successOrNothing and exceptionOrNull extensions by @ZacSweers in https://github.com/slackhq/EitherNet/pull/70

Full Changelog: https://github.com/slackhq/EitherNet/compare/1.6.0...1.7.0

• Enhancement: Add shouldRetry parameter to retryWithExponentialBackoff() to allow conditional short-circuiting of retries.

What's Changed

• Add shouldRetry overload for retries by @ZacSweers in https://github.com/slackhq/EitherNet/pull/69

Full Changelog: https://github.com/slackhq/EitherNet/compare/1.5.0...1.6.0

• New: Add new successOrNull, successOrElse, and fold functional extension APIs to ApiResult. These allow easy happy path-ing in user code to coerce results into a concrete value.
• Update to Kotlin 1.9.0.

• Enhancement: Gracefully handle Unit-returning endpoints when encountering a 204 or 205 response code.

Thanks to @JDSM01 for contributing to this release!

Happy new year!

A common pattern in making network requests is to retry with exponential backoff. EitherNet now ships with a highly configurable retryWithExponentialBackoff() function for this case.

// Defaults for reference
val result = retryWithExponentialBackoff(
  maxAttempts = 3,
  initialDelay = 500.milliseconds,
  delayFactor = 2.0,
  maxDelay = 10.seconds,
  jitterFactor = 0.25,
  onFailure = null, // Optional Failure callback for logging
) {
    api.getData()
}

• Update to Kotlin 1.8.21.
• Update to Kotlin Coroutines 1.7.1.
• EitherNet now depends on org.jetbrains.kotlinx:kotlinx-coroutines-core.

• Fix missing Gradle module metadata for test fixtures.

• Update to Kotlin 1.8.0.
• Fix: Fix exception on annotation traversal when target is not present
• Fix: Publish test-fixtures artifact sources.
• Update to JVM target 11.

What's Changed

• Fix exception on annotation traversal when target is not present by @flavioarfaria in https://github.com/slackhq/EitherNet/pull/51
• Update gradle to 7.4.2.+ deps by @ZacSweers in https://github.com/slackhq/EitherNet/pull/52
• Misc updates, mostly around Kotlin 1.7.20 by @ZacSweers in https://github.com/slackhq/EitherNet/pull/54
• Use version catalogs + target java 11 by @ZacSweers in https://github.com/slackhq/EitherNet/pull/55
• Update misc dependencies by @ZacSweers in https://github.com/slackhq/EitherNet/pull/57

New Contributors

• @flavioarfaria made their first contribution in https://github.com/slackhq/EitherNet/pull/51

Full Changelog: https://github.com/slackhq/EitherNet/compare/1.2.1...1.3.0

• Update to Kotlin 1.6.10.
• Promote test-fixtures APIs to stable.
• Update kotlinx-coroutines to 1.6.0 (test-fixtures only)
• Fix: test-fixtures artifact module metadata using the wrong artifact ID. They should correctly resolve when using Gradle's testFixtures(...) syntax.