Work in progress

To do

Next release (2.0a3)

node.xml_write and node.xml_encode -- Completed by amk
XHTML writer
accumulated fixes
example or demo of XML parsing from incremental feed
Windows build by user with Microsoft compiler or 32-bit MinGW
Available Windows installer in 32-bit and 64-bit

Note: we've already moved the test suite to nose, and moved the main code source dir from amara to lib.

Longer term

Make XPath even more lazy (i.e. full expression results lazy iterators rather than just internal steps)

Post 2.0

Consider subclassing XSLT instruction nodes from core Amara nodes
* Refactor XSLT instruction node API to match core Amara nodes (e.g. appendChild -> xml_append_child)
Rename core nodes Document to Entity and update the API, along the lines of DOM Level 3

General notes

Follow PEP 8 for the most part. Modified naming conventions:

public, global constants: SPAM_EGGS
Exception classes: SpamError, all derived from amara.Error
Everything else: spam_eggs (yes, even class names)

Mercurial

See Akara/Developer_notes/Mercurial

Releases

Amara2/Release_process

Test sandbox

There are some instructions for setting up separated Amara 2.x installs at: Amara/Quick_start

You should probably rename the local folder to reflect the branch, and make sure you edit its .hg/hgrc to make its default destination the branch rather than main

Debugging tips

"finding memory leak in edgewall trac 0.11" - Has many general notes for memory leak finding in protocol servers

Profiling

To run a script file and gather the stats:

python -m cProfile -o <statsfile> <scriptfile>

For an interactive profile statistics browser:

python -m pstats <statsfile>

e.g.:

echo "from amara import bindery; bindery.parse('http://intertwingly.net/blog/index.atom')" > /tmp/foo.py
python -m cProfile -o /tmp/foo.stats.txt /tmp/foo.py
python -m pstats /tmp/foo.stats.txt

Some useful commands in the browser:

sort cumulative
stats 10

i18n

Start by following the example of OLPC: http://wiki.laptop.org/go/Python_i18n

In particular make sure all display strings are wrapped for l10n, and we'll figure out the framework as needed.

Amara2/Developer_notes