PySlurm: Slurm Interface for Python

Overview

Currently PySlurm is under development to move from it's thin layer on top of the Slurm C API to an object orientated interface.

For a preview of version 2 of the API, see the dev-17.02-props branch.

This release is based on Slurm 17.02.

Prerequisites

• Slurm
• Python
• Cython

This PySlurm branch has been tested with:

• Cython 0.15.1*, 0.19.2, and the latest stable

• Python 2.6, 2.7, and 3.4

• Slurm 17.02.0 thru 17.02.7

  Note: Cython 0.15.1 is only supported on Python 2.6 and 2.7.

Installation

You will need to instruct the setup.py script where either the Slurm install root directory or where the Slurm libraries and Slurm include files are :

1. Slurm default directory (/usr):

   • python setup.py build
   • python setup.py install

2. Indicate Blue Gene type Q on build line:

   • --bgq

3. Slurm root directory (Alternate installation directory):

   • python setup.py build --slurm=PATH_TO_SLURM_DIR
   • python setup.py install

4. Separate Slurm library and include directory paths:

   • python setup.py build --slurm-lib=PATH_TO_SLURM_LIB --slurm-inc=PATH_TO_SLURM_INC
   • python setup.py install

5. The build will automatically call a cleanup procedure to remove temporary build files but this can be called directly if needed as well with :

   • python setup.py clean

Documentation

Sphinx (needs to be installed) is currently used to generate the documentation from the reStructuredText based doc strings from the module once it is built and can be regenerated at any time :

• cd doc
• make clean
• make html

Authors

• Mark Roberts <[email protected]>
• Giovanni Torres <giovanni.torres/gmail/com>

Help

Ask questions on the pyslurm group.