Skip to main content

fractal-slurm-tools

PyPI version License

You can run a version of this tool from PyPI or GitHub, either via pipx or uvx.

Examples (the CLI entrypoint must be one of fractal-slurm-aggregate fractal-slurm-parse-bulk or fractal-slurm-parse-single-job):

# Latest PyPI release
$ pipx run --spec fractal-slurm-tools <entrypoint>
$ uvx --from fractal-slurm-tools <entrypoint>

# Specific PyPI release
$ pipx run --spec fractal-slurm-tools==0.5.0 <entrypoint>
$ uvx --from fractal-slurm-tools==0.5.0 <entrypoint>

# Latest git commit on the default branch
$ pipx run --spec git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git <entrypoint>
$ uvx --from git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git <entrypoint>

# Specific git commit
$ pipx run --spec git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git@3faeefd0eac0f53c6c73d2e3179b10ff2a111793 <entrypoint>
$ uvx --from git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git@3faeefd0eac0f53c6c73d2e3179b10ff2a111793 <entrypoint>

# Specific git branch
$ pipx run --spec git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git@main <entrypoint>
$ uvx --from git+https://github.com/fractal-analytics-platform/fractal-slurm-tools.git@main <entrypoint>

Environment variables

# Enable compatibility with legacy SLURM (e.g. v15.08.7)
USE_LEGACY_FIELDS=1

# Modify batch size
SACCT_BATCH_SIZE=50

# Token to connect to the Fractal backend
FRACTAL_TOKEN=...

A useful sacct command

sacct --format='JobID%18,JobName%18,State,ReqMem,MaxRSS,AveRSS,Elapsed,NCPUS,CPUTimeRaw,MaxDiskRead,MaxDiskWrite' -j XXXX

Development

uv

We use uv to manage the development environment and the dependencies - see https://docs.astral.sh/uv/getting-started/installation/ for methods to install it. From the root folder, you can get started through

# Create a new virtual environment in `.venv`
uv venv

# Install both the required dependencies and the optional dev/docs dependencies
uv sync --frozen --extra dev

# Run a command from within this environment without updating the `uv.lock` file
uv run --frozen fractal-slurm-parse-single-job

Make a release

# Make a release
uv run --frozen bumpver update --patch --dry

Contributors and license

The Fractal project is developed by the BioVisionCenter at the University of Zurich, who contracts eXact lab s.r.l. for software engineering and development support.

Unless otherwise specified, Fractal components are released under the BSD 3-Clause License, and copyright is with the BioVisionCenter at the University of Zurich.

Metadata

Release files for fractal-slurm-tools 0.6.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for fractal-slurm-tools 0.6.0
File Size Uploaded
fractal_slurm_tools-0.6.0.tar.gz 17.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for fractal-slurm-tools 0.6.0
File Interpreter ABI Platform
fractal_slurm_tools-0.6.0-py3-none-any.whl Python 3 none any Details

Total release size: 36.1 kB

Release files / fractal_slurm_tools-0.6.0.tar.gz

Download URL fractal_slurm_tools-0.6.0.tar.gz
Size 17.4 kB
Tags Source
SHA-256 checksum
How to use checksums
280c21edd82931a10a1644300d992bb08c79126edab1774821af8dc6ab67ea34
BLAKE2b-256 checksum
How to use checksums
50dc285ab7899eb4ae456492b676dc81e320cb11f2a750fb005fdf9e607fbeeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 26, 2026.

Transparency log

Release files / fractal_slurm_tools-0.6.0-py3-none-any.whl

Download URL fractal_slurm_tools-0.6.0-py3-none-any.whl
Size 18.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
3e27853e2aa0d1032e846300cf2634aa84624fca4bcd08aaec86b1497fced86f
BLAKE2b-256 checksum
How to use checksums
9675c4ff0a28b108690fcfd5c6f3997275b7397b44996d401a1275f0b20ad93d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.13

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 26, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page