1 post tagged with "Release Blog"

简介​

KCL 团队很高兴地宣布 KCL v0.9.0 新版本现在已经可用！本次发布为大家带来了三方面的重点更新

• 使用性能更好、功能更完善和错误更少的 KCL 语言、工具链和 IDE 提升代码编写体验和效率
• 更加全面丰富的标准库、三方库以及社区生态集成，涵盖不同应用场景和需求
• 更丰富的多语言 SDK 和插件，无缝地集成不同编程语言和开发环境

KCL 是一个 CNCF 基金会托管的基于约束的记录及函数语言，期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于构建围绕配置的更好的模块化、扩展性和稳定性，更简单的逻辑编写，以及更简单的自动化和生态工具集成。

❤️ 特别鸣谢​

感谢 KCL 在 v0.8 - v0.9 版本迭代过去 120 天中所有 120 位社区参与者，以下排名不分先后

@Shashank Mittal, @MattHodge, @officialasishkumar, @Gmin2, @Akash Kumar, @sfshumaker, @sanzoghenzo, @MOHAMED FAWAS, @bradkwadsworth-mw, @excalq, @Daksh-10, @metacoma, @Wes McNamee, @Stéphane Este-Gracias, @octonawish-akcodes, @zong-zhe, @shashank-iitbhu, @NAVRockClimber, @AkashKumar7902, @Petrosz007, @patrycju, @Korada Vishal, @selfuryon, @tvandinther, @vtomilov, @Peefy, @taylormonacelli, @Tertium, @Stefano Borrelli, @Bishal, @kukacz, @borgius, @steeling, @jheyduk, @HStéphane Este-Gracias, @userxiaosi, @folliehiyuki, @kubernegit, @nizq, @Alexander Fuchs, @ihor-hrytskiv, @Mohamed Asif, @reedjosh, @Wck-iipi, @evensolberg, @aldoborrero@ron18219, @rodrigoalvamat, @mproffitt, @karlhepler, @shruti2522, @leon-andria, @prahaladramji, @Even Solberg, @utnim2, @warjiang, @Asish Kumar, @He1pa, @Emmanuel Alap, @d4v1d03, @Yvan da Silva, @Abhishek, @DavidChevallier, @zargor, @Kim Sondrup, @SamirMarin, @Hai Wu, @MatisseB, @beholdenkey, @nestoralonso, @HAkash Kumar, @olinux, @liangyuanpeng, @ngergs, @Penguin, @ealap, @markphillips100, @Henri Williams, @eshepelyuk, @CC007, @mintu, @M Slane, @zhuxw, @atelsier, @aleeriz, @LinYunling, @YvanDaSilva, @chai2010, @Sergey Ryabin, @vfarcic, @vemoo, @riven-blade, @ibishal, @empath-nirvana, @bozaro, @jgascon-nx, @reckless-huang, @Sergei Iakovlev, @Blarc, @JeevaRamanathan, @dennybaa, @PrettySolution, @east4ming, @nkabir, @sestegra, @XiaoK29, @ricochet1k, @yjsnly, @umaher, @SjuulJanssen, @wilsonwang371, @Lukáš Kubín, @samuel-deal-tisseo, @blakebarnett, @Uladzislau Maher, @ytsarev, @Vishalk91-4, @Stephen C, @Tom van Dinther, @MrGuoRanDuo, @dopesickjam

📚 重点更新内容​

⚡️ 性能提升​

运行性能​

在 KCL v0.9 新版本中，引入了一个新的快速运行模式，可以通过设置 KCL_FAST_EVAL=1 环境变量开启，从而提升启动速度和运行时性能。

对于使用 Schema 的配置（比如 k8s 三方库），相比于之前的版本可以获得 3 倍左右的性能提升。对于简单的不使用 Schema 的配置，输出 YAML 性能经测试超过 helm template 和 kustomize build 等使用 YAML 和 Go Template 的工具。

IDE 性能​

KCL IDE 在大型项目上针对语义分析部分进行了进一步的增量编译和性能优化，对于 400 个文件左右的 KCL 项目, IDE 端到端响应时间可以减小为之前版本的 20%。

🔧 核心功能​

语言​

