在jupyterlab界面中显示slurm作业剩余时间
项目描述
slurm_time
此扩展由一个名为slurm_time
的服务器扩展Python包和一个名为slurm-time
的前端扩展NPM包组成。
要求
- JupyterLab >= 3.0
安装
要安装扩展,请执行
pip install slurm_time
卸载
要移除扩展,请执行
pip uninstall slurm_time
故障排除
如果您看到了前端扩展,但它没有工作,请检查服务器扩展是否启用
jupyter server extension list
如果服务器扩展已安装并启用,但您看不到前端扩展,请检查前端扩展是否已安装
jupyter labextension list
贡献
开发安装
注意:您需要NodeJS来构建扩展包。
jlpm
命令是JupyterLab的yarn的固定版本,它是与JupyterLab一起安装的。您可以使用yarn
或npm
代替下面的jlpm
。
# Clone the repo to your local environment
# Change directory to the slurm_time directory
# Install package in development mode
pip install -e .
# Link your development version of the extension with JupyterLab
jupyter labextension develop . --overwrite
# Server extension must be manually installed in develop mode
jupyter server extension enable slurm_time
# Rebuild extension Typescript source after making changes
jlpm build
您可以在不同的终端中同时监视源目录并运行JupyterLab,以监视扩展源的变化并自动重新构建扩展。
# Watch the source directory in one terminal, automatically rebuilding when needed
jlpm watch
# Run JupyterLab in another terminal
jupyter lab
在运行watch命令时,每次保存的更改将立即在本地构建并可在运行的JupyterLab中使用。刷新JupyterLab以在浏览器中加载更改(您可能需要等待几秒钟以重新构建扩展)。
默认情况下,jlpm build
命令为该扩展生成源映射,以便使用浏览器开发者工具更容易调试。要为JupyterLab核心扩展也生成源映射,可以运行以下命令
jupyter lab build --minimize=False
开发卸载
# Server extension must be manually disabled in develop mode
jupyter server extension disable slurm_time
pip uninstall slurm_time
在开发模式下,您还需要删除由jupyter labextension develop
命令创建的符号链接。要找到其位置,您可以运行jupyter labextension list
以确定labextensions
文件夹的位置。然后您可以在该文件夹中删除名为slurm-time
的符号链接。
测试扩展
服务器测试
此扩展使用Pytest进行Python代码测试。
安装测试依赖项(仅需要一次)
pip install -e ".[test]"
要执行它们,请运行
pytest -vv -r ap --cov slurm_time
前端测试
此扩展使用Jest进行JavaScript代码测试。
要执行它们,请执行
jlpm
jlpm test
集成测试
此扩展使用Playwright进行集成测试(也称为用户级测试)。更具体地说,使用JupyterLab辅助工具Galata来处理在JupyterLab中测试扩展。
更多详细信息请参阅ui-tests的README。
打包扩展
项目详情
下载文件
下载适用于您的平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。