[Docstring-develop] pydps - nothing very exciting

[Tony J I. (Tibs) <to...@ls...>]

Ho hum, bla bla,

     	http://www.tibsnjoan.co.uk/reST/pydps.tgz

I finally fixed the stupid bugs I'd left in sorting out the left
alignment of docstrings (before they get handed to DPS). That's what I
get for programming before bedtime.

The "dumb" HTML formatter is now working, and is split into a Writer
class (which knows about some of the DPS nodes) and a PythonWriter
subclass (which knows about some of the Python "outer level"
infrastructure).

It handles enough of reST to be usefully run on its own modules
(packages aren't supported yet, I'm afraid) and get a reasonably
coherent result.

I seriously like the paradigm of "instantiate a Writer class once and
then call it as needed" - this allows good encapsulation of the baggage
one wants to define only once for a multiplicity of documents, and also
allows one to reduce the number of arguments to the "write" call without
needing scads of optional arguments. I still remember how neat I
realised the __call__ method was when I finally internalised its use.

Speaking of which (hmm - this is probably a Doc-SIG question, but
still), which "special" (i.e., __xxx__) methods do we want to *normally*
report on with DPS? Obviously __init__ and __call__ are extra special,
since their arguments matter. (of course, *removing* things from the
output is unlikely to happen until a long way down the line - so it's
not a decision that's needed Real Soon Now).

Next thing is to transfer more information across from visit.py (where I
remember the information derived from the AST) to nodes.py (where I
place it into a DPS nodes tree) and thus make it available to html.py
(for presentation).

[of course, the school year has now started again, so mornings are now
more rushed getting Michael to school, and evenings have less time, so
Glacial Software Development is back in action, I'm afraid...]

Tibs

(ps: thanks for the nightly tarballs - that makes my life a LOT neater -
a couple of times I've noticed a bug, and magically had it go away the
next day - great stuff!)

--
Tony J Ibbs (Tibs)      http://www.tibsnjoan.co.uk/
You said "run as root" and "securely" in the same sentence relating to
CGI. You're funny! -- Ignacio Vazquez-Abrams, on the Python list
My views! Mine! Mine! (Unless Laser-Scan ask nicely to borrow them.)