KCL v0.10.0 重磅发布 - 更稳定流畅的工具链和 IDE 体验，全新的 KCL Playground !

🔧  核心功能

语言

• 赋值语句中被赋值对象支持属性访问和索引访问。

现在，你可以通过索引访问的方式对被赋值对象的内容进行更改。

_a = [0, 1] * 2
_a[0] = 2
_a[1] += 2
a = _a

通过编译，你将可以得到如下结果

a:
- 2
- 3
- 0
- 1

你也可以通过属性访问的方式对被赋值对象的内容进行更改。

_a = [{key1.key2 = [0] * 2}, {key3.key4 = [0] * 2}]
_a[0].key1.key2[0] = 1
_a[1].key3.key4[1] += 1
a = _a

通过编译，你可以得到如下结果： 

a:
- key1:
    key2:
    - 1
    - 0
- key3:
    key4:
    - 0
    - 1

• 对类型为单子面值常量 Schema 属性支持省略默认值

schema Deployment:
    apiVersion: "apps/v1" = "apps/v1"

schema Deployment:
    apiVersion: "apps/v1"  # 类型值与默认值相同，可以省略默认值

• 修复了 KCL 嵌套多层 config 块语义检查时间过长的问题。
• 去掉了语义解析器中的 unwrap() 语句, 减少 panic 的问题。
• 修复了带有 list index 的字段合并运算的计算错误。
• 修复 as 关键字在外部包存在时类型转换的错误
• 修复在 lambda 函数中 config 到 schema 的类型检查错误
• 优化函数参数调用/返回值 Dict 转 Schema 类型推导和检查，可以省略 Schema 名称简化配置书写
• 赋值语句支持形如 _config["key"] = "value" 或 _config.key = "value"的语法对配置进行原地修改
• 优化配置合并运算符的类型检查，可以在编译时发现更多类型错误
• 修复了 built-in API datetime 中日期格式的问题。
• 修复了 Schema 配置合并参数解析错误的问题。
• 优化了 KCL 部分报错信息。
• KCL 修复了 Schema 继承中循环依赖导致的异常错误。
• KCL 修复了配置自动合并失效的问题。
• KCL 优化了 Schema 继承中循环依赖的错误信息。
• KCL 对编译入口部分代码进行了重构。
• KCL 新增了 windows mingw 环境下链接库的 release。
• KCL 修复了 windows 环境下的 CI 错误。
• 优化了 KCL 运行时错误信息并且新增了部分测试用例。

• kcl test 测试工具支持测试用例中的 print 函数输出

你可以在测试用例中使用 print 输出日志

test_print = lambda {
    print("Test Begin ...")
}

通过 kcl test 命令运行测试用例，你可以看到对应日志：

test_print: PASS (9ms)
Test Begin ...

--------------------------------------------------------------------------------
PASS: 1/1

• kcl import 工具新增对包含 AllOf 验证字段的 JSON Schema 格式导入为 KCL Schema 的支持

对于如下包含 AllOf 验证字段的 JSON Schema：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://example.com/schemas/config",
  "description": "Schema for representing a config information.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "allOf": [
        {
          "pattern": "198.160"
        },
        {
          "pattern": "198.161"
        },
        {
          "pattern": "198.162"
        }
      ]
    },
    "price": {
      "type": "number",
      "minimum": 0
    }
  },
  "required": [
    "name"
  ]
}

将会生成对应 KCL Schema:

"""
This file was generated by the KCL auto-gen tool. DO NOT EDIT.
Editing this file might prove futile when you re-run the KCL auto-gen generate command.
"""
import regex

schema Config:
    r"""
    Schema for representing a config information.

    Attributes
    ----------
    name : str, required
    price : float, optional
    """

    name: str
    price?: float

    check:
        regex.match(name, r"198.160")
        regex.match(name, r"198.161")
        regex.match(name, r"198.162")
        price >= 0 if price

• 包管理工具支持添加 Git 仓库中子包作为三方库。

通过如下命令，KCL 包管理工具支持添加 git 仓库中的某个子目录下的 KCL Package 作为三方库。

kcl mod add <package_name> --git <git_url> --commit <commit_id>

以 https://github.com/kcl-lang/flask-demo-kcl-manifests.git 为例，添加这个仓库中的子目录中名为 cc 的 KCL package 作为依赖：

