Rio是一个易于使用的网站和应用程序创建框架,完全基于Python。🐍
你无需编写任何HTML、CSS或JavaScript代码就能创建美观、现代的应用程序。
教程 - 示例 - Discord - 文档 - 源代码
Rio将React风格的组件引入Python。你可以从丰富的内置组件中选择,并将它们组合以创建自定义组件。然后将这些组件组合成完整的应用程序。最棒的是,Rio应用程序既可以在本地机器上运行,也可以在网络上运行。
特性 🧩
- 现代化的声明式UI框架
- 100% Python - 无需HTML、CSS或JavaScript
- 超过50个内置组件用于常见UI元素,如
rio.Switch
、rio.Button
和rio.Text
等 - 与现代Python工具集成:由于完全类型安全,编辑器可以立即给出建议并突出显示问题
- 应用程序可以在本地和网络上运行
- 内置开发工具
- 开源且永久免费
示例 ⌨️
# 定义一个计算按钮点击次数的组件
class ButtonClicker(rio.Component):
# 定义组件的属性。Rio会监视这些属性的变化
# 并自动更新GUI。
clicks: int = 0
# 定义一个增加点击次数的方法。我们稍后会创建一个按钮,每次按下时都会调用这个方法。
def _on_press(self) -> None:
self.clicks += 1
# 定义`build`方法。这个方法本质上告诉rio
# ButtonClicker组件的外观。每当ButtonClicker组件的状态
# 发生变化时,rio都会调用其`build`方法并根据输出更新GUI。
def build(self) -> rio.Component:
return rio.Column(
rio.Button('点击我', on_press=self._on_press),
rio.Text(f'你点击了按钮 {self.clicks} 次'),
)
# 创建一个App并告诉它在启动时显示ButtonClicker
app = rio.App(build=ButtonClicker)
app.run_in_browser() # 或者使用`app.run_in_window()`作为本地应用运行!
安装 🛠️
Rio可以在PyPI上获取,所以你可以使用pip安装:
pip install rio-ui
快速开始 🎓
Rio提供了一个非常有用的命令行工具来帮助你。只需一个简短的命令就可以创建新项目:
rio new
你可以从各种内置模板中选择来开始。这里是一个基于井字游戏模板创建项目的完整示例:
rio new my-project --type website --template "Tic-Tac-Toe"
cd my-project
rio run
几秒钟内你就能运行起你的第一个应用了!
状态:开发中 🚧
Rio仍在开发中。我们正在努力为你带来最好的体验。如果你有任何反馈,请在我们的Discord服务器上告诉我们。
贡献 🤝
每个项目都因帮助而蓬勃发展,Rio也不例外。有很多方式可以参与进来,比如添加新功能、修复bug,或者只是分享你的想法。向项目提交Pull Request时,请查看我们的贡献指南。Rio每周都在推出新功能,不断变得更好。给这个仓库加星⭐并👀关注,以保持最新动态!
除非你明确声明,否则提交用于包含在Rio中的任何贡献都将根据Apache-2.0许可证的条款进行许可,不附加任何额外条款或条件。
社区支持 🫶
加入Rio冒险,成为一个很棒的团队的一部分!以下是联系方式:
- Discord(提升你的Rio技能!加入我们的Discord服务器与其他开发者聊天,讨论如何贡献。)
- GitHub(**发现bug?**Issues是让我们知道的完美地方。想更进一步帮忙?尝试修复现有issue并提交PR!)
- 社区论坛(加入我们在Github上的社区论坛提问和讨论)
- 功能请求(在GitHub上请求功能的最清晰方式)
关于使用Rio的一般帮助,请参考Rio官方文档。