Re: [Epydoc-devel] AttributeError: _Sentinel instance has no attribute '__getitem__'

[Daniele V. <pi...@de...>]

> On 3/29/07, Daniele Varrazzo <pi...@de...> wrote:
>> This bug has been already reported in the tracker, but i wasn't able to
>> reproduce it yet.
>>
>> Is the package you are documenting available on the web or is a private
>> project?
>
> It's a private project (for the moment at least - if only because the
> documentation is so poor!).
>
>> What is the command line you are using?
>
> epydoc --debug --output auto-doc/  npyscreen/
>
> (npyscreen is the name of the package)
>
>
>> > Warning: Module npyscreen.ActionForm is shadowed by a variable with the
>> >          same name.
>>
>> Correct me: in your package there is a module named "ActionForm.py"
>> containing a class named "ActionForm"? I suspect that this kind of errors
>> (and so issues like #1682525) are caused by a name clash like this, but i
>> don't have a test case yet (the people who reported the issue above gave
>> me
>> one, but i have to setup a VM to test it and i haven't had the time to do
>> that yet).
>
> Yes, there is.  I assume that the error is being caused by the fact that the
> __init__.py file for the package does things like the following to
> expose an API:
>
> from ActionForm import ActionForm

Great, i'll focus on this issue and try to crash Epydoc like this :)

>> To work around the bug you may try to --introspect-only or --parse-only.
>> Please, report success/failures of doing this.
>
> --introspect-only fails with the same error

Ok, this further narrows where to look for troubles.

> --parse-only works perfectly, and doesn't give the warnings above.
> Instead I get the output I've printed below (minor warnings).

Those warnings are only about bad Epytext docstring. By default Epydoc
expects doctrings formatted in the Epytext markup language, which is widely
documented in the manual. You may also choose different markups;
specifically, if you want Epydoc to assume no markup, use the
--docformat=plaintext command line switch.

Thank you very much for the report: i will try to fix the bug and release a
beta2 version soon (many bugs have been reported and most of them have been
fixed since the beta1 was released).

-- 
Daniele Varrazzo - Develer S.r.l.
http://www.develer.com