converted to 1.6 markup
|Deletions are marked like this.||Additions are marked like this.|
|Line 94:||Line 94:|
|Move four commands from setuptools into the Distutils: see [http://mail.python.org/pipermail/python-dev/2006-April/064150.html Philip Eby's python-dev post] for details.||Move four commands from setuptools into the Distutils: see [[http://mail.python.org/pipermail/python-dev/2006-April/064150.html|Philip Eby's python-dev post]] for details.|
These are straightforward, finite-effort coding or writing projects.
The Py_VISIT() macro in objimpl.h was introduced to make coding of most tp_traverse slots straightforward, uniform, and obviously correct. For example, see cycle_traverse() in itertoolsmodule.c. Most older modules that define tp_traverse copy/paste/edit the tedious callback dance by hand, and several even define their own work-alike macros. These should be rewritten to use the standard Py_VISIT macro.
The Py_CLEAR macro in object.h was introduced to make coding of "decref and NULL out a containee pointer" operations safe. The reasons for why this is important but tricky to achieve are explained in a comment block before that macro in current trunk source. tp_clear and even tp_dealloc slot implementations should generally use Py_CLEAR now.
Clean up 64-bit compiler warnings
There are many 64-bit warnings produced by icc when using the -Wp64 flag. icc is freely available for a one month trial license. NealNorwitz has a license and can make the warnings available on the web if anyone is interest in getting rid of these warnings. In addition, there is a patch to gcc to produce such warnings.
Make modules Py_ssize_t clean
Some modules don't use Py_ssize_t. They need a code review. Any module which declares an int (rather than a Py_ssize_t) for size and passes its address to PyArgs_ParseTuple(args, "s#", &str, &size) needs to be updated. An example of a module that has already been updated is Modules/_codecsmodule.c
Check for consistent memory API usage
Verify that if PyMem_* APIs are used to (re)allocate memory, that PyMem_* APIs are used to free memory. Same deal with PyObject_* APIs. (ie, ensure that PyMem_* and PyObject_* memory APIs aren't mixed.)
Verify all int/long C APIs are correct
With the conversion to use Py_ssize_t, it's important that we didn't miss any APIs. There are very few APIs which take (or return) a long. But there are still quite a few that take/return an int. All of these are believed to be correct, but more reviewers could help. Any API which returns an int is fine if the value is known to fit in 32 bits (like APIs that return a value between -2 and 2).
Add Py_LOCAL, Py_LOCAL_INLINE declarations
At the NeedForSpeed sprint, these macros were added to use a faster calling convention on Windows. There are probably many modules where these macros could be used.
Currently these macros only make a difference on Windows. Are there other pragmas that could be used with GCC or other compilers?
Py_MEMCPY can be used instead of memcpy in cases where the copied blocks are often very short. While most platforms have highly optimized code for large transfers, the setup costs for memcpy are often quite high. MEMCPY solves this by doing short copies "in line".
Using this macro gave a 20% speed improvement to some string functions. Are there other uses of memcpy() in CPython that would also benefit?
Update Demo/ and Tools/ directories
PEP 356 says "Check the various bits of code in Demo/ all still work, update or remove the ones that don't."
Directories to check:
cgi classes comparisons embed imputil md5test metaclasses newmetaclasses parser pdist pysvr rpc scripts sockets threads tix tix/bitmaps tix/samples tkinter tkinter/guido tkinter/matt xml
QUESTION: Should it just be made sure that the demos and examples are working or should they be updated to use the newest applicable Python features (e.g. the new any/all functions)?
Create tests for sequences over 2GB
It would be great if someone could try to put together some tests for bigmem machines. The tests should be broken up by those that require 2+ GB of memory, those that take 4+, etc. Many people won't have boxes with that much memory. Ultimately, the tests should be incorporated into the test suite with a special designation similar to -u all. I'm thinking -G # where # is the size of RAM in GB.
The test cases should test all methods (don't forget slicing operations) at boundary points, particularly just before and after 2GB. Strings are probably the easiest. There's unicode too. lists, dicts are good but will take more than 16 GB of RAM, so those can be pushed out some.
update the stdlib
For instance, most uses of "print" in the stdlib should probably be replaced by logging -- and adding a few extra logging calls wouldn't be a bad idea. Don't forget the tests... (I'd be at most -0 on this. In my experience the logging module isn't very efficient. Wholesale replacement of the print statement should consider this. I'd be more in favor of making sure print to stdout isn't hard-coded. -- SkipMontanaro)
Move four commands from setuptools into the Distutils: see Philip Eby's python-dev post for details.
[ImprovingLibTests] -- describes test suite improvements
Update the PerlPhrasebook for the current state of Python and Perl.
Write a Java or Ruby phrasebook.
Clean up the organization of database-related pages in the wiki.