Typhon requires Python version 3.5 or higher. The recommended way to get Python is through Anaconda. But of course, any other Python distribution is also working.

The easiest way to develop typhon is to install the local working copy in your Python environment. This can be done using pip:

pip install --user --editable .

This will install the package in editable mode (develop mode) in the user's home directory. That way, local changes to the package are directly available in the current environment.

Typhon contains a simple testing framework using Nosetests. It is good practice to write code for all your functions and classes. Those tests may not be too extensive but should cover the basic use cases to ensure correct behavior through further development of the package.

Tests can be run on the command line...

nosetests typhon

or using the Python interpreter:

import typhon
typhon.test()

Typhon supports a configuration file in configparser syntax. The configuration is handled by the typhon.config module. The default file location is ~/.typhonrc but can be changed using the TYPHONRC environment variable.

It is also possible to set environment variables in the same-named section of the configuration file, e.g.:::

[environment]
ARTS_BUILD_PATH: /path/to/arts/build/

The documentation of the project is created with Sphinx. You can use the enclose Makefile to build your own documentation:

cd doc
make html

The latest version Typhon Docs is also accessible online.