• 字符串插值支持类似 Shell 的 \${} 转义功能取消插值

world = "world"
hello_world_0 = "hello ${world}"  # hello world
hello_world_1 = "hello \${world}" # hello ${world}

• typeof 函数新增 Schema 类型的支持用于区分 schema 类型和实例

schema Foo:
    bar?: str

foo = Foo {}
type_schema = typeof(foo) # schema
type_type = typeof(Foo) # type

• Schema 的 instances() 方法新增关键字参数 full_pkg 参数用于读取所有代码中对应 Schema 的实例

schema Person:
    name: str

alice = Person {name = "Alice"}
all_persons = Person.instances(True)

• 去除 bool 类型和 int 类型隐式比较的功能 0 < True
• 去除 list 类型的比较功能 [0] < [1]
• as 关键字增加类型断言失败功能
• 优化 lambda 函数和配置代码块 {} 在不同作用域的闭包变量捕获逻辑，更符合直觉

工具链​

• kcl run 支持使用 --format toml 输出 TOML 格式的配置
• kcl mod add 支持使用 --oci 和 --git 添加私有三方 OCI Registry 和 Git 仓库的依赖
• kcl import 支持从整个 Go Package 导入为 KCL Schema
• kcl import 支持导入带 YAML Stream --- 格式的文件
• kcl import 支持从 TOML 文件导入为 KCL 配置
• kcl clean 支持清理外部依赖和编译缓存
• kcl mod init 支持 --version 标签设置 KCL 新建模块的版本

• kcl run, kcl mod add 和 kcl mod pull 等命令支持通过本地 Git 对私有仓库进行访问

IDE​

• 支持多个 Quick Fix 修复选项
• 支持 kcl.mod 和 kcl.mod.lock 文件的高亮
• IDE 支持部分语法悬停高亮
• 支持 import 对外部依赖的补全
• 支持函数符号的高亮和 Inlay Hints 显示缺省的变量类型

API​

• Override API 支持设置配置覆盖时使用不同的属性运算符 :, = 和 +=
• Go API 支持 prototext 格式和 KCL schema 输出为 KCL 配置
• Go API 支持任意 Go Type 和 Go Value 序列化为 KCL Schema 和配置

📦️ 标准库及三方库​

标准库​

• 新增标准库 file 用于文件 IO 操作，比如从 YAML 读取配置并进行配置合并操作

import file
import yaml
import json_merge_patch as p

config = p.merge(yaml.decode(file.read("deployment.yaml")), {
    metadata.name = "override_value"
})

其他更多 file 模块函数详见：https://www.kcl-lang.io/docs/reference/model/file

• 新增标准库 template 用于模版配置编写

import template

_data = {
    name = "handlebars",
    v = [ { a = 1 }, { a = 2 } ],
    c = { d = 5 },
    g = { b = [ { aa = { bb = 55} }, { aa = { bb = 66} } ] },
    people = [ "Yehuda Katz", "Alan Johnson", "Charles Jolley" ]
}

content = template.execute("""\
Hello world from {{name}}

{{#each v}}
{{this.a}}
{{/each}}
{{ c.d }}
{{#each people}}
{{ this }}
{{/each}}
{{#each g.b}}
{{this.aa.bb}}
{{/each}}
""", _data)

• 新增标准库 runtime 可以用于捕获运行时异常，并用于 kcl test 工具测试异常用例

import runtime

schema Person:
    name: str
    age: int

    check:
        0 <= age <= 120, "age must be in [1, 120], got ${age}"

test_person_check_error = lambda {
    assert runtime.catch(lambda {
        p = Person {name = "Alice", age: -1}
    }) == "age must be in [1, 120], got -1"
}

三方库​

KCL 模型数量新增至 313 个, 主要包含如下更新:

• k8s 发布 1.30 版本
• argo-cd 发布 0.1.1 版本
• argo-workflow 0.0.3 版本
• istio 发布 1.21.2 版本
• victoria-metrics-operator 发布 0.45.1 版本
• cert-manager 发布 0.1.2 版本
• cilium 发布 0.1.1 版本
• Longhorn 发布 0.0.1 版本
• jsonpatch 发布 0.0.5 版本，支持 rfc6901Decode
• 新增 difflib 三方库，支持比较配置差异
• 新增 argo-cd-order 用于排序 argocd 同步操作的资源顺序
• 新增 cluster-api 相关的模型库：包括 cluster-api, cluster-api-provider-metal3, cluster-api-provider-gcp, cluster-api-addon-provider-helm, cluster-api-addon-provider-aws, cluster-api-provider-azure 等

