What version of epydoc needed to create api documentation for bazaar?

[John Arbash Meinel]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Alexander Belchenko wrote:
> John, I think question in subj is mainly addressed to you.
> 
> I can't successfully run epydoc on bzrlib:
> 
> E:\work\bzr.dev>python tools/bzr_epydoc --html --docformat 'restructuredtext en' bzrlib
> Traceback (most recent call last):
>   File "tools/bzr_epydoc", line 9, in ?
>     import bzr_epydoc_uid
>   File "E:\work\bzr.dev\tools\bzr_epydoc_uid.py", line 19, in ?
>     import epydoc.uid
> ImportError: No module named uid
> 
> E:\work\bzr.dev>epydoc --version
> Epydoc, version 3.0beta1
> 
> 
> [µ]


I'm using epydoc 2.1. I thought I had tried with at least one of the 3.0 beta
versions, but they probably changed the structuring in their code.

You can try skipping some of those imports, but most likely we just need to
patch epydoc in a different way (so that it can know a bit more about Lazy
objects.)

I don't have time right now to verify against epdoc 3.0. I don't know all the
tricks that they may have included for finding an object. But the basic need is
to just check that if an object is a bzrlib.lazy_import.ScopeReplacer, then you
want to grab the real object with object.__getattribute__(obj, '_real_obj')

You have to go through object.__getattribute__ or you will trigger the
ScopeReplacer code.

John
=:->
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.7 (Darwin)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGn31HJdeBCYSNAAMRAin7AJ9b/4KofjVFWFXCnT864hjUESCaTgCgnTBl
sbxNdUGwGBzn6PfVuQVSivQ=
=5ftv
-----END PGP SIGNATURE-----