The "packaging.install" module doesn't have a clear API defined and it's doing a lot of indirections between all the functions to get metadata, fetch the dependencies and install what's need to be installed.

We might be able to come with a better solution for the API we expose there, and to allow easier maintenance. I'll go ahead this week and propose a change to this module which hopefully will make things clearer.

To summarize the high-level API needed: install from an index (argument is a version requirement as string), install archive file, install from directory (containing setup.cfg or setup.py).

When #8668 is implemented, an “editable” option will be nice too.  (Need to check pip doc and use cases to see if only the install from directory should get it.)

For the implementation, as discussed on IRC we want to go with classes to represent the various kinds of installable things (requirement, path to a file, path to a dir) and one or more high-level functions to wrap them for common cases (see Nick’s good article http://www.boredomandlaziness.org/2012/05/djangos-cbvs-are-not-mistake-but.html ).  I would prefer having two functions, one that takes a version req and another one that takes a path; it’s easy to distinguish between file (archive) and directory but I don’t like guessing between name and path (see the not-cool code in pysetup actions).

BTW I suggest you work off a d2 checkout; I have not ported all changes from Montreal sprints to cpython/p7g at the moment.

Attaching a work in progress file which intend to replace the current install.py file. The implementation isn't finished yet but the overall design is here.

It comes with four classes:

- Installer which manages the overall installation procedure. It shares a distribution cache with the dependency handler so distributions are not downloaded / extracted multiple times. The installer is able to install / remove single distributions OR distributions with their dependency tree.
- DependencyHandler which takes care about getting the dependencies from either the metadata stored in the indexes or inside the distirbutions.
- The DistributionCache class is just a store containing the location of the distributions that had been extracted/downloaded. It provides methods to ease the work with them (so any external user don't need to care about the state of the distribution when requesting it).
- DirectoryMover provides a way to deal with moving/deleting operations with a commit/rollback API. The goal is to simplify a lot the current API and to provide a reusable tool for other installers. why not putting this in shutil at some point.

This file is provided here mostly for feedback, but the work is not finished yet.