From f55ffe817be568887cb8301672448a7e6cd29ab9 Mon Sep 17 00:00:00 2001 From: Co An Date: Tue, 2 Jul 2019 22:35:46 +0800 Subject: [PATCH 1/3] Update api.md --- docs/api.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/api.md b/docs/api.md index 511aa135..de604326 100644 --- a/docs/api.md +++ b/docs/api.md @@ -2393,7 +2393,7 @@ async def _(session): - **参数:** - - `expr: Expression_T`: 要渲染的 Expression + - `expr: Expression_T`: 要渲染的 Expression，当 Expression 为非字符串的 Squence 类型时则会随机选择其中一项 - `escape_args: bool`: 是否对渲染参数进行转义 - `*args: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入位置参数 - `**kwargs: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入命名参数 From a163d2c0755b1e3d56c3b3b591a0e5885a706105 Mon Sep 17 00:00:00 2001 From: Richard Chien Date: Tue, 2 Jul 2019 22:51:24 +0800 Subject: [PATCH 2/3] Update api.md --- docs/api.md | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/docs/api.md b/docs/api.md index de604326..771c949f 100644 --- a/docs/api.md +++ b/docs/api.md @@ -2391,9 +2391,15 @@ async def _(session): 渲染 Expression。 + 对于 Expression 的三种类型：`str`、`Sequence[str]`、`Callable`，行为分别是： + + - `str`：以 `*args`、`**kwargs` 为参数，使用 `str.format()` 进行格式化 + - `Sequence[str]`：随机选择其中之一，进行上面 `str` 的操作 + - `Callable`：以 `*args`、`**kwargs` 为参数，调用该可调用对象/函数，对返回的字符串进行上面 `str` 的操作 + - **参数:** - - `expr: Expression_T`: 要渲染的 Expression，当 Expression 为非字符串的 Squence 类型时则会随机选择其中一项 + - `expr: Expression_T`: 要渲染的 Expression - `escape_args: bool`: 是否对渲染参数进行转义 - `*args: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入位置参数 - `**kwargs: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入命名参数 From 2f5d37c426372091d3e1141eac0fa7c07808f444 Mon Sep 17 00:00:00 2001 From: Richard Chien Date: Tue, 2 Jul 2019 22:55:02 +0800 Subject: [PATCH 3/3] Update api.md --- docs/api.md | 15 ++++++--------- 1 file changed, 6 insertions(+), 9 deletions(-) diff --git a/docs/api.md b/docs/api.md index 771c949f..59210fe1 100644 --- a/docs/api.md +++ b/docs/api.md @@ -2391,18 +2391,15 @@ async def _(session): 渲染 Expression。 - 对于 Expression 的三种类型：`str`、`Sequence[str]`、`Callable`，行为分别是： - - - `str`：以 `*args`、`**kwargs` 为参数，使用 `str.format()` 进行格式化 - - `Sequence[str]`：随机选择其中之一，进行上面 `str` 的操作 - - `Callable`：以 `*args`、`**kwargs` 为参数，调用该可调用对象/函数，对返回的字符串进行上面 `str` 的操作 - - **参数:** - - `expr: Expression_T`: 要渲染的 Expression + - `expr: Expression_T`: 要渲染的 Expression，对于 Expression 的三种类型：`str`、`Sequence[str]`、`Callable`，行为分别是： + - `str`：以 `*args`、`**kwargs` 为参数，使用 `str.format()` 进行格式化 + - `Sequence[str]`：随机选择其中之一，进行上面 `str` 的操作 + - `Callable`：以 `*args`、`**kwargs` 为参数，调用该可调用对象/函数，对返回的字符串进行上面 `str` 的操作 - `escape_args: bool`: 是否对渲染参数进行转义 - - `*args: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入位置参数 - - `**kwargs: Any`: 渲染参数，用于 `str.format()` 或 Expression 函数调用时传入命名参数 + - `*args: Any`: 渲染参数 + - `**kwargs: Any`: 渲染参数 - **返回:**