ktor-client-plugins/kresil.ktor.client.plugins.retry

Package-level declarations

Properties

private val defaultRetryPluginConfig: RetryPluginConfig

private lateinit var globalConfig: RetryPluginConfig

val KresilRetryPlugin: ClientPlugin<RetryPluginConfigBuilder>

A plugin that enables the client to retry failed requests based on the Kresil Retry mechanism configuration and the HttpRequestRetry plugin provided by Ktor. Configuration can be done globally when installing the plugin, and on a per-request basis with the kRetry function.

logger

private val logger: Logger

RetryPluginConfigBuilderPerRequestAttributeKey

private val RetryPluginConfigBuilderPerRequestAttributeKey: AttributeKey<RetryPluginConfigBuilder>

Functions

copyRequestAndPropagateCompletion

private fun copyRequestAndPropagateCompletion(request: HttpRequestBuilder): HttpRequestBuilder

Creates a copy of the given HTTP request builder, preserving its configuration but not the execution context, and guarantees that any completion or failure of the original request is mirrored onto the copy.

kRetry

fun HttpRequestBuilder.kRetry(disable: Boolean = false, configure: RetryPluginConfigBuilder.() -> Unit = {})

Configures the KresilRetryPlugin on a per-request level. The configuration declared in this block will override the global configuration, or inherit from it if not specified.