michaeta / pip2 Goto Github PK

The goal of this project is to create a new version of pip built on distutils2/packaging instead of setuptools/distribute. Pip2 is currently being developed as part of a senior capstone project at Oregon State University.

Rather than starting as a fork of the pip codebase, pip2 was written from scratch to avoid the unmaintainable mess that would likely result from trying to add distutils2/packaging support to pip while maintaining backwards compatibility. Our goal is to create a solid, well-tested foundation with very basic functionality that can be handed off to the pip maintainers for further development. Pip2 currently provides minimal install, uninstall, search and freeze commands that use distutils2/packaging under the hood.

See the pip2 contribution instructions for details on setting up a development environment and installing pip2. Note that only Python 3.2 and 3.3 (currently in alpha) are supported at this time.

The following commands are currently supported. Since distutils2/packaging aims to maintain backwards compability, these commands should work on projects that are packaged with distutils2/packaging as well as with other libraries such as distutils, setuptools, and distribute.

Install one or more projects.

Usage: pip2 install <project>...

Projects can be installed from the Python Packaging Index (PyPI):

$ pip2 install TowelStuff sample-distutils2-project
[...]
Successfully installed TowelStuff sample-distutils2-project.

Projects can also be installed from local archives (.zip, .tar.gz, .tar.bz2, .tgz, or .tar) or directories:

$ pip2 install sample-distutils2-project.tar.gz
Successfully installed sample-distutils2-project.tar.gz

$ pip2 install /path/to/TowelStuff
Successfully installed /path/to/TowelStuff.

Display a list of installed projects with their version.

Usage: pip2 freeze

Example:

$ pip2 freeze
TowelStuff==0.1.1
sample-distutils2-project==1.1.0

Search the Python Package Index (PyPI).

Usage: pip2 search <query>

Example:

$ pip2 search pyglet
snowui                     - snowui is a fast and simple GUI using
                             pyglet and rabbyt.
svgbatch                   - Loads SVG files into pyglet Batch objects
                             for OpenGL rendering.
kytten                     - GUI Framework for Pyglet
Fungus                     - A simple scene based game engine building
                             on pyglet.
simplui                    - Light-weight GUI toolkit for pyglet
pyglet                     - Cross-platform windowing and multimedia
                             library
pygarrayimage              - Allow numpy arrays as source of texture
                             data for pyglet.
gloopy                     - Gloopy is a Python library for creating 3D
                             polyhedra and rendering them using OpenGL.
                             It uses Pyglet to open a window and manage
                             events, and PyOpenGL for OpenGL bindings.

Uninstall one or more projects.

Usage: pip2 uninstall <project>...

Example:

$ pip2 uninstall sample-distutils2-project
Successfully uninstalled sample-distutils2-project.