kcl-go - GitLite

KO | EN

gitlite — search

#ai #typescript #go #android #linux #docker #windows #awesome #cli #kubernetes #vue #security #pytorch #mcp

kcl-go

(★ 57)

KCL Go SDK

파일 탐색기

최종 버전 다운로드 (.zip)

- - codeql-analysis.yml
  - main_darwin.yml
  - main_linux.yml
  - main_linux_musl.yml
  - main_windows.yml
- dependabot.yml
- api.md
- - main.go
- - main.go
- - ast.go
  - expr.go
  - json.go
  - op.go
  - stmt.go
  - type.go
- - api.go
  - api_test.go
  - hook.go
  - opt.go
  - opt_test.go
  - service.go
  - testing_test.go
  - type.go
  - version.go
- - options.go
  - options_test.go
  - package.go
  - variables.go
- - example_test.go
  - logger.go
- - client.go
  - client_test.go
- - parser.go
  - parser_test.go
- - api.go
  - api_test.go
  - error.go
  - plugin.go
  - spec.go
- - rest_server.go
- - service.go
- - a_test.go
  - a_test_unix.go
  - a_test_windows.go
  - kcl.mod
  - utils_settings_yaml.go
- - source.go
- - assert.go
  - pkg_path_test.go
  - pkg_root.go
  - utils.go
- kcl.go
- util_fs.go
- util_http_get.go
- util_md5.go
- util_untargz.go
- util_unzip.go
- util_zipfs.go
- - kcl.yaml
  - main.k
- - kcl.yaml
  - main.k
- - base.k
  - schema.k
- - hello.k
  - hello_test.k
- - main.k
- - kcl.mod
- - a.k
  - import.k
  - kcl.mod
- - main.k
- - one_stream.k
  - two_stream.k
- - sub.k
  - sub_test.k
- - kcl.mod
- - kcl.mod
  - main.k
- - kcl.mod
  - main.k
- - kcl.mod
  - main.k
- - hello.k
  - hello.k.json
  - sample.k
  - sample.k.json
- - settings.yaml
- kcl.mod
- main.k
.editorconfig
.gitignore
bench_test.go
example_test.go
go.mod
go.sum
hello.k
kcl.go
kcl_test.go
kcl_version.go
LICENSE
Makefile
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/kcl-lang/kcl-go

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd kcl-go

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Go

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Go Go 언어 컴파일러 및 도구 모음입니다.

go run ./examples/kubernetes/main.go

따로 빌드하지 않고 바로 Go 프로그램을 실행합니다.

✅ 빌드가 에러 없이 끝나면 성공입니다. go run . 을 썼다면 터미널 출력을 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Make

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Make Linux/macOS는 보통 기본 설치되어 있습니다. Windows는 별도 설치(예: MSYS2, WSL)가 필요합니다.

make

생성된 빌드 설정을 바탕으로 실제 컴파일을 진행해 실행 파일을 만듭니다.

✅ 에러 없이 끝나면 성공입니다. 생성된 실행 파일을 직접 실행해보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# KCL Go SDK

[![GoDoc](https://godoc.org/github.com/kcl-lang/kcl-go?status.svg)](https://godoc.org/github.com/kcl-lang/kcl-go)
[![Coverage Status](https://coveralls.io/repos/github/kcl-lang/kcl-go/badge.svg)](https://coveralls.io/github/kcl-lang/kcl-go)
[![license](https://img.shields.io/github/license/kcl-lang/kcl-go.svg)](https://github.com/kcl-lang/kcl-go/blob/master/LICENSE)
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fkcl-lang%2Fkcl-go.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fkcl-lang%2Fkcl-go?ref=badge_shield)

[KCL](https://github.com/kcl-lang/kcl) is an open-source, constraint-based record and functional language that enhances the writing of complex configurations, including those for cloud-native scenarios. With its advanced programming language technology and practices, KCL is dedicated to promoting better modularity, scalability, and stability for configurations. It enables simpler logic writing and offers ease of automation APIs and integration with homegrown systems.

## What is it for?

You can use KCL to

+ [Generate low-level static configuration data](https://kcl-lang.io/docs/user_docs/guides/configuration) such as JSON, YAML, etc., or [integrate with existing data](https://kcl-lang.io/docs/user_docs/guides/data-integration).
+ Reduce boilerplate in configuration data with the [schema modeling](https://kcl-lang.io/docs/user_docs/guides/schema-definition).
+ Define schemas with [rule constraints for configuration data and validate](https://kcl-lang.io/docs/user_docs/guides/validation) them automatically.
+ Organize, simplify, unify and manage large configurations without side effects through [gradient automation schemes and GitOps](https://kcl-lang.io/docs/user_docs/guides/automation).
+ Manage large configurations in a scalable way with [isolated configuration blocks](https://kcl-lang.io/docs/reference/lang/tour#config-operations).
+ Mutating or validating Kubernetes resources with [cloud-native configuration tool plugins](https://kcl-lang.io/docs/user_docs/guides/working-with-k8s/).
+ Used as a platform engineering programming language to deliver modern applications with [Kusion Stack](https://kusionstack.io).

## Building & Testing

- [Install Go 1.24+](https://go.dev/dl/)

```bash
go test ./...
```

## Run KCL Code with Go SDK

```go
package main

import (
	"fmt"

kcl "kcl-lang.io/kcl-go"
)

func main() {
	yaml := kcl.MustRun("kubernetes.k", kcl.WithCode(code)).GetRawYamlResult()
	fmt.Println(yaml)
}

const code = `
apiVersion = "apps/v1"
kind = "Deployment"
metadata = {
    name = "nginx"
    labels.app = "nginx"
}
spec = {
    replicas = 3
    selector.matchLabels = metadata.labels
    template.metadata.labels = metadata.labels
    template.spec.containers = [
        {
            name = metadata.name
            image = "${metadata.name}:1.14.2"
            ports = [{ containerPort = 80 }]
        }
    ]
}
`
```

Run the command:

```bash
go run ./examples/kubernetes/main.go
```

Output:

```yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
  labels:
    app: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:1.14.2
        ports:
        - containerPort: 80
```

## Run KCL Code with Go Plugin

```go
package main

import (
	"fmt"

"kcl-lang.io/kcl-go/pkg/kcl"
	_ "kcl-lang.io/kcl-go/pkg/plugin/hello_plugin" // Import the hello plugin
)

func main() {
	yaml := kcl.MustRun("main.k", kcl.WithCode(code)).GetRawYamlResult()
	fmt.Println(yaml)
}

const code = `
import kcl_plugin.hello

name = "kcl"
three = hello.add(1,2)  # hello.add is written by Go
`
```

> Note: CGO is required when using plugins

## Documents

See the [KCL website](https://kcl-lang.io)

## License

Apache License Version 2.0

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fkcl-lang%2Fkcl-go.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2Fkcl-lang%2Fkcl-go?ref=badge_large)