diff --git a/blog/2024-12-24-kcl-0.11.0-release/index.md b/blog/2024-12-24-kcl-0.11.0-release/index.md new file mode 100644 index 00000000..ad07eef3 --- /dev/null +++ b/blog/2024-12-24-kcl-0.11.0-release/index.md @@ -0,0 +1,131 @@ +--- +slug: 2024-12-24-kcl-0.11.0-release +title: KCL v0.11.0 Release Blog +authors: + name: KCL Team + title: KCL Team +tags: [Release Blog, KCL] +--- + +## Introduction + +The KCL team is pleased to announce that **KCL v0.11.0 is now available**! This release has brought two key updates to everyone + +- _Enhance the coding experience and efficiency with a more performant, feature-rich, and less error-prone KCL language, toolchain, and IDE._ +- _A more comprehensive and diverse set of standard libraries, third-party libraries, and community ecosystem integrations, covering different application scenarios and requirements._ + +[KCL](https://github.com/kcl-lang) is an open-source, constraint-based record and functional language hosted by Cloud Native Computing Foundation (CNCF). KCL improves the writing of numerous complex configurations, such as cloud-native scenarios, through its mature programming language technology and practice. It is dedicated to building better modularity, scalability, and stability around configurations, simpler logic writing, faster automation, and great built-in or API-driven integrations. + +## ❤️ Special Thanks + +**We would like to extend our heartfelt thanks to all 80 community contributors who participated in the iteration from version v0.10 to v0.11. The following list is in no particular order.** + +_@adamwg, @steeling, @dennybaa, @liangyuanpeng, @NishantBansal2003, @mayrf, @eminaktas, @Gmin2, @tvandinther, @diefans, @nkabir, @suin, @Chewie, @lwz23, @eminaktas,@steeling, @bozaro, @cakemanny, @Yufeireal, @andrzejgorski, @yonas, @dansrogers, @SkySingh04, @jellllly420, @slashexx, @xnull, @diefans, @zflat, @vfarcic, @spastorclovr, @patpicos, @mproffitt, @fraenkel, @irizzant, @vfarcic, @patpicos, @mproffitt, @fraenkel_ + +## 📚 Key Updates + +### 🔧 Core Features + +#### Language + +- KCL supports Alpine Linux(musl) platform. +- KCL refactored the implementation of the Parser and reorganized the parse process of import dependencies. +- KCL optimized the type parsing of ** expressions in schema attributes. +- KCL fixed the problem that lambda expressions do not work when nested calls. +- KCL fixed the memory leak problem of schema mixin parse. +- KCL fixed the type promotion in function call expressions in assignment statements with type declarations. +- KCL fixed the error of lambda functions calling attr in mixin + + +#### Toolchain + +- Package management tool version selection algorithm is released. In v0.11.0, the KCL package management tool supports the selection of different version numbers of the same tripartite library that appears in the dependency graph. The KCL package management tool refers to the mvs algorithm of go mod. + +To ensure as much compatibility as possible, package management tools currently prefer to select the latest version that appears in the dependency diagram rather than the latest version that has already been released. + +In version v0.11.0, version selection is turned off by default. You can control whether version selection is turned on by setting the environment variable `export KPM_FEATURE_GATES='SupportMVS=true'`. + +- Package management tool added a new local tripartite library cache. In v0.11.0, KCL package management tool implemented a new local tripartite library cache, and the new storage cache structure improved the performance of downloading git repositories by 88% on average. + +In v0.11.0, the new cache structure is turned off by default, and the new local tripartite library cache is controlled by setting the environment variable `export KPM_FEATURE_GATES=' SupportNewStorage=true'`. + +- Fix `kcl fmt` formatting error for code comments. +- Fix `kcl fmt` error in handling line continuation and comment combinations. + +#### IDE + +- KCL IntelliJ plugin released 0.4.0, supporting LSP4IJ. +- IDE can complete schemas defined in the worksace but not imported , and automatically insert the import statements of the package. +![complete](/img/blog/2024-12-06-kcl-0.11.0-release/complete.gif) +- IDE adds type hints for key in the Config block. +![hint](/img/blog/2024-12-06-kcl-0.11.0-release/hint.png) +- IDE hover provides schema attribute default value information. +![hover](/img/blog/2024-12-06-kcl-0.11.0-release/hover.png) +- IDE fixed the failure of Windows path issues. +- IDE fixed the failure of compound assignment operation statements. +- IDE distinguished the highlighting of the `any` from keyword and type. +- IDE fixed the failure of formatting code in the IntelliJ plugin. +- Optimized the parser part of the IDE compilation process. +- IDE fixed inconsistent hints for function parameters. +- Optimized hint information and added the feature of double-clicking to insert hints into the code. + +#### API + +- Added `kcl_run_with_log_message` API +- Added `kcl_exec_program` capi +- Added `kcl_version` api for wasm + +### 📦️ Standard Libraries and Third-Party Libraries + +#### Standard Libraries + +- KCL new standard libraries `filesha512` and `fileblake3`。 + +```kcl +import crypto + +sha_filesha512 = crypto.filesha512("test.txt") +sha_fileblake3 = crypto.fileblake3("test.txt") +``` + +- Fixes an issue that `ignore_private=False` parameter does not take effect in `manifests.yaml_stream`. + +#### Third-Party Libraries + +- k8s updated to 1.31.2 +- Fixed the import alias problem in the k8s package. +- helloworld updated to 0.1.4 +- gateway updated to 0.3.2 +- kubevirt updated to 0.3.0 +- cert-manager updated to 0.3.0 +- Added edp-keycloak-operator +- Added sealed-secrets +- Added DeploymentStrategy model in konfig + +### ☸️ Ecosystem Integration + +#### Multi-Language Plugins + +- KCL Plugin supports development through Rust. +- Add more test cases for the KCL Plugin. + +### 📖 Documentation Updates + +- Fixed errors in sample code for argocd kcl plugin configuration +- Added FAQ document about plugin. +- Added more sample documents about system packages. +- Added FAQ document about json_merge_patch. +- Added FAQ document about isnullish function. +- Added sample code about oam app inheritance. +- Fixed Windows installation script. +- Fixed some typos and broken links in the document. +- Updated the documentation of KCL IntelliJ plugin. + +## 🌐 Other Resources + +🔥 Check out the [KCL Community](https://github.com/kcl-lang/community) and join us 🔥 + +For more resources, refer to: + +- [KCL Website](https://kcl-lang.io/) +- [KusionStack Website](https://kusionstack.io/) diff --git a/i18n/zh-CN/docusaurus-plugin-content-blog/2024-12-24-kcl-0.11.0-release/index.md b/i18n/zh-CN/docusaurus-plugin-content-blog/2024-12-24-kcl-0.11.0-release/index.md new file mode 100644 index 00000000..ba13ab61 --- /dev/null +++ b/i18n/zh-CN/docusaurus-plugin-content-blog/2024-12-24-kcl-0.11.0-release/index.md @@ -0,0 +1,123 @@ +--- +slug: 2024-09-24-kcl-0.11.0-release +title: KCL v0.11.0 重磅发布 - 更稳定流畅的工具链和 IDE 体验 ! +authors: + name: KCL Team + title: KCL Team +tags: [Release Blog, KCL] +--- + +## 简介 + +KCL 团队很高兴地宣布 **KCL v0.11.0 新版本现在已经可用**!本次发布为大家带来了两方面的重点更新 + +- _使用功能更完善和错误更少的 KCL 语言、工具链和 IDE 提升代码编写体验和效率_ +- _更加全面丰富的标准库、三方库以及社区生态集成,涵盖不同应用场景和需求_ + +[KCL](https://github.com/kcl-lang) 是一个 CNCF 基金会托管的基于约束的记录及函数语言,期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写,致力于构建围绕配置的更好的模块化、扩展性和稳定性,更简单的逻辑编写,以及更简单的自动化和生态工具集成。 + +## ❤️ 特别鸣谢 + +**感谢 KCL 在 v0.10 - v0.11 版本迭代所有 80 位社区参与者,以下排名不分先后** + +_@adamwg, @steeling, @dennybaa, @liangyuanpeng, @NishantBansal2003, @mayrf, @eminaktas, @Gmin2, @tvandinther, @diefans, @nkabir, @suin, @Chewie, @lwz23, @eminaktas, @steeling, @bozaro, @cakemanny, @Yufeireal, @andrzejgorski, @yonas, @dansrogers, @SkySingh04, @jellllly420, @slashexx, @xnull, @diefans, @zflat, @vfarcic, @spastorclovr, @patpicos, @mproffitt, @fraenkel, @irizzant, @vfarcic, @patpicos, @mproffitt, @fraenkel_ + +## 📚 重点更新内容 + +### 🔧 核心功能 + +#### 语言 + +- KCL 新增对 Alpine Linux(musl) 平台的支持。 +- KCL 重构了 Parser 部分的实现,重新组织了 import 依赖的 parse 流程。 +- KCL 优化了 schema attribute 中对 ** 表达式的类型解析。 +- KCL 修复了 lambda 表达式嵌套调用时不生效的问题。 +- KCL 修复了 schema mixin parse 内存泄露的问题。 +- KCL 修复了在有类型声明的赋值语句中函数调用表达式中的类型提升。 +- KCL 修复了 mixin 中调用 attr 的 lambda 函数的错误 + +#### 工具链 + +- 包管理工具版本选择算法上线。在 v0.11.0 版本中, KCL 包管理工具支持对依赖图中出现的同一个三方库的不同版本号进行选择,KCL 包管理工具参考了 go mod 的 mvs 算法, +为了尽可能保证兼容性,包管理工具目前倾向于选择依赖图中出现的最新的版本而不是已经 release 的最新版本。 +在 v0.11.0 版本中,版本选择默认关闭,通过设置环境变量 `export KPM_FEATURE_GATES="SupportMVS=true"` 控制是否开启版本选择。 + +- 包管理工具新增了新的本地三方库缓存结构,在 v0.11.0 版本中,KCL 包管理工具实现了新的本地三方库缓存结构,新的存储缓存结构对下载 git 仓库性能平均提升 88%。 +在 v0.11.0 版本中,新的缓存结构默认关闭,通过设置环境变量 `export KPM_FEATURE_GATES="SupportNewStorage=true"` 控制是否启用新的本地三方库缓存。 + +- 修复 `kcl fmt` 代码注释的格式化错误。 +- 修复 `kcl fmt` 在处理行连接符和注释组合时的错误。 + +#### IDE + +- KCL IntelliJ 插件发布 0.4.0 版本,支持 LSP4IJ +- IDE 可以补全目录中未 import 的 schema,并且自动补充包的 import 语句 +![complete](/img/blog/2024-12-06-kcl-0.11.0-release/complete.gif) +- IDE 新增了 Config 块中 key 的类型 hint。 +![hint](/img/blog/2024-12-06-kcl-0.11.0-release/hint.png) +- IDE schema hover 中提供了 attr 默认值信息。 +![hover](/img/blog/2024-12-06-kcl-0.11.0-release/hover.png) +- 修复了 IDE 在 Windows 系统中的异常。 +- 修复了 IDE 在复合赋值运算语句中异常的问题。 +- 区分了 `any` 关键字和类型的高亮 +- 修复了 IntelliJ 插件中格式化代码报错的问题。 +- 优化了 IDE 编译流程中 parser 部分。 +- 修复了函数参数 hint 不一致的问题。 +- 优化了 hint 信息,增加了双击将 hint 插入代码的功能。 + +#### API + +- 新增了 `kcl_run_with_log_message` API +- 新增了 `kcl_exec_program` capi +- 为 wasm 添加 `kcl_version` api + +### 📦️ 标准库及三方库 + +#### 标准库 + +- KCL 新增标准库函数 `filesha512` 和 `fileblake3`。 + +```kcl +import crypto + +sha_filesha512 = crypto.filesha512("test.txt") +sha_fileblake3 = crypto.fileblake3("test.txt") +``` +- 修复 `manifests.yaml_stream` 中 `ignore_private=False` 参数 不生效的问题。 + +#### 三方库 + +- k8s 更新至 1.31.2 +- 修复 k8s 包中 import 别名的问题。 +- konfig 中增加 DeploymentStrategy 模型 +- helloworld 更新至 0.1.4 +- gateway 更新至 0.3.2 +- kubevirt 更新至 0.3.0 +- cert-manager 更新至 0.3.0 +- 新增 edp-keycloak-operator +- 新增 sealed-secrets + +### ☸️ 生态集成 + +- crossplane function-kcl 支持通过环境变量 `FUNCTION_KCL_DEFAULT_SOURCE` 设置默认编译环境入口。 + +### 📖 文档更新 + +- 修复 argocd kcl plugin 配置的示例代码中的错误 +- 新增了关于 plugin 相关的 FAQ 文档。 +- 新增了更多关于系统包相关的示例文档。 +- 新增了关于 json_merge_patch 相关的 FAQ 文档。 +- 新增了关于 isnullish 函数 相关的 FAQ 文档。 +- 新增了关于 oam app 继承相关的示例代码。 +- 修复了 Windows 安装脚本。 +- 修复了文档中部分 typo 和失效链接。 +- 更新了 KCL IntelliJ 插件的说明文档。 + +## 🌐 其他资源 + +🔥 查看 _[KCL 社区](https://github.com/kcl-lang/community)_ 加入我们 🔥 + +更多其他资源请参考: + +- [KCL 网站](https://kcl-lang.io/) +- [KusionStack 网站](https://kusionstack.io/) diff --git a/static/img/blog/2024-12-06-kcl-0.11.0-release/complete.gif b/static/img/blog/2024-12-06-kcl-0.11.0-release/complete.gif new file mode 100644 index 00000000..e6f8c04f Binary files /dev/null and b/static/img/blog/2024-12-06-kcl-0.11.0-release/complete.gif differ diff --git a/static/img/blog/2024-12-06-kcl-0.11.0-release/hint.png b/static/img/blog/2024-12-06-kcl-0.11.0-release/hint.png new file mode 100644 index 00000000..58b017dd Binary files /dev/null and b/static/img/blog/2024-12-06-kcl-0.11.0-release/hint.png differ diff --git a/static/img/blog/2024-12-06-kcl-0.11.0-release/hover.png b/static/img/blog/2024-12-06-kcl-0.11.0-release/hover.png new file mode 100644 index 00000000..1ffaa0de Binary files /dev/null and b/static/img/blog/2024-12-06-kcl-0.11.0-release/hover.png differ