QtVoila

一个Qt for Python扩展，用于Voila！

QtVoila是一个Qt for Python (PySide6)小部件，用于控制和渲染一个Voila应用程序。它是将Voila的强大功能嵌入到您的Qt应用程序中的便捷方式。

小部件的想法和实现细节在本博客文章中描述。

安装

$ pip install qtvoila

用法

QtVoila应该作为PySide6小部件导入和使用，在您的GUI应用程序的任何位置。尽管它可以使用默认参数初始化，但您可以定义parent（PySide6应用程序），任何创建的notebooks将临时存储的临时目录，现有的外部notebook的路径以及布尔选项，用于在Voila渲染时是否删除代码源

from qtvoila import QtVoila

voila_widget = QtVoila(
    parent=None,
    temp_dir=None,
    external_notebook=None,
    strip_sources=True
)

如果以编程方式创建notebook，可以使用add_notebook_cell()方法添加新单元格。此方法接受三个参数：code_imports是要导入的模块的字典，code是包含单元格代码或markdown文本的字符串，cell_type定义了单元格的类型是代码还是markdown。示例

# Mardown cell
mtext = "#This is my title\n"
mtext += "Here goes some text. Check out this graphic:"
voila_widget.add_notebook_cell(code=mtext, cell_type='markdown')

# Code cell
imports = {
  'matplotlib': ['pyplot'],
  'numpy': [],
}
code = "%matplotlib inline\n"
code += "pyplot.plot(numpy.random.rand(10))"
voila_widget.add_notebook_cell(code_imports=imports, code=code, cell_type='code')

要在小部件上运行Voila进程并渲染结果

voila_widget.run_voila()

要清除小部件并停止后台Voila进程

voila_widget.close_renderer()

示例

您可以在此处找到一些示例，说明如何在PySide6应用程序中使用QtVoila。例如，从用户的输入创建notebooks并将它们渲染出来

使您的GUI导入现有的notebooks并将它们渲染出来