☸️ 生态集成​

• 修复 Argo KCL 插件并发 Sync 报错的问题
• Flux KCL Controller 发布 https://github.com/kcl-lang/flux-kcl-controller，目前支持 OCI 和 Git 配置进行 GitOps
• KCL 正式登陆 Crossplane 函数市场并发布 v0.9.0 版本 https://github.com/crossplane-contrib/function-kcl

apiVersion: apiextensions.crossplane.io/v1
kind: Composition
metadata:
  name: example
spec:
  compositeTypeRef:
    apiVersion: example.crossplane.io/v1beta1
    kind: XR
  mode: Pipeline
  pipeline:
    - step: basic
      functionRef:
        name: function-kcl
      input:
        apiVersion: krm.kcl.dev/v1alpha1
        kind: KCLInput
        source: |
          # Read the XR
          oxr = option("params").oxr
          # Patch the XR with the status field
          dxr = oxr | {
              status.dummy = "cool-status"
          }
          # Construct a AWS bucket
          bucket = {
              apiVersion = "s3.aws.upbound.io/v1beta1"
              kind = "Bucket"
              metadata.annotations: {
                  "krm.kcl.dev/composition-resource-name" = "bucket"
              }
              spec.forProvider.region = option("oxr").spec.region
          }
          # Return the bucket and patched XR
          items = [bucket, dxr]
    - step: automatically-detect-ready-composed-resources
      functionRef:
        name: function-auto-ready

此外，可以在这里找到更多的关于 KCL 和其他生态项目一起使用的真实用例

• https://github.com/mindwm/mindwm-gitops
• https://github.com/vfarcic/crossplane-kubernetes
• https://github.com/giantswarm/crossplane-gs-apis/blob/main/crossplane.giantswarm.io/xnetworks/package/compositions/peered-vpc-network.yaml
• https://github.com/upbound/configuration-aws-eks/blob/main/apis/composition-kcl.yaml

🧩 多语言 SDK 和插件​

多语言 SDK​

KCL 多语言 SDK 新增至 7 个, 目前主要支持 Rust, Go, Java, .NET, Python, Node.js 和 WASM，无需额外安装 KCL 命令行即可使用，安装体积优化为之前版本的 90%，且不需要复杂的系统依赖。

此外，不同的 SDK 均提供了相同的 API，主要包括代码运行，代码分析，类型解析和添加外部依赖等操作，下面以 Java 和 C# SDK 为例

• Java

import com.kcl.api.API;
import com.kcl.api.Spec.ExecProgram_Args;
import com.kcl.api.Spec.ExecProgram_Result;

public class ExecProgramTest {
    public static void main(String[] args) throws Exception {
        API api = new API();
        ExecProgram_Result result = api
                .execProgram(ExecProgram_Args.newBuilder().addKFilenameList("path/to/kcl.k").build());
        System.out.println(result.getYamlResult());
    }
}

• C#

namespace KclLib.Tests;

using KclLib.API;

public class KclLibAPITest
{
    public static void Main()
    {
        var execArgs = new ExecProgram_Args();
        execArgs.KFilenameList.Add("path/to/kcl.k");
        var result = new API().ExecProgram(execArgs);
        Console.WriteLine(result.YamlResult);
    }
}

更多其他 SDK 安装和使用方式详见：https://github.com/kcl-lang/lib

多语言插件更新​

KCL 多语言插件新增至 3 个，目前主要支持 Go, Python 和 Java, 仅需要基础的 SDK 依赖，可以实现通用语言和 KCL 的无缝互操作，下面以 Python 和 Java 插件为例

编写如下 KCL 代码 (main.k)

import kcl_plugin.my_plugin

result = my_plugin.add(1, 1)

使用 Python SDK 注册 Python 函数实现在 KCL 中调用

import kcl_lib.plugin as plugin
import kcl_lib.api as api

