[Zope3-dev] More questions about Configuration system

[Jim Fulton]

R. David Murray wrote:
> INonEmptyDirective's __call__ method says it returns an
> IComplexDirectiveHandler.  But I can't find IComplexDirectiveHandler
> anywhere (though several tests do talk about testing complex
> directives).   Is this a todo, or a doc error?

It's a doc error, which I just fixed.

> Looking at the fact that IEmptyDirective and ISubdirectiveHandler
> (at least) both reference the "list of actions" data structure,
> and that there is a function Action that builds and returns
> an Action tuple,

The Action function was a reaction to the difficulty in spelling and
reading sequences of tuples.

 > it looks to my naive eyes like there might be
> a place for an Action class with a corresponding Interface.

Maybe, but that would be a large refactoring and wouldn't really
change things all that much.

> Is there a reason for not having one,  or did using an Action
> class (whose Interface might just be a Schema) just seem like
> overkill?

I think it would be overkill.

> I'm thinking that I should try to write a tool that reads the meta
> configuration stuff and makes sure that there are files in
> doc/zcml/namespaces.zope.org that describe all the defined directives.
> But *that* makes me speculate about putting the documentation info
> into the meta.zcml files.  Am I crazy?

No, however, if you did the later, you might want a tool to create
configuration documentation from the configuration files, as the configuration
files would not make a very friendly documentation interface.

Jim

-- 
Jim Fulton           mailto:jim@zope.com       Python Powered!
CTO                  (888) 344-4332            http://www.python.org
Zope Corporation     http://www.zope.com       http://www.zope.org