pypissh / README

PyPI SSH Access
---------------

For a long time, PyPI access required HTTP basic authentication with username and password.
Even though OpenID is supported as well today, this cannot work for use in the distutils
register and upload commands. In addition to these two methods, PyPI also supports
authentication with an SSH key.

To use this feature, upload your SSH key into the PyPI's 
`Your Details <http://pypi.python.org/pypi?%3Aaction=user_form>`_ form. As distutils
currently doesn't support using such a connection, this package performs heavy
monkey-patching of distutils to make it use the system's ssh command. Users using
this package should run ssh-agent (which runs automatically in the background on
many systems) and load their PyPI key into the ssh agent.

This release requires an "ssh" binary in the path.
It has been tested on Mac OS X and Linux, with Python 2.5, 2.6, and 2.7.

The source code and bug tracker for this package is available on 
`Bitbucket <https://bitbucket.org/loewis/pypissh>`_.

Changes
-------

1.3 (2011-04-13):
  - fix file list

1.2 (2011-04-10):
  - support Python 2.5 and 2.6
  - various bug fixes
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.