Upgrade pydoctor and fix nexus docs

Author: VegetarianOrc

pyproject.toml

@@ -44,7 +44,7 @@ dev = [
   "mypy-protobuf>=3.3.0,<4",
   "psutil>=5.9.3,<6",
   "pydocstyle>=6.3.0,<7",
-  "pydoctor>=24.11.1,<25",
+  "pydoctor>=25.10.1,<26",
   "pyright==1.1.403",
   "pytest~=7.4",
   "pytest-asyncio>=0.21,<0.22",

temporalio/nexus/__init__.py

@@ -6,15 +6,28 @@
 See https://github.com/temporalio/sdk-python/tree/main#nexus
 """
 
-from ._decorators import workflow_run_operation as workflow_run_operation
-from ._operation_context import Info as Info
-from ._operation_context import LoggerAdapter as LoggerAdapter
-from ._operation_context import NexusCallback as NexusCallback
+from ._decorators import workflow_run_operation
 from ._operation_context import (
-    WorkflowRunOperationContext as WorkflowRunOperationContext,
+    Info,
+    LoggerAdapter,
+    NexusCallback,
+    WorkflowRunOperationContext,
+    client,
+    in_operation,
+    info,
+    logger,
+)
+from ._token import WorkflowHandle
+
+__all__ = (
+    "workflow_run_operation",
+    "Info",
+    "LoggerAdapter",
+    "NexusCallback",
+    "WorkflowRunOperationContext",
+    "client",
+    "in_operation",
+    "info",
+    "logger",
+    "WorkflowHandle",
 )
-from ._operation_context import client as client
-from ._operation_context import in_operation as in_operation
-from ._operation_context import info as info
-from ._operation_context import logger as logger
-from ._token import WorkflowHandle as WorkflowHandle

temporalio/nexus/_operation_context.py

@@ -23,8 +23,12 @@
 import temporalio.api.common.v1
 import temporalio.api.workflowservice.v1
 import temporalio.common
-from temporalio.nexus import _link_conversion
-from temporalio.nexus._token import WorkflowHandle
+from ._link_conversion import (
+    nexus_link_to_workflow_event,
+    workflow_execution_started_event_link_from_workflow_handle,
+    workflow_event_to_nexus_link,
+)
+from ._token import WorkflowHandle
 from temporalio.types import (
     MethodAsyncNoParam,
     MethodAsyncSingleParam,
@@ -162,7 +166,7 @@ def _get_workflow_event_links(
     ) -> list[temporalio.api.common.v1.Link.WorkflowEvent]:
         event_links = []
         for inbound_link in self.nexus_context.inbound_links:
-            if link := _link_conversion.nexus_link_to_workflow_event(inbound_link):
+            if link := nexus_link_to_workflow_event(inbound_link):
                 event_links.append(link)
         return event_links
 
@@ -182,14 +186,13 @@ def _add_outbound_links(
                             wf_event_links.append(link.workflow_event)
             if not wf_event_links:
                 wf_event_links = [
-                    _link_conversion.workflow_execution_started_event_link_from_workflow_handle(
+                    workflow_execution_started_event_link_from_workflow_handle(
                         workflow_handle,
                         self.nexus_context.request_id,
                     )
                 ]
             self.nexus_context.outbound_links.extend(
-                _link_conversion.workflow_event_to_nexus_link(link)
-                for link in wf_event_links
+                workflow_event_to_nexus_link(link) for link in wf_event_links
             )
         except Exception as e:
             logger.warning(