kcl mod add cc --git https://github.com/kcl-lang/flask-demo-kcl-manifests.git --commit 8308200

• 基于 WASM 后端的 kcl-playground https://play.kcl-lang.io/ 上线。

• kcl import 工具支持导入整个 Go Package 并将其中所有的 Go 结构体定义转换为 KCL Schema 定义
• 修复 kcl import 在 Kubernetes CRD 和 OpenAPI 导入 Schema 的编译错误
• 优化 kcl mod init 的输出格式
• kcl fmt 工具支持保留用户在多个代码片段之间的空行，不会全部删除
• 包管理工具修复了编译入口无法识别包相对路径 ${KCL_MOD} 的问题。
• 包管理工具将 plainHttp 选项调整为可选。
• 包管理工具修复了编译入口识别错误根目录的问题。
• 包管理工具添加登录凭证的缓存，以降低安全风险。
• 包管理工具修复了由于虚拟编译入口导致的编译失败问题。
• 包管理工具修复了默认依赖在 kcl.mod 中的缺失。
• 包管理工具修复了 vendor path 计算错误导致的三方库重新下载的问题。
• 包管理工具修复了 push https 协议 OCI registry 失败的问题。
• 包管理工具修复了多次添加 git 子包作为依赖时导致的循环依赖问题。
• 包管理工具修复了 metadata 中三方库依赖路径丢失的问题。
• 包管理工具 Add, Update 命令预载了 MVS 版本管理算法，通过环境变量 SupportMVS=true 控制开启。
• 包管理工具修复了编译多个 *.k 文件失败的 bug。
• 包管理工具新增部分测试用例。
• KCL tree-sitter 新增 sequence operations, selector 支持。
• KCL tree-sitter 优化了部分语法规则，添加了更多测试用例。
• 修复 kcl fmt 工具对 Schema 索引签名注释错误的格式化位置
• 修复 kcl import 导入 Kubernetes CRD 时设置 -o 参数非预期的报错
• 修复 kcl import 导入空 Go 结构体输出非预期的 KCL Schema 错误
• kcl-openapi 对代码结构和文档结构进行了优化和调整。
• kcl-playground 添加了更多的测试用例，对工程结构体进行了优化和升级。
• krm-kcl function 修复了部分测试和文档中的错误。
• krm-kcl function 修复了依赖下载失败的问题。
• kcl-operator 更新和修复了部分文档内容，优化了部分代码结构。
• kcl-operator 新增部分测试用例，优化了发布流程。
• kcl-operator 新增了初始化容器时的自动鉴权。
• KCL fmt 工具提供了 C api。
• KCL fmt 工具移除了 if 块中多余的空行。

API

📦️ 标准库与三方库
标准库

import file

a = file.current()

a: /Users/xxx/xxx/main.k # 当前编译的文件路径

sha512(value: str, encoding: str = "utf-8") -> str

import crypto
blake3 = crypto.blake3("ABCDEF")

a = [100, 10, 100]
A = isnullish(a)
e = None
E = isnullish(e)

import datetime
assert datetime.validate("2024-08-26", "%Y-%m-%d")

三方库

☸️ 生态集成

多语言插件

• KCL Plugin 支持通过 Rust 开发。
• 新增部分插件开发测试用例。

📖 文档更新

• 新增 Python, Java, Node.js, Rust, WASM, .NET, C/C++ 等多语言 API 文档。
• 更新了 IDE Quick Start 文档。 
• 新增博客 A Comparative Overview of Jsonnet and KCL
• 更新文档 Adapt From Kubernetes中的 crd 资源。
• 新增了 KCL 在 kubecon 2024 的回顾文章。
• 文档中增加了新增 built-in API 相关的文档。
• 调整了文档中包管理工具与 OCI registry 和 Git Repo 部分集成的文档。
• 新增了文档中关于 kcl.mod include 和 exclude 字段的描述。
• 新增了关于 docker-credential-desktop not found 的解决方案。
• 新增了 konfig 库部分资源的参考文档。
• 新增了关于 KCL WASM 相关的 API 文档。
• 新增了关于 Rust 开发 KCL 插件相关的 API。
• 新增了关于 mixin 和 protocol 相关的 FAQ 文档。
• 修复了部分文档错误。