Installation

Downloading AEGIS

The package can be installed either from source or from the pypi reposository.

AEGIS is publically available from a GitHub repository. It can be downloaded or cloned with:

git clone https://github.com/mlares/aegis.git

The code can be explored using GitHub, including development activity and documentation.

Requirements

AEGIS generates and compile Latex documents, so it need a working installation of Latex in the system.

Installing AEGIS

Once the virtualenvironment has been set (recommended), then install the required packages:

pip install -r requirements.txt

It is convenient to save the root directory of the installation. In bash, for example,:

export aegis_rootdir="$(pwd)"

AEGIS module can be used anywhere provided the following command is executed within the environment in the directory $aegis_rootdir:

pip install .

Alternatively, it can be installed via the python package index:

pip install aegis_latex

Testing

For testing purposes, an utility is provided in the :meth:aegis.Exam.gen_examples method.

X.gen_examples(N_problems=4, N_versions=[3, 3, 3, 3],
               dir_tex='dir_tex/', dir_pdf='dir_pdf/')

This will create two directories, and fill them with TEX and PDF files. Each tex file contains a short message indicating the problem and version numbers.

import aegis

problems, versions = aegis.gen_examples(dir_tex='exams', dir_pdf='exams')

print(problems)
print(versions)

X = aegis.Exam()
X.load_template('template.tex')

items_dir = 'exams'
items = problems
subitems = versions

X.load_items(items_dir, items, subitems)

X.generate(N=4, output_dir='exams', makepdfs=True)
# X.gen_excell(output_dir='exams/')

More tests can be found at tests/test.py.