temporalio / temporalio/sdk-python

[Feature Request] Better error message when trying to upsert a datetime search attribute with non-tz-aware datetime.

Open
#611 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
Python
Stars
1.2k
Forks
241
Avg merge
3d 21h
Merged PRs (30d)
55

Description

See https://github.com/temporalio/sdk-python/issues/572

The SDK should raise an exception with a helpful error message if the datetime object is invalid for use as a datetime search attribute (e.g. lacks a timezone), rather than waiting for the server to fail the WFT Completion.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the related sdk-python issue 572 and trace the upsert path for datetime search attributes. Add validation for datetimes without timezone information, with an actionable exception before workflow-task completion reaches the server. Add or update tests to confirm invalid datetimes fail locally with the helpful message.

Written by the indexing model from the issue text.

Assessment

Tech stack
python
Domain
api, backend
Issue type
Feature
Difficulty
3/5
Estimated time
1-2 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
64/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.