PyRoe

PyRoe 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).

[Download]

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.

pyroe --help

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

Python eating its own tail

PyRoe always adds support files pyroe.py and libpyroe.py to the capsule. In particular, pyroizing empty Manifest.pyroe generates capsule called pyroe, which, oh!, is identical to the PyRoe executable! (PyRoe itself is distributed as a PyRoe capsule.)

Links

• PythonEggs

License

Copyright by Grzegorz Jakacki, 2006.
Usage of the works is permitted provided that this instrument is retained with the works, so that any entity that uses the works is notified of this instrument.
DISCLAIMER: THE WORKS ARE WITHOUT WARRANTY.
[End of License.]

The above is OSI-cerfied open-source license called Fair License.

Hosted at: