Open hdiogenes opened 4 years ago
By commenting the line 5 of docs Makefile SPHINXOPTS = -W
you've got those warnings:
WARNING: error while formatting signature for pyof.foundation.base.GenericBitMask: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: maximum recursion depth exceeded while calling a Python object)
WARNING: error while formatting signature for pyof.v0x01.common.action.ActionType: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.common.flow_match.FlowWildCards: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.common.phy_port.PortConfig: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.common.phy_port.PortFeatures: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.common.phy_port.PortState: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.controller2switch.features_reply.Capabilities: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x01.controller2switch.flow_mod.FlowModFlags: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
/home/barbara/github/python-openflow/pyof/v0x04/common/flow_match.py:docstring of pyof.v0x04.common.flow_match.Match.get_field:5: WARNING: Field list ends without a blank line; unexpected unindent.
WARNING: error while formatting signature for pyof.v0x04.common.port.PortConfig: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.common.port.PortFeatures: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.common.port.PortState: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.controller2switch.features_reply.Capabilities: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.controller2switch.flow_mod.FlowModFlags: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.controller2switch.meter_mod.MeterFlags: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
WARNING: error while formatting signature for pyof.v0x04.controller2switch.multipart_reply.GroupCapabilities: Handler <function record_typehints at 0x7f55f56d65e0> for event 'autodoc-process-signature' threw an exception (exception: '__signature__')
Which leads to remove the inheritance of metaclass=MetaBitMask
from GenericBitMask
, what reduces significantly the amount of warnings. Maybe this could mean that the problem is in the meta class MetaBitMask
.
After that, the only warning that is left is this:
pyof/v0x04/common/flow_match.py:docstring of pyof.v0x04.common.flow_match.Match.get_field:5: WARNING: Field list ends without a blank line
@Niehaus, please make a PR just commenting the SPHINXOPTS line and upgrading sphinx, then we can try to solve the metaclass problem later.
Older versions work: