jupyterlab_dosbox

在jupyterlab中运行DosBox。基于js-dos构建，并使用js-dos 7.xx模块。

这提供了一个非常简单的界面，用于访问WASM编译的DosBox实例。您可以获取截图、核心转储，并发送命令。它将使用pooch从网络下载一些wasm资产。

截至目前，DosBox实例不监听键盘和鼠标事件！

examples目录中的示例展示了如何获取核心转储、截图并发送zip文件。

• 截图
• 发送zip文件并获取核心转储

还有很多粗糙的边缘！但是，您可以使用左侧的文件浏览器面板浏览文件系统中的文件，并且可以检查内存。

路线图中的某些事情

• 与实例的更好交互，包括捕获和发送适当的浏览器事件
• 保存和恢复文件系统和内存实例（即，机器状态）
• 更好的核心转储检查界面
• 声音和视频捕获
• 界面全面优化（比如，为什么没有图标？！）

需求

• JupyterLab >= 3.0
• Pooch
• numpy，用于内存访问

安装

pip install jupyterlab_dosbox

贡献

开发安装

注意：您需要NodeJS来构建扩展包。

jlpm命令是JupyterLab的固定版本的yarn，它是与JupyterLab一起安装的。您可以使用下面的yarn或npm代替jlpm。

# Clone the repo to your local environment
# Change directory to the jupyterlab_dosbox directory
# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Rebuild extension Typescript source after making changes
jlpm run build

您可以在不同的终端中同时监视源目录并运行JupyterLab，以监视扩展源代码的变化并自动重新构建扩展。

# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm run watch
# Run JupyterLab in another terminal
jupyter lab

在运行监视命令的情况下，每次保存的更改都将立即在本地上构建，并可在您的运行中的JupyterLab中使用。刷新JupyterLab以在浏览器中加载更改（您可能需要等待几秒钟以重建扩展）。

默认情况下，jlpm run build命令为该扩展生成源映射，以便更容易使用浏览器开发者工具进行调试。要为JupyterLab核心扩展也生成源映射，可以运行以下命令

jupyter lab build --minimize=False

卸载

pip uninstall jupyterlab_dosbox