pep381client / README

This application implements a PyPI mirror application
according to PEP 381.

Installation
------------

It is possible to run this application directly from the source
distribution. Alternatively, 'python setup.py install' could be used.

The actual mirroring is performed by the pep381run script, which
should be invoked through cron like this::

   */15 *  *   *   *     /path/pep381client/pep381run -q /var/pypi

The command line arguments points to root of the data files that
the mirror creates. An initial run (without the -q option) should
be performed manually. It is possible to interrupt the mirroring;
it will automatically know where to continue when restarted.

In above example, /var/pypi/web must be served through the webserver.
An Apache configuration could read like this::

  <VirtualHost IPADDRESS:80>
    ServerName X.pypi.python.org
    CustomLog /var/log/apache2/pypi.log combined
    DocumentRoot /var/pypi/web
  </VirtualHost>

To propagate the download statistics back to the central server,
processlogs must be run regularly, e.g. through::

   10 7  *   *   *     /path/pep381client/processlogs /var/pypi /var/log/apache2/pypi.log{,.1}

Contact
-------

If you have questions or comments, please submit a bug report to
http://bitbucket.org/loewis/pep381client/issues/new, or contact me
at martin@v.loewis.de

Changes
-------

1.1 (2010-07-05):

- Issue #1: properly setup sqlite connection when initializing mirror.

1.0 (2010-07-05):

- Initial release
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.