Installation and Basic Usage

Installation

Note

When building the gtar module (even when installing from PyPI), a working compiler chain is required. This means that, on Mac OSX systems, you will need to install the XCode command line tools if they are not already installed.

Versioned releases

Install a released version from PyPI using pip:

pip install gtar

From source

Installing the libgetar python module (gtar) from source is straightforward. From the root directory of the project:

pip install .
# Test installation:
cd
python -c 'import gtar'

Note that trying to run scripts from the libgetar source directory will not work!

Documentation

Documentation is built using sphinx and doxygen. To build it, use the Makefile in the doc subdirectory:

cd doc
make html

Note that we use the breathe python package to interface between sphinx and doxygen. If it isn’t installed (and isn’t available in your package manager), you can install it easily with pip:

pip install breathe --user

The latest version of the documentation is available online on ReadTheDocs.