Async-first declarative CLI builder for MoonBit, inspired by gunshi
moon add totto2727/admiral
moon add moonbitlang/asyncsupported_targets = "js+native+wasm"
import {
"totto2727/admiral" @admiral,
"moonbitlang/async",
}supported_targets = "js+native+wasm"
import {
"totto2727/admiral/util/target-file-discovery" @target-file-discovery,
"moonbitlang/core/async",
}
options(
"allow-experimental-packages": [ "moonbitlang/core/async" ],
)let query = @admiral.string("query", env="ADMIRAL_PROJECT_QUERY", config="query")
let project = @admiral.position_string(
"project",
required=true,
interactive=@terminal.project_picker(query),
)impl Show for ConfigLoadFailurepub struct ArgDef[_, Metadata] {
name : String
config : String?
metadata : Metadata
// private fields
} derive(Debug)impl ToStoredOption for ArgDef[T, OptionMetadata]impl ToStoredPosition for ArgDef[T, PositionMetadata]pub struct CliApp {
name : String
version : String
description : String
root_options : Array[ArgDef[Unit, OptionMetadata]]
root_positionals : Array[ArgDef[Unit, PositionMetadata]]
commands : Array[CommandDef]
run : async (Context) -> Unit?
load_config : () -> Map[String, Json] raise ConfigLoadFailure?
}fn CliApp::CliApp(name~ : String, version? : String, description? : String, options? : Array[&ToStoredOption], positionals? : Array[&ToStoredPosition], commands? : Array[CommandDef], run? : async (Context) -> Unit?, load_config? : () -> Map[String, Json] raise ConfigLoadFailure?) -> CliApppub struct CommandDef {
name : String
description : String
options : Array[ArgDef[Unit, OptionMetadata]]
positionals : Array[ArgDef[Unit, PositionMetadata]]
examples : Array[String]
subcommands : Array[CommandDef]
run : async (Context) -> Unit?
}fn CommandDef::CommandDef(name~ : String, description? : String, options? : Array[&ToStoredOption], positionals? : Array[&ToStoredPosition], examples? : Array[String], subcommands? : Array[CommandDef], run? : async (Context) -> Unit?) -> CommandDefpub struct Context {
flags : HashMap[String, Bool]
values : HashMap[String, ReadOnlyArray[String]]
sources : HashMap[String, ValueSource]
config : HashMap[String, Json]
interactive_flags : HashMap[String, Bool]
interactive_values : HashMap[String, ReadOnlyArray[String]]
subcommand : (String, Context)?
}fn Context::get_bool(self : Context, option : ArgDef[Bool, OptionMetadata]) -> Bool raise JsonDecodeErrorfn[Metadata] Context::get_doubles_required(self : Context, argument : ArgDef[Array[Double], Metadata]) -> NonEmptyArray[Double] raisefn[Metadata] Context::get_int64s_required(self : Context, argument : ArgDef[Array[Int64], Metadata]) -> NonEmptyArray[Int64] raisefn[Metadata] Context::get_ints_required(self : Context, argument : ArgDef[Array[Int], Metadata]) -> NonEmptyArray[Int] raisefn[Metadata] Context::get_string(self : Context, argument : ArgDef[String, Metadata]) -> String? raise JsonDecodeErrorfn[Metadata] Context::get_strings(self : Context, argument : ArgDef[Array[String], Metadata]) -> ReadOnlyArray[String] raise JsonDecodeErrorfn[Metadata] Context::get_strings_required(self : Context, argument : ArgDef[Array[String], Metadata]) -> NonEmptyArray[String] raisefn[Metadata] Context::get_uint64s_required(self : Context, argument : ArgDef[Array[UInt64], Metadata]) -> NonEmptyArray[UInt64] raisepub struct OptionMetadata {
type_ : OptionType
short : Char
description : String
env : String?
required : Bool
default_value : String?
multiple : Bool
interactive : Bool
} derive(Debug)impl Show for OptionTypepub struct PositionMetadata {
type_ : OptionType
description : String
required : Bool
multiple : Bool
interactive : Bool
} derive(Debug)fn bool(name : String, short? : Char, description? : String, env? : String, config? : String, interactive? : async (Context, Bool?) -> Bool?) -> ArgDef[Bool, OptionMetadata]fn double(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : Double?, interactive? : async (Context, Double?) -> Double?) -> ArgDef[Double, OptionMetadata]fn int(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : Int?, interactive? : async (Context, Int?) -> Int?) -> ArgDef[Int, OptionMetadata]fn int64(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : Int64?, interactive? : async (Context, Int64?) -> Int64?) -> ArgDef[Int64, OptionMetadata]fn position_double(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, Double?) -> Double?) -> ArgDef[Double, PositionMetadata]fn position_int(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, Int?) -> Int?) -> ArgDef[Int, PositionMetadata]fn position_int64(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, Int64?) -> Int64?) -> ArgDef[Int64, PositionMetadata]fn position_string(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, String?) -> String?) -> ArgDef[String, PositionMetadata]fn position_uint(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, UInt?) -> UInt?) -> ArgDef[UInt, PositionMetadata]fn position_uint64(name : String, description? : String, config? : String, required? : Bool, interactive? : async (Context, UInt64?) -> UInt64?) -> ArgDef[UInt64, PositionMetadata]fn string(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : String?, interactive? : async (Context, String?) -> String?) -> ArgDef[String, OptionMetadata]fn uint(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : UInt?, interactive? : async (Context, UInt?) -> UInt?) -> ArgDef[UInt, OptionMetadata]fn uint64(name : String, short? : Char, description? : String, env? : String, config? : String, required? : Bool, default? : UInt64?, interactive? : async (Context, UInt64?) -> UInt64?) -> ArgDef[UInt64, OptionMetadata]Install
Download zipAsync-first declarative CLI builder for MoonBit, inspired by gunshi