简介​

KCL 团队很快乐地宣布KCL v0.7.0 新版别现在已经可用！本次发布为咱们带来了三方面的要点更新：言语、东西链、社区集成 & 扩展支撑。

  • 运用功用更完善过错更少的 KCL 言语、东西链和 IDE 提高代码编写体会和功率
  • 全新的 KCL 指令行东西，集成 KCL 包办理，doc, test 周边东西链生态，一应俱全，一键直达
  • 丰厚的 KCL 三方库商场 artifacthub.io, 供给了超越 200 种 KCL 三方库，纵情挑选，无限或许

进一步您能够在KCL v0.7.0 发布页面或许KCL 官方网站获得下载安装攻略和具体发布信息。

KCL是一个 CNCF 基金会保管的面向云原生领域开源的根据约束的记录及函数编程言语，希望经过老练的编程言语技能和实践来改善对很多冗杂装备比如云原生 Kubernetes 装备场景的编写，致力于环绕装备的模块化、扩展性和稳定性，打造更简略的逻辑编写体会，构建更简略的主动化和生态集成途径。

本文要点介绍 KCL v0.7.0 版别的更新内容以及 KCL 社区的近期动态。

言语更新​

⭐️ 全新的 KCL 指令行东西​

在新版别中供给了全新的 KCL 指令行东西, 目标是将 KCL 周边生态包括在一起，为您供给一致简明的操作页面，一应俱全，一键直达。

新的 KCL 指令行东西将会以持续 kcl 作为指令前缀，现在供给包含编译，包办理，格局化东西等多个子指令。

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

确诊信息的优化​

在 KCL 新版别中，在部分代码过错信息中增加了修正主张，比如变量称号写错或许查找不到 import 的代码包

import sub as s1
The_first_kcl_program = s.The_first_kcl_program

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

言语编写体会优化​

去掉了部分代码块中的缩进检查​

在 KCL 新版别中，咱们取消了装备代码块的严格缩进检查，假如 KCL 代码写成这样

schema TestIndent:
    name: str
    msg: str
    id: int
test_indent = TestIndent {
                    name = "test"
  msg = "test"
              id = 1
}

运用 kcl fmt 指令会能够一键格局化

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

函数类型注解​

在 KCL 新版别中，新增了函数类型注解，您能够在新版别的 KCL 中编写如下带有类型注解的 lambda。

schema Test:
    name: str
identity: (Test) -> bool = lambda res: Test -> bool {
    res.name == "hello"
}
c = identity(Test { name = "hello" })

API 更新​

其他更新及过错修正​

IDE & 东西链更新​

IDE 更新​

KCL IDE 插件支撑了对符号的引证跳转及重命名功用​

IDE 增加了对符号的引证跳转支撑，运用转到引证或查找一切引证：

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

对符号进行重命名：

IDE 支撑对引证句子和联合类型的格局化​

优化了引证句子与其他代码块之间的空行行为（格局化为一个空行）和联合类型的空格行为（多个类型之间格局化为以|距离）：

KCL IDE 插件根据新增了很多补全提示​

针对装备定义这一中心环节，简化用户根据模型编写装备的心智、提高装备编辑的功率。此外，增强了调用内置函数时参数补全。talk is cheap，咱们直接来看作用：

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

而关于模型规划环节，也新增了对 docstring 的快速生成，削减手敲 boilerplate：

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

功用提高​

  • KCL 规划并重构了新的语义模型以及支撑最近符号查找和符号语义信息查询 API
  • IDE 补全，跳转和悬停等功用完成搬迁至新语义模型，显著降低 IDE 功用开发难度和代码量
  • KCL 编译器支撑语法增量解析以及语义增量检查，大部分场景提高 KCL 编译构建和 IDE 插件运用功用5-10 倍

其他更新和过错修正​

  • KCL IntelliJ 插件适配 2023.2 版别
  • 支撑对标准库和内置函数的悬停提示，支撑对 KCL 代码过错的快速修正
  • 优化了对引证句子和 union 类型的格局化输出。
  • 修正了言语服务虚拟文件体系相关的bug：文件维度的改变引发会言语服务崩溃，有必要重启 IDE 康复，现已修正。
  • 支撑包办理东西引进的外部包依赖 import 句子补全
  • 修正函数参数未定义类型过错显现位置

