Vendor libraries are a chore to maintain, so let's make the computer do it!

Installation

You'll have to install from github while I'm still figuring this out::

pip install -e git://github.com/jbalogh/vending-machine.git#egg=vend

Usage

Help::

vend -h

All commands need to be prefixed by the path to the vendor directory. Right now you use the -d argument, but I might change that::

vend -d path/to/vendor

Then there are some commands for working with your vendor directory. Most commands take a package as an argument. The package can be the name of something on pypi or a url with a git: prefix.

Sync

If you're starting a new vendor library, you can use an existing requirements.txt to seed the vendor lib::

vend -d vendor sync -r requirements.txt

Eventually this command will work with an existing vendor lib as well, to sync new updates to requirements.txt.

Freeze

To generate a requirements.txt file from your vendor library::

vend -d vendor freeze > requirements.txt

Your vendor packages must have the egg-info directories created by setuptools embedded inside for freeze to work properly.

Add

Adding a new package::

vend -d vendor add celery

Adding a new submodule::

vend -d vendor add git://github.com/jbalogh/check#egg=check

Update

Updating a package::

vend -d vendor update celery 2.1.6

Updating a submodule::

vend -d vendor update check 03b26bc3f1
vend -d vendor update check origin/master

Update doesn't use git:// urls since it's clever enough to look for the name of the package in vendor/src. Maybe that's too clever.

Uninstall

Uninstalling a package::

vend -d vendor uninstall celery

Uninstalling a submodule::

vend -d vendor uninstall check

Issues

• add should take a version (you could use update for that effect)
• add should be called install to match pip and oppose uninstall