Skip to content

Releases: ahparhizgar/katch

Release list

v0.2.0

v0.2.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@ahparhizgar ahparhizgar released this 04 Jul 14:14
v0.2.0
d89ae82

Release v0.2.0 — Rename and Bug Fixes

Changelog

  • Project renamed: The library is now called Katch—because it helps you catch exceptions and errors.
  • Bug fix: extractPayload is now a suspend function. Previously, it couldn't safely extract the response body because reading the body requires a suspend context.
  • New feature: Debug message extraction is now supported. When available, the extracted debug message is exposed as the message of ClientError and ServerError.
Loading

v0.1.0

v0.1.0 Pre-release
Pre-release

Choose a tag to compare

View all tags
@ahparhizgar ahparhizgar released this 01 Jan 10:43
v0.1.0
b83ab7c

Release v0.1.0 — Initial release

Highlights

Typed error hierarchy: ApiCallError base plus InvalidDataError, NetworkError, HttpError with ServerError and ClientError (including BadRequest, Unauthorized, Forbidden, NotFound, RateLimitReached, OtherClientError).

  • Ktor plugin: ApiCallErrorPlugin that converts HTTP 4xx/5xx, network failures, and serialization issues into the typed errors.
  • Payload extraction: plugin supports an extractPayload hook to parse structured server error payloads (optional; uses installed content negotiation).
  • Data validation helpers: small utilities to produce InvalidDataError for parsing/validation failures.
  • Manual usage: error classes are usable without Ktor for manual error construction and handling.

Setup & distribution

Published for use via JitPack; add JitPack to settings.gradle.kts and depend on the artifacts in build.gradle.kts.

  • Artifacts in this release: core library and Ktor plugin packages (see README for coordinates).
    Usage notes - Recommended: install ApiCallErrorPlugin into Ktor HttpClient for automatic mapping.
  • Errors can be caught as ApiCallError and inspected by concrete subtype for specific handling.
    Requirements - Kotlin Multiplatform (common code) support.
  • For the Ktor plugin: Ktor Client 3.0.0 or higher.
  • Maven Central publishing not available in this release; JitPack is the only distribution.
  • Initial public release — API may evolve in minor follow-ups.

Contributing & License

Issues, contributions, and feedback welcome via the repository. See the repo for contribution guidelines and license details.

Loading