Skip to content

docs: add 2024-05-29 newsletter blogs #380

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

Merged
merged 5 commits into from
May 29, 2024

Conversation

zong-zhe
Copy link
Contributor

1. Does this PR affect any open issues?(Y/N) and add issue references (e.g. "fix #123", "re #123".):

  • N
  • Y

2. What is the scope of this PR (e.g. component or file name):

3. Provide a description of the PR(e.g. more details, effects, motivations or doc link):

  • Affects user behaviors
  • Contains syntax changes
  • Contains variable changes
  • Contains experimental features
  • Performance regression: Consumes more CPU
  • Performance regression: Consumes more Memory
  • Other

4. Are there any breaking changes?(Y/N) and describe the breaking changes(e.g. more details, motivations or doc link):

  • N
  • Y

5. Are there test cases for these changes?(Y/N) select and add more details, references or doc links:

  • Unit test
  • Integration test
  • Benchmark (add benchmark stats below)
  • Manual test (add detailed scripts or steps below)
  • Other

@zong-zhe zong-zhe added the documentation Improvements or additions to documentation label May 29, 2024
@zong-zhe zong-zhe requested a review from Peefy May 29, 2024 07:29
@zong-zhe zong-zhe self-assigned this May 29, 2024
Copy link

vercel bot commented May 29, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
kcl-lang-io ✅ Ready (Inspect) Visit Preview 💬 Add feedback May 29, 2024 10:15am

@zong-zhe zong-zhe changed the title docs: add 2024-05-29 newsletter blogs [WIP] docs: add 2024-05-29 newsletter blogs May 29, 2024
Signed-off-by: zongz <[email protected]>
**⛵️ API 更新**

- OverrideFile API 返回值中新增编译错误信息。
- OverrideFile API 支持通过运算符 ":" 和 "+="。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Through the : and += to do what?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- KCL API 新增 call_with_plugin_agent 支持调用 KCL API。
- KCL go SDK 中进行了一些代码的优化,去掉了一些冗余的逻辑,调整了设置配置文件的加载方式。
- KCL Cli 新增并行测试用例,以提升在并发场景下项目的稳定性。

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

生态集成

The content can be found in this PR: crossplane-contrib/function-kcl#111

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 感谢 @shruti2522 为 IDE 悬停效果的优化作出的持续贡献 🙌
- 感谢 @XiaoK29 为 KCL go SDK 的代码优化作出的持续贡献 🙌
- 感谢 @d4v1d03 为 KCL 文档作出的持续贡献 🙌
- 感谢 @officialasishkumar 在包管理工具三方依赖重命名功能的贡献 🙌
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感谢 @Vishalk91-4, @Daksh-10 对 KCL tree sitter 语法和解析器生成器的贡献

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 感谢 @XiaoK29 为 KCL go SDK 的代码优化作出的持续贡献 🙌
- 感谢 @d4v1d03 为 KCL 文档作出的持续贡献 🙌
- 感谢 @officialasishkumar 在包管理工具三方依赖重命名功能的贡献 🙌

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Dup @Alexander Fuchs

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 感谢 @warjiang 为 devcontainer 作出的贡献 🙌
- 感谢 @shruti2522 为 IDE 悬停效果的优化作出的持续贡献 🙌
- 感谢 @XiaoK29 为 KCL go SDK 的代码优化作出的持续贡献 🙌
- 感谢 @d4v1d03 为 KCL 文档作出的持续贡献 🙌
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

感谢 @SamirMarin 对 Crossplane KCL 函数的贡献

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 感谢 @d4v1d03 为 KCL 文档作出的持续贡献 🙌
- 感谢 @officialasishkumar 在包管理工具三方依赖重命名功能的贡献 🙌

- 感谢 @officialasishkumar, @d4v1d03, @karlhepler, @Hai Wu, @Alexander Fuchs, @ron18219, @olinux, @Alexander Fuchs 等在近段时间使用 KCL 过程中提供的宝贵建议与反馈 🙌
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add more names

@Emmanuel Alap, @excalq, @leon-andria, @taylormonacelli, @dennybaa, @zhuxw, @aleeriz, @steeling

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- KCL go SDK 中进行了一些代码的优化,去掉了一些冗余的逻辑,调整了设置配置文件的加载方式。
- KCL Cli 新增并行测试用例,以提升在并发场景下项目的稳定性。

