[Python-checkins] python/nondist/sandbox/setuptools ez_setup.py, 1.26, 1.27 pkg_resources.txt, 1.13, 1.14 setup.cfg, 1.3, 1.4

[pje@users.sourceforge.net]

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

Modified Files:
	ez_setup.py pkg_resources.txt setup.cfg 
Log Message:
0.6a1 release of setuptools.


Index: ez_setup.py
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/setuptools/ez_setup.py,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -d -r1.26 -r1.27
--- ez_setup.py	3 Sep 2005 05:01:12 -0000	1.26
+++ ez_setup.py	14 Sep 2005 03:33:49 -0000	1.27
@@ -13,12 +13,16 @@
 
 This file can also be run as a script to install or upgrade setuptools.
 """
-DEFAULT_VERSION = "0.6a1c2"
+DEFAULT_VERSION = "0.6a1"
 DEFAULT_URL     = "http://www.python.org/packages/source/s/setuptools/"
 
 md5_data = {
     'setuptools-0.5a13-py2.3.egg': '85edcf0ef39bab66e130d3f38f578c86',
     'setuptools-0.5a13-py2.4.egg': 'ede4be600e3890e06d4ee5e0148e092a',
+    'setuptools-0.6a1-py2.3.egg': 'ee819a13b924d9696b0d6ca6d1c5833d',
+    'setuptools-0.6a1-py2.4.egg': '8256b5f1cd9e348ea6877b5ddd56257d',
+    'setuptools-0.6a1c1-py2.3.egg': '1eaf2ca9fb2417977d5b5042dc50e1f4',
+    'setuptools-0.6a1c1-py2.4.egg': '5baad71652b3047756ba1dcbf721b1ee',
     'setuptools-0.6a1c2-py2.3.egg': '92291ca957044306d96a7b8589c01d87',
     'setuptools-0.6a1c2-py2.4.egg': '5ae6405341eddb5baf93cd6ab178efb1',
 }

Index: pkg_resources.txt
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/setuptools/pkg_resources.txt,v
retrieving revision 1.13
retrieving revision 1.14
diff -u -d -r1.13 -r1.14
--- pkg_resources.txt	22 Aug 2005 03:40:20 -0000	1.13
+++ pkg_resources.txt	14 Sep 2005 03:33:49 -0000	1.14
@@ -18,16 +18,82 @@
 Overview
 --------
 
-This section isn't written yet.  For now, please check out the extensive `API
-Reference`_ below.
+Eggs are a distribution format for Python modules, similar in concept to Java's
+"jars" or Ruby's "gems".  They differ from previous Python distribution formats
+in that they are importable (i.e. they can be added to ``sys.path``), and they
+are *discoverable*, meaning that they carry metadata that unambiguously
+identifies their contents and dependencies, and thus can be *automatically*
+found and added to ``sys.path`` in response to simple requests of the form,
+"get me everything I need to use docutils' PDF support".
 
+The ``pkg_resources`` module provides runtime facilities for finding,
+introspecting, activating and using eggs and other "pluggable" distribution
+formats.  Because these are new concepts in Python (and not that well-
+established in other languages either), it helps to have a few special terms
+for talking about eggs and how they can be used:
 
------------------
-Developer's Guide
------------------
+project
+    A library, framework, script, plugin, application, or collection of data
+    or other resources, or some combination thereof.  Projects are assumed to
+    have "relatively unique" names, e.g. names registered with PyPI.
 
-This section isn't written yet.  Currently planned topics include::
+release
+    A snapshot of a project at a particular point in time, denoted by a version
+    identifier.  
+
+distribution
+    A file or files that represent a particular release.
+
+importable distribution
+    A file or directory that, if placed on ``sys.path``, allows Python to
+    import any modules contained within it.
+
+pluggable distribution
+    An importable distribution whose filename unambiguously identifies its
+    release (i.e. project and version), and whose contents unamabiguously
+    specify what releases of other projects will satisfy its runtime
+    requirements.
 
+extra
+    An "extra" is an optional feature of a release, that may impose additional
+    runtime requirements.  For example, if docutils PDF support required a
+    PDF support library to be present, docutils could define its PDF support as
+    an "extra", and list what other project releases need to be available in
+    order to provide it.
+
+environment
+    A collection of distributions potentially available for importing, but not
+    necessarily active.  More than one distribution (i.e. release version) for
+    a given project may be present in an environment.
+    
+working set
+    A collection of distributions actually available for importing, as on
+    ``sys.path``.  At most one distribution (release version) of a given
+    project may be present in a working set, as otherwise there would be
+    ambiguity as to what to import.
+
+eggs
+    Eggs are pluggable distributions in one of the three formats currently
+    supported by ``pkg_resources``.  There are built eggs, development eggs,
+    and egg links.  Built eggs are directories or zipfiles whose name ends
+    with ``.egg`` and follows the egg naming conventions, and contain an
+    ``EGG-INFO`` subdirectory (zipped or otherwise).  Development eggs are
+    normal directories of Python code with one or more ``ProjectName.egg-info``
+    subdirectories.  And egg links are ``*.egg-link`` files that contain the
+    name of a built or development egg, to support symbolic linking on
+    platforms that do not have native symbolic links.
+
+(For more information about these terms and concepts, see also this
+`architectural overview`_ of ``pkg_resources`` and Python Eggs in general.)
+
+.. _architectural overview: http://mail.python.org/pipermail/distutils-sig/2005-June/004652.html
+
+
+.. -----------------
+.. Developer's Guide
+.. -----------------
+
+.. This section isn't written yet.  Currently planned topics include
     Accessing Resources
     Finding and Activating Package Distributions
         get_provider()
@@ -43,8 +109,7 @@
         Metadata access
         Extended Discovery and Installation
     Supporting Custom PEP 302 Implementations
-
-For now, please check out the extensive `API Reference`_ below.
+.. For now, please check out the extensive `API Reference`_ below.
 
 
 -------------

Index: setup.cfg
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/setuptools/setup.cfg,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- setup.cfg	3 Sep 2005 05:01:12 -0000	1.3
+++ setup.cfg	14 Sep 2005 03:33:49 -0000	1.4
@@ -1,6 +1,3 @@
-[egg_info]
-tag-build=c2
-
 [aliases]
 binary = bdist_egg upload --show-response
 develop = develop