Installation

This page describes the installation procedure of EggLib.

Requirements

EggLib works under Python 3. It is tested and distributed as binaries for Python 3.7, 3.8, 3.9 and 3.10. Binary distributions are available for MacOSX (10.9+) and Windows (8 or above).

If you plan to compile EggLib from source, you’ll need the development libraries for your version of Python. For using any function of the wrappers module, the corresponding program must be found in your system and EggLib should be configured accordingly (see Configuring paths).

Installation

EggLib is on the Python Package Index and can be installed using pip as:

pip install egglib --user

The --user flag tells pip to install EggLib in your local user libraries. You can drop it from a system-wide install or if you’re working in a virtual environment.

If the pip command is not directly accessible or if you want to install EggLib for a specific (non-default) version of Python (for example, 3.7) you can type:

python3.7 -m pip install egglib --user

or, on Windows, using the Python Launcher:

py -3.7 -m pip install egglib --user

You can also:

  • Select a specific version of EggLib (for example, 3.0.0): pip install egglib==3.0.0.

  • Upgrade to the latest version: pip install --upgrade egglib.

  • Remove EggLib: pip uninstall egglib.

Binary packages

Binary packages (binary wheels) are available on pip for MacOSX and Windows under Python 3.7 or above. pip should use the package wheel corresponding to your system. By default, it will attempt to compile EggLib (which is the normal behaviour on Linux).

Download source and binary packages

The source package can be downloaded from pip using:

pip download egglib --no-binary :all:

This will download the source package. Letting you access to source code. To modify EggLib, it will be much easier to clone EggLib from the git repository since the source package lacks some development scripts. The source package also lets you run the test suite (see below), and run an automated script (located in packaging/) to generate binary distributions.

To download the binary package corresponding to your system (assuming it is available), you can just type:

pip download egglib

Alternatively, all files for the current release are available for download from https://pypi.org/project/EggLib/#files. Older releases are also archived there.

Configuring external applications

If external applications are needed (one is required for every function of the wrappers module), they must be configured. By default, EggLib will assume that the corresponding programs are absent and will not attempt to run them. The best way consists in providing the command allowing to run the programs to the wrappers module, which can be done permanently or temporarily. For details, see Configuring paths.

Tests

The test suite is available from the project package and also from the source package (using pip install egglib). To run the full list of tests, use from the project directory (after installing EggLib):

python test -ao LOG_FILE

It is possible to run tests separately for different subpackages. Use python test -h for a manual. If the paths for external applications have not been provided (see here), the tests involving them will fail.

Note: currently, two tests implying the random module may fail occasionally (one yielding an error, the other hanging indefinitively).