Mailman 3 May 2007 - Python-checkins

r55034 - peps/trunk/pep-0000.txt
by guido.van.rossum 01 May '07

01 May '07

Author: guido.van.rossum Date: Tue May 1 02:44:57 2007 New Revision: 55034 Modified: peps/trunk/pep-0000.txt Log: PEP 3127: Integer Literal Support and Syntax (Patrick Maupin) Modified: peps/trunk/pep-0000.txt ============================================================================== --- peps/trunk/pep-0000.txt (original) +++ peps/trunk/pep-0000.txt Tue May 1 02:44:57 2007 @@ -124,6 +124,7 @@ S 3124 Overloading, Generic Functions, Interfaces Eby S 3125 Remove Backslash Continuation Jewett S 3126 Remove Implicit String Concatenation Jewett + S 3127 Integer Literal Support and Syntax Maupin S 3141 A Type Hierarchy for Numbers Yasskin Finished PEPs (done, implemented in Subversion) @@ -490,6 +491,7 @@ S 3124 Overloading, Generic Functions, Interfaces Eby S 3125 Remove Backslash Continuation Jewett S 3126 Remove Implicit String Concatenation Jewett + S 3127 Integer Literal Support and Syntax Maupin S 3141 A Type Hierarchy for Numbers Yasskin @@ -565,6 +567,7 @@ von Loewis, Martin loewis(a)informatik.hu-berlin.de Lownds, Tony tony(a)pagedna.com Martelli, Alex aleax(a)aleax.it + Maupin, Patrick pmaupin(a)gmail.com McClelland, Andrew eternalsquire(a)comcast.net McMillan, Gordon gmcm(a)hypernet.com McNamara, Andrew andrewm(a)object-craft.com.au

1 0

r55033 - peps/trunk/pep-3124.txt
by phillip.eby 01 May '07

01 May '07

Author: phillip.eby Date: Tue May 1 02:32:18 2007 New Revision: 55033 Modified: peps/trunk/pep-3124.txt Log: Fix missing imports in examples Modified: peps/trunk/pep-3124.txt ============================================================================== --- peps/trunk/pep-3124.txt (original) +++ peps/trunk/pep-3124.txt Tue May 1 02:32:18 2007 @@ -179,6 +179,8 @@ effects, except for name binding side-effects (which will be described below):: + from overloading import when + @overload def flatten(ob: basestring): yield ob @@ -325,10 +327,11 @@ Like ``@when``, all of these decorators must be passed the function to be overloaded, and can optionally accept a predicate as well:: + from overloading import before, after + def begin_transaction(db): print "Beginning the actual transaction" - @before(begin_transaction) def check_single_access(db: SingletonDB): if db.inuse: @@ -383,6 +386,8 @@ to transform input arguments or return values, or to wrap specific cases with special error handling or try/finally conditions, e.g.:: + from overloading import around + @around(commit_transaction) def lock_while_committing(__proceed__, db: SingletonDB): with db.global_lock:

1 0

r55032 - peps/trunk/pep-0000.txt peps/trunk/pep-0365.txt
by phillip.eby 01 May '07

01 May '07

