PyScript CLI

PyScript的命令行界面。

快速将Python脚本包装成HTML模板，预先配置了PyScript。

❯ pyscript

 Usage: pyscript [OPTIONS] COMMAND [ARGS]...

 Command Line Interface for PyScript.

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────╮
│ --version          Show project version and exit.                                              │
│ --help             Show this message and exit.                                                 │
╰────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────╮
│ create  Create a new pyscript project with the passed in name, creating a new directory in the │
│         current directory. Alternatively, use `--wrap` so as to embed a python file instead.   │
│ run     Creates a local server to run the app on the path and port specified.                  │
╰────────────────────────────────────────────────────────────────────────────────────────────────╯

安装

使用Pip

$ pip install pyscript

从仓库克隆中安装开发环境

请参阅CONTRIBUTING页面上的开发环境部分

用法

运行

启动本地服务器，在指定的路径和端口上运行

$ pyscript run <path_of_folder>

默认情况下，这将通过localhost:8000服务path_of_folder文件夹，并在浏览器窗口中打开URL。如果没有提供path_of_folder，则默认为当前目录。

要使用不同的端口，请使用--port选项。

$ pyscript run <path_of_folder> --port 9000

要避免打开浏览器窗口，请使用--no-view选项。

$ pyscript run <path_of_folder> --no-view

创建

使用传递的名称创建一个新的pyscript项目，创建一个新的目录

$ pyscript create <name_of_app>

这将创建一个名为name_of_app的新目录，位于当前目录下。

交互式提示将进一步询问有关应用程序的描述、作者的名称、作者的电子邮件等信息。当然，可以通过如--author-name等选项提供这些信息。使用pyscript create --help获取更多信息。

以下文件将被创建

• index.html：项目的起始页面
• pyscript.toml：项目元数据和配置文件
• main.py：一个“Hello world”Python入门模块

使用 --wrap 嵌入Python文件或命令字符串

• 将Python脚本嵌入到PyScript HTML文件中

$ pyscript create --wrap <filename.py>

这将在当前目录下生成一个项目，即名为filename的新目录。

类似于上面，交互式提示将进一步询问元数据信息。

以下文件将被创建

• index.html：项目的起始页面
• pyscript.toml：项目元数据和配置文件
• main.py：包含filename.py的代码

这可以通过-o或--output选项来覆盖

$ pyscript create --wrap <filename.py> -o <another_filename.html>

例如，上述目录中创建的HTML文件现在将被命名为another_filename.html

• 带有--command选项的非常简单的命令示例

可以使用-c或--command选项演示非常简单的情况。

默认情况下，创建的项目文件夹名称将为pyscript-command-app，HTML文件名为index.html。

-o/--output选项可以与-c/--command选项一起使用，以配置项目文件夹的名称以及生成的HTML文件的名称。

$ pyscript create --wrap -c 'print("Hello World!")' -o <output_filename.html>

这将在当前目录下生成一个项目，即名为output_filename的新目录。

类似于上面，交互式提示将进一步询问元数据信息。

以下文件将被创建

• output_filename.html：项目的起始页面
• pyscript.toml：项目元数据和配置文件
• main.py：包含通过-c/--command传递的命令字符串的代码