Repository navigation
Documentation for Edge is incomplete #813
Description
Activity
This issue has been automatically marked as stale because it has not had recent activity. It will be closed in 14 days if no further activity occurs. Thank you for your contributions.
Any updates?
I took a look at this now; apparently it seems that
pydoctordoes not recognize properties defined in classes implemented in C code automatically as it relies on parsing the Python source of the class, which is not accessible in this case. I'll check whether there's a way to tell PyDoctor the list of properties explicitly.Unfortunately this seems to be an issue with
pydoctor.pydoctorusesobj.__dict__.items()to iterate over all the members of a class to find out which ones are to be documented. The items that are missing from the documentation never appear inobj.__dict__, and even adding them manually to the class docstring with@ivardoes not seem to help - the list of items to be documented in a class is still decided byobj.__dict__.items().The only option that we have right now (without patching
pydoctor) would be to just document the missing attributes in the class docstring in plain text. They would not appear in the list of class members but at least they would be mentioned in the HTML docs. Would that be OK for you?Yes, that would be an improvement over the current situation, where the functions are not discoverable from the documentation alone so the reader would not know what he is missing.
Adding
@ivarfields in the class docstring should create attribute entries for these names. If you think you've hit a bug in pydoctor , please open an issue! Thanks- added a commit that references this issue
on Jul 6, 2025
Describe the bug
The documentation for Edge (https://python.igraph.org/en/main/api/igraph.Edge.html) is incomplete. It fails to mention
source,target,tuple,graph,index,source_vertexat all, among other things.To reproduce
Just view the documentation page at the URL.
Version information
Latest or stable.