Skip to content

Add test utility to create Nexus endpoint #1279

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Quinn-With-Two-Ns wants to merge 2 commits into
base: main
Choose a base branch
from
Open

Add test utility to create Nexus endpoint #1279

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
71c8912
Add utility to create Nexus endpoint
Quinn-With-Two-Ns Jan 16, 2026
4d747a8
Merge branch 'main' into SDK-3837
THardy98 Feb 3, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
44 changes: 44 additions & 0 deletions temporalio/testing/_workflow.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@
import google.protobuf.empty_pb2
from typing_extensions import Self

import temporalio.api.nexus.v1
import temporalio.api.operatorservice.v1
import temporalio.api.testservice.v1
import temporalio.bridge.testing
import temporalio.client
Expand Down Expand Up @@ -401,6 +403,48 @@ def supports_time_skipping(self) -> bool:
"""Whether this environment supports time skipping."""
return False

async def create_nexus_endpoint(
self, endpoint_name: str, task_queue: str
) -> temporalio.api.nexus.v1.Endpoint:
"""Create a Nexus endpoint with the given name and task queue.

Args:
endpoint_name: The name of the Nexus endpoint to create.
task_queue: The task queue to associate with the endpoint.

Returns:
The created Nexus endpoint.
"""
response = await self._client.operator_service.create_nexus_endpoint(
temporalio.api.operatorservice.v1.CreateNexusEndpointRequest(
spec=temporalio.api.nexus.v1.EndpointSpec(
name=endpoint_name,
target=temporalio.api.nexus.v1.EndpointTarget(
worker=temporalio.api.nexus.v1.EndpointTarget.Worker(
namespace=self._client.namespace,
task_queue=task_queue,
)
),
)
)
)
return response.endpoint
Comment on lines +406 to +431
Copy link
Contributor

@VegetarianOrc VegetarianOrc Feb 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good to me, but we should make sure that tests/helpers/nexus.py::create_nexus_endpoint is removed and this is used throughout.


async def delete_nexus_endpoint(
self, endpoint: temporalio.api.nexus.v1.Endpoint
) -> None:
"""Delete a Nexus endpoint.

Args:
endpoint: The Nexus endpoint to delete.
"""
await self._client.operator_service.delete_nexus_endpoint(
temporalio.api.operatorservice.v1.DeleteNexusEndpointRequest(
id=endpoint.id,
version=endpoint.version,
)
)

@contextmanager
def auto_time_skipping_disabled(self) -> Iterator[None]:
"""Disable any automatic time skipping if this is a time-skipping
Expand Down
37 changes: 25 additions & 12 deletions tests/nexus/test_workflow_caller.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,7 +68,7 @@
)
from tests.helpers import find_free_port, new_worker
from tests.helpers.metrics import PromMetricMatcher
from tests.helpers.nexus import create_nexus_endpoint, make_nexus_endpoint_name
from tests.helpers.nexus import make_nexus_endpoint_name
Copy link

@cursor cursor bot Feb 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Removed import but usages remain causing NameError

High Severity

The import of create_nexus_endpoint from tests.helpers.nexus was removed, but there are still 4 usages of this function in the file at lines 802, 847, 881, and 2145. These tests (test_start_operation_headers, test_workflow_run_operation_headers, test_cancel_operation_headers, and another test) would fail with NameError: name 'create_nexus_endpoint' is not defined when run. These usages need to be updated to use env.create_nexus_endpoint(endpoint_name, task_queue) like the other tests.

Additional Locations (2)

Fix in Cursor Fix in Web


# TODO(nexus-preview): test worker shutdown, wait_all_completed, drain etc

Expand Down Expand Up @@ -603,7 +603,8 @@ async def test_sync_operation_happy_path(client: Client, env: WorkflowEnvironmen
task_queue=task_queue,
workflow_failure_exception_types=[Exception],
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
wf_output = await client.execute_workflow(
CallerWorkflow.run,
args=[
Expand Down Expand Up @@ -640,7 +641,8 @@ async def test_workflow_run_operation_happy_path(
task_queue=task_queue,
workflow_failure_exception_types=[Exception],
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
wf_output = await client.execute_workflow(
CallerWorkflow.run,
args=[
Expand Down Expand Up @@ -930,7 +932,8 @@ async def test_sync_response(
task_queue=task_queue,
workflow_failure_exception_types=[Exception],
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
caller_wf_handle = await client.start_workflow(
CallerWorkflow.run,
args=[
Expand Down Expand Up @@ -1004,6 +1007,7 @@ async def test_async_response(
workflow_failure_exception_types=[Exception],
):
caller_wf_handle, handler_wf_handle = await _start_wf_and_nexus_op(
env,
client,
task_queue,
exception_in_operation_start,
Expand Down Expand Up @@ -1076,6 +1080,7 @@ async def test_async_response(


async def _start_wf_and_nexus_op(
env: WorkflowEnvironment,
client: Client,
task_queue: str,
exception_in_operation_start: bool,
Expand All @@ -1089,7 +1094,8 @@ async def _start_wf_and_nexus_op(
"""
Start the caller workflow and wait until the Nexus operation has started.
"""
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
operation_workflow_id = str(uuid.uuid4())

# Start the caller workflow and wait until it confirms the Nexus operation has started.
Expand Down Expand Up @@ -1174,7 +1180,8 @@ async def test_untyped_caller(
op_definition_type=op_definition_type,
exception_in_operation_start=exception_in_operation_start,
)
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
caller_wf_handle = await client.start_workflow(
UntypedCallerWorkflow.run,
args=[
Expand Down Expand Up @@ -1335,7 +1342,8 @@ async def test_service_interface_and_implementation_names(
task_queue=task_queue,
workflow_failure_exception_types=[Exception],
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
assert await client.execute_workflow(
ServiceInterfaceAndImplCallerWorkflow.run,
args=(CallerReference.INTERFACE, NameOverride.YES, task_queue),
Expand Down Expand Up @@ -1451,7 +1459,8 @@ async def test_workflow_run_operation_can_execute_workflow_before_starting_backi
],
task_queue=task_queue,
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
result = await client.execute_workflow(
WorkflowCallingNexusOperationThatExecutesWorkflowBeforeStartingBackingWorkflow.run,
args=("result-1", task_queue),
Expand Down Expand Up @@ -1503,7 +1512,8 @@ async def test_nexus_operation_summary(
],
task_queue=task_queue,
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
wf_id = f"wf-{uuid.uuid4()}"
handle = await client.start_workflow(
ExecuteNexusOperationWithSummaryWorkflow.run,
Expand Down Expand Up @@ -1799,7 +1809,8 @@ async def test_workflow_run_operation_overloads(
],
nexus_service_handlers=[OverloadTestServiceHandler()],
):
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
res = await client.execute_workflow(
OverloadTestCallerWorkflow.run,
args=[op, OverloadTestValue(value=2)],
Expand Down Expand Up @@ -1859,7 +1870,8 @@ async def test_workflow_caller_custom_metrics(client: Client, env: WorkflowEnvir
pytest.skip("Nexus tests don't work with time-skipping server")

task_queue = str(uuid.uuid4())
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)

# Create new runtime with Prom server
prom_addr = f"127.0.0.1:{find_free_port()}"
Expand Down Expand Up @@ -1952,7 +1964,8 @@ async def test_workflow_caller_buffered_metrics(
runtime=runtime,
)
task_queue = str(uuid.uuid4())
await create_nexus_endpoint(task_queue, client)
endpoint_name = make_nexus_endpoint_name(task_queue)
await env.create_nexus_endpoint(endpoint_name, task_queue)
async with new_worker(
client,
CustomMetricsWorkflow,
Expand Down
Loading