Skip to content

KTransport is a simple multiplatform API library built on top of gRPC that handles requests and responses internally

License

Notifications You must be signed in to change notification settings

JamshedAlamQaderi/KTransport

Repository files navigation

Android JVM JS Kotlin/Wasm

KTransport Maven Central

CI Analyse Publish CodeFactor Coverage

KTransport is a Kotlin Multiplatform library built on top of gRPC, that enables you to easily create cross-platform communication between your apps and services.

Features

  • Easy to use API for creating gRPC services and clients in Kotlin.
  • Support for both unary and server side streaming RPCs.
  • Built on top of gRPC, ensuring compatibility with other platforms.

Supported Platforms

  • Android
  • JVM
  • JavaScript (JS)
  • Wasm (Need to use tricks because of its experimental issues)

Getting Started

Installation

To use KTransport in your project, you need to add the following dependencies to your build.gradle.kts file:

plugins {
    //....
    id("com.jamshedalamqaderi.ktransport.gradle-plugin") version < ktransport_version >
}

ktransport {
    packageName = "com.jamshedalamqaderi.ktransport.example.ksp"
}

kotlin {
    android()
    jvm()
    js(IR) {
        browser()
        binaries.executable()
    }
    wasm {
        browser()
    }
    sourceSets {
        val commonMain by getting {
            dependencies {
                // KTransport
                implementation("com.jamshedalamqaderi.ktransport:ktransport:<ktransportVersion>")
                // Other dependencies
            }
        }
        val jsMain by getting {}
        // JsMain could be used for wasm platform
        val wasmMain by getting {
            dependsOn(jsMain)
        }
    }
}

Usage

please check out the example project in the repository. Just clone the repo and run ExampleServer.kt then run ExampleClient.kt using intellij. Do the same as ExampleClient.kt for JS platform

The example dir include all the necessary setup dependencies and code

Author

Contributing

We welcome contributions to KTranport! If you have an idea for a new feature or bug fix, please open an issue or pull request.

Support

If you found KTransport useful and would like to support its development, you can donate via Patreon by clicking on the button below:

Support via Patreon

Acknowledgements

  • Thank you to the gRPC team for their amazing work on gRPC

Roadmap

  • Add native platforms
  • 100% test coverage

LICENSE

KTransport is licensed under the Apache License 2.0.

Copyright 2023 Jamshed Alam Qaderi

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

KTransport is a simple multiplatform API library built on top of gRPC that handles requests and responses internally

Topics

Resources

License

Stars

Watchers

Forks

Sponsor this project

Packages

No packages published

Languages