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
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).
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 <one.or.more.test.modules.or.classes.or.functions>.