api

Documentation

Index

• func GetKclPkgPath() (string, error)
• func IsSchema(kt *KclType) bool
• func IsSchemaInstance(kt *KclType) bool
• func IsSchemaNamed(kt *KclType, name string) bool
• func IsSchemaType(kt *KclType) bool
• func RunCurrentPkg(opts *opt.CompileOptions) (*kcl.KCLResultList, error)
• func RunOci(ociRef, version string, opts *opt.CompileOptions) (string, error)
• func RunOciPkg(ociRef, version string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)
• func RunPkg(opts *opt.CompileOptions) (string, error)
• func RunPkgInPath(opts *opt.CompileOptions) (string, error)
• func RunPkgWithOpt(opts *opt.CompileOptions) (*kcl.KCLResultList, error)
• func RunTar(tarPath string, opts *opt.CompileOptions) (string, error)
• func RunTarPkg(tarPath string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)
• func RunWithOpt(opts *opt.CompileOptions) (*kcl.KCLResultList, error)
• func RunWithOpts(opts ...opt.Option) (*kcl.KCLResultList, error)
• type KclPackage
  • func GetKclPackage(pkgPath string) (*KclPackage, error)
  • func (pkg *KclPackage) GetAllSchemaTypeMapping() (map[string]map[string]*KclType, error)
  • func (pkg *KclPackage) GetDependencies() pkg.Dependencies
  • func (pkg *KclPackage) GetEdition() string
  • func (pkg *KclPackage) GetFullSchemaTypeMappingWithFilters(kpmcli *client.KpmClient, fileterFuncs []KclTypeFilterFunc) (map[string]map[string]*KclType, error)
  • func (pkg *KclPackage) GetPkgHomePath() string
  • func (pkg *KclPackage) GetPkgName() string
  • func (pkg *KclPackage) GetPkgProfile() *pkg.Profile
  • func (pkg *KclPackage) GetSchemaTypeMappingNamed(schemaName string) (map[string]map[string]*KclType, error)
  • func (pkg *KclPackage) GetSchemaTypeMappingWithFilters(fileterFuncs []KclTypeFilterFunc) (map[string]map[string]*KclType, error)
  • func (pkg *KclPackage) GetVersion() string
  • func (pkg *KclPackage) UpdateDependencyInPath(pkg_path string) error
• type KclType
  • func NewKclTypes(name, path string, tys *gpyrpc.KclType) *KclType
• type KclTypeFilterFunc

Functions

func GetKclPkgPath

func GetKclPkgPath() (string, error)

GetKclPkgPath will return the value of $KCL_PKG_PATH.

If $KCL_PKG_PATH does not exist, it will return '$HOME/.kcl/kpm' by default.

func IsSchema

func IsSchema(kt *KclType) bool

IsSchema returns true if the type is schema.

func IsSchemaInstance

func IsSchemaInstance(kt *KclType) bool

IsSchemaInstance returns true if the type is schema instance.

func IsSchemaNamed

func IsSchemaNamed(kt *KclType, name string) bool

IsSchemaNamed returns true if the type is schema and the name is equal to the given name.

func IsSchemaType

func IsSchemaType(kt *KclType) bool

IsSchemaType returns true if the type is schema type.

func RunCurrentPkg

func RunCurrentPkg(opts *opt.CompileOptions) (*kcl.KCLResultList, error)

RunCurrentPkg will compile the current kcl package.

func RunOci

func RunOci(ociRef, version string, opts *opt.CompileOptions) (string, error)

RunOci will compile the kcl package from an OCI reference.

func RunOciPkg

func RunOciPkg(ociRef, version string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)

RunOciPkg will compile the kcl package from an OCI reference.

func RunPkg

func RunPkg(opts *opt.CompileOptions) (string, error)

RunPkg will compile current kcl package.

func RunPkgInPath

func RunPkgInPath(opts *opt.CompileOptions) (string, error)

RunPkgInPath will load the 'KclPkg' from path 'pkgPath'. And run the kcl package with entry file in 'entryFilePath' in 'vendorMode'.

func RunPkgWithOpt

func RunPkgWithOpt(opts *opt.CompileOptions) (*kcl.KCLResultList, error)

