From fa9a04b06a7c6f62979c506b9999abf6b2eb8208 Mon Sep 17 00:00:00 2001 From: Rob Austein Date: Sun, 10 Mar 2019 13:46:08 -0400 Subject: First public version. --- README.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..d248b1d --- /dev/null +++ b/README.md @@ -0,0 +1,27 @@ +pyzipper +======== + +A small tool to package up a Python program and associated data files +as a single executable zip file. + +All the facilities for this are already built into Python, this script +just ties it all together with a bow. + +`demo1` and `demo2` are two trivial sample packages. + +Tested with both Python 2 and Python 3, should work with either. + +How it works +------------ + +This relies on two somewhat obscure Python features: + +* The `zipfile.PyZipFile` class's ability to construct an executable + ZIP file and populate it with Python modules, packages, and data; + and + +* Python's ability to treat a zip file as equivalent to a directory + tree on `import`. + +`demo1` takes advantage of a third obscure feature: the `pkgutil` +library's ability to load data files via the `import` system. -- cgit v1.2.3