Improving Pydoc and submitting changes:)

M.E.Farmer mefjr75 at hotmail.com
Mon Oct 18 13:50:47 EDT 2004


Hello again!,
    I just wanted to start off saying I love this newsgroup!
Everytime I have an idea someone seems to post on it, or about it.
The word for today is **Synchronicity** !
    The reason for this post is to talk about pydoc. 
I have been writing a module that colorizes source code,
and have hoped to make it work with pydoc.
I saw a thread 2 days ago about pydoc and firefox having issues.
(Actually all Mozilla based browsers ignore 'file//:' type links.
It seems they see some security issues with local file access.
They list it as designed and won't fix it.)
In true C.L.PY fashion someone already had a fix for pydoc!
The amazing part is that piece of code is **exactly** what I needed.
Thank you Jeff Epler for that timesaver.
    Basically I have taken Jeff's patch and extended it.
I modified a copy of python 2.2 pydoc.py and python 2.4 pydoc.py .
It now serves up files as plain txt and colorized html instead of local linking.
Solves the Mozilla issue, which to me seems like it needs to be addressed,
for all the non I.E. users out there.
    Please kick the tires and give me some feedback. 
all you need is PySourceColor ver 1.8 or up and the patched pydoc for your version .
You can get them from here 'http://bellsouthpwp.net/m/e/mefjr75/'
I don't have python 2.3 version of pydoc , I will add it later if needed.

How to get it working:
    1)Remember to backup your old pydoc first so you can revert if you want to.
    2)Put both files in your Lib folder (PySourceColor and the modified pydoc).
    3)Start pydoc (python pydoc.py -g)
    4)Click a module and look to the top-right at the links.
    5)Click the bottom link. You should get served on-the-fly colorized code!

What I want to know is:
    *Sorry if these questions are obvious*
    Does anybody even care?
    Why does pydoc handle .pyw files diffrently?
    What does it need to make it better?
    What functions do you need added to PySourceColor?( example: Str2Tmpfile )
    What do I do to get these in the standard library, do I write a PEP:
      1) PySourcColor  .... It was designed to be standalone or modular
      2) pydoc changes .... Jeff Epler may have already submitted some of this
                            I used his patch as a starting point.
Thanks for your time,
    M.E.Farmer



More information about the Python-list mailing list