gokulchandra / kohttp

Kotlin DSL http client

Introduction

Kotlin DSL http client

Features

🔹 Developers Experinece-driven library without verbosity.

🔹 Providing a native way to use http client in Kotlin.

🔹 HTTP GET/POST/PUT/HEAD/DELETE/PATCH requests.

🔹 Asynchronous and blocking requests.

🔹 Upload files.

🔹 Logging - easily dump your http requests or convert them to cURL commands.

🔹 Minimal footprint.

Quick start

val response = "https://my-host.com/users?admin=true".httpGet()
// use integration with your favorite serialization library
val usersData = users.toJson()

val pushNotifications: List<Deferred<Response>> = usersData.map {
    httpPostAsync {
        url("https://my-host.com/friends/push")
        
        param {
            "userId" to it[id]
            "eventType" to NewFriend
        }
        
        header {
            "locale" to "en_EN"
            cookie {
                "user_session" to "toFycNV"
                "authToken" to "d2dwa6011w96c93ct3e3493d4a1b5c8751563217409"
            }
        }
    }
}

About kohttp

• Kotlin weekly mentioned us
• Android weekly (CN) mentioned us
• Kotlin http client. Making kohttp 0.11.0 - medium post
• Write your Android network as Kotlin DSL - medium post
• Upload files to Google Drive with Kotlin - medium post
• Production Kotlin DSL (RU + subtitles) - Kotlin/Everywhere talk, YouTube

Installation

Gradle

Kotlin DSL:

implementation(group = "io.github.rybalkinsd", name = "kohttp", version = "0.11.0")

Groovy DSL:

implementation 'io.github.rybalkinsd:kohttp:0.11.0'

Maven:

<dependency>
  <groupId>io.github.rybalkinsd</groupId>
  <artifactId>kohttp</artifactId>
  <version>0.11.0</version>
</dependency>

Table of contents

• Synchronous calls
  • GET
  • POST
  • PUT
  • HEAD
  • DELETE
  • PATCH
  • Upload files
• Asynchronous calls
  • async GET
  • async POST
  • async PUT
  • async HEAD
  • async DELETE
  • async PATCH
  • async Upload files
• Response usage
• Interceptors
• Customisation
• Experimental features
• Changelog