The work on this project is mainly based on go-swagger, and this project just adds some KCL-specific templates and language features to it. We are grateful and sincerely respectful for the outstanding work in go-swagger. Meanwhile, we are working on making the customized features separated from the basic OpenAPI logic in go-swagger.
Main use cases:
- Swagger OpenAPI
- Translate Swagger OpenAPI spec to KCL code
- Kubernetes CRD
- Translate Kubernetes CRD to KCL code
The kcl-openapi tool can be installed in both ways:
go install kcl-lang.io/kcl-openapi@latest
If you don't have to go, you can install the CLI with this one-liner:
curl -fsSL https://kcl-lang.io/script/install-kcl-openapi.sh | /bin/bash
# 1. download the released binary from:
# https://github.com/kcl-lang/kcl-openapi/releases
# 2. Unzip the package and add the binary location to PATH
export PATH="<Your directory to store KCLOpenAPI binary>:$PATH"
The tool translates Swagger OpenAPI spec and Kubernetes CRD to KCL models.
The tool now supports OpenAPI 2.0. By parsing the "Definitions" section of the spec, the KCL OpenAPI tool will extract the defined models from it and generate the corresponding KCL representation.
The command is as follows:
kcl-openapi generate model -f ${your_open_api_spec} -t ${the_kcl_files_output_dir}
Note: The Kubernetes KCL models among all versions are pre-generated, you get it by executing
kpm add k8s:<version>
under your project. For detailed information about kpm usage, please refer to kpm quick start guide. Alternatively, if you may want to generate them yourself, please refer Generate KCL Packages from Kubernetes OpenAPI Specs.
The tool can also translate
the Kubernetes CRD to KCL models.
By parsing the spec.versions[n].schema.openAPIV3Schema
(n means the latest version of the spec will be used) section of the CRD, the KCL
OpenAPI tool will extract the structural schema and generate the corresponding KCL representation.
The command is as follows:
kcl-openapi generate model --crd -f ${your_CRD.yaml} -t ${the_kcl_files_output_dir} --skip-validation
The KCL OpenAPI Spec defines a complete specification of how OpenAPI objects are mapped to KCL language elements.
If the tool isn't working as you expect, please reach out to us by filing an issue.
Apache License Version 2.0