Author: phillip.eby Date: Tue May 1 02:24:48 2007 New Revision: 55032 Added: peps/trunk/pep-0365.txt (contents, props changed) Modified: peps/trunk/pep-0000.txt Log: Added pkg_resources PEP Modified: peps/trunk/pep-0000.txt ============================================================================== --- peps/trunk/pep-0000.txt (original) +++ peps/trunk/pep-0000.txt Tue May 1 02:24:48 2007 @@ -110,6 +110,7 @@ S 355 Path - Object oriented filesystem paths Lindqvist S 362 Function Signature Object Cannon, Seo S 364 Transitioning to the Py3K Standard Library Warsaw + S 365 Adding the pkg_resources module Eby S 754 IEEE 754 Floating Point Special Values Warnes S 3101 Advanced String Formatting Talin S 3108 Standard Library Reorganization Cannon @@ -455,6 +456,7 @@ S 362 Function Signature Object Cannon, Seo SR 363 Syntax For Dynamic Attribute Access North S 364 Transitioning to the Py3K Standard Library Warsaw + S 365 Adding the pkg_resources module Eby SR 666 Reject Foolish Indentation Creighton S 754 IEEE 754 Floating Point Special Values Warnes P 3000 Python 3000 GvR Added: peps/trunk/pep-0365.txt ============================================================================== --- (empty file) +++ peps/trunk/pep-0365.txt Tue May 1 02:24:48 2007 @@ -0,0 +1,127 @@ +PEP: 365 +Title: Adding the pkg_resources module +Version: $Revision$ +Last-Modified: $Date$ +Author: Phillip J. Eby <pje(a)telecommunity.com> +Status: Draft +Type: Standards Track +Content-Type: text/x-rst +Created: 30-Apr-2007 +Post-History: 30-Apr-2007 + + +Abstract +======== + +This PEP proposes adding an enhanced version of the ``pkg_resources`` +module to the standard library. + +``pkg_resources`` is a module used to find and manage Python +package/version dependencies and access bundled files and resources, +including those inside of zipped ``.egg`` files. Currently, +``pkg_resources`` is only available through installing the entire +``setuptools`` distribution, but it does not depend on any other part +of setuptools; in effect, it comprises the entire runtime support +library for Python Eggs, and is independently useful. + +In addition, with one feature addition, this module could support +easy bootstrap installation of several Python package management +tools, including ``setuptools``, ``workingenv``, and ``zc.buildout``. + + +Proposal +======== + +Rather than proposing to include ``setuptools`` in the standard +library, this PEP proposes only that ``pkg_resources`` be added to the +standard library for Python 2.6 and 3.0. ``pkg_resources`` is +considerably more stable than the rest of setuptools, with virtually +no new features being added in the last 12 months. + +However, this PEP also proposes that a new feature be added to +``pkg_resources``, before being added to the stdlib. Specifically, it +should be possible to do something like:: + + python -m pkg_resources SomePackage==1.2 + +to request downloading and installation of ``SomePackage`` from PyPI. +This feature would *not* be a replacement for ``easy_install``; +instead, it would rely on ``SomePackage`` having pure-Python ``.egg`` +files listed for download via the PyPI XML-RPC API, and the eggs would +be placed in the ``$PYTHONEGGS`` cache, where they would **not** be +importable by default. (And no scripts would be installed) However, +if the download egg contains installation bootstrap code, it will be +given a chance to run. + +These restrictions would allow the code to be extremely simple, yet +still powerful enough to support users downloading package management +tools such as ``setuptools``, ``workingenv`` and ``zc.buildout``, +simply by supplying the tool's name on the command line. + + +Rationale +========= + +Many users have requested that ``setuptools`` be included in the +standard library, to save users needing to go through the awkward +process of bootstrapping it. However, most of the bootstrapping +complexity comes from the fact that setuptools-installed code cannot +use the ``pkg_resources`` runtime module unless setuptools is already +installed. Thus, installing setuptools requires (in a sense) that +setuptools already be installed. + +Other Python package management tools, such as ``workingenv`` and +``zc.buildout``, have similar bootstrapping issues, since they both +make use of setuptools, but also want to provide users with something +approaching a "one-step install". The complexity of creating bootstrap +utilities for these and any other such tools that arise in future, is +greatly reduced if ``pkg_resources`` is already present, and is also +able to download pre-packaged eggs from PyPI. + +(It would also mean that setuptools would not need to be installed +in order to simply *use* eggs, as opposed to building them.) + +Finally, in addition to providing access to eggs built via setuptools +or other packaging tools, it should be noted that since Python 2.5, +the distutils install package metadata (aka ``PKG-INFO``) files that +can be read by ``pkg_resources`` to identify what distributions are +already on ``sys.path``. In environments where Python packages are +installed using system package tools (like RPM), the ``pkg_resources`` +module provides an API for detecting what versions of what packages +are installed, even if those packages were installed via the distutils +instead of setuptools. + + +Implementation and Documentation +================================ + +The ``pkg_resources`` implementation is maintained in the Python +SVN repository under ``/sandbox/trunk/setuptools/``; see +``pkg_resources.py`` and ``pkg_resources.txt``. Documentation for the +egg format(s) supported by ``pkg_resources`` can be found in +``doc/formats.txt``. HTML versions of these documents are available +at: + +* http://peak.telecommunity.com/DevCenter/PkgResources and + +* http://peak.telecommunity.com/DevCenter/EggFormats + +(These HTML versions are for setuptools 0.6; they may not reflect all +of the changes found in the Subversion trunk's ``.txt`` versions.) + + +Copyright +========= + +This document has been placed in the public domain. + + + +.. + Local Variables: + mode: indented-text + indent-tabs-mode: nil + sentence-end-double-space: t + fill-column: 70 + coding: utf-8 + End:

1 0

r55031 - peps/trunk/pep-3124.txt
by phillip.eby 01 May '07

01 May '07

Author: phillip.eby Date: Tue May 1 02:19:45 2007 New Revision: 55031 Modified: peps/trunk/pep-3124.txt Log: Fix typo Modified: peps/trunk/pep-3124.txt ============================================================================== --- peps/trunk/pep-3124.txt (original) +++ peps/trunk/pep-3124.txt Tue May 1 02:19:45 2007 @@ -87,7 +87,7 @@ generic functions, and new kinds of interfaces, and use them in place of the predefined features. For example, it should be possible to use a ``zope.interface`` interface object to specify the desired -type of a function argument, as long as the ``zope.interface`` +type of a function argument, as long as the ``zope.interface`` package registered itself correctly (or a third party did the registration). In this way, the proposed API simply offers a uniform way of accessing

1 0