Pipenv: the sacred marraige of Pipfile, Pip, & Virtualenv 
=========================================================

Pipenv is an experimental project that aims to bring the best of all packaging worlds to the Python world. It harnesses `pipfile <https://github.com/pypa/pipfile>`_, pip, and virtualenv into one single toolchain.

Features
--------

- automatically updates pip
- automatically adds things to pipfile when you install them
- automatically creates a pipfile
- automatically creates a virtualenv

Usage
-----

::

    $ pipenv
    Usage: pipenv.py [OPTIONS] COMMAND [ARGS]...

    Options:
      --version  Show the version and exit.
      --help     Show this message and exit.

    Commands:
      freeze
      install
      init
      py
      purge
      uninstall
      venv
      where
      
    $ pipenv where
    Pipfile found at /Users/kennethreitz/repos/project/Pipfile. Considering this to be the project home.

    $ pipenv where --venv
    Virtualenv location: /Users/kennethreitz/repos/project/.venv
    
    $ pipenv venv --bare
    source /Users/kennethreitz/repos/project/.venv/bin/activate

    $ pipenv init
    Creating a Pipfile for this project...
    Assuring all dependencies from Pipfile are installed...
    Freezing development dependencies...
    Freezing default dependencies.....
    Pipfile found at /Users/kennethreitz/repos/project/Pipfile. Considering this to be the project home.
    Creating a virtualenv for this project...
    ...
    Virtualenv location: /Users/kennethreitz/repos/project/.venv
    Pipfile.freeze not found, creating...
    ...
    
    To activate this project's virtualenv, run the following:
    $ source /Users/kennethreitz/repos/project/.venv/bin/activate


    $ python pipenv.py install requests --dev
    Installing requests...
    ...
    Adding requests to Pipfile...
    # Generating Pipfile.lock


    $ pipenv freeze
    Generating requirements.txt from Pipfile.lock