RunPkgWithOpt will compile the kcl package with the compile options. Deprecated: This method will not be maintained in the future. Use RunWithOpts instead.

func RunTar

func RunTar(tarPath string, opts *opt.CompileOptions) (string, error)

RunTar will compile the kcl package from a kcl package tar.

func RunTarPkg

func RunTarPkg(tarPath string, opts *opt.CompileOptions) (*kcl.KCLResultList, error)

RunTarPkg will compile the kcl package from a kcl package tar.

func RunWithOpt

func RunWithOpt(opts *opt.CompileOptions) (*kcl.KCLResultList, error)

CompileWithOpt will compile the kcl program without kcl package. Deprecated: This method will not be maintained in the future. Use RunWithOpts instead.

func RunWithOpts

func RunWithOpts(opts ...opt.Option) (*kcl.KCLResultList, error)

RunWithOpts will compile the kcl package with the compile options.

Types

type KclPackage

type KclPackage struct {
	// contains filtered or unexported fields
}

The KCL Package

func GetKclPackage

func GetKclPackage(pkgPath string) (*KclPackage, error)

GetKclPackage returns the kcl package infomation.

'pkgPath' is the root path of the package where the 'kcl.mod' is located in.

'kcl_pkg_path' is the path of dependencies download by kpm.

func (*KclPackage) GetAllSchemaTypeMapping

func (pkg *KclPackage) GetAllSchemaTypeMapping() (map[string]map[string]*KclType, error)

GetAllSchemaTypeMapping returns all the schema types of the package.

It will return a map of schema types, the key is the relative path to the package home path.

And, the value is a map of schema types, the key is the schema name, the value is the schema type.

func (*KclPackage) GetDependencies

func (pkg *KclPackage) GetDependencies() pkg.Dependencies

GetDependencies returns the dependencies of the package.

func (*KclPackage) GetEdition

func (pkg *KclPackage) GetEdition() string

GetPkgEdition returns the kcl compiler edition of the package.

func (*KclPackage) GetFullSchemaTypeMappingWithFilters

func (pkg *KclPackage) GetFullSchemaTypeMappingWithFilters(kpmcli *client.KpmClient, fileterFuncs []KclTypeFilterFunc) (map[string]map[string]*KclType, error)

GetFullSchemaTypeMappingWithFilters returns the full schema type filtered by the filter functions.

func (*KclPackage) GetPkgHomePath

func (pkg *KclPackage) GetPkgHomePath() string

GetPkgHomePath returns the home path of the package.

func (*KclPackage) GetPkgName

func (pkg *KclPackage) GetPkgName() string

GetPkgName returns the name of the package.

func (*KclPackage) GetPkgProfile

func (pkg *KclPackage) GetPkgProfile() *pkg.Profile

GetPkgProfile returns the profile of the package.

func (*KclPackage) GetSchemaTypeMappingNamed

func (pkg *KclPackage) GetSchemaTypeMappingNamed(schemaName string) (map[string]map[string]*KclType, error)

GetSchemaTypeMappingNamed returns the schema type filtered by schema name.

If 'schemaName' is empty, it will return all the schema types.

func (*KclPackage) GetSchemaTypeMappingWithFilters

func (pkg *KclPackage) GetSchemaTypeMappingWithFilters(fileterFuncs []KclTypeFilterFunc) (map[string]map[string]*KclType, error)

GetSchemaTypeMappingWithFilters returns the schema type filtered by the filter functions.

func (*KclPackage) GetVersion

func (pkg *KclPackage) GetVersion() string

GetPkgVersion returns the version of the package.

func (*KclPackage) UpdateDependencyInPath

func (pkg *KclPackage) UpdateDependencyInPath(pkg_path string) error

UpdateDependencyInPath updates the dependencies in the path.

'pkg_path' is the path of dependencies download by kpm.

type KclType

type KclType struct {
	Name    string
	RelPath string
	*gpyrpc.KclType
}

An additional field 'Name' is added to the original 'KclType'.

'Name' is the name of the kcl type.

'RelPath' is the relative path to the package home path.

func NewKclTypes

func NewKclTypes(name, path string, tys *gpyrpc.KclType) *KclType

NewKclTypes returns a new KclType.

type KclTypeFilterFunc

type KclTypeFilterFunc func(kt *KclType) bool