a script for managing vendor libraries
Python
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.rst
argparse.py
setup.py
vend

README.rst

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