Locate api documentation from interface base classes
Affects | Status | Importance | Assigned to | Milestone | |
---|---|---|---|---|---|
pydoctor |
Fix Released
|
Undecided
|
Unassigned |
Bug Description
In
* https:/
getHostByName comes from IResolverSimple which is a base class of IResolver
Pydoctor only seems to include documentation from IResolver not the base class.
There is a way to enumerate the attributes of interface base classes described here...
* http://
* http://
{{{
names(all=False)
Get the interface attribute names
Return a sequence of the names of the attributes, including methods, included in the interface definition.
Normally, only directly defined attributes are included. If a true positional or keyword argument is given, then attributes defined by base classes will be included.
}}}
...which might be relevant.
Changed in pydoctor: | |
status: | New → Fix Committed |
Changed in pydoctor: | |
status: | Fix Committed → Fix Released |
The point here is that ResolverBase does not implement any interfaces, so there's no way that pydoctor can know where to get the interface docs from.
There is also a hilarious typo (missing @) at http:// twistedmatrix. com/trac/ browser/ trunk/twisted/ names/client. py#L34:
34 implementer( interfaces. IResolver) common. ResolverBase) :
35 class Resolver(
which I guess I should report in Twisted trac, but I don't think this affects my point above.