Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

feat: release 0.7.0 blogs #228

Merged
merged 8 commits into from
Dec 1, 2023
Merged
Show file tree
Hide file tree
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,206 @@
---
slug: 2023-11-30-kcl-0.7.0-release
title: KCL v0.7.0 重磅发布 - 面向云原生场景更易用的语言、工具链,社区集成和扩展支持
authors:
name: KCL Team
title: KCL Team
tags: [Release Blog, KCL]
---

## 简介

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

- _使用功能更完善错误更少的 KCL 语言、工具链和 IDE 提升代码编写体验和效率_
- _全新的 KCL cli,集成 KCL 包管理,doc, test 等周边生态,包罗万象,一键直达_
Peefy marked this conversation as resolved.
Show resolved Hide resolved
Peefy marked this conversation as resolved.
Show resolved Hide resolved
- _丰富的 KCL 三方库市场 artifacthub.io, 提供了超过 200 种 KCL 三方库,尽情挑选,无限可能_

进一步您可以在 [KCL v0.7.0 发布页面](https://github.com/kcl-lang/kcl/releases/tag/v0.7.0) 或者 [KCL 官方网站](https://kcl-lang.io) 获得下载安装指南和详细发布信息。

[KCL](https://github.com/kcl-lang/kcl) 是一个面向云原生领域开源的基于约束的记录及函数编程语言,期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写,致力于围绕配置的模块化、扩展性和稳定性,打造更简单的逻辑编写体验,构建更简单的自动化和生态集成路径。
Peefy marked this conversation as resolved.
Show resolved Hide resolved

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

## 语言更新

### ⭐️ 全新的 KCL Cli
Peefy marked this conversation as resolved.
Show resolved Hide resolved

编译的时候使用 kcl, 下载包的使用使用 kpm, 如果您有一个 KCL 模型想要发到集群,您还需要使用 kusion, kcl 是编译命令,kpm run 也可以编译,我在 kusion 的命令行中还发现了 kusion compile,您是否也有相同的困惑,这些工具之间的关系是什么?我该如何使用它们 ?

为此,我们为您提供了全新的 KCL cli, 目标是将 KCL 周边生态囊括在一起,为您提供统一简明的操作页面,包罗万象,一键直达。

新的 KCL cli 将会以继续 kcl 作为命令前缀,目前提供包含编译,包管理,格式化工具等多个子命令。

![cli-help](/img/blog/2023-11-30-kcl-0.7.0-release/cli-help.png)

### 🔧 诊断信息的优化

我们尝试在部分错误信息中,增加了修复建议,如果您对 KCL 编译失败感到苦恼,不妨来听听编译器的建议。

明明编写了 import 语句,却在编译的时候无法找到 ?

```
import sub as s1

The_first_kcl_program = s.The_first_kcl_program
```

来听听编译器怎么说,您可能把 s1 写成 s 了。

![did you mean](/img/blog/2023-11-30-kcl-0.7.0-release/did-you-mean.png)

KCL 包中使用的三方库找不到咋办 ?try 一下 kcl mod add, 如果还是不行,我们在 artifacthub.io 为您准备了超过 200 个 KCL 模型,来看看,总有一款适合你!

![try-kcl-mod-add](/img/blog/2023-11-30-kcl-0.7.0-release/try-kcl-mod-add.png)

### 🚀 语言编写体验优化

#### 去掉了部分代码块中的缩进检查
在部分代码块中,缩进是否对齐已经变得不那么重要,毕竟,通过 kcl fmt 命令就能修复的问题,何必大动干戈搞的满屏飘红。

如果您的代码写成这样

```
schema TestIndent:
name: str
msg: str
id: int

test_indent = TestIndent {
name = "test"
msg = "test"
id = 1
}
```

现在这并不算错误,kcl fmt 会帮您把它整理好

![kcl-fmt](/img/blog/2023-11-30-kcl-0.7.0-release/kclfmt.gif)

#### lambda 表达式类型注解

新增了 lambda 表达式的类型注解,您可以在新版本的 KCL 中编写如下带有类型注解的 lambda。

```
import sub as s

identity: (s.Test) -> s.Test = lambda res: s.Test {
res {
name = "world"
}
}

c = identity(s.Test{name="hello"})
```

### 🏄 API 更新

- 新增 KCL 单元测试 API: https://github.com/kcl-lang/kcl/pull/904
- KCL Schema 模型解析API增强版 GetFullSchemaType支持获取带有三方库的 KCL 包相关信息和 Schema 属性默认值 https://github.com/kcl-lang/kcl/pull/914

### 🐞 错误修复

- 修复部分场景字典类型的类型推导错误 https://github.com/kcl-lang/kcl/pull/900
- 修复 Schema 参数的检查 https://github.com/kcl-lang/kcl/pull/877/files
- 修复了带有三方库的KCL程序编译缓存失效的问题 https://github.com/kcl-lang/kcl/pull/841
- 错误信息中补全缺失的 lambda 的类型信息 https://github.com/kcl-lang/kcl/pull/771
- 修复了诊断信息中单数和复数的问题 https://github.com/kcl-lang/kcl/pull/769
- 修复了带有类型注解赋值语句中类型检查失效的问题 https://github.com/kcl-lang/kcl/pull/757

- 增加了检查,禁止同名的 import 语句 https://github.com/kcl-lang/kcl/pull/727

## 工具链更新

### 测试工具更新

担心您的 KCL 程序写错了,要不来测测 ?本次更新提供了全新的 KCL 测试工具,代码好坏,一测便知 !新的 KCL 测试工具支持使用 KCL 函数编写单元测试并使用工具执行测试。

您可以在后缀名为 “_test.k” 文件中通过 lambda 表达式来编写您的测试用例。

```
import manifests

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 您可以运行这个测试用例并查看测试结果。

测试通过您将得到如下结果:

![test-pass](/img/blog/2023-11-30-kcl-0.7.0-release/test-pass.png)

如果您的测试失败了,kcl test 将输出错误信息帮助您排查问题所在。

![test-failed](/img/blog/2023-11-30-kcl-0.7.0-release/test-failed.png)

### KCL 包管理

新增 update 命令用于自动更新本地依赖,kcl mod update 将会为您自动下载本地缺失的三方库。具体参考: https://github.com/kcl-lang/kpm/pull/212

## 社区集成 & 扩展更新

### KCL 三方库市场 artifacthub.io

通过集成 artifacthub.io 我们构建了一个 KCL 三方库市场,在这里您尽可以大展您的才华,与我们一同分享您对 KCL 程序的独特理解,您也可以尽情挑选,找到适合您自己的 KCL 三方库 !

打开首页,直接搜索您需要的关键字,就能看到关于 KCL 三方库的相关内容 !

![artifachub-index](/img/blog/2023-11-30-kcl-0.7.0-release/artifachub-index.png)

在三方库首页,可以查看关于三方库的详细内容和相关文档。

![pkg-page](/img/blog/2023-11-30-kcl-0.7.0-release/pkg-page.png)

如果您不知道该如何使用这些三方库,右侧的按钮可以为您唤起安装页面。

![install-pkg](/img/blog/2023-11-30-kcl-0.7.0-release/install-pkg.png)

## 其他更新

完整更新和错误修复列表详见: https://github.com/kcl-lang/kcl/compare/v0.6.0...v0.7.0
Peefy marked this conversation as resolved.
Show resolved Hide resolved

## 文档更新

KCL 网站 新增 KCL v0.7.0 文档内容并支持版本化语义选项,目前支持 v0.4.x, v0.5.x 和 v0.7.0 版本选择,同时欢迎社区同学进行文档共建。
Peefy marked this conversation as resolved.
Show resolved Hide resolved

## 社区动态

- 感谢 @XiaoK29 对 IDE 悬停功能体验提升的贡献 🙌
- 感谢 @jakezhu9 对编译器单元测试,benchmark 的贡献 🙌

## 下一步计划

预计 2023 年 11 月,我们将发布 KCL v0.8.0 版本,更多详情请参考 KCL 2024 路线规划 和 KCL v0.8.0 Milestone,如果您有更多的想法和需求,欢迎在 KCL Github 仓库发起 Issues 或讨论,也欢迎加入我们的社区进行交流 🙌 🙌 🙌
Peefy marked this conversation as resolved.
Show resolved Hide resolved
- KCL 2024 路线规划: https://kcl-lang.io/docs/community/release-policy/roadmap
Peefy marked this conversation as resolved.
Show resolved Hide resolved
- KCL v0.8.0 Milestone: https://github.com/kcl-lang/kcl/milestone/8
- KCL GitHub Issues: https://github.com/kcl-lang/kcl/issues
- KCL GitHub Discussion: https://github.com/orgs/kcl-lang/discussions
- KCL 社区: https://github.com/kcl-lang/community

## 其他资源

感谢所有 KCL 用户和社区小伙伴在此次版本更新过程中提出的宝贵反馈与建议。

更多其他资源请参考:

- [KCL 网站](https://kcl-lang.io/)
- [Kusion 网站](https://kusionstack.io/)
- [KCL GitHub 仓库](https://github.com/kcl-lang/kcl)
- [Kusion GitHub 仓库](https://github.com/KusionStack/kusion)

欢迎加入我们的社区进行交流 👏👏👏:[https://github.com/kcl-lang/community](https://github.com/kcl-lang/community)
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading