环境
- windows 10 64bit
- python 3.8.15
- pynecone 0.1.14
简介
Pynecone 是一个基于纯 python 的用于开发 web app 的开源框架,它依赖于 nodejs,不过不需要另外编写前端代码,这对于没有接触过前端的朋友是非常友好的。
安装
第一步,安装 nodejs,来到官网 https://nodejs.org/en/,下载 LTS 版本,目前最新的是 18.12.1 LTS

文件下载后,双击进行傻瓜式安装即可


第二步,安装 pynecone,使用 pip 进行
pip install -U pynecone-io
测试
安装完成后,我们来到桌面,创建一个项目
cd ~/Desktop
mkdir pc_app
pc init

然后,以管理员权限打开 powershell,执行 pc run

接着,来到浏览器,输入地址 http://localhost:3000

可以看到,默认的页面是长这个样子的,页面中也提示,修改文件 pc_app/pc_app.py 即可改变页面,也就是说不需要去写 html、javascript 和 css 就可以更改页面了
如果碰到 pc run 中报错
Error: Multiple children were passed to <Link> with `href` of `one_value` but only one child is supported https://nextjs.org/docs/messages/link-multiple-children
就需要升级下 pynecone-io,详情可以看看项目中的 issue,见文末的链接
样例解析
回到上面的例子,看看文件 pc_app/pc_app.py 文件中的代码
class State(pc.State):
"""The app state."""
pass
在 pynecone 中,state 定义了应用中的所有变量(这里叫 vars),这些变量都可以被 state 中的方法改变,这些方法叫做事件处理器(event handler),本例中并没有涉及,可以看下面这个示例,有2个事件处理器,increment 和 decrement
class State(pc.State):
count: int = 0
def increment(self):
self.count += 1
def decrement(self):
self.count -= 1
接下来的 index 方法负责前端页面的显示,也是需要重点关注的部分
def index():
return pc.center(
pc.vstack(
pc.heading("Welcome to Pynecone!", font_size="2em"),
pc.box("Get started by editing ", pc.code(filename, font_size="1em")),
pc.link(
"Check out our docs!",
href=docs_url,
border="0.1em solid",
padding="0.5em",
border_radius="0.5em",
_hover={
"color": "rgb(107,99,246)",
},
),
spacing="1.5em",
font_size="2em",
),
padding_top="10%",
)
在 pynecone 中,有50多个组件(component)可以使用,如常见的按钮 button、box、heading、slider 等等,具体可以参考这个链接 https://pynecone.io/docs/library。在本例中使用了标题 heading、box 和超链接 link,这3个组件被装在了 vstack 里,也就是垂直排列,而且是居中的(pc.center)。各组件的样式,都可以通过对应方法中的参数进行调整。
组件可以引用应用中的变量,这里看个 button 的例子
pc.button(
"Decrement",
color_scheme="red",
border_radius="1em",
on_click=State.decrement,
),
on_click 中跟上的是事件处理器 decrement,也就是当按钮被点击一次,count 的值就减1
当页面写好之后,就需要设置路由了(Routing)
# 初始化app
app = pc.App(state=State)
# 设置应用的根URl
app.add_page(index)
如果要添加多个页面,在 add_page 时,可以跟上参数 route,比如
app.add_page(second_page, route="/demo")
访问的 url 就变成了 http://localhost:3000/demo
最后一步就是启动服务了,在 pynecone 中叫 compile
app.compile()
就这样,一个简单的 web 项目就完成了,没有写一点前端相关的代码
项目中还有个重要的配置文件,就是 pcconfig.py,比如要更改下默认的端口,可以这样

继而访问的 url 就变成了 http://localhost:5000 了

另外官方提供了另一示例仓库,里面包含了很多类似的工程,非常值得学习借鉴,链接是 https://github.com/pynecone-io/pynecone-examples