Merge pull request #329 from Peefy/faq-kcl-docker-start

faq: add kcl start in docker containers

Author: Peefy

docs/user_docs/support/faq-install.md

@@ -31,3 +31,12 @@ Please ensure that the following dependencies are in your PATH:
 ## Encountering exit status 0xc0000135 error on Windows platform
 
 Please ensure that `.NET Framework` and `MSVC` are installed on your Windows. If not installed, you can install them and try again.
+
+## Errors on Starting/Running KCL inside a Container for "Permission Denied" or "File Not Found"
+
+The issue is due to KCL requiring write permissions for its default global configuration and global package cache at compile time. One solution is to set the global configuration and package directory to the `/tmp` folder. For detailed Dockerfile configuration, please see [here](https://github.com/kcl-lang/cli/blob/main/Dockerfile).
+
+```dockerfile
+ENV KCL_PKG_PATH=/tmp
+ENV KCL_CACHE_PATH=/tmp
+```

i18n/zh-CN/docusaurus-plugin-content-docs/current/user_docs/support/faq-install.md

@@ -31,3 +31,12 @@ xattr -rd com.apple.quarantine /path/to/kcl
 ## 在 Windows 平台上遇到 exit status 0xc0000135 错误
 
 请确保您的 Windows 上安装了 `.NET Framework` 和 `MSVC`，如没有安装，可以安装并重试。
+
+## 在容器中启动/运行 KCL 报没有权限或者找不到文件的错误
+
+这是因为 KCL 在编译时的默认全局配置和全局包缓存需要写入权限，一种解决方式是将全局配置和包目录设置到 `/tmp` 文件夹，详见[这里](https://github.com/kcl-lang/cli/blob/main/Dockerfile) 的 Dockerfile 配置
+
+```dockerfile
+ENV KCL_PKG_PATH=/tmp
+ENV KCL_CACHE_PATH=/tmp
+```

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/reference/model/file.md

@@ -8,7 +8,7 @@ weight: 100
 
 ## read
 
-`read(filepath: string) -> str`
+`read(filepath: str) -> str`
 
 读取文件 `filepath` 中的内容，并返回一个字符串实例。
 
@@ -29,3 +29,15 @@ weight: 100
 `workdir() -> str`
 
 返回当前工作目录的路径。
+
+## exists
+
+`exists(filepath: str) -> bool`
+
+判断文件路径是否存在。如果路径指向一个存在的实体，则返回 True。此函数会遍历符号链接以查询目标文件的信息。
+
+## abs
+
+`abs(filepath: str) -> str`
+
+返回路径的规范化绝对形式，其中所有中间路径均已规范化并解析为符号链接。

i18n/zh-CN/docusaurus-plugin-content-docs/version-0.8/user_docs/support/faq-install.md

@@ -31,3 +31,12 @@ xattr -rd com.apple.quarantine /path/to/kcl
 ## 在 Windows 平台上遇到 exit status 0xc0000135 错误
 
 请确保您的 Windows 上安装了 `.NET Framework` 和 `MSVC`，如没有安装，可以安装并重试。
+
+## 在容器中启动/运行 KCL 报没有权限或者找不到文件的错误
+
+这是因为 KCL 在编译时的默认全局配置和全局包缓存需要写入权限，一种解决方式是将全局配置和包目录设置到 `/tmp` 文件夹，详见[这里](https://github.com/kcl-lang/cli/blob/main/Dockerfile) 的 Dockerfile 配置
+
+```dockerfile
+ENV KCL_PKG_PATH=/tmp
+ENV KCL_CACHE_PATH=/tmp
+```

versioned_docs/version-0.8/reference/model/file.md

@@ -8,7 +8,7 @@ weight: 100
 
 ## read
 
-`read(filepath: string) -> str`
+`read(filepath: str) -> str`
 
 Read the contents of the file `filepath` and return a string instance.
 
@@ -29,3 +29,15 @@ Return the root path of the current KCL module (kcl.mod file path or single \*.k
 `workdir() -> str`
 
 Return the path of the current working directory.
+
+## exists
+
+`exists(filepath: str) -> bool`
+
+Whether this file path exists. Returns true if the path points at an existing entity. This function will traverse symbolic links to query information about the destination file.
+
+## abs
+
+`abs(filepath: str) -> str`
+
+Returns the canonical, absolute form of the path with all intermediate components normalized and symbolic links resolved.

versioned_docs/version-0.8/user_docs/support/faq-install.md

@@ -31,3 +31,12 @@ Please ensure that the following dependencies are in your PATH:
 ## Encountering exit status 0xc0000135 error on Windows platform
 
 Please ensure that `.NET Framework` and `MSVC` are installed on your Windows. If not installed, you can install them and try again.
+
+## Errors on Starting/Running KCL inside a Container for "Permission Denied" or "File Not Found"
+
+The issue is due to KCL requiring write permissions for its default global configuration and global package cache at compile time. One solution is to set the global configuration and package directory to the `/tmp` folder. For detailed Dockerfile configuration, please see [here](https://github.com/kcl-lang/cli/blob/main/Dockerfile).
+
+```dockerfile
+ENV KCL_PKG_PATH=/tmp
+ENV KCL_CACHE_PATH=/tmp
+```

versioned_docs/version-0.8/user_docs/support/faq-kcl.md

@@ -2512,3 +2512,37 @@ worldString: world
 s: Hello world
 raw_s: Hello ${worldString}
 ```
+
+## 59. How does KCL infer return types in lambdas?
+
+For lambda(s),KCL automatically infers the return value type in the function body, although we can explicitly specify it. An example KCL code over here is:
+
+```KCL
+f1 = lambda t: Type1 {
+    Type2 {}
+} # The type of f1 is (Type1) -> Type2
+
+f2 = lambda t: Type1 -> Type2 {
+    Type2 {}
+} # The type of f2 is (Type1) -> Type2
+```
+
+## 60. How to convert a list of lists to a single list in KCL?
+
+To convert a list of lists into a single list, we use the `sum()` function. For example if we have a number of lists such as `[[1,2],[3,4]], [5,6]`, we use the KCL code given below to convert these three lists into a single list:
+
+```KCL
+final_list = sum([[1,2],[3,4]],[5,6])
+```
+
+The above KCL code gives the output:
+
+```yaml
+final_list:
+- 5
+- 6
+- 1
+- 2
+- 3
+- 4
+```