如何用PyScript CLI将Python脚本快速转化为Web应用？

引言

在现代开发环境中，将Python代码快速转化为Web应用是一项重要技能。PyScript CLI应运而生，它是一个便捷的命令行界面，能帮助开发者快速创建和运行基于PyScript的Web应用。本文将详细介绍PyScript CLI的功能、安装方法和使用技巧，让你高效上手这一工具。

什么是 PyScript CLI？

PyScript CLI 是一个命令行工具，专门简化 PyScript 框架的使用流程。开发者可以通过它轻松把 Python 脚本封装进 HTML 模板，并借助基础命令创建、运行 PyScript 应用。无论你是入门新手还是经验丰富的工程师，PyScript CLI 都能让 Web 应用开发效率大幅提升。

安装 PyScript CLI

安装过程非常直接，使用 Python 的包管理工具 Pip 即可：

pip install pyscript

如果你更倾向于从源码克隆并进行本地开发，可以参考项目的贡献指南来搭建开发环境。

使用 PyScript CLI

PyScript CLI 提供了几个核心命令，你可以按需选用。

创建项目

create 命令用于快速搭建新项目，格式如下：

pyscript create <name_of_app>

执行后，当前目录下会出现一个名为 name_of_app 的文件夹。创建过程中，系统会提示你填写应用描述、作者等信息。
如果想把已有的 Python 文件直接嵌入项目，可以使用 --wrap 选项：

pyscript create --wrap <filename.py>

此时，CLI 会生成一个新的项目目录，并将指定的 Python 代码集成到生成的 HTML 文件中。

运行项目

run 命令会启动本地服务器来运行你的 PyScript 应用：

pyscript run <path_of_folder>

默认情况下，应用会在 localhost:8000 上启动。如需更改端口，可以加上 --port 选项：

pyscript run <path_of_folder> --port 9000

另外，如果你不希望自动打开浏览器窗口，可以添加 --no-view：

pyscript run <path_of_folder> --no-view

快速示例

只想快速尝试一些简单的 Python 命令？用 --command 选项就能一步到位。比如：

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

这条命令会创建一个新项目目录，并生成一个输出 “Hello World!” 的 HTML 文件，省去了手动编写 Python 脚本的步骤。

项目文件结构

创建项目后，你会看到如下典型文件：

• index.html ：项目的入口页面  
• pyscript.toml ：存放项目元数据和配置信息  
• main.py ：包含你 Python 代码的核心模块  

这些文件构成了清晰、可维护的开发基础。

总结

PyScript CLI 让基于 Python 的 Web 应用开发变得快速又简单。几行命令就能把 Python 代码转变为动态 Web 应用，大幅降低了构建复杂度。无论是新建项目还是启动现有项目，PyScript CLI 都能显著提升你的开发效率。

项目地址：https://github.com/pyscript/pyscript-cli