pyxenon 3.0.3

安装

克隆此存储库，并执行以下操作

pip install .

代码将在准备发布时出现在PyPI上。

文档

编译的文档托管在Read the Docs上。这包括快速入门指南。

示例

import xenon
from pathlib import Path
import os

xenon.init()

# create a new job scheduler, using SSH to localhost to submit new jobs.
with xenon.Scheduler.create(
        adaptor='ssh', location='localhost') as scheduler:

    # make a new job description. The executable must already be present on
    # the target host.
    target = Path('.') / 'stdout.txt'
    desc = xenon.JobDescription(
        executable='hostname',
        stdout=str(target.resolve()))

    # submit a job
    job = scheduler.submit_batch_job(desc)
    status = scheduler.wait_until_done(job, 1000)

    # read the standard output of the job. We can do this directly because
    # we ran on localhost, otherwise, we need to transfer the file first.
    with open(target) as f:
        print(f.read())

开发

PyXenon附带Xenon-GRPC jar 文件和命令行可执行文件。如果需要升级，请按照Xenon-GRPC中的说明手动构建它们，并将build/install/xenon-grpc-shadow文件夹（lib和bin）的内容放在此处。

要生成GRPC代码，请在项目根目录中运行scripts/protoc.sh。

./gradlew shadowJar

测试

单元测试都是在针对 本地 调度器和 文件 适配器进行的。要运行它们，只需做

$ pytest ./tests

为了加快测试速度，可能需要手动启动 xenon-grpc 守护进程；在单独的终端中启动它，因为它可能提供有用的调试输出。

对于集成测试，运行以下 docker 容器以测试远程 slurm

docker run --detach --publish 10022:22 nlesc/xenon-slurm:17

一些示例代码在 examples/tutorial.py 中运行针对此容器。

贡献

可以通过 GitHub pull 请求进行贡献。要添加功能，首先安装测试需求

pip install -U tox

然后运行

tox

直到所有测试成功。该命令检查 flake8 代码标准和 Python 3.5 和 3.6 中的语法错误。然后提交，以确保更改没有破坏任何代码。拉取请求将在 Travis 上进行评估。