## 特别鸣谢
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bring this section to the front.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- ListVariable API 返回值支持解析 List 和 Dict 结构。
- 修复了 OverrideFile API 在插入 import 语句时导致的配置格式错乱的问题。
- 重构了获取 schema type 相关的 API。
- 修复了 LSP handle_semantic_tokens_full 和 handle_document_symbol 方法导致的 panic 问题。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add UpdateDependencies API.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- IDE 新增 native tool chain 层以支持 IDE 对工具链的集成。
- KCL API 新增 call_with_plugin_agent 支持调用 KCL API。
- KCL go SDK 中进行了一些代码的优化,去掉了一些冗余的逻辑,调整了设置配置文件的加载方式。
- KCL Cli 新增并行测试用例,以提升在并发场景下项目的稳定性。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

a/Cli/CLI

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed


- 修复了开发向导文档中的错误拼写与一些环境配置描述。
- 新增关于 file.read_env 库函数的文档说明。
- 语言文档中补充了关于schema属性名称中“-”,“.”等符号的说明。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Keep a space between English and Chinese.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- KCL 测试工具支持 fast eval 模式。
- kcl clean 支持清理缓存。
- 包管理 kcl mod 支持对三方库重命名。
- 包管理工具修复了添加本地文件目录作为依赖时,kcl.mod 文件依赖丢失的问题。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

包管理工具更新

  • aaa
  • bbb
  • ccc
  • ...

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 包管理工具,支持通过分支名称添加 git 三方库。
- 包管理工具,移除了在更新依赖时输出的无效日志。
- 包管理工具新增 API 支持写入 kcl.mod 和 kcl.mod.lock 文件。
- 包管理工具移除加载三方库是请求 metadata 过程。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo 是请求

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 包管理工具移除加载三方库是请求 metadata 过程。
- 包管理工具在打包和上传时,针对本地依赖情况输出对应提示信息。
- 包管理工具 LFX 1 期题目版本管理模块 mvp 版本开发完成。
- 包管理工具,支持 kcl.mod 文件中通过 include 和 exclude 字段指定打包过程。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do what?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed


- KCL 测试工具支持 fast eval 模式。
- kcl clean 支持清理缓存。
- 包管理 kcl mod 支持对三方库重命名。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kcl 支持通过 mod add --rename 参数和 kcl.mod 文件中重命名依赖防止名称冲突

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed.

**📬️ 工具链更新**

- KCL 测试工具支持 fast eval 模式。
- kcl clean 支持清理缓存。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

kcl clean 支持清理 module 缓存

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 包管理工具修复了添加本地文件目录作为依赖时,kcl.mod 文件依赖丢失的问题。
- 包管理工具,支持通过分支名称添加 git 三方库。
- 包管理工具,移除了在更新依赖时输出的无效日志。
- 包管理工具新增 API 支持写入 kcl.mod 和 kcl.mod.lock 文件。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move to the API section.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- 语言文档中补充了关于schema属性名称中“-”,“.”等符号的说明。
- 新增了一些 Q&A。

**🎵 项目工程**
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Remove this section.

**🔥 SDK 更新**

- KCL SDK v0.9.0-beta.1 版本发布, 同步支持 API 更新。
- KCL go SDK 调整了 yaml stream 的输出格式。
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Move this line to the toolchain section.

  • KCL Import 工具修复 YAML Stream 格式导入过程非预期的错误

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed.

@zong-zhe zong-zhe changed the title [WIP] docs: add 2024-05-29 newsletter blogs docs: add 2024-05-29 newsletter blogs May 29, 2024
- New module `difflib` added to support configuration comparison.

Through the `diff` method provided by the `difflib`, the configuration difference is output.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Lost kcl mod add difflib

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

}
diff = difflib.diff(yaml.encode(data1), yaml.encode(data2))
```

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add the expect output.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

- Fixed the unexpected error in the YAML Stream format import process of the KCL import tool.

- Package management tool updates.
- - Added support for renaming dependencies to prevent name conflicts through the `mod add --rename` parameter and the `kcl.mod` file.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Unexpected double -

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

fixed

@Peefy Peefy merged commit c9fb02b into kcl-lang:main May 29, 2024
5 of 6 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

2 participants