PyRoe 1.0

PyRoe project is a "static partial linker" for small helper Python libraries.

PyRoe links a Python script with its helper libraries into self-contained Python executable (PyRoe capsule).

Pyroe HOWTO

Assume that your main module is called frob.py and that it uses libraries libfoo.py and libbar.py (directly or indirectly). To pyroize your program, follow these steps (see Figure above for enlightenment):

Create the file Manifest.pyroe containing these three lines:

frob.py
libfoo.py
libbar.py

and put it in a directory together with your source files.

Run pyroe
After pyroe is done, you will find the file frob in the working directory.
The file frob is executable, the invocation
./frob ARGS...

is equivalent to

python frob.py ARGS...

but to run frob you no longer need libfoo.py or libbar.foo lying around.
Pyroe runtime library hidden inside of frob hijacks some command-line options starting with --pyroe-; in particular

frob --pyroe-unpack

will unpack the content of the capsule back to individual files.

For more information see

pyroe --help

The name of PyRoe capsule is always derived from the name of the first file in the Manifest.pyroe.