-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

This is an EXPERIMENTAL utility, to demonstrate a concept that could be used
in a hypothetical 'monocrystalline' Vtron. There are three included items:

(1)

dir2txt.py PATH

           ^ eats a Unix dir PATH, and produces a textual representation
             of its total contents to stdout.

           Example usage:

             ./dir2txt.py fg > fg.xtal

           This example's output is INCLUDED with this genesis.


(2)

txt2dir.py XTALFILE [OPTIONAL PATH PREFIX]

           ^ eats a 'crystal' text file produced by dir2txt.py, and an
             OPTIONAL prefix path. Produces a binary-identical
             representation of the directory that went into producing the
             file; and optionally prefixes the given prefix (second arg.)


(3)

The included example, fg.xtal, represents the contents of the
FUCKGOATS genesis.



TESTING PROCESS:

Test by creating arse-mouth system:

E.g.,

$ ./txt2dir.py fg.xtal foo
Reconstituting crystal:  fg.xtal ...
Creating 13865 byte file at path:  foo/./fg.v
Creating directories of path:  foo/.
Creating 3182 byte file at path:  foo/./Makefile
Creating 654 byte file at path:  foo/./README
Creating 2094 byte file at path:  foo/./fg.ucf
Done!

$ cd foo

$ ../dir2txt.py . > ../test.xtal

$ diff fg.xtal t.xtal

[ null output ]
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.10 (GNU/Linux)

iQEcBAEBCgAGBQJavujhAAoJELmCKKABq//H85MH/jpcdPYEMkfyXuvyxSd2qO05
xsiR3Uln+JVwAm6VCtQ5I4D1DFSs8RqZU5tomQemFzheI65aVnKR4zgqb8MMTyoT
6rEJ1FlAjKlvrkWWmjoEGB1WPXkNSo+dim8TNJg1yixaq9xi5j9ngGebI1CK52qx
KfNgHqpXVxVP4GCDwnSn5uSr3WKkvqsrTxMiOe1QxavBC103HY/kvyI2hRkEu4ur
3mKbceDK5gp7P6lK6mONoPAOiy4/ov+UgALD3ov0n2sPU5hdIhLJ6OVZLuLkycWA
C4YcPkUG8R+ZEhCzZbwkMulr15bmvpQ7csVaFcN113YvKC+IluOCFg4tRntRdvM=
=b2aW
-----END PGP SIGNATURE-----