+ add bootstrap_env

2 files changed, 141 insertions, 0 deletions

diff --git a/bootstrap.py b/bootstrap.py
new file mode 100755
index 0000000..80d9048
--- /dev/null
+++ b/bootstrap.py
@@ -0,0 +1,123 @@
+#!/usr/bin/env python2
+from __future__ import absolute_import, print_function, unicode_literals
+
+import os
+import subprocess
+import sys
+
+
+def warning(*objs):
+    print("WARNING: ", *objs, file=sys.stderr)
+
+
+def fail(message):
+    sys.exit("Error: {message}".format(message=message))
+
+
+def has_module(module_name):
+    try:
+        import imp
+        imp.find_module(module_name)
+        del imp
+        return True
+    except ImportError:
+        return False
+
+
+def which(exe=None, throw=True):
+    """Return path of bin. Python clone of /usr/bin/which.
+
+    from salt.util - https://www.github.com/saltstack/salt - license apache
+
+    :param exe: Application to search PATHs for.
+    :type exe: string
+    :param throw: Raise ``Exception`` if not found in paths
+    :type throw: bool
+    :rtype: string
+
+    """
+    if exe:
+        if os.access(exe, os.X_OK):
+            return exe
+
+        # default path based on busybox's default
+        default_path = '/bin:/sbin:/usr/bin:/usr/sbin:/usr/local/bin'
+        search_path = os.environ.get('PATH', default_path)
+
+        for path in search_path.split(os.pathsep):
+            full_path = os.path.join(path, exe)
+            if os.access(full_path, os.X_OK):
+                return full_path
+
+        message = (
+            '{0!r} could not be found in the following search '
+            'path: {1!r}'.format(
+                exe, search_path
+            )
+        )
+
+        if throw:
+            raise Exception(message)
+        else:
+            print(message)
+    return None
+
+
+project_dir = os.path.dirname(os.path.realpath(__file__))
+env_dir = os.path.join(project_dir, '.venv')
+pip_bin = os.path.join(env_dir, 'bin', 'pip')
+python_bin = os.path.join(env_dir, 'bin', 'python')
+virtualenv_bin = which('virtualenv', throw=False)
+virtualenv_exists = os.path.exists(env_dir) and os.path.isfile(python_bin)
+sphinx_requirements_filepath = os.path.join(
+    project_dir, 'requirements.txt')
+
+
+try:
+    import virtualenv  # NOQA
+except ImportError:
+    message = (
+        'Virtualenv is required for this bootstrap to run.\n'
+        'Install virtualenv via:\n'
+        '\t$ [sudo] pip install virtualenv'
+    )
+    fail(message)
+
+
+try:
+    import pip  # NOQA
+except ImportError:
+    message = (
+        'pip is required for this bootstrap to run.\n'
+        'Find instructions on how to install at: %s' %
+        'http://pip.readthedocs.io/en/latest/installing.html'
+    )
+    fail(message)
+
+
+def main():
+    if not which('entr', throw=False):
+        message = (
+            '\nentr(1) is used in this app as a cross platform file watcher.'
+            'You can install it via your package manager on most POSIX '
+            'systems. See the site at http://entrproject.org/\n'
+        )
+        print(message)
+
+    if not virtualenv_exists:
+        virtualenv_bin = which('virtualenv', throw=False)
+
+        subprocess.check_call(
+            [virtualenv_bin, env_dir]
+        )
+
+    if not os.path.isfile(os.path.join(env_dir, 'bin', 'sphinx-quickstart')):
+        subprocess.check_call(
+            [pip_bin, 'install', '-r', sphinx_requirements_filepath]
+        )
+
+    if os.path.exists(os.path.join(env_dir, 'build')):
+        os.removedirs(os.path.join(env_dir, 'build'))
+
+if __name__ == '__main__':
+    main()
diff --git a/requirements.txt b/requirements.txt
new file mode 100644
index 0000000..47b54bf
--- /dev/null
+++ b/requirements.txt
@@ -0,0 +1,18 @@
+alabaster==0.7.10
+alagitpull==0.0.14
+Babel==2.5.1
+certifi==2017.11.5
+chardet==3.0.4
+docutils==0.14
+idna==2.6
+imagesize==0.7.1
+Jinja2==2.10
+MarkupSafe==1.0
+Pygments==2.2.0
+pytz==2017.3
+requests==2.18.4
+six==1.11.0
+snowballstemmer==1.2.1
+Sphinx==1.6.6
+sphinxcontrib-websupport==1.0.1
+urllib3==1.22