plugin.register_plugin("my_plugin", {"add": lambda x, y: x + y})

def main():
    result = api.API().exec_program(
        api.ExecProgram_Args(k_filename_list=["main.k"])
    )
    assert result.yaml_result == "result: 2"

main()

使用 Java SDK 注册 Java 函数实现在 KCL 中调用

package com.kcl;

import com.kcl.api.API;
import com.kcl.api.Spec.ExecProgram_Args;
import com.kcl.api.Spec.ExecProgram_Result;

import java.util.Collections;

public class PluginTest {
    public static void main(String[] mainArgs) throws Exception {
        API.registerPlugin("my_plugin", Collections.singletonMap("add", (args, kwArgs) -> {
            return (int) args[0] + (int) args[1];
        }));
        ExecProgram_Result result = new API()
                .execProgram(ExecProgram_Args.newBuilder().addKFilenameList("main.k").build());
        System.out.println(result.getYamlResult());
    }
}

更多其他多语言插件使用方式详见：https://www.kcl-lang.io/docs/reference/plugin/overview

此外，可以在这里找到更多的关于 KCL 多语言插件使用的真实用例

• https://github.com/cakehappens/kcfoil/blob/main/cmd/kcf/template.go

🌐 其他资源​

🔥 查看 KCL 社区 加入我们 🔥

更多其他资源请参考：

• KCL 网站
• KusionStack 网站

简介​

KCL 团队很高兴地宣布 KCL v0.8.0 新版本现在已经可用！本次发布为大家带来了三方面的重点更新：语言、工具链、社区集成 & 扩展支持。

• 使用功能更完善错误更少的 KCL 语言、工具链和 IDE 提升代码编写体验和效率
• 更加全面丰富的社区生态集成，改善运维体验
• 更加丰富的 KCL 三方库模型，更加轻松的与云原生生态集成

进一步您可以在 KCL v0.8.0 发布页面 或者 KCL 官方网站 获得下载安装指南和详细发布信息。

KCL 是一个 CNCF 基金会托管的面向云原生领域开源的基于约束的记录及函数编程语言，期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于围绕配置的模块化、扩展性和稳定性，打造更简单的逻辑编写体验，构建更简单的自动化和生态集成路径。

语言更新​

🚗 语法语义更新​

支持 show-hidden​

通过 --show-hidden 参数显示私有变量。

KCL 程序如下

a = {_b = 1}

通过命令 kcl run main.k --show-hidden 编译结果如下

a:
  _b: 1

支持参数和关键字参数的合并​

KCL v0.8.0 版本中新增了参数和关键字参数的合并功能。带参数的 schema 实例在合并操作时参数也会合并。

schema Person[separator]:
    firstName: str = "John"
    lastName: str
    fullName: str = firstName + separator + lastName

x = Person(" ") {lastName = "Doe"}

y = Person("-") {lastName = "Doe1"}

z = x | y

对应编译结果

x:
  firstName: John
  lastName: Doe
  fullName: John Doe
y:
  firstName: John
  lastName: Doe1
  fullName: John-Doe1
z:
  firstName: John
  lastName: Doe1
  fullName: John-Doe1

支持字面值的 yaml stream 格式输出.​

通过 yaml_stream 方法，可以支持输出 yaml 字面值的结果。

import manifests

x0 = 1
x1 = 2
manifests.yaml_stream([x0, x1])

对应编译结果

1
---
2

修复了在循环表达式中的类型检查错误​

name = "volume"
configMapVolumes1: {str:{str:}} = {
    name = {
        name = name
    } for _ in range(1)
}

configMapVolumes2: [{str:}] = [
    {
        name = name
    } for _ in range(1)
]

在 v0.8.0 之前，上述程序编译会出现类型错误。

error[E2G22]: TypeError
 --> main.k:4:9
  |
4 |         name = name
  |         ^ expected {str:any}, got str
  |

 --> main.k:2:1
  |
