AdHoc 0.2.0

.. role:: mod(strong)
.. role:: func(strong)
.. role:: class(strong)
.. role:: attr(strong)
.. role:: meth(strong)

AdHoc Standalone Python Script Generator
########################################

AdHoc consists of a single python source file `adhoc.py`, which can
be used as a program (see `Script Usage`_) as well as a module (see
:class:`adhoc.AdHoc`).

`adhoc.py` itself is distributed as a compiled adhoc script.

After installation of the binary package, run ``adhoc.py --explode``
to obtain the full source in directory ``__adhoc__``.


Purpose
=======

AdHoc provides python scripts with

- template facilities
- default file generation
- standalone module inclusion

AdHoc has been designed to provide an implode/explode cycle:

======== ======= ========= ======= =========
source_0 xsource_0
source_1 implode explode xsource_1
... ------> script.py ------> ...
source_n xsource_n
======== ======= ========= ======= =========

where ``xsource_i === source_i``. I.e., ``diff source_i xsource_i``
does not produce any output.