[Twisted-web] Re: Actual Useful Post
mwh at python.net
Tue Jan 24 02:32:14 MST 2006
Christopher Armstrong <radeex at gmail.com> writes:
> On 1/23/06, Michael Hudson <mwh at python.net> wrote:
>> Well, I've had a quick pop at the interesting bit of this task while
>> travelling over the weekend: using the compiler module I can extract
>> the docstrings and class hierachy of all the stuff in the Twisted
>> source. It's a touch fragile, but seems to work for all the
>> constructions used by Twisted.
>> One issue is classes that are defined in one file but generally used
>> from another, for example twisted.spread.jelly.Serializable is often
>> (always?) imported as twisted.spread.pb.Serializable. Where should it
>> be documented it?
>> The boring bit of the task (for me, at least) is HTML generation. I'd
>> love some help with this :) I guess I should get on IRC and talk about
>> what people actually want/need from these tools, but I'm at a PyPy
>> sprint this week so I'm *slightly* busy...
> Funny, I wrote a doc extractor over the weekend too ;-) It's currently
> at 104 lines and sitting in sandbox/radix/extractdocs.py. Where's
Mine's a bit more over-engineered, a bit longer, makes an effort to
work out class's bases and only on my hard drive... or rather, it's here:
> As for HTML output, I'm thinking outputting to Effbot's new Pyref
> format would be really cool (and really easy), if he releases the
> tools soon.
> 1: http://effbot.org//zone/pythondoc-lib.htm
I haven't looked at this yet...
When physicists speak of a TOE, they don't really mean a theory
of *everything*. Taken literally, "Everything" covers a lot of
ground, including biology, art, decoherence and the best way to
barbecue ribs. -- John Baez, sci.physics.research
More information about the Twisted-web