[Python-checkins] r70699 - peps/trunk/pep-0381.txt

[tarek.ziade]

Author: tarek.ziade
Date: Sun Mar 29 23:37:27 2009
New Revision: 70699

Log:
start to rewrite mirrorring specs (using DNS approach)

Modified:
   peps/trunk/pep-0381.txt

Modified: peps/trunk/pep-0381.txt
==============================================================================
--- peps/trunk/pep-0381.txt	(original)
+++ peps/trunk/pep-0381.txt	Sun Mar 29 23:37:27 2009
@@ -19,8 +19,8 @@
 Rationale
 =========
 
-PyPI is hosting over 4000 projects and is used on a daily basis by
-people to build applications.  Especially systems like `easy_install`
+PyPI is hosting over 6000 projects and is used on a daily basis 
+by people to build applications. Especially systems like `easy_install`
 and `zc.buildout` make intensive usage of PyPI.
 
 For people making intensive use of PyPI, it can act as a single point
@@ -41,48 +41,26 @@
 Mirror listing and registering
 ==============================
 
-A new text page will be added at http://pypi.python.org/mirrors that
-can be browsed like the simple index. This page gives a list of the
-mirrors through a list of links.
-
-These links are the URL of the simple index of each mirror.  The page
-will look like this::
-
-    # PyPI mirrors
-    #    
-    # If you want to register a new mirror, send an email
-    # to the catalog-SIG at python.org with:
-    #
-    # - The urls of your mirror:
-    #   - the root of the server
-    #   - the index page 
-    #   - the last modified page
-    #   - the local stats page
-    #   - the global stats page
-    #   - the mirrors page
-    #
-    # - The name and email of the maintainer.
-    #   
-    #   The registering is done manually and to become a
-    #   mirror, you need to strictly follow the mirror protocol
-    #   described here:
-    #
-    #    http://wiki.python.org/PEP_374
-    #    
-    # root,index,last-modified,local-stats,stats,mirrors
-    http://example.com/pypi,index,last-modified,local-stats,stats,mirrors
-    http://example2.com/pypi,index,last-modified,local-stats,stats,mirrors
-
-When a mirror is proposed on the mailing list, it is manually added in
-the mirror list in the PyPI application after it has been checked to
-be compliant with the mirroring rules.
-
-The mirror list page is a simple text page that can be browsed by any
-tool that wants to get a list of registered mirrors.  Other package
-indexes that are not mirrors of PyPI are not added in the mirror list
-in PyPI, although they can provide themselve the same mirroring list
-mechanism for their own mirrors.
+People that wants to mirror PyPI make a proposal on catalog-SIG.
+When a mirror is proposed on the mailing list, it is manually
+added in a mirror list in the PyPI application after it
+has been checked to be compliant with the mirroring rules.
 
+A mirror has to be a hostname. For example:
+
+- http://pypi.my-company.com
+- http://mirror-pypi.somewhere.org
+
+The mirror list is handled by a DNS entry for this hostname:
+
+    mirrors.pypi.python.org
+
+When a mirror is added into the DNS, it becomes an official
+IP for `mirrors.pypi.python.org`.
+
+The new mirror also appears at `http://pypi.python.org/mirrors`
+which is a human-readable page that gives the list of mirrors.
+This page also explains how to register a new mirror.
 
 Special pages a mirror needs to provide
 =======================================