iSharkFly-Open
/
python-peps
mirror of https://github.com/python/peps.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Reference cleanup and reformatting of modules to be removed.

This commit is contained in:
Brett Cannon 2006-07-07 03:33:39 +00:00
parent 09618837a9
commit 8f320ce8ac
1 changed files with 55 additions and 58 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

113
pep-3100.txt
View File

@ -63,7 +63,7 @@ Style changes
Core language
=============
* True division becomes default behavior [10]_
* True division becomes default behavior [#pep238]_
* ``exec`` as a statement is not worth it -- make it a function
* Add optional declarations for static typing [11]_
* Support only new-style classes; classic classes will be gone [1]_
@ -84,7 +84,7 @@ Core language
* floats will not be acceptable as arguments in place of ints for operations
where floats are inadvertantly accepted (PyArg_ParseTuple() i & l formats)
* Imports will be absolute by default.
Relative imports must be explicitly specified [19]_
Relative imports must be explicitly specified [#pep328]_
* __init__.py will be optional in sub-packages. __init__.py will still
be required for top-level packages.
* Cleanup the Py_InitModule() variants {,3,4} (also import and parser APIs)
@ -148,7 +148,7 @@ To be removed:
* ``basestring.find()`` and ``basestring.rfind()``; use ``basestring.index()``
or ``basestring.rindex()`` in a try/except block [15]_
* ``file.xreadlines()`` method [17]_
* ``file.xreadlines()`` method [#file-object]_
* ``dict.setdefault()`` [22]_
* ``dict.has_key()`` method
@ -163,7 +163,7 @@ Built-in Namespace
* Introduce ``trunc()``, which would call the ``__trunc__()`` method on its
argument; suggested use is for objects like float where calling ``__int__()``
has data loss, but an integral representation is still desired [8]_
* Exception hierarchy changes [20]_
* Exception hierarchy changes [#pep352]_
To be removed:
@ -191,29 +191,26 @@ Standard library
To be removed:
* Deprecated modules, methods, parameters, attributes, etc. [1]_ [17]_ [18]_
There may be other modules, the most common are listed below.
stdlib modules to be removed (see docstrings and comments in the source):
* ``macfs``, ``new``, ``reconvert``, ``stringold``, ``xmllib``
* ``pcre``, ``pypcre``, ``strop``
stdlib modules to be removed (see PEP 4): [18]_
* ``posixfile``, ``pre``, ``regsub``, ``rfc822``,
* ``statcache``, ``string``, ``TERMIOS``
* ``mimetools``, ``MimeWriter``, ``mimify``,
* ``mpz``, ``rgbimage``
* Everything in lib-old: [18]_
* Para.py, addpack.py, cmp.py, cmpcache.py, codehack.py,
* dircmp.py, dump.py, find.py, fmt.py, grep.py, lockfile.py,
* newdir.py, ni.py, packmail.py, poly.py, rand.py, statcache.py,
* tb.py, tzparse.py, util.py, whatsound.py, whrandom.py, zmod.py
* ``sys.exitfunc``: use atexit module instead [17]_
* stdlib modules to be removed
+ see docstrings and comments in the source
- ``macfs``, ``new``, ``reconvert``, ``stringold``, ``xmllib``,
``pcre``, ``pypcre``, ``strop``
+ see PEP 4 [18]_
- ``posixfile``, ``pre``, ``regsub``, ``rfc822``,
``statcache``, ``string``, ``TERMIOS`` ``mimetools``,
``MimeWriter``, ``mimify``, ``mpz``, ``rgbimage``
+ Everything in lib-old [18]_
- ``Para``, ``addpack``, ``cmp``, ``cmpcache``, ``codehack``,
``dircmp``, ``dump``, ``find``, ``fmt``, ``grep``,
``lockfile``, ``newdir``, ``ni``, ``packmail``, ``poly``,
``rand``, ``statcache``, ``tb``, ``tzparse``, ``util``,
``whatsound``, ``whrandom``, ``zmod``
* ``sys.exitfunc``: use atexit module instead [#sys-module]_
* ``sys.exc_type``, ``sys.exc_values``, ``sys.exc_traceback``:
not thread-safe; use ``sys.exc_info()`` or an attribute
of the exception [2]_ [13]_ [17]_
* ``array.read``, ``array.write`` [17]_
* ``operator.isCallable``, ``operator.sequenceIncludes`` [17]_
of the exception [2]_ [13]_ [#sys-module]_
* ``array.read``, ``array.write`` [#array-module]_
* ``operator.isCallable``, ``operator.sequenceIncludes`` [#operator-module]_
* In the thread module, the aquire_lock() and release_lock() aliases
for the acquire() and release() methods on lock objects.
(Probably also just remove the thread module as a public API,
@ -239,6 +236,12 @@ References
.. [2] Python Regrets:
http://www.python.org/doc/essays/ppt/regrets/PythonRegrets.pdf
.. [9] Guido's blog ("The fate of reduce() in Python 3000")
http://www.artima.com/weblogs/viewpost.jsp?thread=98196
.. [11] Guido's blog ("Python Optional Typechecking Redux")
http://www.artima.com/weblogs/viewpost.jsp?thread=89161
.. [3] Python Wiki:
http://www.python.org/moin/Python3.0
@ -258,18 +261,6 @@ References
objects can be used")
http://mail.python.org/pipermail/python-dev/2005-February/051674.html
.. [9] Guido's blog ("The fate of reduce() in Python 3000")
http://www.artima.com/weblogs/viewpost.jsp?thread=98196
.. [10] PEP 238 ("Changing the Division Operator")
http://www.python.org/dev/peps/pep-0238
.. [11] Guido's blog ("Python Optional Typechecking Redux")
http://www.artima.com/weblogs/viewpost.jsp?thread=89161
.. [12] PEP 289 ("Generator Expressions")
http://www.python.org/dev/peps/pep-0289
.. [13] python-dev email ("anonymous blocks")
http://mail.python.org/pipermail/python-dev/2005-April/053060.html
@ -282,31 +273,12 @@ References
.. [16] python-dev email (Replacement for print in Python 3.0)
http://mail.python.org/pipermail/python-dev/2005-September/056154.html
.. [17] Python docs
http://docs.python.org/ref/sequence-methods.html
http://docs.python.org/lib/module-sys.html
http://docs.python.org/lib/module-operator.html
http://docs.python.org/lib/module-array.html
http://docs.python.org/lib/bltin-file-objects.html
.. [18] PEP 4 ("Deprecation of Standard Modules")
http://www.python.org/dev/peps/pep-0004
.. [19] PEP 328 ("Imports: Multi-Line and Absolute/Relative")
http://www.python.org/dev/peps/pep-0328
.. [20] PEP 352 ("Required Superclass for Exceptions")
http://www.python.org/dev/peps/pep-0352
.. [21] python-dev email
http://mail.python.org/pipermail/python-dev/2006-February/061169.html
.. [22] python-dev email ("defaultdict")
http://mail.python.org/pipermail/python-dev/2006-February/061261.html
.. [23] PEP 308 ("Conditional Expressions")
http://www.python.org/dev/peps/pep-0308
.. [24] python-3000 email
http://mail.python.org/pipermail/python-3000/2006-April/000996.html
@ -325,12 +297,36 @@ References
.. [29] python-3000 email ("bug in modulus?")
http://mail.python.org/pipermail/python-3000/2006-May/001735.html
.. [30] PEP 299 ("Special __main__() function in modules")
http://www.python.org/dev/peps/pep-0299
.. [17] Python docs (Additional methods for emulation of sequence types)
http://docs.python.org/ref/sequence-methods.html
.. [#sys-module] Python docs (sys -- System-specific parameters and functions)
http://docs.python.org/lib/module-sys.html
.. [#operator-module] Python docs (operator -- Standard operators as functions)
http://docs.python.org/lib/module-operator.html
.. [#array-module] Python docs (array -- Efficient arrays of numeric values)
http://docs.python.org/lib/module-array.html
.. [#file-object] Python docs (File objects)
http://docs.python.org/lib/bltin-file-objects.html
.. [18] PEP 4 ("Deprecation of Standard Modules")
http://www.python.org/dev/peps/pep-0004
.. [#pep238] PEP 238 (Changing the Division Operator)
http://www.python.org/dev/peps/pep-0238
.. [12] PEP 289 ("Generator Expressions")
http://www.python.org/dev/peps/pep-0289
.. [30] PEP 299 ("Special __main__() function in modules")
http://www.python.org/dev/peps/pep-0299
.. [23] PEP 308 ("Conditional Expressions")
http://www.python.org/dev/peps/pep-0308
.. [#pep328] PEP 328 (Imports: Multi-Line and Absolute/Relative)
http://www.python.org/dev/peps/pep-0328
@ -347,6 +343,7 @@ References
http://www.python.org/dev/peps/pep-3099
Copyright
=========