Skip to content

Jobs api stable, bump to latest dapr version and regen protos#1060

Merged
sicoyle merged 2 commits into
dapr:mainfrom
cicoyle:feat-jobs-api-stable-sdks
May 27, 2026
Merged

Jobs api stable, bump to latest dapr version and regen protos#1060
sicoyle merged 2 commits into
dapr:mainfrom
cicoyle:feat-jobs-api-stable-sdks

Conversation

@cicoyle
Copy link
Copy Markdown
Contributor

@cicoyle cicoyle commented May 26, 2026

Jobs api stable, bump to latest dapr version and regen protos

Signed-off-by: Cassandra Coyle <cassie@diagrid.io>
Copilot AI review requested due to automatic review settings May 26, 2026 21:27
@cicoyle cicoyle requested review from a team as code owners May 26, 2026 21:27
@codecov
Copy link
Copy Markdown

codecov Bot commented May 26, 2026

Codecov Report

❌ Patch coverage is 86.66667% with 14 lines in your changes missing coverage. Please review.
✅ Project coverage is 82.61%. Comparing base (bffb749) to head (105d631).
⚠️ Report is 135 commits behind head on main.

Files with missing lines Patch % Lines
dapr/aio/clients/grpc/client.py 83.33% 7 Missing ⚠️
dapr/clients/grpc/client.py 80.55% 7 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main    #1060      +/-   ##
==========================================
- Coverage   86.63%   82.61%   -4.02%     
==========================================
  Files          84      146      +62     
  Lines        4473    14572   +10099     
==========================================
+ Hits         3875    12039    +8164     
- Misses        598     2533    +1935     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR graduates the Python SDK’s Jobs API from the *_alpha1 surface to stable methods (schedule_job, get_job, delete_job), updates generated protobufs to the latest Dapr version, and adds compatibility behavior to transparently fall back to alpha RPCs when the connected sidecar doesn’t implement the stable Jobs RPCs.

Changes:

  • Switch SDK/client/test/example usage from *_alpha1 Jobs methods to stable schedule_job/get_job/delete_job.
  • Implement stable-first Jobs RPC calls with UNIMPLEMENTED fallback to *Alpha1, and deprecate the *_alpha1 client methods as aliases.
  • Regenerate runtime protos/stubs to include stable Jobs RPCs and stable AppCallback OnJobEvent.

Reviewed changes

Copilot reviewed 17 out of 21 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tests/integration/test_jobs.py Updates integration tests to use stable Jobs client methods.
tests/integration/test_jobs_async.py Updates async integration tests to use stable Jobs client methods.
tests/integration/AGENTS.md Updates documentation of which APIs each integration test file exercises.
tests/clients/test_dapr_grpc_client.py Renames Jobs unit tests to stable APIs; adds fallback + deprecation-alias coverage.
tests/clients/test_dapr_grpc_client_async.py Async equivalents of stable Jobs tests; adds fallback + deprecation-alias coverage.
tests/clients/fake_dapr_server.py Adds stable Jobs RPC handlers plus an “alpha-only sidecar” simulation mode.
ext/dapr-ext-grpc/tests/test_servicier.py Adds tests ensuring stable and alpha job event callbacks route identically.
ext/dapr-ext-grpc/dapr/ext/grpc/_servicer.py Adds stable OnJobEvent handler delegating to shared job-event routing logic.
examples/jobs/README.md Updates Jobs API documentation to stable + fallback messaging.
examples/jobs/job_processing.py Updates example to call stable schedule_job.
examples/jobs/job_management.py Updates example to call stable Jobs methods.
dapr/proto/runtime/v1/jobs_pb2.pyi Adds typings for new stable Jobs messages (e.g., list/delete-by-prefix).
dapr/proto/runtime/v1/jobs_pb2.py Regenerated Jobs proto module to include stable messages.
dapr/proto/runtime/v1/dapr_pb2.py Regenerated Dapr service descriptor to include stable Jobs RPCs (and other updates).
dapr/proto/runtime/v1/dapr_pb2_grpc.py Regenerated gRPC stubs/servicers for new stable Jobs RPCs (and other updates).
dapr/proto/runtime/v1/appcallback_pb2.py Regenerated AppCallback protos to include stable OnJobEvent.
dapr/proto/runtime/v1/appcallback_pb2_grpc.py Regenerated AppCallback gRPC stubs/servicers for stable OnJobEvent.
dapr/proto/runtime/v1/actors_pb2.pyi Regenerated typings to include new actor streaming protocol messages.
dapr/proto/runtime/v1/actors_pb2.py Regenerated actor proto module for new actor streaming protocol messages.
dapr/clients/grpc/client.py Implements stable Jobs methods + UNIMPLEMENTED fallback; deprecates *_alpha1 aliases.
dapr/aio/clients/grpc/client.py Async implementation of stable Jobs methods + fallback; deprecates *_alpha1 aliases.
Files not reviewed (4)
  • dapr/proto/runtime/v1/actors_pb2.py: Language not supported
  • dapr/proto/runtime/v1/appcallback_pb2.py: Language not supported
  • dapr/proto/runtime/v1/dapr_pb2.py: Language not supported
  • dapr/proto/runtime/v1/jobs_pb2.py: Language not supported

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread examples/jobs/README.md Outdated
Comment thread tests/clients/fake_dapr_server.py Outdated
Comment thread tests/clients/fake_dapr_server.py Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Signed-off-by: Cassie Coyle <cassie.i.coyle@gmail.com>
@cicoyle
Copy link
Copy Markdown
Contributor Author

cicoyle commented May 27, 2026

flake issue opened here

Copy link
Copy Markdown
Contributor

@sicoyle sicoyle left a comment

Choose a reason for hiding this comment

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

thank you!!

@sicoyle sicoyle added this pull request to the merge queue May 27, 2026
Merged via the queue into dapr:main with commit 8840b9a May 27, 2026
24 of 27 checks passed
@sicoyle sicoyle added this to the v1.18 milestone May 27, 2026
sicoyle pushed a commit that referenced this pull request May 28, 2026
…#1063)

* jobs api stable, bump to latest dapr version and regen protos



* Apply suggestions from code review




---------




(cherry picked from commit 8840b9a)

Signed-off-by: Cassandra Coyle <cassie@diagrid.io>
Signed-off-by: Cassie Coyle <cassie.i.coyle@gmail.com>
Signed-off-by: dapr-bot <dapr-bot@users.noreply.github.com>
Co-authored-by: Cassie Coyle <cassie.i.coyle@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants