drmaa 0.7.6

a python DRMAA library

Distributed Resource Management Application API (DRMAA) bindings for Python. For more information read the docs.

Requirements

• Python 2.6+

• A DRMAA-compatible cluster (e.g., Grid Engine)

Installation

To use the DRMAA Python library, you need to install it via pip:

pip install drmaa

and then setup any environment variables that are necessary for your particular DRM system. For SGE, this means SGE_ROOT and SGE_CELL, which should be set as follows:

export SGE_ROOT=/path/to/gridengine
export SGE_CELL=default

where /path/to/gridengine/ is replaced with the actual path to your Grid Engine installation. This is typically /var/lib/gridengine.

You will also need access to the libdrmaa.so.1.0 C library, which can often be installed as part of the libdrmaa-dev package on most Unixes. Once you have installed that, you may need to tell DRMAA Python where it is installed by setting the DRMAA_LIBRARY_PATH environment variable, if it is not installed in a location that Python usually looks for libraries.

export DRMAA_LIBRARY_PATH=/usr/lib/libdrmaa.so.1.0

License

• BSD (3 Clause)

Changelog

• v0.7.6

  • Fix a typo in DictAttribute that was causing a crash.

• v0.7.5

  • Fix an issue where dictionary attributes (like jtEnvironment) could encounter UnicodeDecodeError issues upon assignment.

• v0.7.4

  • Switch to using preferred encoding from locale module for converting strings to binary. This should prevent some lingering UnicodeEncodeError crashes on Python 2.7.

• v0.7.3

  • Fix a couple crashes when certain functions that expect str were passed integers.

• v0.7.2

  • Fix a couple inconsistencies with str vs bytes in Python 3 in drmaa.session.

• v0.7.1

  • Add Read The Docs documentation

  • Add const module identifiers back into package namespace

  • Remove b prefixes from strings inserted into error messages.

• v0.7.0

  • String attribute issues with Python 3 have all been resolved, and now each function that takes a string can handle unicode strings, and returns unicode strings.

  • All code has been updated to use future imports for unicode_literals and print_function, so we’re effectively writing Python 3 code now.

  • PEP8 compliance changes all over the place, except those that would break names required by underlying C DRMAA library.

  • Now automatically run unit tests of Travis-CI with SGE, and all tests pass for Python 2.6, 2.7, and 3.3. SGE is installed using scripts I describe in this gist.

  • Unit tests are now in a top-level directory instead of a sub-directory under the drmaa package.

  • There is now a session.py module that contains most of the code that was in __init__.py before, and __init__ just imports things and sets __all__ and __version__, as is typically recommended now.

  • Drops support for Python 2.5.