add more docs and freeze support for windows (#4)

Author: thrau

Makefile

@@ -23,7 +23,7 @@ $(VENV_ACTIVATE): requirements.txt
 # once that is remedied, we can exclude boto3 and botocore modules again
 dist/localstack/localstack: main.py
 	$(VENV_RUN); pyinstaller main.py \
-		-n localstack \
+		$(PYINSTALLER_ARGS) -n localstack \
 		--exclude-module moto \
 		--hidden-import docker
 	rm -rf dist/localstack/botocore/data

README.md

@@ -3,8 +3,32 @@ localstack-packaged-cli
 
 Repository for the build config that packages the localstack cli into a standalone binary.
 
-## Make a distribution
+## Build
 
+### python3-dev
+
+You need Python developer version libraries in your path to be able to build the distribution.
+
+For most of us who use pyenv, this is done with
+
+```bash
+pyenv install 3.8-dev
+pyenv local 3.8-dev
+python --version
 ```
+
+should print something like `Python 3.8.15+`.
+
+### make all
+
+Just run
+
+```bash
 make clean all
 ```
+
+in `dist/localstack` you should now find the binary assets.
+
+If you want a single binary you can run `PYINSTALLER_ARGS=-F make clean all`.
+This will create a single binary `dist/localstack`.
+The single binary has a slower startup time than the binary distribution.

main.py

@@ -1,4 +1,7 @@
 import os
+from multiprocessing import freeze_support
+freeze_support()
+
 os.environ["SKIP_PATCH_MOTO_ACCOUNT_ID"] = "1"
 from localstack.cli import main