Skip to main content

virtualenv with less hassle

Project description

autovenv: virtualenv with less hassle
=====================================

*I don't want to be a product of my environment, I want my environment to be a product of me.*

-- Frank Costello in **The Departed**

Virtual environments are great, but they can be a bit annoying to create, manage, and switch between. autovenv takes the annoyance away.

*(Author's note: I created autovenv for my own use and am now chucking the code up on github and pypi very much as alpha software. It would be cool if you'd try it out. Issues/pull requests/etc would be even cooler).*

Documentation
-------------

Full documentation is at `https://autovenv.readthedocs.org <https://autovenv.readthedocs.org>`_ (currently a work in progress!).


How It Works
------------

Basically, as long as there's a requirements.txt file in your python project, autovenv will figure out that the folder you're in is a python project, create a virtualenv for that project automatically, and activate/deactivate that virtualenv when you cd in/out of the project folder.

Here's how it works:

Just cd to anywhere within a python project, and autovenv will create a virtual environment for you if you don't have one already:

.. code-block:: shell
:emphasize-lines: 1,6

alex@xyz:~$ cd pyprojects/skynet
AUTOVENV: creating virtual environment: skynet
New python executable in /home/alex/.virtualenvs/skynet/bin/python
Installing setuptools, pip, wheel...done.
Requirement already up-to-date: pip in ...
(skynet)alex@xyz:~/pyprojects/skynet$

(as you can see, it also checks that the pip within the virtualenv is up to date)

cd to a different project, it'll switch virtual environments automatically. cd out of a project and it'll deactivate the virtual environment.

autovenv tries to keep things tidy by storing the virtualenvs it creates under ~/.virtualenvs

Installation
------------

Simply install with `pip <https://pip.pypa.io>`_::

$ pip install autovenv

and then add the following line to the end of your .bashrc file::

source `which autovenv.sh`

That's it.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autovenv-0.1.0.tar.gz (3.9 kB view hashes)

Uploaded Source

Built Distribution

autovenv-0.1.0-py2-none-any.whl (6.2 kB view hashes)

Uploaded Python 2

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page