moonbitstack/moonctl/doc

README
U
Bind
U
DataSource
U
DataSourceError
U
DdlColumn
U
DdlTable
U
DocVersion
U
Field
U
FuncFn
U
GenFile
U
Group
U
Label
U
PgTarget
U
Plugin
U
Proto
U
ProtoEnum
U
ProtoEnumValue
U
ProtoField
U
ProtoMessage
U
ProtoOneof
U
ProtoService
U
Range
U
ReflectedColumn
U
Regen
U
Route
U
Rpc
U
Spec
U
SpecError
U
Style
U
StyleError
U
Template
U
TemplateError
U
TreeFile
U
TypeDef
U
Value
V
deps
V
gen_files_to_json
V
generate
V
generate_agent
V
generate_crud
V
generate_crud_from_ddl
V
generate_crud_from_reflection
V
generate_doc
V
generate_gql
V
generate_gql_tree
V
generate_grpc
V
generate_model
V
generate_rpc_tree
V
generate_tree
V
generate_with
V
openapi_document
V
parse
V
parse_all
V
parse_ddl
V
parse_dsn
V
parse_gen_files
V
parse_lenient
V
parse_proto
V
pins
V
plugin_argv
V
plugin_from_json
V
plugin_request
V
port
V
proto_reserved_conflicts
V
render
V
resolve_import
V
scaffold_api
V
scaffold_docker
V
scaffold_gql
V
scaffold_kube
V
scaffold_model
V
scaffold_rpc
V
spec_from_json
V
spec_to_json
V
spec_to_value
V
swagger_ui_stub
V
tables_from_reflection
V
tree_plan

moonbitstack/moonctl/doc does not have a README file

DocVersion

pub(all) enum DocVersion {
  Swagger20
  OpenApi30
  OpenApi31
} derive(Eq)

Target OpenAPI / Swagger document version. mctl emits every mainstream version from one .api spec — the same shape moonapi's runtime emitter takes, so a generated service and a hand-built moonapi app document the same way.

DocVersion::equal

source

fn DocVersion::equal(DocVersion, DocVersion) -> Bool

DocVersion::not_equal

source

fn DocVersion::not_equal(x : DocVersion, y : DocVersion) -> Bool

generate_doc

source

fn generate_doc(spec : @moonbitstack/moonctl/api.Spec
Spec, version? : DocVersion, title? : String, api_version? : String) -> String

Generate an OpenAPI / Swagger document from spec, stringified with two-space indentation. version picks the dialect (Swagger 2.0 / OpenAPI 3.0 / 3.1).

openapi_document

source

fn openapi_document(spec : @moonbitstack/moonctl/api.Spec
Spec, version? : DocVersion, title? : String, api_version? : String) -> Json

Build the OpenAPI / Swagger document for spec as a Json value. Routes fold into paths → HTTP method → operation (with operationId, any :name path parameters, and a 200 response); every type block becomes a component schema (definitions in 2.0, components/schemas in 3.x). version selects the document dialect; title/api_version fill the info block.

swagger_ui_stub

source

fn swagger_ui_stub(spec_url? : String, title? : String) -> String

A self-contained Swagger UI page for the document served at spec_url. The same stub moonapi ships, so a generated service and a live app render alike.

Source Files

doc.mbt

Install

Download zip

moonctl (mctl) — a spec-driven code generator for MoonBit (← goctl): parse a .api service spec and emit compilable moonapi scaffolding (routes + handler stubs).

goctlcodegenscaffoldapimoonapimoonbitcli