Merge pull request #335 from Peefy/blog-20240417-newsletter

docs: add 0417 newsletter blogs
kcl-lang · Apr 16, 2024 · 11892be · 11892be
2 parents 74c8db4 + 877f392
commit 11892be
Show file tree

Hide file tree

Showing 2 changed files with 282 additions and 0 deletions.
diff --git a/blog/2024-04-17-newsletter/index.md b/blog/2024-04-17-newsletter/index.md
@@ -0,0 +1,142 @@
+---
+slug: 2024-04-17-newsletter
+title: KCL Newsletter (2024 04.04 - 2024.04.17)
+authors:
+  name: KCL Team
+  title: KCL Team
+tags: [KCL, Newsletter]
+image: /img/biweekly-newsletter.png
+---
+
+![](/img/biweekly-newsletter.png)
+
+[KCL](https://github.com/kcl-lang) is a constraint-based record and functional language hosted by Cloud Native Computing Foundation (CNCF) that enhances the writing of complex configurations and polices, including those for cloud-native scenarios. With its advanced programming language technology and practices, KCL is dedicated to promoting better modularity, scalability, and stability for configurations. It enables simpler logic writing and offers ease of automation APIs and integration with homegrown systems.
+
+This section will update the KCL language community's latest news, including features, website updates, and the latest community news, helping everyone better understand the KCL community!
+
+**_KCL Website: [https://kcl-lang.io](https://kcl-lang.io)_**
+
+## Overview
+
+Thanks to to all contributors for their outstanding work over the past twenty days (2024 04.04 - 2024 04.17). Here is an overview of the key content.
+
+**🏄 Language Updates**
+
+- The `instances()` method of Schema has added a new keyword parameter `full_pkg` for reading all instances corresponding to the Schema in the code.
+
+```python
+schema Person:
+    name: str
+
+alice = Person {name = "Alice"}
+all_persons = Person.instances(True)
+```
+
+- Added the `template` system module for manipulation of templates in KCL.
+
+```python
+import template
+
+content = template.execute("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""", {
+  author: True,
+  firstName: "Yehuda",
+  lastName: "Katz",
+})
+```
+
+**⛵️ Toolchain Updates**
+
+- The OverrideFile API supports modifying/deleting non-schema type fields.
+- New ListVariable API for reading the values of variables in KCL files.
+
+**🔥 SDK Updates**
+
+- The KCL Go SDK has been released in version 0.8.4.
+- The KCL Rust SDK has added the `llvm` feature, allowing to choose whether to use the LLVM, defaulting to off. When the LLVM feature is turned off, binary size can be reduced by 90%. Dependencies can be added in the following way:
+
+```shell
+cargo add --git https://github.com/kcl-lang/lib
+```
+
+- The initial release of the KCL Node.js SDK, supporting KCL code execution API and variable reading API. Repository link: [https://github.com/kcl-lang/lib/tree/main/nodejs](https://github.com/kcl-lang/lib/tree/main/nodejs). Contributions are welcome.
+
++ `__test__/test_data/schema.k`
+
+```python
+schema AppConfig:
+    replicas: int
+
+app: AppConfig {
+    replicas: 2
+}
+```
+
++ `execProgram`
+
+```ts
+import { execProgram, ExecProgramArgs } from "kcl-lib";
+
+function main() {
+  const result = execProgram(ExecProgramArgs(["__test__/test_data/schema.k"]));
+  console.log(result.yamlResult);  // 'app:\n  replicas: 2'
+}
+
+main();
+```
+
++ `listVariables`
+
+```ts
+import { listVariables, ListVariablesArgs } from "kcl-lib";
+
+function main() {
+  const result = listVariables(ListVariablesArgs('__test__/test_data/schema.k', []))
+  console.log(result.variables['app'].value);  // 'AppConfig {replicas: 2}'
+}
+
+main();
+```
+
+**💻 IDE Updates**
+
+- Added compilation unit caching to enhance IDE performance.
+
+**🌼 Integration Updates**
+
+- Crossplane KCL Function supports reading Function Context parameters for passing parameters to different functions.
+  - Support reading the function context across different functions.
+  - Support reading the function details to set sensitive information.
+  - Support setting the status field of XR to output user information.
+  - Fixed errors related to concurrent requests when issuing clusters under multiple XR resources.
+- KCL has released a Nix package, allowing installation of the KCL command line tools with `nix-shell` or `devbox shell`.
+
+## Special Thanks
+
+We'd like to thank all the community participants from the past two weeks.
+
+The following are listed in no particular order:
+
+- Thanks to @bozaro for the contribution to the KCL Go SDK 🙌
+- Thanks to @jheyduk for the contribution to the Kubectl KCL plugin 🙌
+- Thanks to @shashank-iitbhu for the contribution to the quick fix feature for KCL IDE syntax 🙌
+- Thanks to @d4v1d03 for the contribution to the KCL official website FAQ documentation 🙌
+- Thanks to @octonawish-akcodes for the contribution to the automatic dependency update feature for KCL IDE based on kcl.mod 🙌
+- Thanks to @utnim2 for the contribution to the restart kcl-language-server command for KCL IDE 🙌
+- Thanks to @AkashKumar7902 for the contribution to the KCL package management tool MVS algorithm 🙌
+- Thanks to @steeling, @bozaro, @vtomilov, @sanzoghenzo, @folliehiyuki, @markphillips100, @wilsonwang371, @zargor, @aleeriz, @reckless-huang, @zhuxw, @jheyduk, @Vitaly Tomilov, @Sergey Ryabin, @Stephen C, and others for their valuable suggestions and feedback while using KCL recently. 🙌
+
+## Resources
+
+❤️ See [here](https://github.com/kcl-lang/community) to join us!
+
+For more resources, please refer to
+
+- [KCL Website](https://kcl-lang.io/)
+- [KusionStack Website](https://kusionstack.io/)
+- [KCL v0.9.0 Milestone](https://github.com/kcl-lang/kcl/milestone/9)
diff --git a/i18n/zh-CN/docusaurus-plugin-content-blog/2024-04-17-newsletter/index.md b/i18n/zh-CN/docusaurus-plugin-content-blog/2024-04-17-newsletter/index.md
@@ -0,0 +1,140 @@
+---
+slug: 2024-04-17-newsletter
+title: KCL 最新动态速递 (2024 04.04 - 2024.04.17)
+authors:
+  name: KCL 团队
+  title: KCL 团队
+tags: [KCL, Newsletter]
+image: /img/biweekly-newsletter.png
+---
+
+![](/img/biweekly-newsletter-zh.png)
+
+[KCL](https://github.com/kcl-lang) 是一个 CNCF 基金会托管的基于约束的记录及函数语言，期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于构建围绕配置的更好的模块化、扩展性和稳定性，更简单的逻辑编写，以及更简单的自动化和生态工具集成。
+
+本栏目将会双周更新 KCL 语言社区最新动态，包括功能、官网更新和最新的社区动态等，帮助大家更好地了解 KCL 社区！
+
+**_KCL 官网：[https://kcl-lang.io](https://kcl-lang.io)_**
+
+## 内容概述
+
+感谢所有贡献者过去一段时间 (2024 04.04 - 2024.04.17) 的杰出工作，以下是重点内容概述
+
+**🏄 语言更新**
+
+- Schema 的 `instances()` 方法新增关键字参数 `full_pkg` 参数用于读取所有代码中对应 Schema 的实例
+
+```python
+schema Person:
+    name: str
+
+alice = Person {name = "Alice"}
+all_persons = Person.instances(True)
+```
+
+- 新增 `template` 系统库用于在 KCL 中操作模版
+
+```python
+import template
+
+content = template.execute("""\
+<div class="entry">
+{{#if author}}
+<h1>{{firstName}} {{lastName}}</h1>
+{{/if}}
+</div>
+""", {
+  author: True,
+  firstName: "Yehuda",
+  lastName: "Katz",
+})
+```
+
+**⛵️ API 更新**
+
+- OverrideFile API 支持修改/删除非 schema 类型的字段
+- 新增 ListVariable API 用于读取 KCL 文件中变量的值
+
+**🔥 SDK 更新**
+
+- KCL Go SDK 发布 0.8.4 版本。
+- KCL Rust SDK 新增 `llvm` feature 选项，可以选择是否采用 LLVM 编译，默认为关闭。当关闭 LLVM 特性时，可以降低构建二进制体积 90%。通过以下方式添加依赖
+
+```shell
+cargo add --git https://github.com/kcl-lang/lib
+```
+
+- KCL Node.js SDK 初版发布，支持 KCL 代码运行 API 和变量读取 API，仓库地址 [https://github.com/kcl-lang/lib/tree/main/nodejs](https://github.com/kcl-lang/lib/tree/main/nodejs), 欢迎共建
+
++ `__test__/test_data/schema.k`
+
+```python
+schema AppConfig:
+    replicas: int
+
+app: AppConfig {
+    replicas: 2
+}
+```
+
++ `execProgram`
+
+```ts
+import { execProgram, ExecProgramArgs } from "kcl-lib";
+
+function main() {
+  const result = execProgram(ExecProgramArgs(["__test__/test_data/schema.k"]));
+  console.log(result.yamlResult);  // 'app:\n  replicas: 2'
+}
+
+main();
+```
+
++ `listVariables`
+
+```ts
+import { listVariables, ListVariablesArgs } from "kcl-lib";
+
+function main() {
+  const result = listVariables(ListVariablesArgs('__test__/test_data/schema.k', []))
+  console.log(result.variables['app'].value);  // 'AppConfig {replicas: 2}'
+}
+
+main();
+```
+
+**💻 IDE 更新**
+
+- 新增编译单元缓存提升 IDE 性能
+
+**🌼 集成更新**
+
+- Crossplane KCL Function 发布 v0.5.1 版本
+  - 支持读取 Function Context 参数用于不同的函数进行参数传递
+  - 支持读写 Function Details 字段用于处理与 Secret 资源相关的敏感信息
+  - 支持设置 XR 资源的 status 字段用于输出用户提示信息
+  - 修复多个 XR 资源下发集群时并发请求的错误
+- KCL 发布 Nix 包，可以通过 `nix-shell` 或者 `devbox shell` 工具一键安装 KCL 命令行工具，详情查看 [https://search.nixos.org/packages?channel=unstable&show=kcl-cli&from=0&size=50&sort=relevance&type=packages&query=kcl-cli](https://search.nixos.org/packages?channel=unstable&show=kcl-cli&from=0&size=50&sort=relevance&type=packages&query=kcl-cli)
+
+## 特别鸣谢
+
+感谢过去两周所有的社区参与者，以下排名不分先后
+
+- 感谢 @bozaro 对 KCL Go SDK 的贡献 🙌
+- 感谢 @jheyduk 对 Kubectl KCL 插件的贡献 🙌
+- 感谢 @shashank-iitbhu 对 KCL IDE 语法快速修复功能的贡献 🙌
+- 感谢 @d4v1d03 对 KCL 官网 FAQ 文档的贡献 🙌
+- 感谢 @octonawish-akcodes 对 KCL IDE 根据 kcl.mod 自动更新依赖功能的贡献 🙌
+- 感谢 @utnim2 对 KCL IDE 重启 kcl-language-server 命令的贡献 🙌
+- 感谢 @AkashKumar7902 对 KCL 包管理工具最小版本选择 MVS 算法的贡献 🙌
+- 感谢 @steeling, @bozaro, @vtomilov, @sanzoghenzo, @folliehiyuki, @markphillips100, @wilsonwang371, @zargor, @aleeriz, @reckless-huang, @zhuxw, @jheyduk ,@Vitaly Tomilov, @Sergey Ryabin, @Stephen C 等在近段时间使用 KCL 过程中提供的宝贵建议与反馈 🙌
+
+## 其他资源
+
+❤️ 查看 _[KCL 社区](https://github.com/kcl-lang/community)_ 加入我们。
+
+更多其他资源请参考：
+
+- [KCL 网站](https://kcl-lang.io/)
+- [KusionStack 网站](https://kusionstack.io/)
+- [KCL v0.9.0 Milestone](https://github.com/kcl-lang/kcl/milestone/9)