mirror of https://github.com/python/cpython
1430 lines
61 KiB
Plaintext
1430 lines
61 KiB
Plaintext
What's new in this release?
|
|
===========================
|
|
|
|
Below is a list of all relevant changes since the release 1.4, up till
|
|
the release of 1.5a3. At the end is a list of changes made since
|
|
1.5a3 up to the release of 1.5a4.
|
|
|
|
A note on attributions: while I have sprinkled some names throughout
|
|
here, I'm grateful to many more people who remain anonymous. You may
|
|
find your name in the ACKS file. If you believe you deserve more
|
|
credit, let me know and I'll add you to the list!
|
|
|
|
|
|
Security
|
|
--------
|
|
|
|
- If you are using the setuid script C wrapper (Misc/setuid-prog.c),
|
|
please use the new version. The old version has a huge security leak.
|
|
|
|
Miscellaneous
|
|
-------------
|
|
|
|
- Because of various (small) incompatible changes in the Python
|
|
bytecode interpreter, the magic number for .pyc files has changed
|
|
again.
|
|
|
|
- The default module search path is now much saner. Both on Unix and
|
|
Windows, it is essentially derived from the path to the executable
|
|
(which can be overridden by setting the environment variable
|
|
$PYTHONHOME). The value of $PYTHONPATH on Windows is now inserted in
|
|
front of the default path, like in Unix (instead of overriding the
|
|
default path). On Windows, the directory containing the executable is
|
|
added to the end of the path.
|
|
|
|
- A new version of python-mode.el for Emacs has been included. Also,
|
|
a new file ccpy-style.el has been added to configure Emacs cc-mode for
|
|
the preferred style in Python C sources.
|
|
|
|
- On Unix, when using sys.argv[0] to insert the script directory in
|
|
front of sys.path, expand a symbolic link. You can now install a
|
|
program in a private directory and have a symbolic link to it in a
|
|
public bin directory, and it will put the private directory in the
|
|
module search path. Note that the symlink is expanded in sys.path[0]
|
|
but not in sys.argv[0], so you can still tell the name by which you
|
|
were invoked.
|
|
|
|
- It is now recommended to use ``#!/usr/bin/env python'' instead of
|
|
``#!/usr/local/bin/python'' at the start of executable scripts, except
|
|
for CGI scripts. It has been determined that the use of /usr/bin/env
|
|
is more portable than that of /usr/local/bin/python -- scripts almost
|
|
never have to be edited when the Python interpreter lives in a
|
|
non-standard place. Note that this doesn't work for CGI scripts since
|
|
the python executable often doesn't live in the HTTP server's default
|
|
search path.
|
|
|
|
- The silly -s command line option and the corresponding
|
|
PYTHONSUPPRESS environment variable (and the Py_SuppressPrint global
|
|
flag in the Python/C API) are gone.
|
|
|
|
- Most problems on 64-bit platforms should now be fixed. Andrew
|
|
Kuchling helped. Some uncommon extension modules are still not
|
|
clean (image and audio ops?).
|
|
|
|
- Fixed a bug where multiple anonymous tuple arguments would be mixed up
|
|
when using the debugger or profiler (reported by Just van Rossum).
|
|
The simplest example is ``def f((a,b),(c,d)): print a,b,c,d''; this
|
|
would print the wrong value when run under the debugger or profiler.
|
|
|
|
- The hacks that the dictionary implementation used to speed up
|
|
repeated lookups of the same C string were removed; these were a
|
|
source of subtle problems and don't seem to serve much of a purpose
|
|
any longer.
|
|
|
|
- All traces of support for the long dead access statement have been
|
|
removed from the sources.
|
|
|
|
- Plugged the two-byte memory leak in the tokenizer when reading an
|
|
interactive EOF.
|
|
|
|
- There's a -O option to the interpreter that removes SET_LINENO
|
|
instructions and assert statements (see below); it uses and produces
|
|
.pyo files instead of .pyc files. The speedup is only a few percent
|
|
in most cases. The line numbers are still available in the .pyo file,
|
|
as a separate table (which is also available in .pyc files). However,
|
|
the removal of the SET_LINENO instructions means that the debugger
|
|
(pdb) can't set breakpoints on lines in -O mode. The traceback module
|
|
contains a function to extract a line number from the code object
|
|
referenced in a traceback object. In the future it should be possible
|
|
to write external bytecode optimizers that create better optimized
|
|
.pyo files, and there should be more control over optimization;
|
|
consider the -O option a "teaser". Without -O, the assert statement
|
|
actually generates code that first checks __debug__; if this variable
|
|
is false, the assertion is not checked. __debug__ is a built-in
|
|
variable whose value is initialized to track the -O flag (it's true
|
|
iff -O is not specified). With -O, no code is generated for assert
|
|
statements, nor for code of the form ``if __debug__: <something>''.
|
|
Sorry, no further constant folding happens.
|
|
|
|
|
|
Performance
|
|
-----------
|
|
|
|
- It's much faster (almost twice for pystone.py -- see
|
|
Tools/scripts). See the entry on string interning below.
|
|
|
|
- Some speedup by using separate free lists for method objects (both
|
|
the C and the Python variety) and for floating point numbers.
|
|
|
|
- Big speedup by allocating frame objects with a single malloc() call.
|
|
The Python/C API for frames is changed (you shouldn't be using this
|
|
anyway).
|
|
|
|
- Significant speedup by inlining some common opcodes for common operand
|
|
types (e.g. i+i, i-i, and list[i]). Fredrik Lundh.
|
|
|
|
- Small speedup by reordering the method tables of some common
|
|
objects (e.g. list.append is now first).
|
|
|
|
- Big optimization to the read() method of file objects. A read()
|
|
without arguments now attempts to use fstat to allocate a buffer of
|
|
the right size; for pipes and sockets, it will fall back to doubling
|
|
the buffer size. While that the improvement is real on all systems,
|
|
it is most dramatic on Windows.
|
|
|
|
|
|
Documentation
|
|
-------------
|
|
|
|
- Many new pieces of library documentation were contributed, mostly by
|
|
Andrew Kuchling. Even cmath is now documented! There's also a
|
|
chapter of the library manual, "libundoc.tex", which provides a
|
|
listing of all undocumented modules, plus their status (e.g. internal,
|
|
obsolete, or in need of documentation). Also contributions by Sue
|
|
Williams, Skip Montanaro, and some module authors who succumbed to
|
|
pressure to document their own contributed modules :-). Note that
|
|
printing the documentation now kills fewer trees -- the margins have
|
|
been reduced.
|
|
|
|
- I have started documenting the Python/C API. Unfortunately this project
|
|
hasn't been completed yet. It will be complete before the final release of
|
|
Python 1.5, though. At the moment, it's better to read the LaTeX source
|
|
than to attempt to run it through LaTeX and print the resulting dvi file.
|
|
|
|
- The posix module (and hence os.py) now has doc strings! Thanks to Neil
|
|
Schemenauer. I received a few other contributions of doc strings. In most
|
|
other places, doc strings are still wishful thinking...
|
|
|
|
|
|
Language changes
|
|
----------------
|
|
|
|
- Private variables with leading double underscore are now a permanent
|
|
feature of the language. (These were experimental in release 1.4. I have
|
|
favorable experience using them; I can't label them "experimental"
|
|
forever.)
|
|
|
|
- There's new string literal syntax for "raw strings". Prefixing a string
|
|
literal with the letter r (or R) disables all escape processing in the
|
|
string; for example, r'\n' is a two-character string consisting of a
|
|
backslash followed by the letter n. This combines with all forms of string
|
|
quotes; it is actually useful for triple quoted doc strings which might
|
|
contain references to \n or \t. An embedded quote prefixed with a
|
|
backslash does not terminate the string, but the backslash is still
|
|
included in the string; for example, r'\'' is a two-character string
|
|
consisting of a backslash and a quote. (Raw strings are also
|
|
affectionately known as Robin strings, after their inventor, Robin
|
|
Friedrich.)
|
|
|
|
- There's a simple assert statement, and a new exception
|
|
AssertionError. For example, ``assert foo > 0'' is equivalent to ``if
|
|
not foo > 0: raise AssertionError''. Sorry, the text of the asserted
|
|
condition is not available; it would be too complicated to generate
|
|
code for this (since the code is generated from a parse tree).
|
|
However, the text is displayed as part of the traceback!
|
|
|
|
- The raise statement has a new feature: when using "raise SomeClass,
|
|
somevalue" where somevalue is not an instance of SomeClass, it
|
|
instantiates SomeClass(somevalue). In 1.5a4, if somevalue is an
|
|
instance of a *derived* class of SomeClass, the exception class raised
|
|
is set to somevalue.__class__, and SomeClass is ignored after that.
|
|
|
|
- Duplicate keyword arguments are now detected at compile time;
|
|
f(a=1,a=2) is now a syntax error.
|
|
|
|
|
|
Changes to builtin features
|
|
---------------------------
|
|
|
|
- There's a new exception FloatingPointError (used only by Lee Busby's
|
|
patches to catch floating point exceptions, at the moment).
|
|
|
|
- The obsolete exception ConflictError (presumably used by the long
|
|
obsolete access statement) has been deleted.
|
|
|
|
- There's a new function sys.exc_info() which returns the tuple
|
|
(sys.exc_type, sys.exc_value, sys.exc_traceback) in a thread-safe way.
|
|
|
|
- There's a new variable sys.executable, pointing to the executable file
|
|
for the Python interpreter.
|
|
|
|
- The sort() methods for lists no longer uses the C library qsort(); I
|
|
wrote my own quicksort implementation, with lots of help (in the form
|
|
of a kind of competition) from Tim Peters. This solves a bug in
|
|
dictionary comparisons on some Solaris versions when Python is built
|
|
with threads, and makes sorting lists even faster.
|
|
|
|
- The semantics of comparing two dictionaries have changed, to make
|
|
comparison of unequal dictionaries faster. A shorter dictionary is
|
|
always considered smaller than a larger dictionary. For dictionaries
|
|
of the same size, the smallest differing element determines the
|
|
outcome (which yields the same results as before in this case, without
|
|
explicit sorting). Thanks to Aaron Watters for suggesting something
|
|
like this.
|
|
|
|
- The semantics of try-except have changed subtly so that calling a
|
|
function in an exception handler that itself raises and catches an
|
|
exception no longer overwrites the sys.exc_* variables. This also
|
|
alleviates the problem that objects referenced in a stack frame that
|
|
caught an exception are kept alive until another exception is caught
|
|
-- the sys.exc_* variables are restored to their previous value when
|
|
returning from a function that caught an exception.
|
|
|
|
- There's a new "buffer" interface. Certain objects (e.g. strings and
|
|
arrays) now support the "buffer" protocol. Buffer objects are acceptable
|
|
whenever formerly a string was required for a write operation; mutable
|
|
buffer objects can be the target of a read operation using the call
|
|
f.readinto(buffer). A cool feature is that regular expression matching now
|
|
also work on array objects. Contribution by Jack Jansen. (Needs
|
|
documentation.)
|
|
|
|
- String interning: dictionary lookups are faster when the lookup
|
|
string object is the same object as the key in the dictionary, not
|
|
just a string with the same value. This is done by having a pool of
|
|
"interned" strings. Most names generated by the interpreter are now
|
|
automatically interned, and there's a new built-in function intern(s)
|
|
that returns the interned version of a string. Interned strings are
|
|
not a different object type, and interning is totally optional, but by
|
|
interning most keys a speedup of about 15% was obtained for the
|
|
pystone benchmark.
|
|
|
|
- Dictionary objects have several new methods; clear() and copy() have
|
|
the obvious semantics, while update(d) merges the contents of another
|
|
dictionary d into this one, overriding existing keys. The dictionary
|
|
implementation file is now called dictobject.c rather than the
|
|
confusing mappingobject.c.
|
|
|
|
- The intrinsic function dir() is much smarter; it looks in __dict__,
|
|
__members__ and __methods__.
|
|
|
|
- The intrinsic functions int(), long() and float() can now take a
|
|
string argument and then do the same thing as string.atoi(),
|
|
string.atol(), and string.atof(). No second 'base' argument is
|
|
allowed, and complex() does not take a string (nobody cared enough).
|
|
|
|
- When a module is deleted, its globals are now deleted in two phases.
|
|
In the first phase, all variables whose name begins with exactly one
|
|
underscore are replaced by None; in the second phase, all variables
|
|
are deleted. This makes it possible to have global objects whose
|
|
destructors depend on other globals. The deletion order within each
|
|
phase is still random.
|
|
|
|
- It is no longer an error for a function to be called without a
|
|
global variable __builtins__ -- an empty directory will be provided
|
|
by default.
|
|
|
|
- Guido's corollary to the "Don Beaudry hook": it is now possible to
|
|
do metaprogramming by using an instance as a base class. Not for the
|
|
faint of heart; and undocumented as yet, but basically if a base class
|
|
is an instance, its class will be instantiated to create the new
|
|
class. Jim Fulton will love it -- it also works with instances of his
|
|
"extension classes", since it is triggered by the presence of a
|
|
__class__ attribute on the purported base class. See
|
|
Demo/metaclasses/index.html for an explanation and see that directory
|
|
for examples.
|
|
|
|
- Another change is that the Don Beaudry hook is now invoked when
|
|
*any* base class is special. (Up to 1.5a3, the *last* special base
|
|
class is used; in 1.5a4, the more rational choice of the *first*
|
|
special base class is used.)
|
|
|
|
- New optional parameter to the readlines() method of file objects.
|
|
This indicates the number of bytes to read (the actual number of bytes
|
|
read will be somewhat larger due to buffering reading until the end of
|
|
the line). Some optimizations have also been made to speed it up (but
|
|
not as much as read()).
|
|
|
|
- Complex numbers no longer have the ".conj" pseudo attribute; use
|
|
z.conjugate() instead, or complex(z.real, -z.imag). Complex numbers
|
|
now *do* support the __members__ and __methods__ special attributes.
|
|
|
|
- The complex() function now looks for a __complex__() method on class
|
|
instances before giving up.
|
|
|
|
- Long integers now support arbitrary shift counts, so you can now
|
|
write 1L<<1000000, memory permitting. (Python 1.4 reports "outrageous
|
|
shift count for this.)
|
|
|
|
- The hex() and oct() functions have been changed so that for regular
|
|
integers, they never emit a minus sign. For example, on a 32-bit
|
|
machine, oct(-1) now returns '037777777777' and hex(-1) returns
|
|
'0xffffffff'. While this may seem inconsistent, it is much more
|
|
useful. (For long integers, a minus sign is used as before, to fit
|
|
the result in memory :-)
|
|
|
|
- The hash() function computes better hashes for several data types,
|
|
including strings, floating point numbers, and complex numbers.
|
|
|
|
|
|
New extension modules
|
|
---------------------
|
|
|
|
- New extension modules cStringIO.c and cPickle.c, written by Jim
|
|
Fulton and other folks at Digital Creations. These are much more
|
|
efficient than their Python counterparts StringIO.py and pickle.py,
|
|
but don't support subclassing. cPickle.c clocks up to 1000 times
|
|
faster than pickle.py; cStringIO.c's improvement is less dramatic but
|
|
still significant.
|
|
|
|
- New extension module zlibmodule.c, interfacing to the free zlib
|
|
library (gzip compatible compression). There's also a module gzip.py
|
|
which provides a higher level interface. Written by Andrew Kuchling
|
|
and Jeremy Hylton.
|
|
|
|
- New module readline; see the "miscellaneous" section above.
|
|
|
|
- New Unix extension module resource.c, by Jeremy Hylton, provides
|
|
access to getrlimit(), getrusage(), setrusage(), getpagesize(), and
|
|
related symbolic constants.
|
|
|
|
- New extension puremodule.c, by Barry Warsaw, which interfaces to the
|
|
Purify(TM) C API. See also the file Misc/PURIFY.README. It is also
|
|
possible to enable Purify by simply setting the PURIFY Makefile
|
|
variable in the Modules/Setup file.
|
|
|
|
|
|
Changes in extension modules
|
|
----------------------------
|
|
|
|
- The struct extension module has several new features to control byte
|
|
order and word size. It supports reading and writing IEEE floats even
|
|
on platforms where this is not the native format. It uses uppercase
|
|
format codes for unsigned integers of various sizes (always using
|
|
Python long ints for 'I' and 'L'), 's' with a size prefix for strings,
|
|
and 'p' for "Pascal strings" (with a leading length byte, included in
|
|
the size; blame Hannu Krosing; new in 1.5a4). A prefix '>' forces
|
|
big-endian data and '<' forces little-endian data; these also select
|
|
standard data sizes and disable automatic alignment (use pad bytes as
|
|
needed).
|
|
|
|
- The array module supports uppercase format codes for unsigned data
|
|
formats (like the struct module).
|
|
|
|
- The fcntl extension module now exports the needed symbolic
|
|
constants. (Formerly these were in FCNTL.py which was not available
|
|
or correct for all platforms.)
|
|
|
|
- The extension modules dbm, gdbm and bsddb now check that the
|
|
database is still open before making any new calls.
|
|
|
|
- The dbhash module is no more. Use bsddb instead. (There's a third
|
|
party interface for the BSD 2.x code somewhere on the web; support for
|
|
bsddb will be deprecated.)
|
|
|
|
- The gdbm module now supports a sync() method.
|
|
|
|
- The socket module now has some new functions: getprotobyname(), and
|
|
the set {ntoh,hton}{s,l}().
|
|
|
|
- Various modules now export their type object: socket.SocketType,
|
|
array.ArrayType.
|
|
|
|
- The socket module's accept() method now returns unknown addresses as
|
|
a tuple rather than raising an exception. (This can happen in
|
|
promiscuous mode.) Theres' also a new function getprotobyname().
|
|
|
|
- The pthread support for the thread module now works on most platforms.
|
|
|
|
- STDWIN is now officially obsolete. Support for it will eventually
|
|
be removed from the distribution.
|
|
|
|
- The binascii extension module is now hopefully fully debugged.
|
|
(XXX Oops -- Fredrik Lundh promised me a uuencode fix that I never
|
|
received.)
|
|
|
|
- audioop.c: added a ratecv() function; better handling of overflow in
|
|
add().
|
|
|
|
- posixmodule.c: now exports the O_* flags (O_APPEND etc.). On
|
|
Windows, also O_TEXT and O_BINARY. The 'error' variable (the
|
|
exception is raises) is renamed -- its string value is now "os.error",
|
|
so newbies don't believe they have to import posix (or nt) to catch
|
|
it when they see os.error reported as posix.error. The execve()
|
|
function now accepts any mapping object for the environment.
|
|
|
|
- A new version of the al (audio library) module for SGI was
|
|
contributed by Sjoerd Mullender.
|
|
|
|
- The regex module has a new function get_syntax() which retrieves the
|
|
syntax setting set by set_syntax(). The code was also sanitized,
|
|
removing worries about unclean error handling. See also below for its
|
|
successor, re.py.
|
|
|
|
- The "new" module (which creates new objects of various types) once
|
|
again has a fully functioning new.function() method. Dangerous as
|
|
ever! Also, new.code() has several new arguments.
|
|
|
|
- A problem has been fixed in the rotor module: on systems with signed
|
|
characters, rotor-encoded data was not portable when the key contained
|
|
8-bit characters. Also, setkey() now requires its argument rather
|
|
than having broken code to default it.
|
|
|
|
- The sys.builtin_module_names variable is now a tuple. Another new
|
|
variables in sys is sys.executable (the full path to the Python
|
|
binary, if known).
|
|
|
|
- The specs for time.strftime() have undergone some revisions. It
|
|
appears that not all format characters are supported in the same way
|
|
on all platforms. Rather than reimplement it, we note these
|
|
differences in the documentation, and emphasize the shared set of
|
|
features. There's also a thorough test set (that occasionally finds
|
|
problems in the C library implementation, e.g. on some Linuxes),
|
|
thanks to Skip Montanaro.
|
|
|
|
- The nis module seems broken when used with NIS+; unfortunately
|
|
nobody knows how to fix it. It should still work with old NIS.
|
|
|
|
|
|
New library modules
|
|
-------------------
|
|
|
|
- New (still experimental) Perl-style regular expression module,
|
|
re.py, which uses a new interface for matching as well as a new
|
|
syntax; the new interface avoids the thread-unsafety of the regex
|
|
interface. This comes with a helper extension reopmodule.c and vastly
|
|
rewritten regexpr.c. Most work on this was done by Jeffrey Ollie, Tim
|
|
Peters, and Andrew Kuchling. See the documentation libre.tex. In
|
|
1.5, the old regex module is still fully supported; in the future, it
|
|
will become obsolete.
|
|
|
|
- New module gzip.py; see zlib above.
|
|
|
|
- New module keyword.py exports knowledge about Python's built-in
|
|
keywords. (New version by Ka-Ping Yee.)
|
|
|
|
- New module pprint.py (with documentation) which supports
|
|
pretty-printing of lists, tuples, & dictionaries recursively. By Fred
|
|
Drake.
|
|
|
|
- New module code.py. The function code.compile_command() can
|
|
determine whether an interactively entered command is complete or not,
|
|
distinguishing incomplete from invalid input. (XXX Unfortunately,
|
|
this seems broken at this moment, and I don't have the time to fix
|
|
it. It's probably better to add an explicit interface to the parser
|
|
for this.)
|
|
|
|
- There is now a library module xdrlib.py which can read and write the
|
|
XDR data format as used by Sun RPC, for example. It uses the struct
|
|
module.
|
|
|
|
|
|
Changes in library modules
|
|
--------------------------
|
|
|
|
- Module codehack.py is now completely obsolete.
|
|
|
|
- The pickle.py module has been updated to make it compatible with the
|
|
new binary format that cPickle.c produces. By default it produces the
|
|
old all-ASCII format compatible with the old pickle.py, still much
|
|
faster than pickle.py; it will read both formats automatically. A few
|
|
other updates have been made.
|
|
|
|
- A new helper module, copy_reg.py, is provided to register extensions
|
|
to the pickling code.
|
|
|
|
- Revamped module tokenize.py is much more accurate and has an
|
|
interface that makes it a breeze to write code to colorize Python
|
|
source code. Contributed by Ka-Ping Yee.
|
|
|
|
- In ihooks.py, ModuleLoader.load_module() now closes the file under
|
|
all circumstances.
|
|
|
|
- The tempfile.py module has a new class, TemporaryFile, which creates
|
|
an open temporary file that will be deleted automatically when
|
|
closed. This works on Windows and MacOS as well as on Unix. (Jim
|
|
Fulton.)
|
|
|
|
- Changes to the cgi.py module: Most imports are now done at the
|
|
top of the module, which provides a speedup when using ni (Jim
|
|
Fulton). The problem with file upload to a Windows platform is solved
|
|
by using the new tempfile.TemporaryFile class; temporary files are now
|
|
always opened in binary mode (Jim Fulton). The cgi.escape() function
|
|
now takes an optional flag argument that quotes '"' to '"'. It
|
|
is now possible to invoke cgi.py from a command line script, to test
|
|
cgi scripts more easily outside an http server. There's an optional
|
|
limit to the size of uploads to POST (Skip Montanaro). Added a
|
|
'strict_parsing' option to all parsing functions (Jim Fulton). The
|
|
function parse_qs() now uses urllib.unquote() on the name as well as
|
|
the value of fields (Clarence Gardner). The FieldStorage class now
|
|
has a __len__() method.
|
|
|
|
- httplib.py: the socket object is no longer closed; all HTTP/1.*
|
|
responses are now accepted; and it is now thread-safe (by not using
|
|
the regex module).
|
|
|
|
- BaseHTTPModule.py: treat all HTTP/1.* versions the same.
|
|
|
|
- The popen2.py module is now rewritten using a class, which makes
|
|
access to the standard error stream and the process id of the
|
|
subprocess possible.
|
|
|
|
- Added timezone support to the rfc822.py module, in the form of a
|
|
getdate_tz() method and a parsedate_tz() function; also a mktime_tz().
|
|
Also added recognition of some non-standard date formats, by Lars
|
|
Wirzenius, and RFC 850 dates (Chris Lawrence).
|
|
|
|
- mhlib.py: various enhancements, including almost compatible parsing
|
|
of message sequence specifiers without invoking a subprocess. Also
|
|
added a createmessage() method by Lars Wirzenius.
|
|
|
|
- The StringIO.StringIO class now supports readline(nbytes). (Lars
|
|
Wirzenius.) (Of course, you should be using cStringIO for performance.)
|
|
|
|
- UserDict.py supports the new dictionary methods as well.
|
|
|
|
- Improvements for whrandom.py by Tim Peters: use 32-bit arithmetic to
|
|
speed it up, and replace 0 seed values by 1 to avoid degeneration.
|
|
A bug was fixed in the test for invalid arguments.
|
|
|
|
- Module ftplib.py: added support for parsing a .netrc file (Fred
|
|
Drake). Also added an ntransfercmd() method to the FTP class, which
|
|
allows access to the expected size of a transfer when available, and a
|
|
parse150() function to the module which parses the corresponding 150
|
|
response.
|
|
|
|
- urllib.py: the ftp cache is now limited to 10 entries. Added
|
|
quote_plus() and unquote_plus() functions which are like quote() and
|
|
unquote() but also replace spaces with '+' or vice versa, for
|
|
encoding/decoding CGI form arguments. Catch all errors from the ftp
|
|
module. HTTP requests now add the Host: header line. The proxy
|
|
variable names are now mapped to lower case, for Windows. The
|
|
spliturl() function no longer erroneously throws away all data past
|
|
the first newline. The basejoin() function now intereprets "../"
|
|
correctly. I *believe* that the problems with "exception raised in
|
|
__del__" under certain circumstances have been fixed (mostly by
|
|
changes elsewher in the interpreter).
|
|
|
|
- In urlparse.py, there is a cache for results in urlparse.urlparse();
|
|
its size limit is set to 20. Also, new URL schemes shttp, https, and
|
|
snews are "supported".
|
|
|
|
- shelve.py: use cPickle and cStringIO when available. Also added
|
|
a sync() method, which calls the database's sync() method if there is
|
|
one.
|
|
|
|
- The mimetools.py module now uses the available Python modules for
|
|
decoding quoted-printable, uuencode and base64 formats, rather than
|
|
creating a subprocess.
|
|
|
|
- The python debugger (pdb.py, and its base class bdb.py) now support
|
|
conditional breakpoints. See the docs.
|
|
|
|
- The modules base64.py, uu.py and quopri.py can now be used as simple
|
|
command line utilities.
|
|
|
|
- Various small fixes to the nntplib.py module that I can't bother to
|
|
document in detail.
|
|
|
|
- Sjoerd Mullender's mimify.py module now supports base64 encoding and
|
|
includes functions to handle the funny encoding you sometimes see in mail
|
|
headers. It is now documented.
|
|
|
|
- mailbox.py: Added BabylMailbox. Improved the way the mailbox is
|
|
gotten from the environment.
|
|
|
|
- Many more modules now correctly open files in binary mode when this
|
|
is necessary on non-Unix platforms.
|
|
|
|
- The copying functions in the undocumented module shutil.py are
|
|
smarter.
|
|
|
|
- The Writer classes in the formatter.py module now have a flush()
|
|
method.
|
|
|
|
- The sgmllib.py module accepts hyphens and periods in the middle of
|
|
attribute names. While this is against the SGML standard, there is
|
|
some HTML out there that uses this...
|
|
|
|
- The interface for the Python bytecode disassembler module, dis.py,
|
|
has been enhanced quite a bit. There's now one main function,
|
|
dis.dis(), which takes almost any kind of object (function, module,
|
|
class, instance, method, code object) and disassembles it; without
|
|
arguments it disassembles the last frame of the last traceback. The
|
|
other functions have changed slightly, too.
|
|
|
|
- The imghdr.py module recognizes new image types: BMP, PNG.
|
|
|
|
- The string.py module has a new function replace(str, old, new,
|
|
[maxsplit]) which does substring replacements. It is actually
|
|
implemented in C in the strop module. The functions [r]find() an
|
|
[r]index() have an optional 4th argument indicating the end of the
|
|
substring to search, alsoo implemented by their strop counterparts.
|
|
(Remember, never import strop -- import string uses strop when
|
|
available with zero overhead.)
|
|
|
|
- The string.join() function now accepts any sequence argument, not
|
|
just lists and tuples.
|
|
|
|
- The string.maketrans() requires its first two arguments to be
|
|
present. The old version didn't require them, but there's not much
|
|
point without them, and the documentation suggests that they are
|
|
required, so we fixed the code to match the documentation.
|
|
|
|
- The regsub.py module has a function clear_cache(), which clears its
|
|
internal cache of compiled regular expressions. Also, the cache now
|
|
takes the current syntax setting into account. (However, this module
|
|
is now obsolete -- use the sub() or subn() functions or methods in the
|
|
re module.)
|
|
|
|
- The undocumented module Complex.py has been removed, now that Python
|
|
has built-in complex numbers. A similar module remains as
|
|
Demo/classes/Complex.py, as an example.
|
|
|
|
|
|
Changes to the build process
|
|
----------------------------
|
|
|
|
- The way GNU readline is configured is totally different. The
|
|
--with-readline configure option is gone. It is now an extension
|
|
module, which may be loaded dynamically. You must enable it (and
|
|
specify the correct linraries to link with) in the Modules/Setup file.
|
|
Importing the module installs some hooks which enable command line
|
|
editing. When the interpreter shell is invoked interactively, it
|
|
attempts to import the readline module; when this fails, the default
|
|
input mechanism is used. The hook variables are PyOS_InputHook and
|
|
PyOS_ReadlineFunctionPointer. (Code contributed by Lee Busby, with
|
|
ideas from William Magro.)
|
|
|
|
- New build procedure: a single library, libpython1.5.a, is now built,
|
|
which contains absolutely everything except for a one-line main()
|
|
program (which calls Py_Main(argc, argv) to start the interpreter
|
|
shell). This makes life much simpler for applications that need to
|
|
embed Python. The serial number of the build is now included in the
|
|
version string (sys.version).
|
|
|
|
- As far as I can tell, neither gcc -Wall nor the Microsoft compiler
|
|
emits a single warning any more when compiling Python.
|
|
|
|
- A number of new Makefile variables have been added for special
|
|
situations, e.g. LDLAST is appended to the link command. These are
|
|
used by editing the Makefile or passing them on the make command
|
|
line.
|
|
|
|
- A set of patches from Lee Busby has been integrated that make it
|
|
possible to catch floating point exceptions. Use the configure option
|
|
--with-fpectl to enable the patches; the extension modules fpectl and
|
|
fpetest provide control to enable/disable and test the feature,
|
|
respectively.
|
|
|
|
- The support for shared libraries under AIX is now simpler and more
|
|
robust. Thanks to Vladimir Marangozov for revamping his own patches!
|
|
|
|
- The Modules/makesetup script now reads a file Setup.local as well as
|
|
a file Setup. Most changes to the Setup script can be done by editing
|
|
Setup.local instead, which makes it easier to carry a particular setup
|
|
over from one release to the next.
|
|
|
|
- The Modules/makesetup script now copies any "include" lines it
|
|
encounters verbatim into the output Makefile. It also recognizes .cxx
|
|
and .cpp as C++ source files.
|
|
|
|
- The configure script is smarter about C compiler options; e.g. with
|
|
gcc it uses -O2 and -g when possible, and on some other platforms it
|
|
uses -Olimit 1500 to avoid a warning from the optimizer about the main
|
|
loop in ceval.c (which has more than 1000 basic blocks).
|
|
|
|
- The configure script now detects whether malloc(0) returns a NULL
|
|
pointer or a valid block (of length zero). This avoids the nonsense
|
|
of always adding one byte to all malloc() arguments on most platforms.
|
|
|
|
- The configure script has a new option, --with-dec-threads, to enable
|
|
DEC threads on DEC Alpha platforms. Also, --with-threads is now an
|
|
alias for --with-thread (this was the Most Common Typo in configure
|
|
arguments).
|
|
|
|
- Many changes in Doc/Makefile; amongst others, latex2html is now used
|
|
to generate HTML from all latex documents.
|
|
|
|
|
|
Change to the Python/C API
|
|
--------------------------
|
|
|
|
- Because some interfaces have changed, the PYTHON_API macro has been
|
|
bumped. Most extensions built for the old API version will still run,
|
|
but I can't guarantee this. Python prints a warning message on
|
|
version mismatches; it dumps core when the version mismatch causes a
|
|
serious problem :-)
|
|
|
|
- I've completed the Grand Renaming, with the help of Roger Masse and
|
|
Barry Warsaw. This makes reading or debugging the code much easier.
|
|
Many other unrelated code reorganizations have also been carried out.
|
|
The allobjects.h header file is gone; instead, you would have to
|
|
include Python.h followed by rename2.h. But you're better off running
|
|
Tools/scripts/fixcid.py -s Misc/RENAME on your source, so you can omit
|
|
the rename2.h; it will disappear in the next release.
|
|
|
|
- Various and sundry small bugs in the "abstract" interfaces have been
|
|
fixed. Thanks to all the (involuntary) testers of the Python 1.4
|
|
version! Some new functions have been added, e.g. PySequence_List(o),
|
|
equivalent to list(o) in Python.
|
|
|
|
- New API functions PyLong_FromUnsignedLong() and
|
|
PyLong_AsUnsignedLong().
|
|
|
|
- The API functions in the file cgensupport.c are no longer
|
|
supported. This file has been moved to Modules and is only ever
|
|
compiled when the SGI specific 'gl' module is built.
|
|
|
|
- PyObject_Compare() can now raise an exception. Check with
|
|
PyErr_Occurred(). The comparison function in an object type may also
|
|
raise an exception.
|
|
|
|
- The slice interface uses an upper bound of INT_MAX when no explicit
|
|
upper bound is given (e.x. for a[1:]). It used to ask the object for
|
|
its length and do the calculations.
|
|
|
|
- Support for multiple independent interpreters. See Doc/api.tex,
|
|
functions Py_NewInterpreter() and Py_EndInterpreter(). Since the
|
|
documentation is incomplete, also see the new Demo/pysvr example
|
|
(which shows how to use these in a threaded application) and the
|
|
source code.
|
|
|
|
- There is now a Py_Finalize() function which "de-initializes"
|
|
Python. It is possible to completely restart the interpreter
|
|
repeatedly by calling Py_Finalize() followed by Py_Initialize(). A
|
|
change of functionality in Py_Initialize() means that it is now a
|
|
fatal error to call it while the interpreter is already initialized.
|
|
The old, half-hearted Py_Cleanup() routine is gone. Use of Py_Exit()
|
|
is deprecated (it is nothing more than Py_Finalize() followed by
|
|
exit()).
|
|
|
|
- There are no known memory leaks left. While Py_Finalize() doesn't
|
|
free *all* allocated memory (some of it is hard to track down),
|
|
repeated calls to Py_Finalize() and Py_Initialize() do not create
|
|
unaccessible heap blocks.
|
|
|
|
- There is now explicit per-thread state. (Inspired by, but not the
|
|
same as, Greg Stein's free threading patches.)
|
|
|
|
- There is now better support for threading C applications. There are
|
|
now explicit APIs to manipulate the interpreter lock. Read the source
|
|
or the Demo/pysvr example; the new functions are
|
|
PyEval_{Acquire,Release}{Lock,Thread}().
|
|
|
|
- The test macro DEBUG has changed to Py_DEBUG, to avoid interference
|
|
with other libraries' DEBUG macros. Likewise for any other test
|
|
macros that didn't yet start with Py_.
|
|
|
|
- New wrappers around malloc() and friends: Py_Malloc() etc. call
|
|
malloc() and call PyErr_NoMemory() when it fails; PyMem_Malloc() call
|
|
just malloc(). Use of these wrappers could be essential if multiple
|
|
memory allocators exist (e.g. when using certain DLL setups under
|
|
Windows). (Idea by Jim Fulton.)
|
|
|
|
- New C API PyImport_Import() which uses whatever __import__() hook
|
|
that is installed for the current execution environment. By Jim
|
|
Fulton.
|
|
|
|
- It is now possible for an extension module's init function to fail
|
|
non-fatally, by calling one of the PyErr_* functions and returning.
|
|
|
|
- The PyInt_AS_LONG() and PyFloat_AS_DOUBLE() macros now cast their
|
|
argument to the proper type, like the similar PyString macros already
|
|
did. (Suggestion by Marc-Andre Lemburg.) Similar for PyList_GET_SIZE
|
|
and PyList_GET_ITEM.
|
|
|
|
- Some of the Py_Get* function, like Py_GetVersion() (but not yet
|
|
Py_GetPath()) are now declared as returning a const char *. (More
|
|
should follow.)
|
|
|
|
- Changed the run-time library to check for exceptions after object
|
|
comparisons. PyObject_Compare() can now return an exception; use
|
|
PyErr_Occurred() to check (there is *no* special return value).
|
|
|
|
- PyFile_WriteString() and Py_Flushline() now return error indicators
|
|
instead of clearing exceptions. This fixes an obscure bug where using
|
|
these would clear a pending exception, discovered by Just van Rossum.
|
|
|
|
- There's a new function, PyArg_ParseTupleAndKeywords(), which parses
|
|
an argument list including keyword arguments. Contributed by Geoff
|
|
Philbrick.
|
|
|
|
- PyArg_GetInt() is gone.
|
|
|
|
- It's no longer necessary to include graminit.h when calling one of
|
|
the extended parser API functions. The three public grammar start
|
|
symbols are now in Python.h as Py_single_input, Py_file_input, and
|
|
Py_eval_input.
|
|
|
|
- The CObject interface has a new function,
|
|
PyCObject_Import(module, name). It calls PyCObject_AsVoidPtr()
|
|
on the object referenced by "module.name".
|
|
|
|
|
|
Tkinter
|
|
-------
|
|
|
|
- On popular demand, _tkinter once again installs a hook for readline
|
|
that processes certain Tk events while waiting for the user to type
|
|
(using PyOS_InputHook).
|
|
|
|
- A patch by Craig McPheeters plugs the most obnoxious memory leaks,
|
|
caused by command definitions referencing widget objects beyond their
|
|
lifetime.
|
|
|
|
- New standard dialog modules: tkColorChooser.py, tkCommonDialog.py,
|
|
tkMessageBox.py, tkFileDialog.py, tkSimpleDialog.py These interface
|
|
with the new Tk dialog scripts, and provide more "native platform"
|
|
style file selection dialog boxes on some platforms. Contributed by
|
|
Fredrik Lundh.
|
|
|
|
- Tkinter.py: when the first Tk object is destroyed, it sets the
|
|
hiddel global _default_root to None, so that when another Tk object is
|
|
created it becomes the new default root. Other miscellaneous
|
|
changes and fixes.
|
|
|
|
- The Image class now has a configure method.
|
|
|
|
- Added a bunch of new winfo options to Tkinter.py; we should now be
|
|
up to date with Tk 4.2. The new winfo options supported are:
|
|
mananger, pointerx, pointerxy, pointery, server, viewable, visualid,
|
|
visualsavailable.
|
|
|
|
- The broken bind() method on Canvas objects defined in the Canvas.py
|
|
module has been fixed. The CanvasItem and Group classes now also have
|
|
an unbind() method.
|
|
|
|
- The problem with Tkinter.py falling back to trying to import
|
|
"tkinter" when "_tkinter" is not found has been fixed -- it no longer
|
|
tries "tkinter", ever. This makes diagnosing the problem "_tkinter
|
|
not configured" much easier and will hopefully reduce the newsgroup
|
|
traffic on this topic.
|
|
|
|
- The ScrolledText module once again supports the 'cnf' parameter, to
|
|
be compatible with the examples in Mark Lutz' book (I know, I know,
|
|
too late...)
|
|
|
|
- The _tkinter.c extension module has been revamped. It now support
|
|
Tk versions 4.1 through 8.0; support for 4.0 has been dropped. It
|
|
works well under Windows and Mac (with the latest Tk ports to those
|
|
platforms). It also supports threading -- it is safe for one
|
|
(Python-created) thread to be blocked in _tkinter.mainloop() while
|
|
other threads modify widgets. To make the changes visible, those
|
|
threads must use update_idletasks()method. (The patch for threading
|
|
in 1.5a3 was broken; in 1.5a4, it is back in a different version,
|
|
which requires access to the Tcl sources to get it to work -- hence it
|
|
is disabled by default.)
|
|
|
|
- A bug in _tkinter.c has been fixed, where Split() with a string
|
|
containing an unmatched '"' could cause an exception or core dump.
|
|
|
|
- Unfortunately, on Windows and Mac, Tk 8.0 no longer supports
|
|
CreateFileHandler, so _tkinter.createfilehandler is not available on
|
|
those platforms when using Tk 8.0 or later. I will have to rethink
|
|
how to interface with Tcl's lower-level event mechanism, or with its
|
|
channels (which are like Python's file-like objects). Jack Jansen has
|
|
provided a fix for the Mac, so createfilehandler *is* actually
|
|
supported there; maybe I can adapt his fix for Windows.
|
|
|
|
|
|
Tools and Demos
|
|
---------------
|
|
|
|
- A new regression test suite is provided, which tests most of the
|
|
standard and built-in modules. The regression test is run by invoking
|
|
the script Lib/test/regrtest.py. Barry Warsaw wrote the test harnass;
|
|
he and Roger Masse contributed most of the new tests.
|
|
|
|
- New tool: faqwiz -- the CGI script that is used to maintain the
|
|
Python FAQ (http://grail.cnri.reston.va.us/cgi-bin/faqw.py). In
|
|
Tools/faqwiz.
|
|
|
|
- New tool: webchecker -- a simple extensible web robot that, when
|
|
aimed at a web server, checks that server for dead links. Available
|
|
are a command line utility as well as a Tkinter based GUI version. In
|
|
Tools/webchecker. A simplified version of this program is dissected
|
|
in my article in O'Reilly's WWW Journal, the issue on Scripting
|
|
Languages (Vol 2, No 2); Scripting the Web with Python (pp 97-120).
|
|
Includes a parser for robots.txt files by Skip Montanaro.
|
|
|
|
- New small tools: cvsfiles.py (prints a list of all files under CVS
|
|
n a particular directory tree), treesync.py (a rather Guido-specific
|
|
script to synchronize two source trees, one on Windows NT, the other
|
|
one on Unix under CVS but accessible from the NT box), and logmerge.py
|
|
(sort a collection of RCS or CVS logs by date). In Tools/scripts.
|
|
|
|
- The freeze script now also works under Windows (NT). Another
|
|
feature allows the -p option to be pointed at the Python source tree
|
|
instead of the installation prefix. This was loosely based on part of
|
|
xfreeze by Sam Rushing and Bill Tutt.
|
|
|
|
- New examples (Demo/extend) that show how to use the generic
|
|
extension makefile (Misc/Makefile.pre.in).
|
|
|
|
- Tools/scripts/h2py.py now supports C++ comments.
|
|
|
|
- Tools/scripts/pystone.py script is upgraded to version 1.1; there
|
|
was a bug in version 1.0 (distributed with Python 1.4) that leaked
|
|
memory. Also, in 1.1, the LOOPS variable is incremented to 10000.
|
|
|
|
- Demo/classes/Rat.py completely rewritten by Sjoerd Mullender.
|
|
|
|
|
|
Windows (NT and 95)
|
|
-------------------
|
|
|
|
- New project files for Developer Studio (Visual C++) 5.0 for Windows
|
|
NT (the old VC++ 4.2 Makefile is also still supported, but will
|
|
eventually be withdrawn due to its bulkiness).
|
|
|
|
- See the note on the new module search path in the "Miscellaneous" section
|
|
above.
|
|
|
|
- Support for Win32s (the 32-bit Windows API under Windows 3.1) is
|
|
basically withdrawn. If it still works for you, you're lucky.
|
|
|
|
- There's a new extension module, msvcrt.c, which provides various
|
|
low-level operations defined in the Microsoft Visual C++ Runtime Library.
|
|
These include locking(), setmode(), get_osfhandle(), set_osfhandle(), and
|
|
console I/O functions like kbhit(), getch() and putch().
|
|
|
|
- The -u option not only sets the standard I/O streams to unbuffered
|
|
status, but also sets them in binary mode. (This can also be done
|
|
using msvcrt.setmode(), by the way.)
|
|
|
|
- The, sys.prefix and sys.exec_prefix variables point to the directory
|
|
where Python is installed, or to the top of the source tree, if it was run
|
|
from there.
|
|
|
|
- The various os.path modules (posixpath, ntpath, macpath) now support
|
|
passing more than two arguments to the join() function, so
|
|
os.path.join(a, b, c) is the same as os.path.join(a, os.path.join(b,
|
|
c)).
|
|
|
|
- The ntpath module (normally used as os.path) supports ~ to $HOME
|
|
expansion in expanduser().
|
|
|
|
- The freeze tool now works on Windows.
|
|
|
|
- See also the Tkinter category for a sad note on
|
|
_tkinter.createfilehandler().
|
|
|
|
- The truncate() method for file objects now works on Windows.
|
|
|
|
- Py_Initialize() is no longer called when the DLL is loaded. You
|
|
must call it yourself.
|
|
|
|
- The time module's clock() function now has good precision through
|
|
the use of the Win32 API QueryPerformanceCounter().
|
|
|
|
- Mark Hammond will release Python 1.5 versions of PythonWin and his
|
|
other Windows specific code: the win32api extensions, COM/ActiveX
|
|
support, and the MFC interface.
|
|
|
|
|
|
Mac
|
|
---
|
|
|
|
- As always, the Macintosh port will be done by Jack Jansen. He will
|
|
make a separate announcement for the Mac specific source code and the
|
|
binary distribution(s) when these are ready.
|
|
|
|
|
|
======================================================================
|
|
|
|
|
|
Fixed after 1.5a3 was released
|
|
------------------------------
|
|
|
|
The following changes have been made to the source base after the
|
|
release of 1.5a3. They still need to be sorted. They also need to be
|
|
merged into their respective categories for the final release, but
|
|
it's useful to have them separately during the alpha test cycle.
|
|
|
|
- faqwiz.py: version 0.8; Recognize https:// as URL; <html>...</html>
|
|
feature; better install instructions; removed faqmain.py (which was an
|
|
older version).
|
|
|
|
- nntplib.py: Fixed some bugs reported by Lars Wirzenius (to Debian)
|
|
about the treatment of lines starting with '.'. Added a minimal test
|
|
function.
|
|
|
|
- struct module: ignore most whitespace in format strings.
|
|
|
|
- urllib.py: close the socket and temp file in URLopener.retrieve() so
|
|
that multiple retrievals using the same connection work.
|
|
|
|
- All standard exceptions are now classes by default; use -X to make
|
|
them strings (for backward compatibility only).
|
|
|
|
- There's a new standard exception hierarchy, defined in the standard
|
|
library module exceptions.py (which you never need to import
|
|
explicitly). See
|
|
http://grail.cnri.reston.va.us/python/essays/stdexceptions.html for
|
|
more info.
|
|
|
|
- Three new C API functions:
|
|
|
|
- int PyErr_GivenExceptionMatches(obj1, obj2)
|
|
|
|
Returns 1 if obj1 and obj2 are the same object, or if obj1 is an
|
|
instance of type obj2, or of a class derived from obj2
|
|
|
|
- int PyErr_ExceptionMatches(obj)
|
|
|
|
Higher level wrapper around PyErr_GivenExceptionMatches() which uses
|
|
PyErr_Occurred() as obj1. This will be the more commonly called
|
|
function.
|
|
|
|
- void PyErr_NormalizeException(typeptr, valptr, tbptr)
|
|
|
|
Normalizes exceptions, and places the normalized values in the
|
|
arguments. If type is not a class, this does nothing. If type is a
|
|
class, then it makes sure that value is an instance of the class by:
|
|
|
|
1. if instance is of the type, or a class derived from type, it does
|
|
nothing.
|
|
|
|
2. otherwise it instantiates the class, using the value as an
|
|
argument. If value is None, it uses an empty arg tuple, and if
|
|
the value is a tuple, it uses just that.
|
|
|
|
- Another new C API function: PyErr_NewException() creates a new
|
|
exception class derived from Exception; when -X is given, it creates a
|
|
new string exception.
|
|
|
|
- core interpreter: remove the distinction between tuple and list
|
|
unpacking; allow an arbitrary sequence on the right hand side of any
|
|
unpack instruction. (UNPACK_LIST and UNPACK_TUPLE now do the same
|
|
thing, which should really be called UNPACK_SEQUENCE.)
|
|
|
|
- classes: Allow assignments to an instance's __dict__ or __class__,
|
|
so you can change ivars (including shared ivars -- shock horror) and
|
|
change classes dynamically. Also make the check on read-only
|
|
attributes of classes less draconic -- only the specials names
|
|
__dict__, __bases__, __name__ and __{get,set,del}attr__ can't be
|
|
assigned.
|
|
|
|
- Two new built-in functions: issubclass() and isinstance(). Both
|
|
take classes as their second arguments. The former takes a class as
|
|
the first argument and returns true iff first is second, or is a
|
|
subclass of second. The latter takes any object as the first argument
|
|
and returns true iff first is an instance of the second, or any
|
|
subclass of second.
|
|
|
|
- configure: Added configuration tests for presence of alarm(),
|
|
pause(), and getpwent().
|
|
|
|
- Doc/Makefile: changed latex2html targets.
|
|
|
|
- classes: Reverse the search order for the Don Beaudry hook so that
|
|
the first class with an applicable hook wins. Makes more sense.
|
|
|
|
- Changed the checks made in Py_Initialize() and Py_Finalize(). It is
|
|
now legal to call these more than once. The first call to
|
|
Py_Initialize() initializes, the first call to Py_Finalize()
|
|
finalizes. There's also a new API, Py_IsInitalized() which checks
|
|
whether we are already initialized (in case you want to leave things
|
|
as they were).
|
|
|
|
- Completely disable the declarations for malloc(), realloc() and
|
|
free(). Any 90's C compiler has these in header files, and the tests
|
|
to decide whether to suppress the declarations kept failing on some
|
|
platforms.
|
|
|
|
- *Before* (instead of after) signalmodule.o is added, remove both
|
|
intrcheck.o and sigcheck.o. This should get rid of warnings in ar or
|
|
ld on various systems.
|
|
|
|
- Added reop to PC/config.c
|
|
|
|
- configure: Decided to use -Aa -D_HPUX_SOURCE on HP-UX platforms.
|
|
Removed outdated HP-UX comments from README. Added Cray T3E comments.
|
|
|
|
- Various renames of statically defined functions that had name
|
|
conflicts on some systems, e.g. strndup (GNU libc), join (Cray),
|
|
roundup (sys/types.h).
|
|
|
|
- urllib.py: Interpret three slashes in file: URL as local file (for
|
|
Netscape on Windows/Mac).
|
|
|
|
- copy.py: Make sure the objects returned by __getinitargs__() are
|
|
kept alive (in the memo) to avoid a certain kind of nasty crash. (Not
|
|
easily reproducable because it requires a later call to
|
|
__getinitargs__() to return a tuple that happens to be allocated at
|
|
the same address.)
|
|
|
|
- Added definition of AR to toplevel Makefile. Renamed @buildno temp
|
|
file to buildno1.
|
|
|
|
- Moved Include/assert.h to Parser/assert.h, which seems to be the
|
|
only place where it's needed.
|
|
|
|
- Tweaked the dictionary lookup code again for some more speed
|
|
(Vladimir Marangozov).
|
|
|
|
- NT build: Changed the way python15.lib is included in the other
|
|
projects. Per Mark Hammond's suggestion, add it to the extra libs in
|
|
Settings instead of to the project's source files.
|
|
|
|
- regrtest.py: Change default verbosity so that there are only three
|
|
levels left: -q, default and -v. In default mode, the name of each
|
|
test is now printed. -v is the same as the old -vv. -q is more quiet
|
|
than the old default mode.
|
|
|
|
- Removed the old FAQ from the distribution. You now have to get it
|
|
from the web!
|
|
|
|
- Removed the PC/make_nt.in file from the distribution; it is no
|
|
longer needed.
|
|
|
|
- Changed the build sequence so that shared modules are built last.
|
|
This fixes things for AIX and doesn't hurt elsewhere.
|
|
|
|
- Improved test for GNU MP v1 in mpzmodule.c
|
|
|
|
- fileobject.c: ftell() on Linux discards all buffered data; changed
|
|
read() code to use lseek() instead to get the same effect
|
|
|
|
- configure.in, configure, importdl.c: NeXT sharedlib fixes
|
|
|
|
- tupleobject.c: PyTuple_SetItem asserts refcnt==1
|
|
|
|
- resource.c: Different strategy regarding whether to declare
|
|
getrusage() and getpagesize() -- #ifdef doesn't work, Linux has
|
|
conflicting decls in its headers. Choice: only declare the return
|
|
type, not the argument prototype, and not on Linux.
|
|
|
|
- importdl.c, configure*: set sharedlib extensions properly for NeXT
|
|
|
|
- configure*, Makefile.in, Modules/Makefile.pre.in: AIX shared libraries
|
|
fixed; moved addition of PURIFY to LINKCC to configure
|
|
|
|
- reopmodule.c, regexmodule.c, regexpr.c, zlibmodule.c: needed casts
|
|
added to shup up various compilers.
|
|
|
|
- _tkinter.c: removed buggy mac #ifndef
|
|
|
|
- Doc: various Mac documentation changes, added docs for 'ic' module
|
|
|
|
- PC/make_nt.in: deleted
|
|
|
|
- test_time.py, test_strftime.py: tweaks to catch %Z (which may return
|
|
"")
|
|
|
|
- test_rotor.py: print b -> print `b`
|
|
|
|
- Tkinter.py: (tagOrId) -> (tagOrId,)
|
|
|
|
- Tkinter.py: the Tk class now also has a configure() method and
|
|
friends (they have been moved to the Misc class to accomplish this).
|
|
|
|
- dict.get(key[, default]) returns dict[key] if it exists, or default
|
|
if it doesn't. The default defaults to None. This is quicker for
|
|
some applications than using either has_key() or try:...except
|
|
KeyError:....
|
|
|
|
- Tools/webchecker/: some small changes to webchecker.py; added
|
|
websucker.py (a simple web site mirroring script).
|
|
|
|
- Dictionary objects now have a get() method (also in UserDict.py).
|
|
dict.get(key, default) returns dict[key] if it exists and default
|
|
otherwise; default defaults to None.
|
|
|
|
- Tools/scripts/logmerge.py: print the author, too.
|
|
|
|
- Changes to import: support for "import a.b.c" is now built in. See
|
|
http://grail.cnri.reston.va.us/python/essays/packages.html
|
|
for more info. Most important deviations from "ni.py": __init__.py is
|
|
executed in the package's namespace instead of as a submodule; and
|
|
there's no support for "__" or "__domain__". Note that "ni.py" is not
|
|
changed to match this -- it is simply declared obsolete (while at the
|
|
same time, it is documented...:-( ).
|
|
Unfortunately, "ihooks.py" has not been upgraded (but see "knee.py"
|
|
for an example implementation of hierarchical module import written in
|
|
Python).
|
|
|
|
- More changes to import: the site.py module is now imported by
|
|
default when Python is initialized; use -S to disable it. The site.py
|
|
module extends the path with several more directories: site-packages
|
|
inside the lib/python1.5/ directory, site-python in the lib/
|
|
directory, and pathnames mentioned in *.pth files found in either of
|
|
those directories. See
|
|
http://grail.cnri.reston.va.us/python/essays/packages.html
|
|
for more info.
|
|
|
|
- Changes to standard library subdirectory names: those subdirectories
|
|
that are not packages have been renamed with a hypen in their name,
|
|
e.g. lib-tk, lib-stdwin, plat-win, plat-linux2, plat-sunos5, dos-8x3.
|
|
The test suite is now a package -- to run a test, you must now use
|
|
"import test.test_foo".
|
|
|
|
- A completely new re.py module is provided (thanks to Andrew
|
|
Kuchling) which uses Philip Hazel's "pcre" re compiler and engine.
|
|
For a while, the "old" re.py (which was new in 1.5a3!) will be kept
|
|
around as re1.py. The "old" regex module and underlying parser and
|
|
engine are still present -- while regex is now officially obsolete, it
|
|
will probably take several major release cycles before it can be
|
|
removed.
|
|
|
|
- The posix module now has a strerror() function which translates an
|
|
error code to a string.
|
|
|
|
- The emacs.py module (which was long obsolete) has been removed.
|
|
|
|
- The universal makefile Misc/Makefile.pre.in now features an
|
|
"install" target. By default, installed shared libraries go into
|
|
$exec_prefix/lib/python$VERSION/site-packages/.
|
|
|
|
- The install-sh script is installed with the other configuration
|
|
specific files (in the config/ subdirectory).
|
|
|
|
- It turns out whatsound.py and sndhdr.py were identical modules.
|
|
Since there's also an imghdr.py file, I propose to make sndhdr.py the
|
|
official one. For compatibility, whatsound.py imports * from
|
|
sndhdr.py.
|
|
|
|
- Class objects have a new attribute, __module__, giving the name of
|
|
the module in which they were declared. This is useful for pickle and
|
|
for printing the full name of a class exception.
|
|
|
|
- Many extension modules no longer issue a fatal error when their
|
|
initialization fails; the importing code now checks whether an error
|
|
occurred during module initialization, and correctly propagates the
|
|
exception to the import statement.
|
|
|
|
- Most extension modules now raise class-based exceptions (except when
|
|
-X is used).
|
|
|
|
- Subtle changes to PyEval_{Save,Restore}Thread(): always swap the
|
|
thread state -- just don't manipulate the lock if it isn't there.
|
|
|
|
- Fixed a bug in Python/getopt.c that made it do the wrong thing when
|
|
an option was a single '-'. Thanks to Andrew Kuchling.
|
|
|
|
- New module mimetypes.py will guess a MIME type from a filename's
|
|
extension.
|
|
|
|
- Windows: the DLL version is now settable via a resource rather than
|
|
being hardcoded. This can be used for "branding" a binary Python
|
|
distribution.
|
|
|
|
- urllib.py is now threadsafe -- it now uses re instead of regex, and
|
|
sys.exc_info() instead of sys.exc_{type,value}.
|
|
|
|
- Many other library modules that used to use
|
|
sys.exc_{type,value,traceback} are now more thread-safe by virtue of
|
|
using sys.exc_info().
|
|
|
|
- The functions in popen2 have an optional buffer size parameter.
|
|
Also, the command argument can now be either a string (passed to the
|
|
shell) or a list of arguments (passed directly to execv).
|
|
|
|
|
|
- Alas, the thread support for _tkinter released with 1.5a3 didn't
|
|
work. It's been rewritten. The bad news is that it now requires a
|
|
modified version of a file in the standard Tcl distribution, which you
|
|
must compile with a -I option pointing to the standard Tcl source
|
|
tree. For this reason, the thread support is disabled by default.
|
|
|
|
- The errno extension module adds two tables: errorcode maps errno
|
|
numbers to errno names (e.g. EINTR), and errorstr maps them to
|
|
message strings. (The latter is redundant because the new call
|
|
posix.strerror() now does the same, but alla...) (Marc-Andre Lemburg)
|
|
|
|
- The readline extension module now provides some interfaces to
|
|
internal readline routines that make it possible to write a completer
|
|
in Python. An example completer, rlcompleter.py, is provided.
|
|
|
|
When completing a simple identifier, it completes keywords,
|
|
built-ins and globals in __main__; when completing
|
|
NAME.NAME..., it evaluates (!) the expression up to the last
|
|
dot and completes its attributes.
|
|
|
|
It's very cool to do "import string" type "string.", hit the
|
|
completion key (twice), and see the list of names defined by
|
|
the string module!
|
|
|
|
Tip: to use the tab key as the completion key, call
|
|
|
|
readline.parse_and_bind("tab: complete")
|
|
|
|
- The traceback.py module has a new function tb_lineno() by Marc-Andre
|
|
Lemburg which extracts the line number from the linenumber table in
|
|
the code object. Apparently the traceback object doesn't contains the
|
|
right linenumber when -O is used. Rather than guessing whether -O is
|
|
on or off, the module itself uses tb_lineno() unconditionally.
|
|
|
|
- Fixed Demo/tkinter/matt/canvas-moving-or-creating.py: change bind()
|
|
to tag_bind() so it works again.
|
|
|
|
- The pystone script is now a standard library module. Example use:
|
|
"import test.pystone; test.pystone.main()".
|
|
|
|
- The import of the readline module in interactive mode is now also
|
|
attempted when -i is specified. (Yes, I know, giving in to Marc-Andre
|
|
Lemburg, who asked for this. :-)
|
|
|
|
- rfc822.py: Entirely rewritten parseaddr() function by Sjoerd
|
|
Mullender, to be closer to the standard. This fixes the getaddr()
|
|
method. Unfortunately, getaddrlist() is as broken as ever, since it
|
|
splits on commas without regard for RFC 822 quoting conventions.
|
|
|
|
- pprint.py: correctly emit trailing "," in singleton tuples.
|
|
|
|
- _tkinter.c: export names for its type objects, TkappType and
|
|
TkttType.
|
|
|
|
- pickle.py: use __module__ when defined; fix a particularly hard to
|
|
reproduce bug that confuses the memo when temporary objects are
|
|
returned by custom pickling interfaces; and a semantic change: when
|
|
unpickling the instance variables of an instance, use
|
|
inst.__dict__.update(value) instead of a for loop with setattr() over
|
|
the value.keys(). This is more consistent (the pickling doesn't use
|
|
getattr() either but pickles inst.__dict__) and avoids problems with
|
|
instances that have a __setattr__ hook. But it *is* a semantic change
|
|
(because the setattr hook is no longer used). So beware!
|
|
|
|
- config.h is now installed (at last) in
|
|
$exec_prefix/include/python1.5/. For most sites, this means that it
|
|
is actually in $prefix/include/python1.5/, with all the other Python
|
|
include files, since $prefix and $exec_prefix are the same by
|
|
default.
|
|
|
|
- The imp module now supports parts of the functionality to implement
|
|
import of hierarchical module names. It now supports find_module()
|
|
and load_module() for all types of modules. Docstrings have been
|
|
added for those functions in the built-in imp module that are still
|
|
relevant (some old interfaces are obsolete). For a sample
|
|
implementation of hierarchical module import in Python, see the new
|
|
library module knee.py.
|
|
|
|
- The % operator on string objects now allows arbitrary nested parens
|
|
in a %(...)X style format. (Brad Howes)
|
|
|
|
- Reverse the order in which Setup and Setup.local are passed to the
|
|
makesetup script. This allows variable definitions in Setup.local to
|
|
override definitions in Setup. (But you'll still have to edit Setup
|
|
if you want to disable modules that are enabled by default, or if such
|
|
modules need non-standard options.)
|
|
|
|
- Added PyImport_ImportModuleEx(name, globals, locals, fromlist); this
|
|
is like PyImport_ImporModule(name) but receives the globals and locals
|
|
dict and the fromlist arguments as well. (The name is a char*; the
|
|
others are PyObject*s).
|
|
|
|
- The 'p' format in the struct extension module alloded to above is
|
|
new in 1.5a4.
|
|
|
|
- The types.py module now uses try-except in a few places to make it
|
|
more likely that it can be imported in restricted mode. Some type
|
|
names are undefined in that case, e.g. CodeType (inaccessible),
|
|
FileType (not always accessible), and TracebackType and FrameType
|
|
(inaccessible).
|
|
|
|
- In urllib.py: added separate administration of temporary files
|
|
created y URLopener.retrieve() so cleanup() can properly remove them.
|
|
The old code removed everything in tempcache which was a bad idea if
|
|
the user had passed a non-temp file into it. Also, in basejoin(),
|
|
interpret relative paths starting in "../". This is necessary if the
|
|
server uses symbolic links.
|
|
|
|
- The Windows build procedure and project files are now based on
|
|
Microsoft Visual C++ 5.x. The build now takes place in the PCbuild
|
|
directory. It is much more robust, and properly builds separate Debug
|
|
and Release versions. (The installer will be added shortly.)
|
|
|
|
- Added casts and changed some return types in regexpr.c to avoid
|
|
compiler warnings or errors on some platforms.
|
|
|
|
- The AIX build tools for shared libraries now supports VPATH. (Donn
|
|
Cave)
|
|
|
|
- By default, disable the "portable" multimedia modules audioop,
|
|
imageop, and rgbimg, since they don't work on 64-bit platforms.
|
|
|
|
- Fixed a nasty bug in cStringIO.c when code was actually using the
|
|
close() method (the destructors would try to free certain fields a
|
|
second time).
|
|
|
|
- For those who think they need it, there's a "user.py" module. This
|
|
is *not* imported by default, but can be imported to run user-specific
|
|
setup commands, ~/.pythonrc.py.
|
|
|
|
- Various speedups suggested by Fredrik Lundh, Marc-Andre Lemburg,
|
|
Vladimir Marangozov, and others.
|
|
|
|
- Added os.altsep; this is '/' on DOS/Windows, and None on systems
|
|
with a sane filename syntax.
|
|
|
|
- os.py: Write out the dynamic OS choice, to avoid exec statements.
|
|
Adding support for a new OS is now a bit more work, but I bet that
|
|
'dos' or 'nt' will cover most situations...
|
|
|
|
- The obsolete exception AccessError is now really gone.
|
|
|
|
- Tools/faqwiz/: New installation instructions show how to maintain
|
|
multiple FAQs. Removed bootstrap script from end of faqwiz.py module.
|
|
Added instructions to bootstrap script, too. Version bumped to 0.8.1.
|
|
Added <html>...</html> feature suggested by Skip Montanaro. Added
|
|
leading text for Roulette, default to 'Hit Reload ...'. Fix typo in
|
|
default SRCDIR.
|
|
|
|
- Documentation for the relatively new modules "keyword" and "symbol"
|
|
has been added (to the end of the section on the parser extension
|
|
module).
|
|
|
|
- In module bisect.py, but functions have two optional argument 'lo'
|
|
and 'hi' which allow you to specify a subsequence of the array to
|
|
operate on.
|
|
|
|
- In ftplib.py, changed most methods to return their status (even when
|
|
it is always "200 OK") rather than swallowing it.
|
|
|
|
- main() now calls setlocale(LC_ALL, ""), if setlocale() and
|
|
<locale.h> are defined.
|
|
|
|
- Changes to configure.in, the configure script, and both
|
|
Makefile.pre.in files, to support SGI's SGI_ABI platform selection
|
|
environment variable.
|