Installation

ObjDiff makes use of the yield from statement in Python 3.3 or greater and as such the minimum supported version of Python is 3.3.

ObjDiff is a fully self contained pure python module with no dependencies beyond the stdlib. As such a simple pip install will install the package.

$ pip install objdiff

Note that it is not recommended to do this as root. if you need this available to all code running under your current user please install the module user wide with the following command:

$ pip install --user objdiff

If the module needs to be accessible to a different user please consider using a virtualenv or installing a package provided by the OS that contains the objdiff library.

Developers

If you are hacking on the source for objdiff, several commands in the Makefile have been provided to get a standard environment up quickly.

to build a virtual environment to a standard location use the following command:

$ make virtual

This will proceed to build a virtual environment that you can then activate for your current shell with the following command:

$ . venv/bin/activate

Your current python installation is now separate from the Operating System provided one allowing you to add packages without root privileges.

To activate the ObjDiff source repository as a module in your new virtual environment, issue the following command.

$ make develop

This will activate the module in such a way that any changes made to the module itself are reflected instantly without having to re-install the module every time.