[Python-checkins] python/nondist/sandbox/setuptools EasyInstall.txt, 1.66, 1.67

[pje@users.sourceforge.net]

Update of /cvsroot/python/python/nondist/sandbox/setuptools
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv17238

Modified Files:
	EasyInstall.txt 
Log Message:
Added "--allow-hosts" option to restrict downloading and spidering to
a specified list of server glob patterns.


Index: EasyInstall.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/setuptools/EasyInstall.txt,v
retrieving revision 1.66
retrieving revision 1.67
diff -u -d -r1.66 -r1.67
--- EasyInstall.txt	18 Oct 2005 04:08:44 -0000	1.66
+++ EasyInstall.txt	19 Oct 2005 03:00:30 -0000	1.67
@@ -692,6 +692,26 @@
     tools that wrap eggs in a platform-specific packaging system.  (We don't
     recommend that you use it for anything else.)
 
+``--allow-hosts=PATTERNS, -H PATTERNS``   (New in 0.6a6)
+    Restrict downloading and spidering to hosts matching the specified glob
+    patterns.  E.g. ``-H *.python.org`` restricts web access so that only
+    packages listed and downloadable from machines in the ``python.org``
+    domain.  The glob patterns must match the *entire* user/host/port section of
+    the target URL(s).  For example, ``*.python.org`` will NOT accept a URL
+    like ``http://python.org/foo`` or ``http://www.python.org:8080/``.
+    Multiple patterns can be specified by separting them with commas.  The
+    default pattern is ``*``, which matches anything.
+
+    In general, this option is mainly useful for blocking EasyInstall's web
+    access altogether (e.g. ``-Hlocalhost``), or to restrict it to an intranet
+    or other trusted site.  EasyInstall will do the best it can to satisfy
+    dependencies given your host restrictions, but of course can fail if it
+    can't find suitable packages.  EasyInstall displays all blocked URLs, so
+    that you can adjust your ``--allow-hosts`` setting if it is more strict
+    than you intended.  Some sites may wish to define a restrictive default
+    setting for this option in their `configuration files`_, and then manually
+    override the setting on the command line as needed.
+
 
 Non-Root Installation
 ---------------------
@@ -850,7 +870,7 @@
    that makes the PYTHONPATH-based approach work with .pth files, so that you
    can get the full EasyInstall feature set on such installations.
 
- * Added ``--no-deps`` option.
+ * Added ``--no-deps`` and ``--allow-hosts`` options.
 
  * Improved Windows ``.exe`` script wrappers so that the script can have the
    same name as a module without confusing Python.