As pip installs packages, pmp manages projects.

It provides a simple extensible command interface designed to influence good behavior in project management using existing tools (and minor hacks/additions).

Optional Behaviors

• vendor packages vs using an external virtualenv (vendor/) * have bin/python deal with sites (as buildout does) so only items listed in lockfile (version specific) get bound
• manage package version via publish? (project/VERSION?)
• maintain a lockfile/requirements file (similar to requirements.txt, also used by the install commands) * this could happen via a second command, or via install

CLI

pmp [command] [options]

pmp install  # pip install .
pmp install <name>  # pip install <name>
pmp install github.com/dcramer/pmp  # pip install <repo short url>

pmp develop  # pip install -e .

pmp test [options] # install test dependencies and run setup.py [test|nosetests]

# publish will register the package if its not already present on pypi
pmp publish  # python setup.py sdist upload
pmp publish disqus  # python setup.py sdist upload -r disqus

pmp register
pmp register disqus

pmp add-pypi [name] [url]  # register remote pypi, attempt to fix bad urls you enter

Concepts

# add to lockfile
pmp require [name]

# update any top-level dependencies which have a newer version within range
# requires lockfile
pmp update

# generates a new setup.py, etc. for you
pmp bootstrap

Packaging (Alternative to setuptools)

Much like Distribute, pmp will allow you to require it to install your package. This will give the benefit of being able to bind to various sources and support excess metadata that setuptools does not.

# setup.py
from .pmpstrap import setup

setup(
    # ...
)

You would include a pmpstrap.py in your distribution, which could be generated via a simple command line tool:

pmp bootstrap

This file would simply check for the existance of pmp, and if it's not present (or if it's a version which is too old for your package), it would install it. Re-running pmp bootstrap would bind your project to the latest version of pmp.

Note

pmp is designed for isolated environments (e.g. virtualenv) so that the pmp version required by your package would not affect any other packages on the system.