pep381client 1.5

Mirroring tool that implements the client (mirror) side of PEP 381
pep381client is an application that implements a PyPI mirror application according to PEP 381.


It is possible to run this application directly from the source distribution. Alternatively, 'python 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 >
 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}

last updated on:
May 10th, 2011, 10:26 GMT
license type:
Academic Free License (AFL) 
developed by:
Martin v. Lowis
ROOT \ Internet \ HTTP (WWW)
Download Button

In a hurry? Add it to your Download Basket!

user rating



Rate it!
What's New in This Release:
  • Fix mirroring bug that caused unnecessary deletion of files
  • Provide pep381checkfiles script to verify presence and integrity of all files
read full changelog

Add your review!