The work on this project is mainly based on go-swagger, and this project just adds some KCL-specific templates and language features on 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
-
Since kcl openapi tool is packaged with kusion distribution, and we highly recommend you to install the Kusion tools package which contains the KCL language support and other tools.
-
Or we can only install the tool with go install:
go install kusionstack.io/kcl-openapi@latest
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}
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 mapping 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