测验东西更新​

担心您的 KCL 程序写错了，要不来测测 ？本次更新供给了全新的 KCL 测验东西，代码好坏，一测便知 ！新的 KCL 测验东西支撑运用 KCL 函数编写单元测验并运用东西执行测验。

您能够在后缀名为 “_test.k” 文件中经过 lambda 表达式来编写您的测验用例。

import .app
# Convert the `App` model into Kubernetes Deployment and Service Manifests
test_kubernetesRender = lambda {
    a = app.App {
        name = "app"
        containers.ngnix = {
            image = "ngnix"
            ports = [{containerPort = 80}]
        }
        service.ports = [{ port = 80 }]
    }
    deployment_got = kubernetesRender(a)
    assert deployment_got[0].kind == "Deployment"
    assert deployment_got[1].kind == "Service"
}

经过 kcl test 指令能够运转这个测验用例并检查测验成果。

测验经过会将得到如下成果：

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

假如测验失败了，kcl test 会将输出过错信息进行输出。

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

KCL 包办理东西​

新增 update 指令用于主动更新本地依赖，运用kcl mod update将会主动下载本地缺失的三方库。具体参阅:github.com/kcl-lang/kp…

KCL 导入东西发布​

支撑从 YAML/JSON/CRD/Terraform Schema 一键生成 KCL 装备/模型，完成主动化搬迁。

假如您有如下 yaml 文件：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
  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

经过指令kcl import test.yaml您能够将其转换为 KCL 程序。

"""
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.
"""
apiVersion = "apps/v1"
kind = "Deployment"
metadata = {
    name = "nginx-deployment"
    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
                        }
                    ]
                }
            ]
        }
    }
}

更多具体内容请参阅一键从 Kubernetes 生态搬迁到 KCL

社区集成 & 扩展更新​

KCL 三方库商场 ArtifactHub​

经过集成 artifacthub.io 咱们构建了一个 KCL 三方库商场，在这里您尽能够大展您的才调，与咱们一起分享您对 KCL 程序的独特了解，您也能够纵情挑选，找到适合您自己的 KCL 三方库 ！

打开主页，直接搜索您需求的关键字，就能看到关于 KCL 三方库的相关内容 ！

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

在三方库主页，能够检查关于三方库的具体内容和相关文档。

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

假如您不知道该怎么运用这些三方库，右侧的按钮能够为您唤起安装页面。

KCL v0.7.0 重磅发布 - 面向云原生场景更完善的生态模型、言语和东西链

欢迎咱们来 artifacthub.io 为 KCL 社区奉献您的三方库，让 KCL 社区变得愈加丰厚多彩！

奉献攻略：kcl-lang.io/docs/user_d…

其他更新​

完整更新和过错修正列表详见:github.com/kcl-lang/kc…

文档更新​

KCL 网站新增 KCL v0.7.0 文档内容并支撑版别化语义选项，现在支撑 v0.4.x, v0.5.x, v0.6.x 和 v0.7.0 版别挑选，一起欢迎社区同学进行文档共建。

社区动态​

KCL 正式成为 CNCF 沙箱项目​

2023 年 9 月 20 日，KCL 项目经过了全球尖端开源基金会云原生核算基金会（CNCF）技能监督委员会评定，正式成为 CNCF 沙箱项目。

更多详情详见:kcl-lang.io/blog/2023-0…

特别道谢​

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

下一步方案​

感谢一切 KCL 用户和社区小伙伴在此次版别更新过程中提出的宝贵反馈与主张。预计 2024 年 2 月，咱们将发布 KCL v0.8.0 版别，更多详情请参阅 KCL 2024 道路规划 和 KCL v0.8.0 Milestone，假如您有更多的想法和需求，欢迎在 KCL Github 库房建议 Issues 或讨论，也欢迎加入咱们的社区进行交流

更多其他资源请参阅：