Metadata-Version: 1.1
Name: bootstrap-env
Version: 0.3.3
Summary: Create a complete self contained virtualenv bootstrap file by enbed 'get-pip.py'
Home-page: https://github.com/jedie/bootstrap_env
Author: Jens Diemer
Author-email: bootstrap_env@jensdiemer.de
License: GPL v3+
Description: -------------
        bootstrap_env
        -------------
        
        Experimental project to create a complete self contained virtualenv bootstrap file.
        See: `packaging-problems issues 55 <https://github.com/pypa/packaging-problems/issues/55>`_
        
        info
        ====
        
        Since ``virtualenv`` v1.10 you a virtualenv bootstrap file is not runnable without the pip and setuptools wheel files.
        There must be created a ``virtualenv_support`` with the wheels.
        
        e.g.:
        
        ::
        
            /bootstrap.py
            /virtualenv_support/
                    pip-1.5.6-py2.py3-none-any.whl
                    setuptools-3.6-py2.py3-none-any.whl
        
        With this project this is not needed. The current solution embed ``get_pip.py`` into the bootstrap file
        and call it after env creation.
        
        There are also some helpers to parse pip requirement files and install packages after virtualenv creation. Look into "boot bootstrap_env" project below.
        
        the example
        ===========
        
        The included ``example`` will create a ``boot_example.py`` bootstrap file. Running this looks like:
        
        ::
        
            ~ $ python2 boot_example.py ~/testenv
            The additional example extend_parser() code is called.
            The additional example adjust_options() code is called.
            New python executable in /home/jens/testenv/bin/python2
            Also creating executable in /home/jens/testenv/bin/python
            call to install pip with: '/home/jens/testenv/bin/python /path/to/bootstrap_env/boot_example.py --install-pip /home/jens/testenv'
            install pip from self contained 'get_pip.py'
            Downloading/unpacking pip
              Downloading pip-1.5.6-py2.py3-none-any.whl (1.0MB): 1.0MB downloaded
            Downloading/unpacking setuptools
              Downloading setuptools-6.0.2-py2.py3-none-any.whl (543kB): 543kB downloaded
            Installing collected packages: pip, setuptools
            Successfully installed pip setuptools
            Cleaning up...
            The additional example after_install() code is called.
        
        The ``example`` hook code stored separated files in `example <https://github.com/jedie/bootstrap_env/blob/master/example/>`_ directory looks like this:
        
        ::
        
            def extend_parser(parser):
                # --- CUT here ---
                sys.stdout.write("The additional example extend_parser() code is called.\n")
        
        ::
        
            def adjust_options(options, args):
                # --- CUT here ---
                sys.stdout.write("The additional example adjust_options() code is called.\n")
        
        ::
        
            def after_install(options, home_dir):
                # --- CUT here ---
                sys.stdout.write("The additional example after_install() code is called.\n")
        
        Creating the example bootstrap file looks like this:
        
        ::
        
            /path/to/bootstrap_env/ $ python2 example.py
            Generate bootstrap file: 'boot_example.py'...
            Reade code from: 'example/extend_parser.py'...
            Reade code from: 'example/adjust_options.py'...
            Reade code from: 'example/after_install.py'...
            Reade code from: '/path/to/bootstrap_env/bootstrap_env/bootstrap_install_pip.py'...
            Request: 'https://raw.githubusercontent.com/pypa/pip/master/contrib/get-pip.py'...
            get-pip.py SHA256: 'd43dc33a5670d69dd14a9be1f2b2fa27ebf124ec1b212a47425331040f742a9b', ok.
            'boot_example.py' written.
        
        After the first call, the requested ``get-pip.py`` file will be cached into the default temp
        and reused from there. So it is fast to generate it again:
        
        ::
        
            /path/to/bootstrap_env/ $ python2 example.py
            Generate bootstrap file: 'boot_example.py'...
            Reade code from: 'example/extend_parser.py'...
            Reade code from: 'example/adjust_options.py'...
            Reade code from: 'example/after_install.py'...
            Reade code from: '/path/to/bootstrap_env/bootstrap_env/bootstrap_install_pip.py'...
            Use '/tmp/get-pip.py'
            get-pip.py SHA256: 'd43dc33a5670d69dd14a9be1f2b2fa27ebf124ec1b212a47425331040f742a9b', ok.
            'boot_example.py' written.
        
        usage
        =====
        
        To create you own bootstrap file, is easy. Just copy the ``example`` or ``boot bootstrap_env`` code and change it for your needs.
        
        Projects that use bootstrap_env are:
        
        * `PyLucid django-cms branch <https://github.com/jedie/PyLucid/tree/django-cms/bootstrap>`_
        
        * `DwLoadServer <https://github.com/DWLOAD/DwLoadServer/tree/master/bootstrap>`_
        
        Missing project? Do you use it? Just send me a mail: ``bootstrap_env AT jensdiemer DOT de`` or use IRC/Jabber (see below)
        
        boot bootstrap_env
        ==================
        
        To create a fresh virtualenv with ``bootstrap_env`` do the following:
        
        ::
        
            # Download 'boot_bootstrap_env.py' from github:
            /home/FooBar$ wget https://raw.githubusercontent.com/jedie/bootstrap_env/master/boot_bootstrap_env.py
            
            # Create virtualenv and use read-only GIT:
            /home/FooBar$ python3 boot_bootstrap_env.py ~/bootstrap_env --install_type git_readonly
        
        The created virtualenv is under ``~/bootstrap_env/`` ;)
        
        If you would like to use PyPi packages do this:
        
        ::
        
            # Create virtualenv and use read-only GIT:
            /home/FooBar$ python3 boot_bootstrap_env.py ~/bootstrap_env --install_type pypi
        
        The sourcecode of this is here: `/boot_bootstrap_env/ <https://github.com/jedie/bootstrap_env/tree/master/boot_bootstrap_env>`_
        
        This also work under Windows.
        e.g:
        
        ::
        
            C:\> C:\Python34\python.exe d:\downloads\boot_bootstrap_env.py --install_type=pypi d:\bootstrap_env
        
        There is also a maybe helpful batch file: `boot_bootstrap_env.cmd <https://github.com/jedie/bootstrap_env/tree/master/boot_bootstrap_env.cmd>`_
        
        -------
        History
        -------
        
        * v0.3.3 - 14.11.2014 - Add version number into generated bootstrap file.
        
        * v0.3.2 - 14.11.2014 - Add 'boot bootstrap_env' and bugfixes for running under Windows.
        
        * v0.3.1 - 14.11.2014 - Bugfix for "error: no such option:" while pip install, if own optional options are used.
        
        * v0.3.0 - 13.11.2014 - typo: rename all ``bootstrip`` to ``bootstrap`` ;)
        
        * v0.2.0 - 09.10.2014 - add ``prefix`` and ``suffix`` argument to ``generate_bootstrap()``
        
        * v0.1.0 - 09.10.2014 - initial release
        
        ------
        Links:
        ------
        
        +--------+------------------------------------------------+
        | Forum  | `http://forum.pylucid.org/`_                   |
        +--------+------------------------------------------------+
        | IRC    | `#pylucid on freenode.net`_                    |
        +--------+------------------------------------------------+
        | Jabber | pylucid@conference.jabber.org                  |
        +--------+------------------------------------------------+
        | PyPi   | `https://pypi.python.org/pypi/bootstrap_env/`_ |
        +--------+------------------------------------------------+
        | Github | `https://github.com/jedie/bootstrap_env`_      |
        +--------+------------------------------------------------+
        
        .. _http://forum.pylucid.org/: http://forum.pylucid.org/
        .. _#pylucid on freenode.net: http://www.pylucid.org/permalink/304/irc-channel
        .. _https://pypi.python.org/pypi/bootstrap_env/: https://pypi.python.org/pypi/bootstrap_env/
        .. _https://github.com/jedie/bootstrap_env: https://github.com/jedie/bootstrap_env
        
        Simmilar projects are:
        
        * `https://pypi.python.org/pypi/bootstrapper/ <https://pypi.python.org/pypi/bootstrapper/>`_
        
        Related pages:
        
        * `https://packaging.python.org <https://packaging.python.org>`_
        
        * `https://virtualenv.pypa.io <https://virtualenv.pypa.io>`_
        
        * `https://pip.pypa.io <https://pip.pypa.io>`_
        
        --------
        donation
        --------
        
        * Send `Bitcoins <http://www.bitcoin.org/>`_ to `1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F <https://blockexplorer.com/address/1823RZ5Md1Q2X5aSXRC5LRPcYdveCiVX6F>`_
Keywords: virtualenv pip
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: System :: Emulators
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Provides: bootstrap_env
