diff --git a/docx/CHANGELOG.md b/docx/CHANGELOG.md index ed00ada..865d368 100644 --- a/docx/CHANGELOG.md +++ b/docx/CHANGELOG.md @@ -1,11 +1,12 @@ -# [0.30](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx) +# [0.31](https://github.com/shelllet/winui/compare/main...dev) (2023-xx-xx) ### Changed: 1. *工作线程* 动作支持选择是否立即运行。 2. *监听鼠标* 动作支持鼠标侧键。 3. *For*(循环)动作名称变更为 *ForEach*(迭代)动作,功能不变。 -4. *IterParam*(迭代参数)动作名称变更为 *IterValue*(迭代数据)动作,并支持默认数据参数,功能不变。 +4. *IterParam*(迭代参数)动作名称变更为 *IterValue*(迭代数据)动作,并支持设置默认参数,功能不变。 +5. 增加 *StandardPath*(标准路径)动作,用来表示系统常用路径。 ### Deprecated: diff --git a/docx/_sidebar.md b/docx/_sidebar.md index f6434c8..45e12a3 100644 --- a/docx/_sidebar.md +++ b/docx/_sidebar.md @@ -117,11 +117,11 @@ - [键盘/鼠标宏重放](./actions/media/PlayRecord.md) - [相机图像](./actions/media/VideoFrame.md) - 网络 - - [下载](./actions/network/HttpDownload.md) + - [文件下载](./actions/network/HttpDownload.md) - [视频下载](./actions/network/YoutubeDownload.md) - - [Head](./actions/network/HttpHead.md) - - [Get](./actions/network/HttpGet.md) - - [Post](./actions/network/HttpPost.md) + - [HEAD 请求](./actions/network/HttpHead.md) + - [GET 请求](./actions/network/HttpGet.md) + - [POST 请求](./actions/network/HttpPost.md) - [监听](./actions/network/TcpListen.md) - [发送](./actions/network/TcpSend.md) - [接收](./actions/network/TcpReceive.md) diff --git a/docx/actions/filesystem/StandardPath.md b/docx/actions/filesystem/StandardPath.md new file mode 100644 index 0000000..40b3689 --- /dev/null +++ b/docx/actions/filesystem/StandardPath.md @@ -0,0 +1,26 @@ +# 标准路径 +此操作包含在本地文件系统上查询标准路径位置的功能,例如特定于用户目录或系统范围的配置目录等常见任务。 + +## 子流程 +> 不支持 + + +## 运行参数 + +* 类型 + +> 参考:[KnownFolder](../enums/KnownFolder.md) + +## 输出 + +> 路径,参考:[Path](../types/Path.md)。 + + +## 脚本调用 + +```python +import simple; + +``` + +## 资源 \ No newline at end of file diff --git a/docx/actions/method/SubString.md b/docx/actions/method/SubString.md new file mode 100644 index 0000000..faab5d2 --- /dev/null +++ b/docx/actions/method/SubString.md @@ -0,0 +1,32 @@ +# 字符串提取 +根据特定的方法,可以获取部分字符串。 + +## 子流程 +> 不支持 + + +## 运行参数 + +* 数据 + +> 字符串 + +* 位置 +> 起始位置,如果是 *正值* 从左边开始,如果是 *负值*,从右边开始。 + +* 长度 +> 提取的长度。 + +## 输出 + +> 部分字符串,参考:[String](../types/String.md)。 + + +## 脚本调用 + +```python +import simple; + +``` + +## 资源 \ No newline at end of file diff --git a/docx/actions/network/HttpDownload.md b/docx/actions/network/HttpDownload.md index ee1514d..858a0c2 100644 --- a/docx/actions/network/HttpDownload.md +++ b/docx/actions/network/HttpDownload.md @@ -1,4 +1,4 @@ -# 下载 +# 文件下载 通过 *http/https* 协议下载网络文件。 ![HttpDownload](./images/01.png ':size=90%') diff --git a/docx/actions/network/HttpGet.md b/docx/actions/network/HttpGet.md index 1d63758..431fc43 100644 --- a/docx/actions/network/HttpGet.md +++ b/docx/actions/network/HttpGet.md @@ -1,5 +1,5 @@ -# Get -发送基于 *HTTP* 的*Get* 请求 +# GET 请求 +用于向服务器请求指定的资源,HTTP GET 请求应该只接收数据而不改变服务器的状态。 ## 子流程 > 不支持 @@ -7,13 +7,17 @@ ## 运行参数 -* Url:网址 - +* 网址 +> 可以在网址中直接包含查询字符串,如:`/test/demo.html?name1=value1&name2=value2`。 +* 标头 +> 在 HTTP GET 请求中传递 HTTP 标头,例如:`Accept: application/json` +* 参数 +> 查询字符串(名称/值对),在 GET 请求的 URL 中发送:`/test/demo.html?name1=value1&name2=value2`,可选项。 ## 输出 - +> GET 方法返回的内容,参考字符串类型:[String](../types/String.md) ## 脚本调用 @@ -23,4 +27,4 @@ import simple; ``` -## 示例 \ No newline at end of file +## 资源 \ No newline at end of file diff --git a/docx/actions/network/HttpHead.md b/docx/actions/network/HttpHead.md index 6ded600..551ab9f 100644 --- a/docx/actions/network/HttpHead.md +++ b/docx/actions/network/HttpHead.md @@ -1,18 +1,17 @@ -# Head -发送基于 *HTTP* 的*Head* 请求 - +# HEAD 请求 +使用 HTTP HEAD 方法从服务器请求 HTTP 标头,就像使用 HTTP GET 方法请求文档一样。HTTP HEAD 和 GET 请求之间的唯一区别是,对于 HTTP HEAD,服务器仅返回标头而不返回正文。 ## 子流程 > 不支持 ## 运行参数 -* Url:网址 +* 网址 ## 输出 - +> 输出 *HEAD* 方法的返回内容,参考类型:[String](../types/String.md) ## 脚本调用 diff --git a/docx/actions/network/HttpPost.md b/docx/actions/network/HttpPost.md index b244d4a..c000cd8 100644 --- a/docx/actions/network/HttpPost.md +++ b/docx/actions/network/HttpPost.md @@ -1,5 +1,15 @@ # Post -发送基于 *HTTP* 的*Post* 请求 +将数据通过 POST 方法发送至服务器用以创建/更新资源,请求主体的类型由 Content-Type 标头指示。该动作使用 超文本传输协议(HTTP/1.1)。 + +例如: + +* application/x-www-form-urlencoded + > 这是默认的 Content-Type,键和值被编码在由 分隔的键值元组中 '&','='键和值之间有一个。非字母数字值使用百分比编码进行转义。 +* multipart/form-data + > 每个值都作为数据块(正文部分)发送,并用用户代理定义的分隔符(边界)分隔每个部分。 + +* text/plain + > 消息体没有规定的格式,服务器需要进行相应的处理。 ## 子流程 > 不支持 @@ -7,13 +17,17 @@ ## 运行参数 -* Url:网址 -* ContentType:数据类型 -* Content:数据 +* 网址 +> +* 数据类型 +> Content-Type 如:`application/json`,要将 JSON 数据发布到服务器。 +* 数据 +> 如果 Content-Type 设置为`application/json`, 请求正文中提供 JSON 数据 + ## 输出 - +> 请求返回的数据,字符串类型,参考:[String](../types/String.md) ## 脚本调用 @@ -23,4 +37,7 @@ import simple; ``` -## 示例 \ No newline at end of file +## 资源 + + +!> [Python 3 HTTP/1.1 Server](https://gist.github.com/andystanton/2ec0dca0bf6de90c2000025319f63e2d) \ No newline at end of file diff --git a/docx/actions/network/YoutubeDownload.md b/docx/actions/network/YoutubeDownload.md index 3a10d3b..72c4993 100644 --- a/docx/actions/network/YoutubeDownload.md +++ b/docx/actions/network/YoutubeDownload.md @@ -1,5 +1,5 @@ # 视频下载 -目前只支持 *Youtube* 视频下载,需要能访问 *Youtube* 的网络。 +只支持 *Youtube* 视频下载,中国用户需要能访问 *Youtube* 的代理网络。 ## 子流程 > 不支持 @@ -7,12 +7,19 @@ ## 运行参数 -* Url:链接 -* Output:输出目录 +* 网址 +> 视频链接 +* 音频 +> 在预览环境时,只输出音频资源。 +* 标签 +> 下载的视频*itag*, 可以参考:[YouTube video stream format codes](https://gist.github.com/sidneys/7095afe4da4ae58694d128b1034e01e2), 也可以通过动作预览,获取 *itag*。 +* 输出 -## 输出 +> 下载的视频保存的文件夹。 +## 输出 +> 下载的视频路径,参考:[Path](../types/Path.md) @@ -23,4 +30,4 @@ import simple; ``` -## 示例 \ No newline at end of file +## 资源 \ No newline at end of file diff --git a/docx/actions/type/TypeDict.md b/docx/actions/type/TypeDict.md new file mode 100644 index 0000000..343cce8 --- /dev/null +++ b/docx/actions/type/TypeDict.md @@ -0,0 +1,22 @@ +# 字典 +定义一个 `Dict`(字典) 类型。 + +## 子流程 +> 支持 + +## 运行参数 + + +## 输出 + +> [`Dict`](./types/Dict.md) + + +## 脚本调用 + +```python +import simple; + +``` + +## 示例 \ No newline at end of file diff --git a/docx/actions/type/TypeTuple.md b/docx/actions/type/TypeTuple.md new file mode 100644 index 0000000..781277b --- /dev/null +++ b/docx/actions/type/TypeTuple.md @@ -0,0 +1,27 @@ +# 字典 +定义一个 `Tuple`(元组) 类型。 + +## 子流程 +> 支持 + +## 运行参数 + +* 名称 +> 元组的第 1 个元素。 + +* 数据 +> 元组的第 2 个元素。 + +## 输出 + +> [`Tuple`](./types/Tuple.md) + + +## 脚本调用 + +```python +import simple; + +``` + +## 示例 \ No newline at end of file diff --git a/docx/enums/KnownFolder.md b/docx/enums/KnownFolder.md new file mode 100644 index 0000000..14eda03 --- /dev/null +++ b/docx/enums/KnownFolder.md @@ -0,0 +1,8 @@ +# KnownFolder + +* Downloads +> 下载 +* Documents +> 我的文档 +* LocalAppData +> \ No newline at end of file diff --git a/docx/types/Dict.md b/docx/types/Dict.md new file mode 100644 index 0000000..f872add --- /dev/null +++ b/docx/types/Dict.md @@ -0,0 +1 @@ +# Dict \ No newline at end of file diff --git a/docx/types/Tuple.md b/docx/types/Tuple.md new file mode 100644 index 0000000..f37bec8 --- /dev/null +++ b/docx/types/Tuple.md @@ -0,0 +1 @@ +# Tuple \ No newline at end of file