clap-kotlin in Kotlin

This is a Kotlin Multiplatform line-by-line transliteration port of clap-rs/clap.

Original Project: This port is based on clap-rs/clap. All design credit and project intent belong to the upstream authors; this repository is a faithful port to Kotlin Multiplatform with no behavioural changes intended.

Porting status

This is an in-progress port. The goal is feature parity with the upstream Rust crate while providing a native Kotlin Multiplatform API. Every Kotlin file carries a // port-lint: source <path> header naming its upstream Rust counterpart so the AST-distance tool can track provenance.

---

Upstream README — clap-rs/clap

The text below is reproduced and lightly edited from https://github.com/clap-rs/clap. It is the upstream project's own description and remains under the upstream authors' authorship; links have been rewritten to absolute upstream URLs so they continue to resolve from this repository.

clap

Command Line Argument Parser for Rust

Dual-licensed under Apache 2.0 or MIT.

Get Started

$ cargo add clap

About

Create your command-line parser, with all of the bells and whistles, declaratively or procedurally.

For more details, see:

• docs.rs
• examples

Sponsors

Gold

Silver

Bronze

Backer

---

About this Kotlin port

Installation

dependencies {
    implementation("io.github.kotlinmania:clap-kotlin:0.1.1")
}

Building

./gradlew build
./gradlew test

Targets

• macOS arm64
• Linux x64
• Windows mingw-x64
• iOS arm64 / simulator-arm64 (Swift export + XCFramework)
• JS (browser + Node.js)
• Wasm-JS (browser + Node.js)
• Android (API 24+)

Porting guidelines

See AGENTS.md and CLAUDE.md for translator discipline, port-lint header convention, and Rust → Kotlin idiom mapping.

License

This Kotlin port is distributed under the same MIT license as the upstream clap-rs/clap. See LICENSE (and any sibling LICENSE-* / NOTICE files mirrored from upstream) for the full text.

Original work copyrighted by the clap authors.
Kotlin port: Copyright (c) 2026 Sydney Renee and The Solace Project.

Acknowledgments

Thanks to the clap-rs/clap maintainers and contributors for the original Rust implementation. This port reproduces their work in Kotlin Multiplatform; bug reports about upstream design or behavior should go to the upstream repository.