geopmdpy

This directory contains source code for the geopmdpy Python package, which provides python bindings for libgeopmd, as well as the geopmd daemon, geopmaccess tool for administrators, and the geopmsession tool for end users.

Subdirectories include:

• debian: Configuration files for debian packaging scripts
• geopmdpy: Source code for modules in this package
• test: Test code for this package

Set Up a Development Environment

Run pip install . to install this package. Optionally use the -e installation option to install in editable mode (so you don't need to reinstall between updating python source code and re-running tests). The install command will also install the python execution-time dependencies of this package.

Also run pip install -f requirements.txt to install additional development dependencies. If you follow these steps, then you do not need to modify your PYTHONPATH variable when executing tests.

The geopmdpy package wraps libgeopmd. Be sure to follow the build instructions in the directory for that library as part of setting up a geopmdpy development environment. Either install that builds somewhere on your path, or manually add it to your LD_LIBRARY_PATH (examples in the next section).

Executing Tests

Run LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$PWD/../libgeopmd/.libs" python3 test from this directory to launch the entire test suite. Some of the tests depend on libgeopmd, so it should be built before running tests. Alternatively, run LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$PWD/../libgeopmd/.libs" python3 -m unittest discover -p 'Test*.py'

Execute a single test case with LD_LIBRARY_PATH="$LD_LIBRARY_PATH:$PWD/../libgeopm/.libs" python -m unittest .