2 | configMapVolumes1: {str:{str:}} = {
  | ^ variable is defined here, its type is {str:any}, but got str
  |

在 v0.8.0 版本中, 将会成功编译出如下结果：

name: volume
configMapVolumes1:
  volume:
    name: volume

修复了 Schema 对象必选属性递归检查错误​

在 Schema 内部定义了一个对象，对象内部的属性是必选的，但是在实例化时使用不存在的属性。

schema Name:
    name: str

schema Config:
    n: {str:Name}

Config {
    n = {
        n.n = "n"
    }
}

在 v0.8.0 之后，上述程序编译会出现类型错误。

error[E2L23]: CompileError
 --> main.k:9:11
  |
9 |         n.n = "n"
  |           ^ Cannot add member 'n' to schema 'Name'
  |

在编译输出结果中去掉 __settings__ 属性​

在 v0.8.0 版本中，编译输出结果中去掉了 __settings__ 属性。

schema Person:
    __settings__: {str:str} = {"output_type": "STANDALONE"}
    name?: str
    age?: int
    school?: str

a = Person{
    name: "a",
}

在编译结果中去掉了 __settings__ 属性。

a:
  name: a

支持在 config 表达式中计算 key 和 value 的值​

在 v0.8.0 版本中，支持在 config 表达式中计算 key 和 value 的值。

_data = {
    "a": 'foo'
    "b": 'bar'
}

r0 = [{v = k} for k, v in _data]
r1 = [{k = v} for k, v in _data]
r2 = [{k.foo = v} for k, v in _data]
r3 = [[k] for k, v in _data]
r4 = [[k, v] for k, v in _data]

编译结果如下：

r0:
  - foo: a
  - bar: b
r1:
  - a: foo
  - b: bar
r2:
  - a:
      foo: foo
  - b:
      foo: bar
r3:
  - - a
  - - b
r4:
  - - a
    - foo
  - - b
    - bar

🔧 诊断信息的优化​

KCL 语法在 if 块中使用的是 elif 关键字，而不是 else if。

编译以下 KCL 程序：

if True: a = 1
else if False: b = 1

KCL 在诊断信息中增加了错误修正的建议：

error[E1001]: InvalidSyntax
 --> main.k:2:6
  |
2 | else if False: b = 1
  |      ^ 'else if' here is invalid in KCL, consider using the 'elif' keyword
  |

🚀 语言编写体验优化​

KCL 标准库新增文件系统访问方法​

KCL 增加了访问文件系统的方法。在 v0.8.0 版本中支持了包括 read, glob 等访问文件系统的方法。

通过 read 方法，可以读取一个文件内容为字符串。

import file

a = file.read("hello.txt")

在文件 hello.txt 中添加如下内容：

Hello World !

编译结果

a: Hello World !

通过结合 json.decode 方法，可以轻松的实现将 json 文件反序列化。

在 hello.json 文件中增加如下内容

{
  "name": "John",
  "age": 10
}

KCL 程序如下所示：

import file
import json

_a = json.decode(file.read("hello.json"))

name = _a.name
age = _a.age

编译结果如下所示：

name: John
age: 10

更多内容 - https://kcl-lang.io/zh-CN/docs/reference/model/file/

KCL 编译缓存路径支持使用环境变量 KCL_CACHE_PATH 指定​

KCL 编译器会将缓存生成到环境变量KCL_CACHE_PATH指定的目录当中，如果没指定，将会生成到项目根目录中。

插件系统支持使用 golang 编写 KCL 插件​

使用 golang 定义 hello 插件。

package hello_plugin

import (
    "kcl-lang.io/kcl-go/pkg/plugin"
)

func init() {
    plugin.RegisterPlugin(plugin.Plugin{
        Name: "hello",
        MethodMap: map[string]plugin.MethodSpec{
            "add": {
                Body: func(args *plugin.MethodArgs) (*plugin.MethodResult, error) {
                    v := args.IntArg(0) + args.IntArg(1)
                    return &plugin.MethodResult{V: v}, nil
                },
            },
        },
    })
}

借助 kcl-go 开发，扩展 KCL 编译器使用插件。

package main

import (
    "fmt"

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

func main() {
    // Note we use `native.MustRun` here instead of `kcl.MustRun`, because it needs the cgo feature.
    yaml := native.MustRun("main.k", kcl.WithCode(code)).GetRawYamlResult()
    fmt.Println(yaml)
}

const code = `
import kcl_plugin.hello

name = "kcl"
three = hello.add(1,2) # 3

😸 新增 Linux arm64 版本​

KCL 的 Release 产物中新增了对 Linux arm64 平台的支持。

可以在 KCL Release Page 中找到后缀为 linux-arm64 的压缩包。

🏄 SDK & API 更新​

Rust SDK​

KCL Rust SDK 提供了一系列的 API，可以用于 KCL 文件的编译、校验、测试和格式化代码等操作。

KCL Rust SDK: https://github.com/kcl-lang/lib

Java SDK​

KCL Java SDK 新增语法树、作用域、符号等语法语义结构定义及相关查询 API。

Go SDK 更新​

• KCL Doc 工具支持输出为 OpenAPI 格式。
• 增加 Parse 过程相关 API。

API 更新​

• 新增 json/yaml 验证 API 用来验证 json 和 yaml 文件。
• 新增语法和语义分析 API 用于对 KCL 代码进行分析。
• 新增构建二进制产物 API 用于缓存编译结果。
• 新增运行二进制产物 API 用于直接运行编译结果，避免重复编译并提升性能。
• 新增代码生成 API 以编程方式实现 KCL 代码生成而不是编写复杂的模版。

更多的更新可以查看 KCL v0.8 API 文档

🐞 其他更新及错误修复​

• 修复了 KCL CLI 使用编译参数 -S 可能会导致的编译错误
• 修复了 kcl fmt 工具对 lambda 表达式进行格式化时，结尾增加一个空行的错误。
• 修复 Schema Doc 补全代码片段错误
• 修复 Schema 对象必选属性递归检查错误
• 提升 Schema 索引签名类型检查健壮性
• 修复 Schema 内部诸如 "$if" 的字符串标识符定义找不到的错误
• 优化非预期 token 的语法错误提示
• 修复非预期的字典生成表达式中的 key 与循环变量相同时的变量计算

IDE & 工具链更新​

IDE 更新​

IDE 语义级别的高亮增强​

KCL IDE 高亮之前仅支持 KCL 语法高亮，如下图所示：

我们今年逐步启用了新的 KCL 语义架构模型，在新语义架构的支撑下，KCL IDE 支持语义级别的高亮，在语义上有关联的代码会显示相同的高亮。

更多关于 KCL 语义架构模型的内容，参考： KCL 高效语义模型技术揭秘：实现快速编译与增强 IDE 支持

新增 builtin 方法的补全​

KCL IDE 支持 builtin 方法的补全，如下图所示：

增加变量引用错误时的快速修复功能​

KCL IDE 支持变量引用错误时的快速修复功能，如下图所示：

IDE 支持增量解析和异步编译功能​

IDE 通过 KCL 新语义模型支持增量解析和异步编译功能，提升了编译速度和编写体验。

更多内容详见 https://kcl-lang.io/zh-CN/blog/2023-12-09-kcl-new-semantic-model

IDE LSP 问题修复​

• 修复 assert 语句中字符串插值变量不能跳转的异常
• 修复了字符串中异常触发函数补全的异常
• 修复了字符串后跟注释中补全错误的问题
• 修复了 schema 内部属性符号不能跳转的问题
• 修复 import 语句别名语义检查和补全的异常
• 修复了 schema 中 check 表达式补全的异常
• 修复了嵌套 schema 定义中补全错误的问题
• 修复了部分悬停信息缺失的问题
• 修复不同语法补全符号类型不统一的问题
• 区分 Schema 类型和实例补全符号
• 统一 Schema 注释文档补全的格式
• 修复了配置块内部 if 语句符号不能跳转和补全的问题

验证工具更新​

本次更新中，我们对 KCL 验证工具的报错信息进行了优化，在使用 KCL 验证工具对 json/yaml 文件进行验证的工作中，将会准确定位到 json 文件的异常位置。

以 json 文件为例，我们将要对以下 hello.json 文件进行验证

{
  "name": 10,
  "age": 18,
  "message": "This is Alice"
}

定义如下 main.k 文件来对 json 文件中的内容进行验证

schema User:
    name: str
    age: int
    message?: str

通过以下命令对 json 文件内容进行验证

kcl vet hello.json main.k

可以看到在 json 文件中的错误位置：

error[E2G22]: TypeError
 --> test.json:2:5
  |
2 |     "name": 10,
  |     ^ expected str, got int(10)
  |

 --> main.k:2:5
  |
2 |     name: str
  |     ^ variable is defined here, its type is str, but got int(10)
  |

KCL cli 新增 git 仓库作为编译入口​

通过以下命令，可以将 KCL 的 git 仓库作为编译入口

kcl run <git url>

kcl mod graph 支持输出 KCL 包依赖图​

通过命令 kcl mod graph 输出 KCL 包的依赖图。

KCL 包管理工具​

KCL 包管理支持通过 commit 添加 git 依赖​

KCL 包管理工具增加了通过 commit 来添加 git 三方库依赖的功能。以 https://github.com/KusionStack/catalog 为例，添加 commit 为 a29e3db 的版本作为依赖。可以通过编辑 kcl.mod 文件中的依赖或者命令行直接添加。

编辑 kcl.mod 文件内容如下：

[dependencies]
catalog = { git = "https://github.com/KusionStack/catalog.git", commit = "a29e3db" }

或者通过命令行添加：

kcl mod add --git https://github.com/KusionStack/catalog.git --commit a29e3db

KCL 包管理工具支持三方库名称带有“-”​

KCL 包管理工具支持三方库名称中带有“-”，KCL 包管理工具会自动将 “-” 替换为 “_”。

以三方库 set-annotation 为例，通过以下命令添加 set-annotation 为依赖：

kcl mod add set-annotation

在 KCL 程序中，通过 set_annotation 引用：

import set_annotation

KCL 导入工具更新，支持更多特性​

• 支持 OpenAPI multiplyOf 规范映射到 KCL multiplyof 函数进行校验
• 支持 YAML Stream 格式的 Kubernetes CRD 文件输出为多个 KCL 文件
• 支持 OpenAPI allOf 关键字校验表达式生成
• 支持 KCL 数组和字典类型的 all/any 校验表达式生成

社区集成 & 扩展更新​

Flux KCL Controller 发布​

我们开发了 Flux KCL Controller 支持 KCL 与 Flux 集成。在集群中安装 Flux KCL Controller 后，通过以下资源就可以实现 KCL git 仓库通过 FluxCD 进行持续集成。

apiVersion: source.toolkit.fluxcd.io/v1
kind: GitRepository
metadata:
  name: kcl-deployment
  namespace: source-system
spec:
  interval: 30s
  # 需要持续集成的 github 仓库
  url: https://github.com/awesome-kusion/kcl-deployment.git
  ref:
    branch: main
---
apiVersion: krm.kcl.dev.fluxcd/v1alpha1
kind: KCLRun
metadata:
  name: kcl-deployment
  namespace: source-system
spec:
  sourceRef:
    kind: GitRepository
    name: kcl-deployment

更多内容详见: https://kcl-lang.io/zh-CN/blog/2024-02-01-biweekly-newsletter/

CodeQL KCL 工具​

初步支持 CodeQL KCL dbschema 定义以及对 KCL 语法语义进行数据提取，并可通过 CodeQL 进行数据查询对 KCL 代码进行静态分析和扫描，提升代码安全。

更多内容详见: https://github.com/kcl-lang/codeql-kcl

模型更新​

KCL 模型数量新增至 303 个，主要新增与 Crossplane Provider 相关的模型和与 JSON 合并操作相关的库

• KCL JSON Patch 库：https://artifacthub.io/packages/kcl/kcl-module/jsonpatch

• KCL JSON Merge Patch 库：https://artifacthub.io/packages/kcl/kcl-module/json_merge_patch

• KCL Kubernetes Strategy Merge Patch 库：https://artifacthub.io/packages/kcl/kcl-module/strategic_merge_patch

• KCL Crossplane 及 Crossplane Provider 系列模型：https://artifacthub.io/packages/search?org=kcl&sort=relevance&page=1&ts_query_web=crossplane

• Kubenetes 1.29 版本: https://artifacthub.io/packages/kcl/kcl-module/k8s/1.29.0

• 新增 Podinfo 应用配置模型，支持设置外部动态参数如 replicas 等，可以直接通过一条命令渲染 Kubernetes 资源配置，并且可以在此模型的基础上修改并自定义资源模版

kcl run oci://ghcr.io/kcl-lang/podinfo -D replicas=2

• JSON Schema 库发布 0.0.4 版本，修复类型定义错误, 可以执行如下命令更新或添加依赖

kcl mod add jsonschema:0.0.4

其他更新​

完整更新和错误修复列表详见: https://github.com/kcl-lang/kcl/compare/v0.7.0...v0.8.0

文档更新​

KCL 网站新增 KCL v0.7.0 文档内容并支持版本化语义选项，目前支持 v0.4.x, v0.5.x, v0.6.x, v0.7.0 和 v0.8.0 版本选择，同时欢迎社区同学进行文档共建。

社区动态​

KCL LFX 项目启动​

恭喜 @AkashKumar7902, @octonawish-akcodes, @shashank-iitbhu 入选 CNCF KCL LFX 项目，同时感谢 @Vanshikav123, @Amit Pandey 的积极参与。

KCL 登陆 Crossplane 官方函数市场​

自 Crossplane v1.14 中的组合函数 Beta 版发布以来，使用 Crossplane 构建云原生平台的可能体验范围一直在迅速扩大。KCL 团队在第一时间进行跟进并主动构建了一个可重用的函数，整个 Crossplane 生态系统现在可以利用 KCL 提供的高水平经验和能力来构建自己的云原生平台。

更多内容详见: https://blog.crossplane.io/function-kcl/

特别鸣谢​

感谢社区的小伙伴在 KCL v0.8.0 版本中的贡献，以下排名不分先后

• 感谢 @jakezhu9 同学对 kcl import 工具的持续贡献 🤝
• 感谢 @octonawish-akcodes 对 KCL 代码清理和 FAQ 文档的持续贡献 🙌
• 感谢 @satyazzz123 对 KRM KCL 支持读取环境变量功能的贡献 🙌
• 感谢 @AkashKumar7902 对 KCL 包管理工具功能的贡献 🙌
• 感谢 @UtkarshUmre 对 KCL linux-arm64 构建 CI 的贡献 🙌
• 感谢 @octonawish-akcodes 和 @d4v1d03 对 KCL FAQ 文档和 KCL IDE 功能的持续贡献 🙌
• 感谢 @octonawish-akcodes 对 Ansible KCL Module 的贡献
• 感谢 @AkashKumar7902 和 @Vanshikav123 对 KCL 包管理工具功能的贡献 🙌
• 感谢 @StevenLeiZhang 对 KCL 文档和 KCL 插件的贡献 🙌
• 感谢 @patrycju, @Callum Lyall, @Matt Gowie, @ShiroDN, @FLAGLORD, @YiuTerran, @flyinox, @steeling, @Anoop, @Even Solberg，@Phillip Neumann，@Naxe, @rozaliev, @CloudZero357, @martingreber, @az, @Art3mK, @Erick, @TheChinBot, @Evgeny Shepelyuk, @yonas, @vtomilov, @Fdall, @bozaro, @starkers, 和 @MrGuoRanDuo 等在 KCL v0.8 版本迭代过程中使用 KCL 提供的宝贵建议与反馈 🙌

下一步计划​

感谢所有 KCL 用户和社区小伙伴在此次版本更新过程中提出的宝贵反馈与建议。预计 2024 年 5 月，我们将发布 KCL v0.9.0 版本，更多详情请参考 KCL 2024 路线规划 和 KCL v0.9.0 Milestone，如果您有更多的想法和需求，欢迎在 KCL Github 仓库发起 Issues 或讨论，也欢迎加入我们的社区进行交流 🙌 🙌 🙌

更多其他资源请参考：

• KCL 网站: https://kcl-lang.io/

• KusionStack 网站: https://kusionstack.io/

• KCL GitHub 仓库: https://github.com/kcl-lang

• KusionStack GitHub 仓库: https://github.com/KusionStack

• KCL v0.9.0 Milestone: https://github.com/kcl-lang/kcl/milestone/9

• KCL 2024 路线规划: https://github.com/kcl-lang/kcl/issues/882

• KCL 社区: https://github.com/kcl-lang/community