← Back to team overview

launchpad-dev team mailing list archive

Re: Would you like to have zope's apidoc for Launchpad?

 

On Tue, 2010-07-20 at 23:12 +0200, Guilherme Salgado wrote:
> On Mon, 2010-07-19 at 10:05 +0200, Guilherme Salgado wrote:
> > Hi there,
> > 
> > In case you haven't seen http://apidoc.zope.org I strongly suggest you
> > check it out -- it's very convenient for us using zope3/ztk.  
> > 
> > I've been trying to get that to work on Launchpad (at
> > apidoc.launchpad.dev) so that we can easily find out how to use zcml
> > declarations, what classes implement a given interface, what are the
> > pages registered for that interface and so on. Most things are working
> > (except for the Books section, which we don't care about anyway), but
> > there are still a few hacks that need to be tweaked before they can be
> > accepted into mainline, and I'm at yet another sprint this week and on
> > vacation after that so I won't have time to work on it anytime soon. If
> > you are interested in having apidoc working for Launchpad, I'd really
> > appreciate your help finishing up. My branch is at
> > lp:~salgado/launchpad/apidoc and here's a list of the things that need
> > fixing:
> > 
> >  1. Move changes done to site.py into 
> >     configs/development/apidoc-configure-normal.zcml.OFF
> > 
> >  2. lib/canonical/launchpad/webapp/authentication.py has a
> >     non-persistent IAnnotations adapter for our principals which might
> >     be acceptable into mainline as the lack of persistence only means
> >     we don't save user preferences on apidoc.lp.dev
> > 
> >  3. lib/canonical/launchpad/webapp/authorization.py is the ugliest hack
> >     but Gary said he'd be happy if it would special case just the
> >     specific object type that causes us problems (LocationProxy) instead
> >     of catching TypeErrors for everything.
> 
> I wrote this in a rush and forgot about the real issues:
> 
>   4. The newly added apidoc.txt test fails and I have no idea why
> because it just loads apidoc.lp.dev, which works fine when not running
> the tests

This test no longer gives a 404 when accessing apidoc.lp.dev and I've
moved the zcml includes to
configs/development/apidoc-config-overrides.zcml

> 
>   5. One of the new eggs required to make zope.app.apidoc work caused
> our +basiclogin page to stop working -- it OOPSes.  I don't have the
> traceback handy, but it's a failure to adapt the principal into
> something.

This is actually a failure to adapt the request into ILoginPassword:
http://paste.ubuntu.com/466905/


-- 
Guilherme Salgado <https://launchpad.net/~salgado>

Attachment: signature.asc
Description: This is a digitally signed message part


References