0.5.0

Overview

This release is a long overdue major update to the project. The entire API surface has been touched up and improved to provide a better developer experience.

The most significant change is the decoupling of request creation from request execution:

// Old
suspend fun main() {
  val client = GW2APIClient(...)
  val requestBuilder = client.gw2v2Build()

  val request = coroutineScope { requestBuilder.execute(this) }
  val response = request.get()

  val gw2v2Build = response.data.getOrNull() ?: error("Could not decode request")

  println("Build ID: ${gw2v2Build.id}")
}

Whereas the old way to create requests contained a lot of ceremony to support asynchronous and synchronous execution at the same time, the new way is much more straightforward:

// New
suspend fun main() {
  val client = Gw2ApiClient()
  val gw2v2Build = client.executeAsync(gw2v2Build()).dataOrNull ?: error("Failed to fetch build ID.")

  println("Build ID: {$gw2v2Build.id}")
}

There is no full migration guide available. Please refer to the updated documentation for more information.

Improvements

• Added an explicit Java module descriptor for api-types.
• Added a simple API to allow blocking execution of requests on the JVM.
  • This is especially useful in combination with virtual threads.
• Replaced placeholder exception that is thrown when an unknown type is encountered with a SerializationException.
• Migrated to schema version 2022-03-23T19:00:00.000Z.

Breaking Changes

• Migrated to schema version 2022-03-23T19:00:00.000Z.
• The entire API client has been rewritten to decouple request creation from execution. Please see the updated documentation for more information.

0.4.0

Improvements

• Updated to api-generator to 0.6.0.
• Cleaned up caching.
  • Renamed CacheAccessor to CacheAccess.
  • Cache time overwrites were removed for now.
• Cleaned up the RateLimiter interface and related hooks.
  • A default TokenBucketRateLimiter implementation is now available.
  • API clients are now configured to use a rate limiter by default.
• Introduced the DecodingResult abstraction to improve error-handling
  capabilities for malformed data from the API.
• Introduced the ResponseHeaders abstraction that wraps headers of a
  Response and provides utilities.
• Improved documentation throughout the entire library.

Breaking Changes

• All modules now require Kotlin 1.7
• JVM modules now require Java 11
• The library was significantly reworked and many things were either renamed or
  relocated. Detailed migration guidelines are not available for this release.

0.3.0

Improvements

• Updated to api-generator to 0.4.0.
• Result is now used to catch exceptions during deserialization.

0.2.0

Improvements

• Updated to api-generator to 0.3.0.

0.1.0

Overview

GW2APIClient is a cross-platform client for the official Guild Wars 2 API.
By leveraging Kotlin Multiplatform,
GW2APIClient can be used on a large variety of platforms (including Android, the
JVM, and JS) and interoperates seamlessly with various popular programming
languages.

GW2APIClient provides low-level access to the data provided by Guild Wars 2's
API. It does not provide higher-level abstractions, visualizations or analytical
functionality but may be used to build such tools.