Re: [Epydoc-devel] Epydoc crashes

[Edward L. <ed...@br...>]

On Tue, Sep 23, 2008 at 10:09 AM, Damien Boucard - UbiCast
<dam...@ub...> wrote:
> An unhandled python exception crashes Epydoc command (during source
> parsing, I guess).

Yep, anytime epydoc crashes, that's a bug in epydoc. :)  In this case,
epydoc is making assumptions about what the value of __all__ will look
like that may not always be true..  In particular, it's assuming that
it will contain a list or tuple of strings.  In contrast, your module
says:

__all__ = ("global_skin")

which is actually equivalent to:

__all__ = "global_skin"

(i.e., you're assigning a string value to __all__, not a list or tuple
-- remember, it's the comma(s) that makes a tuple, not the
parentheses.)  Apparently Python is happy with this and does the right
thing, but epydoc doesn't.  If you just want epydoc to work on your
file, then change that line to:

__all__ = ("global_skin",)

(Note the comma.)  But this is also something that should get fixed in
epydoc, so I'll add a bug report for it to the epydoc bug tracker on
sourceforge.

-Edward