一个使用 Python + HTML 开发桌面 GUI 应用的框架,支持 Windows、Mac、Linux 平台。
功能:
我们所采用的技术栈组合是经过深思熟虑的,通过结合 Python 与 HTML 这两种高效、灵活、易用的技术栈,意味着您正在选择一个能够大大减少开发时间、简化开发流程、拥有丰富的第三方扩展的解决方案。与其它工具相比,我们的优势在于对新技术的快速适应、更为强大的社区支持,以及持续的更新和改进。
主页 | Github | PyPi | 微信 | 邮箱 | 捐赠
你可以通过 Github-Issues、微信 与我联系。
pip install miumapp
运行内置Demo:
import asyncio
from miumapp.demo import Introduce
asyncio.run( Introduce().start() )
运行后,若显示出与图片 效果图 所示一致的效果,则说明安装成功。
本文将以最简洁的方式向你介绍核心知识,而不会让你被繁琐的术语所淹没。
import asyncio
from miumapp import App, allow_callpy
class my_app(App):
async def main(self):
...
asyncio.run( my_app().start() )
由于我们在主任务 main 中未定义任何代码,因此这个 APP 是一个空 APP,运行后看不到任何效果。
class my_app(App):
async def main(self):
html = 'Hello, miumapp !'
await self.create_window(html=html)
asyncio.run( my_app().start() )
此时,我们将能看到屏幕上打开了一个窗口,其内容为“Hello, miumapp !”。
可通过传递 HTML 文本或 URL 链接这两种数据之一来决定窗口内容,示例:
await self.create_window(html='你好!')
await self.create_window(url='https://www.baidu.com/')
await self.create_window(html='你好!', title='第一个窗口')
可通过对窗口对象执行 await window.close()
或者点击窗口右上角的 ×
图标来关闭窗口。
使用 allow_callpy 装饰的 Python 异步函数将能够在 HTML 中被调用,例如:
class my_app(App):
async def main(self):
html = 'Hello, miumapp !'
await self.create_window(html=html)
@allow_callpy
async def addition(self, a, b):
return a + b
async def sub(self, a, b):
return a - b
asyncio.run( my_app().start() )
在这个例子中,方法 sub 只能在 Python 层面被调用,而方法 addition 既能在 Python 层面被调用,也能在 HTML 中被调用。
在 HTML 中调用 addition 方法:
async function sum() {
let a = parseInt( document.getElementById('a').value ) // 30
let b = parseInt( document.getElementById('b').value ) // 50
let kwargs = {a:a, b:b}
let result = await miumapp.callpy(method='addition', kwargs=kwargs)
console.log(result) // {"code":0, "msg":"", "data":80}
}
执行 JavaScript 代码:
await window.evaluate("document.title = '第一个APP'", force_expr=True)
await window.evaluate("alert(1)", force_expr=True)
获取变量值:
CityName = await window.evaluate("CityName") # 假设窗口中有一个叫 CityName 的变量
print(CityName) # >>> '北京市'
调用函数并获取返回值:
city_name = await window.evaluate("get_city_name()", force_expr=True) # 假设窗口中有一个叫 get_city_name 的函数
print(city_name) # >>> '上海市'
由于 window 对象继承自 pyppeteer.page.Page,因此 window.evaluate 支持 pyppeteer.page.Page.evaluate 的所有用法。关于 window.evaluate 的更多用法,请参考 pyppeteer.page.Page.evaluate 。
由于 window 对象继承自 pyppeteer.page.Page,因此 window 支持 pyppeteer.page.Page 的所有方法,例如页面跳转、点击按钮、输入等。关于 window 的更多方法,请参考 pyppeteer.page.Page 。