Skip to main content

The easy way to contribute to python packages

Project description

Superwrap in an extension to virtualenvwrapper that makes it easier to contribute to a python package for the first time.

Here is the current workflow for starting to contribute to a new project for people that use virtualenvwrapper:

$ mkvirtualenv requests
(requests)$ ~/Development
(requests)$ git clone
(requests)$ cd requests
(requests)$ python develop

And then start working. After setting up Superwrap, it becomes this:

$ workon requests
Setup kennethreitz:requests repo for development
(requests)$ echo "There is no step 2!"

Anytime you use workon with a repo that you don’t already have setup, it will create a new virtualenv, find and clone the repo from github into a new directory, change to that directory, and run python develop. If you use workon with a virtualenv that has been previously setup, it will work the exact same.


  • First, have virtualenvwrapper configured.
  • Configure where you want new repos to go by setting the SUPERWRAP_DIR evnrionment variable. It will default to ~/Development.
  • (Optional) Configure GITHUB_OAUTH_TOKEN if you want to create a fork of every repo to clone instead of cloning the repo itself.
  • $ pip install superwrap
  • Add the following to $WORKON_HOME/postactivate
proj_name=$(echo $VIRTUAL_ENV|awk -F'/' '{print $NF}')
cd $SUPERWRAP_DIR/$proj_name

Note that this will create issues if your current setup does not consist of virtualenvs and directories with matching names.

Project details

Download files

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

Files for superwrap, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size superwrap-0.0.4.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page