+# Run Python source code with no dependencies directly from checkout.
+# This stuff is placed into public domain by
+# anatoly techtonik <firstname.lastname@example.org>
+# Typical problem with running applications from source is that its
+# path is not included in the list of directories where Python looks
+# for imports. Usually the main script of an application is located
+# inside the source tree and does something like this:
+# If you run this script from source, and `SCons` package is not
+# installed or not immediately present in the script's directory,
+# ImportError: No module named SCons.SCript
+# The solution here is to explicitly add local path with `SCons`
+# package to the sys.path variable.
+# --- 01. bootstrap - add local package path to sys.path ---
+# we assume that this script is located at the root of source code
+# tree, and we save its absolute path in the ROOT variable
+ROOT = os.path.abspath(os.path.dirname(__file__))
+# here we assume that imported packages are located in src/engine/
+sys.path.insert(0, ROOT + '/src/engine')
+# --- 02. launch application code ---
-Public domain snippets to help with executing projects directly
-from the source code checkout without installing, i.e. locally.
+Public domain snippets to help with executing projects
+directly from a source code checkout. Locally, i.e.
+What is `locally` exactly and why would you need it
+There is a set of conventions, examples and helpers to
+run your Python applications without installing. This
+is useful for development, because it:
+ * lowers the barrier for contribution
+ * reduces time loss between checkout and run
+It is also useful for troubleshooting, because user
+will be able to try latest code versions without
+building and packaging things themselves.
+Study by example starting from 01.xxx.py script to
+see what will work for you. Then copy/paste example
+into your bootstrap.py and modify for your app.