_images/logo_hzb_big.png

Welcome to pyexpander’s documentation!

pyexpander - a powerful turing complete macro processor

pyexpander is a macro processor that allows to embed python code in text files.

Some of the features are:

  • Variables like $(VAR) are replaced.

  • Valid python expressions like $(2+3/2) are evaluated.

  • Arbitrary python code like in $py(import math; math.pi) can be executed.

  • The functionality is available as a script and a python library.

  • The program is availiable for python version 3.

See Introduction for more information.

Author:

Goetz Pfeiffer (Goetz.Pfeiffer@helmholtz-berlin.de, goetzpf@googlemail.com)

Documentation

Introduction

This gives a first impression on pyexpander’s capabilities:

Introduction to pyexpander

Reference documents

This is the reference of the pyexpander language:

pyexpander reference

Full list of documents

Download and install

By using pip, installing pyexpander is a single line command. This and other installation methods are described in

Installing pyexpander

pyexpander at sourceforge

You find the sourceforge summary page for pyexpander at pyexpander.

The source

You can browse the mercurial repository here:

repository at Sourceforge.

or clone it with this command:

Sourceforge:

hg clone http://hg.code.sf.net/p/pyexpander/code pyexpander-code

You can then commit changes in your own repository copy.

If you plan to share these changes you can create a mercurial bundle and send it to my e-mail address.

Indices and tables