temporalio 0.0.0 → 0.0.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (327) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +301 -0
  3. data/bridge/Cargo.lock +2888 -0
  4. data/bridge/Cargo.toml +27 -0
  5. data/bridge/sdk-core/ARCHITECTURE.md +76 -0
  6. data/bridge/sdk-core/Cargo.lock +2606 -0
  7. data/bridge/sdk-core/Cargo.toml +2 -0
  8. data/bridge/sdk-core/LICENSE.txt +23 -0
  9. data/bridge/sdk-core/README.md +104 -0
  10. data/bridge/sdk-core/arch_docs/diagrams/README.md +10 -0
  11. data/bridge/sdk-core/arch_docs/diagrams/sticky_queues.puml +40 -0
  12. data/bridge/sdk-core/arch_docs/diagrams/workflow_internals.svg +1 -0
  13. data/bridge/sdk-core/arch_docs/sticky_queues.md +51 -0
  14. data/bridge/sdk-core/client/Cargo.toml +40 -0
  15. data/bridge/sdk-core/client/LICENSE.txt +23 -0
  16. data/bridge/sdk-core/client/src/lib.rs +1286 -0
  17. data/bridge/sdk-core/client/src/metrics.rs +165 -0
  18. data/bridge/sdk-core/client/src/raw.rs +932 -0
  19. data/bridge/sdk-core/client/src/retry.rs +751 -0
  20. data/bridge/sdk-core/client/src/workflow_handle/mod.rs +185 -0
  21. data/bridge/sdk-core/core/Cargo.toml +116 -0
  22. data/bridge/sdk-core/core/LICENSE.txt +23 -0
  23. data/bridge/sdk-core/core/benches/workflow_replay.rs +76 -0
  24. data/bridge/sdk-core/core/src/abstractions.rs +166 -0
  25. data/bridge/sdk-core/core/src/core_tests/activity_tasks.rs +1014 -0
  26. data/bridge/sdk-core/core/src/core_tests/child_workflows.rs +221 -0
  27. data/bridge/sdk-core/core/src/core_tests/determinism.rs +107 -0
  28. data/bridge/sdk-core/core/src/core_tests/local_activities.rs +925 -0
  29. data/bridge/sdk-core/core/src/core_tests/mod.rs +100 -0
  30. data/bridge/sdk-core/core/src/core_tests/queries.rs +894 -0
  31. data/bridge/sdk-core/core/src/core_tests/replay_flag.rs +65 -0
  32. data/bridge/sdk-core/core/src/core_tests/workers.rs +259 -0
  33. data/bridge/sdk-core/core/src/core_tests/workflow_cancels.rs +124 -0
  34. data/bridge/sdk-core/core/src/core_tests/workflow_tasks.rs +2090 -0
  35. data/bridge/sdk-core/core/src/ephemeral_server/mod.rs +515 -0
  36. data/bridge/sdk-core/core/src/lib.rs +282 -0
  37. data/bridge/sdk-core/core/src/pollers/mod.rs +54 -0
  38. data/bridge/sdk-core/core/src/pollers/poll_buffer.rs +297 -0
  39. data/bridge/sdk-core/core/src/protosext/mod.rs +428 -0
  40. data/bridge/sdk-core/core/src/replay/mod.rs +215 -0
  41. data/bridge/sdk-core/core/src/retry_logic.rs +202 -0
  42. data/bridge/sdk-core/core/src/telemetry/log_export.rs +190 -0
  43. data/bridge/sdk-core/core/src/telemetry/metrics.rs +428 -0
  44. data/bridge/sdk-core/core/src/telemetry/mod.rs +407 -0
  45. data/bridge/sdk-core/core/src/telemetry/prometheus_server.rs +78 -0
  46. data/bridge/sdk-core/core/src/test_help/mod.rs +889 -0
  47. data/bridge/sdk-core/core/src/worker/activities/activity_heartbeat_manager.rs +580 -0
  48. data/bridge/sdk-core/core/src/worker/activities/local_activities.rs +1048 -0
  49. data/bridge/sdk-core/core/src/worker/activities.rs +481 -0
  50. data/bridge/sdk-core/core/src/worker/client/mocks.rs +87 -0
  51. data/bridge/sdk-core/core/src/worker/client.rs +373 -0
  52. data/bridge/sdk-core/core/src/worker/mod.rs +570 -0
  53. data/bridge/sdk-core/core/src/worker/workflow/bridge.rs +37 -0
  54. data/bridge/sdk-core/core/src/worker/workflow/driven_workflow.rs +101 -0
  55. data/bridge/sdk-core/core/src/worker/workflow/history_update.rs +532 -0
  56. data/bridge/sdk-core/core/src/worker/workflow/machines/activity_state_machine.rs +907 -0
  57. data/bridge/sdk-core/core/src/worker/workflow/machines/cancel_external_state_machine.rs +294 -0
  58. data/bridge/sdk-core/core/src/worker/workflow/machines/cancel_workflow_state_machine.rs +167 -0
  59. data/bridge/sdk-core/core/src/worker/workflow/machines/child_workflow_state_machine.rs +858 -0
  60. data/bridge/sdk-core/core/src/worker/workflow/machines/complete_workflow_state_machine.rs +136 -0
  61. data/bridge/sdk-core/core/src/worker/workflow/machines/continue_as_new_workflow_state_machine.rs +157 -0
  62. data/bridge/sdk-core/core/src/worker/workflow/machines/fail_workflow_state_machine.rs +129 -0
  63. data/bridge/sdk-core/core/src/worker/workflow/machines/local_activity_state_machine.rs +1450 -0
  64. data/bridge/sdk-core/core/src/worker/workflow/machines/mod.rs +316 -0
  65. data/bridge/sdk-core/core/src/worker/workflow/machines/modify_workflow_properties_state_machine.rs +178 -0
  66. data/bridge/sdk-core/core/src/worker/workflow/machines/patch_state_machine.rs +708 -0
  67. data/bridge/sdk-core/core/src/worker/workflow/machines/signal_external_state_machine.rs +439 -0
  68. data/bridge/sdk-core/core/src/worker/workflow/machines/timer_state_machine.rs +435 -0
  69. data/bridge/sdk-core/core/src/worker/workflow/machines/transition_coverage.rs +175 -0
  70. data/bridge/sdk-core/core/src/worker/workflow/machines/upsert_search_attributes_state_machine.rs +242 -0
  71. data/bridge/sdk-core/core/src/worker/workflow/machines/workflow_machines/local_acts.rs +96 -0
  72. data/bridge/sdk-core/core/src/worker/workflow/machines/workflow_machines.rs +1200 -0
  73. data/bridge/sdk-core/core/src/worker/workflow/machines/workflow_task_state_machine.rs +272 -0
  74. data/bridge/sdk-core/core/src/worker/workflow/managed_run/managed_wf_test.rs +198 -0
  75. data/bridge/sdk-core/core/src/worker/workflow/managed_run.rs +655 -0
  76. data/bridge/sdk-core/core/src/worker/workflow/mod.rs +1200 -0
  77. data/bridge/sdk-core/core/src/worker/workflow/run_cache.rs +145 -0
  78. data/bridge/sdk-core/core/src/worker/workflow/wft_poller.rs +88 -0
  79. data/bridge/sdk-core/core/src/worker/workflow/workflow_stream.rs +985 -0
  80. data/bridge/sdk-core/core-api/Cargo.toml +32 -0
  81. data/bridge/sdk-core/core-api/LICENSE.txt +23 -0
  82. data/bridge/sdk-core/core-api/src/errors.rs +95 -0
  83. data/bridge/sdk-core/core-api/src/lib.rs +109 -0
  84. data/bridge/sdk-core/core-api/src/telemetry.rs +147 -0
  85. data/bridge/sdk-core/core-api/src/worker.rs +148 -0
  86. data/bridge/sdk-core/etc/deps.svg +162 -0
  87. data/bridge/sdk-core/etc/dynamic-config.yaml +2 -0
  88. data/bridge/sdk-core/etc/otel-collector-config.yaml +36 -0
  89. data/bridge/sdk-core/etc/prometheus.yaml +6 -0
  90. data/bridge/sdk-core/etc/regen-depgraph.sh +5 -0
  91. data/bridge/sdk-core/fsm/Cargo.toml +18 -0
  92. data/bridge/sdk-core/fsm/LICENSE.txt +23 -0
  93. data/bridge/sdk-core/fsm/README.md +3 -0
  94. data/bridge/sdk-core/fsm/rustfsm_procmacro/Cargo.toml +27 -0
  95. data/bridge/sdk-core/fsm/rustfsm_procmacro/LICENSE.txt +23 -0
  96. data/bridge/sdk-core/fsm/rustfsm_procmacro/src/lib.rs +647 -0
  97. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/progress.rs +8 -0
  98. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/dupe_transitions_fail.rs +18 -0
  99. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/dupe_transitions_fail.stderr +12 -0
  100. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/dynamic_dest_pass.rs +41 -0
  101. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/forgot_name_fail.rs +14 -0
  102. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/forgot_name_fail.stderr +11 -0
  103. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/handler_arg_pass.rs +32 -0
  104. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/handler_pass.rs +31 -0
  105. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/medium_complex_pass.rs +46 -0
  106. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/no_handle_conversions_require_into_fail.rs +29 -0
  107. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/no_handle_conversions_require_into_fail.stderr +12 -0
  108. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/simple_pass.rs +32 -0
  109. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/struct_event_variant_fail.rs +18 -0
  110. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/struct_event_variant_fail.stderr +5 -0
  111. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/tuple_more_item_event_variant_fail.rs +11 -0
  112. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/tuple_more_item_event_variant_fail.stderr +5 -0
  113. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/tuple_zero_item_event_variant_fail.rs +11 -0
  114. data/bridge/sdk-core/fsm/rustfsm_procmacro/tests/trybuild/tuple_zero_item_event_variant_fail.stderr +5 -0
  115. data/bridge/sdk-core/fsm/rustfsm_trait/Cargo.toml +14 -0
  116. data/bridge/sdk-core/fsm/rustfsm_trait/LICENSE.txt +23 -0
  117. data/bridge/sdk-core/fsm/rustfsm_trait/src/lib.rs +249 -0
  118. data/bridge/sdk-core/fsm/src/lib.rs +2 -0
  119. data/bridge/sdk-core/histories/evict_while_la_running_no_interference-23_history.bin +0 -0
  120. data/bridge/sdk-core/histories/evict_while_la_running_no_interference-85_history.bin +0 -0
  121. data/bridge/sdk-core/histories/fail_wf_task.bin +0 -0
  122. data/bridge/sdk-core/histories/timer_workflow_history.bin +0 -0
  123. data/bridge/sdk-core/integ-with-otel.sh +7 -0
  124. data/bridge/sdk-core/protos/api_upstream/README.md +9 -0
  125. data/bridge/sdk-core/protos/api_upstream/api-linter.yaml +40 -0
  126. data/bridge/sdk-core/protos/api_upstream/buf.yaml +9 -0
  127. data/bridge/sdk-core/protos/api_upstream/build/go.mod +7 -0
  128. data/bridge/sdk-core/protos/api_upstream/build/go.sum +5 -0
  129. data/bridge/sdk-core/protos/api_upstream/build/tools.go +29 -0
  130. data/bridge/sdk-core/protos/api_upstream/dependencies/gogoproto/gogo.proto +141 -0
  131. data/bridge/sdk-core/protos/api_upstream/go.mod +6 -0
  132. data/bridge/sdk-core/protos/api_upstream/temporal/api/batch/v1/message.proto +89 -0
  133. data/bridge/sdk-core/protos/api_upstream/temporal/api/command/v1/message.proto +260 -0
  134. data/bridge/sdk-core/protos/api_upstream/temporal/api/common/v1/message.proto +112 -0
  135. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/batch_operation.proto +47 -0
  136. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/command_type.proto +57 -0
  137. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/common.proto +56 -0
  138. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/event_type.proto +170 -0
  139. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/failed_cause.proto +118 -0
  140. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/interaction_type.proto +39 -0
  141. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/namespace.proto +51 -0
  142. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/query.proto +50 -0
  143. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/reset.proto +41 -0
  144. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/schedule.proto +60 -0
  145. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/task_queue.proto +59 -0
  146. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/update.proto +40 -0
  147. data/bridge/sdk-core/protos/api_upstream/temporal/api/enums/v1/workflow.proto +122 -0
  148. data/bridge/sdk-core/protos/api_upstream/temporal/api/errordetails/v1/message.proto +108 -0
  149. data/bridge/sdk-core/protos/api_upstream/temporal/api/failure/v1/message.proto +114 -0
  150. data/bridge/sdk-core/protos/api_upstream/temporal/api/filter/v1/message.proto +56 -0
  151. data/bridge/sdk-core/protos/api_upstream/temporal/api/history/v1/message.proto +758 -0
  152. data/bridge/sdk-core/protos/api_upstream/temporal/api/interaction/v1/message.proto +87 -0
  153. data/bridge/sdk-core/protos/api_upstream/temporal/api/namespace/v1/message.proto +97 -0
  154. data/bridge/sdk-core/protos/api_upstream/temporal/api/operatorservice/v1/request_response.proto +121 -0
  155. data/bridge/sdk-core/protos/api_upstream/temporal/api/operatorservice/v1/service.proto +80 -0
  156. data/bridge/sdk-core/protos/api_upstream/temporal/api/query/v1/message.proto +61 -0
  157. data/bridge/sdk-core/protos/api_upstream/temporal/api/replication/v1/message.proto +55 -0
  158. data/bridge/sdk-core/protos/api_upstream/temporal/api/schedule/v1/message.proto +379 -0
  159. data/bridge/sdk-core/protos/api_upstream/temporal/api/taskqueue/v1/message.proto +108 -0
  160. data/bridge/sdk-core/protos/api_upstream/temporal/api/version/v1/message.proto +59 -0
  161. data/bridge/sdk-core/protos/api_upstream/temporal/api/workflow/v1/message.proto +146 -0
  162. data/bridge/sdk-core/protos/api_upstream/temporal/api/workflowservice/v1/request_response.proto +1168 -0
  163. data/bridge/sdk-core/protos/api_upstream/temporal/api/workflowservice/v1/service.proto +415 -0
  164. data/bridge/sdk-core/protos/grpc/health/v1/health.proto +63 -0
  165. data/bridge/sdk-core/protos/local/temporal/sdk/core/activity_result/activity_result.proto +78 -0
  166. data/bridge/sdk-core/protos/local/temporal/sdk/core/activity_task/activity_task.proto +79 -0
  167. data/bridge/sdk-core/protos/local/temporal/sdk/core/child_workflow/child_workflow.proto +77 -0
  168. data/bridge/sdk-core/protos/local/temporal/sdk/core/common/common.proto +15 -0
  169. data/bridge/sdk-core/protos/local/temporal/sdk/core/core_interface.proto +30 -0
  170. data/bridge/sdk-core/protos/local/temporal/sdk/core/external_data/external_data.proto +30 -0
  171. data/bridge/sdk-core/protos/local/temporal/sdk/core/workflow_activation/workflow_activation.proto +263 -0
  172. data/bridge/sdk-core/protos/local/temporal/sdk/core/workflow_commands/workflow_commands.proto +304 -0
  173. data/bridge/sdk-core/protos/local/temporal/sdk/core/workflow_completion/workflow_completion.proto +29 -0
  174. data/bridge/sdk-core/protos/testsrv_upstream/api-linter.yaml +38 -0
  175. data/bridge/sdk-core/protos/testsrv_upstream/buf.yaml +13 -0
  176. data/bridge/sdk-core/protos/testsrv_upstream/dependencies/gogoproto/gogo.proto +141 -0
  177. data/bridge/sdk-core/protos/testsrv_upstream/temporal/api/testservice/v1/request_response.proto +63 -0
  178. data/bridge/sdk-core/protos/testsrv_upstream/temporal/api/testservice/v1/service.proto +90 -0
  179. data/bridge/sdk-core/rustfmt.toml +1 -0
  180. data/bridge/sdk-core/sdk/Cargo.toml +47 -0
  181. data/bridge/sdk-core/sdk/LICENSE.txt +23 -0
  182. data/bridge/sdk-core/sdk/src/activity_context.rs +230 -0
  183. data/bridge/sdk-core/sdk/src/app_data.rs +37 -0
  184. data/bridge/sdk-core/sdk/src/interceptors.rs +50 -0
  185. data/bridge/sdk-core/sdk/src/lib.rs +794 -0
  186. data/bridge/sdk-core/sdk/src/payload_converter.rs +11 -0
  187. data/bridge/sdk-core/sdk/src/workflow_context/options.rs +295 -0
  188. data/bridge/sdk-core/sdk/src/workflow_context.rs +694 -0
  189. data/bridge/sdk-core/sdk/src/workflow_future.rs +499 -0
  190. data/bridge/sdk-core/sdk-core-protos/Cargo.toml +30 -0
  191. data/bridge/sdk-core/sdk-core-protos/LICENSE.txt +23 -0
  192. data/bridge/sdk-core/sdk-core-protos/build.rs +107 -0
  193. data/bridge/sdk-core/sdk-core-protos/src/constants.rs +7 -0
  194. data/bridge/sdk-core/sdk-core-protos/src/history_builder.rs +544 -0
  195. data/bridge/sdk-core/sdk-core-protos/src/history_info.rs +230 -0
  196. data/bridge/sdk-core/sdk-core-protos/src/lib.rs +1970 -0
  197. data/bridge/sdk-core/sdk-core-protos/src/task_token.rs +38 -0
  198. data/bridge/sdk-core/sdk-core-protos/src/utilities.rs +14 -0
  199. data/bridge/sdk-core/test-utils/Cargo.toml +36 -0
  200. data/bridge/sdk-core/test-utils/src/canned_histories.rs +1579 -0
  201. data/bridge/sdk-core/test-utils/src/histfetch.rs +28 -0
  202. data/bridge/sdk-core/test-utils/src/lib.rs +650 -0
  203. data/bridge/sdk-core/tests/integ_tests/client_tests.rs +36 -0
  204. data/bridge/sdk-core/tests/integ_tests/ephemeral_server_tests.rs +128 -0
  205. data/bridge/sdk-core/tests/integ_tests/heartbeat_tests.rs +221 -0
  206. data/bridge/sdk-core/tests/integ_tests/metrics_tests.rs +37 -0
  207. data/bridge/sdk-core/tests/integ_tests/polling_tests.rs +133 -0
  208. data/bridge/sdk-core/tests/integ_tests/queries_tests.rs +437 -0
  209. data/bridge/sdk-core/tests/integ_tests/visibility_tests.rs +93 -0
  210. data/bridge/sdk-core/tests/integ_tests/workflow_tests/activities.rs +878 -0
  211. data/bridge/sdk-core/tests/integ_tests/workflow_tests/appdata_propagation.rs +61 -0
  212. data/bridge/sdk-core/tests/integ_tests/workflow_tests/cancel_external.rs +59 -0
  213. data/bridge/sdk-core/tests/integ_tests/workflow_tests/cancel_wf.rs +58 -0
  214. data/bridge/sdk-core/tests/integ_tests/workflow_tests/child_workflows.rs +50 -0
  215. data/bridge/sdk-core/tests/integ_tests/workflow_tests/continue_as_new.rs +60 -0
  216. data/bridge/sdk-core/tests/integ_tests/workflow_tests/determinism.rs +54 -0
  217. data/bridge/sdk-core/tests/integ_tests/workflow_tests/local_activities.rs +788 -0
  218. data/bridge/sdk-core/tests/integ_tests/workflow_tests/modify_wf_properties.rs +53 -0
  219. data/bridge/sdk-core/tests/integ_tests/workflow_tests/patches.rs +113 -0
  220. data/bridge/sdk-core/tests/integ_tests/workflow_tests/replay.rs +223 -0
  221. data/bridge/sdk-core/tests/integ_tests/workflow_tests/resets.rs +93 -0
  222. data/bridge/sdk-core/tests/integ_tests/workflow_tests/signals.rs +167 -0
  223. data/bridge/sdk-core/tests/integ_tests/workflow_tests/stickyness.rs +99 -0
  224. data/bridge/sdk-core/tests/integ_tests/workflow_tests/timers.rs +131 -0
  225. data/bridge/sdk-core/tests/integ_tests/workflow_tests/upsert_search_attrs.rs +75 -0
  226. data/bridge/sdk-core/tests/integ_tests/workflow_tests.rs +597 -0
  227. data/bridge/sdk-core/tests/load_tests.rs +191 -0
  228. data/bridge/sdk-core/tests/main.rs +113 -0
  229. data/bridge/sdk-core/tests/runner.rs +93 -0
  230. data/bridge/src/connection.rs +186 -0
  231. data/bridge/src/lib.rs +239 -0
  232. data/bridge/src/runtime.rs +54 -0
  233. data/bridge/src/worker.rs +124 -0
  234. data/ext/Rakefile +9 -0
  235. data/lib/bridge.so +0 -0
  236. data/lib/gen/dependencies/gogoproto/gogo_pb.rb +14 -0
  237. data/lib/gen/temporal/api/batch/v1/message_pb.rb +50 -0
  238. data/lib/gen/temporal/api/command/v1/message_pb.rb +174 -0
  239. data/lib/gen/temporal/api/common/v1/message_pb.rb +69 -0
  240. data/lib/gen/temporal/api/enums/v1/batch_operation_pb.rb +33 -0
  241. data/lib/gen/temporal/api/enums/v1/command_type_pb.rb +39 -0
  242. data/lib/gen/temporal/api/enums/v1/common_pb.rb +42 -0
  243. data/lib/gen/temporal/api/enums/v1/event_type_pb.rb +68 -0
  244. data/lib/gen/temporal/api/enums/v1/failed_cause_pb.rb +77 -0
  245. data/lib/gen/temporal/api/enums/v1/interaction_type_pb.rb +25 -0
  246. data/lib/gen/temporal/api/enums/v1/namespace_pb.rb +37 -0
  247. data/lib/gen/temporal/api/enums/v1/query_pb.rb +31 -0
  248. data/lib/gen/temporal/api/enums/v1/reset_pb.rb +24 -0
  249. data/lib/gen/temporal/api/enums/v1/schedule_pb.rb +28 -0
  250. data/lib/gen/temporal/api/enums/v1/task_queue_pb.rb +30 -0
  251. data/lib/gen/temporal/api/enums/v1/update_pb.rb +23 -0
  252. data/lib/gen/temporal/api/enums/v1/workflow_pb.rb +89 -0
  253. data/lib/gen/temporal/api/errordetails/v1/message_pb.rb +84 -0
  254. data/lib/gen/temporal/api/failure/v1/message_pb.rb +83 -0
  255. data/lib/gen/temporal/api/filter/v1/message_pb.rb +40 -0
  256. data/lib/gen/temporal/api/history/v1/message_pb.rb +490 -0
  257. data/lib/gen/temporal/api/interaction/v1/message_pb.rb +49 -0
  258. data/lib/gen/temporal/api/namespace/v1/message_pb.rb +63 -0
  259. data/lib/gen/temporal/api/operatorservice/v1/request_response_pb.rb +85 -0
  260. data/lib/gen/temporal/api/operatorservice/v1/service_pb.rb +20 -0
  261. data/lib/gen/temporal/api/query/v1/message_pb.rb +38 -0
  262. data/lib/gen/temporal/api/replication/v1/message_pb.rb +37 -0
  263. data/lib/gen/temporal/api/schedule/v1/message_pb.rb +149 -0
  264. data/lib/gen/temporal/api/taskqueue/v1/message_pb.rb +73 -0
  265. data/lib/gen/temporal/api/version/v1/message_pb.rb +41 -0
  266. data/lib/gen/temporal/api/workflow/v1/message_pb.rb +111 -0
  267. data/lib/gen/temporal/api/workflowservice/v1/request_response_pb.rb +788 -0
  268. data/lib/gen/temporal/api/workflowservice/v1/service_pb.rb +20 -0
  269. data/lib/gen/temporal/sdk/core/activity_result/activity_result_pb.rb +58 -0
  270. data/lib/gen/temporal/sdk/core/activity_task/activity_task_pb.rb +57 -0
  271. data/lib/gen/temporal/sdk/core/bridge/bridge_pb.rb +222 -0
  272. data/lib/gen/temporal/sdk/core/child_workflow/child_workflow_pb.rb +57 -0
  273. data/lib/gen/temporal/sdk/core/common/common_pb.rb +22 -0
  274. data/lib/gen/temporal/sdk/core/core_interface_pb.rb +34 -0
  275. data/lib/gen/temporal/sdk/core/external_data/external_data_pb.rb +27 -0
  276. data/lib/gen/temporal/sdk/core/workflow_activation/workflow_activation_pb.rb +165 -0
  277. data/lib/gen/temporal/sdk/core/workflow_commands/workflow_commands_pb.rb +196 -0
  278. data/lib/gen/temporal/sdk/core/workflow_completion/workflow_completion_pb.rb +34 -0
  279. data/lib/temporalio/activity/context.rb +97 -0
  280. data/lib/temporalio/activity/info.rb +67 -0
  281. data/lib/temporalio/activity.rb +85 -0
  282. data/lib/temporalio/bridge/error.rb +8 -0
  283. data/lib/temporalio/bridge.rb +14 -0
  284. data/lib/temporalio/client/implementation.rb +340 -0
  285. data/lib/temporalio/client/workflow_handle.rb +243 -0
  286. data/lib/temporalio/client.rb +131 -0
  287. data/lib/temporalio/connection.rb +751 -0
  288. data/lib/temporalio/data_converter.rb +191 -0
  289. data/lib/temporalio/error/failure.rb +194 -0
  290. data/lib/temporalio/error/workflow_failure.rb +19 -0
  291. data/lib/temporalio/errors.rb +40 -0
  292. data/lib/temporalio/failure_converter/base.rb +26 -0
  293. data/lib/temporalio/failure_converter/basic.rb +319 -0
  294. data/lib/temporalio/failure_converter.rb +7 -0
  295. data/lib/temporalio/interceptor/chain.rb +28 -0
  296. data/lib/temporalio/interceptor/client.rb +123 -0
  297. data/lib/temporalio/payload_codec/base.rb +32 -0
  298. data/lib/temporalio/payload_converter/base.rb +24 -0
  299. data/lib/temporalio/payload_converter/bytes.rb +27 -0
  300. data/lib/temporalio/payload_converter/composite.rb +49 -0
  301. data/lib/temporalio/payload_converter/encoding_base.rb +35 -0
  302. data/lib/temporalio/payload_converter/json.rb +26 -0
  303. data/lib/temporalio/payload_converter/nil.rb +26 -0
  304. data/lib/temporalio/payload_converter.rb +14 -0
  305. data/lib/temporalio/retry_policy.rb +82 -0
  306. data/lib/temporalio/retry_state.rb +35 -0
  307. data/lib/temporalio/runtime.rb +25 -0
  308. data/lib/temporalio/timeout_type.rb +29 -0
  309. data/lib/temporalio/version.rb +3 -0
  310. data/lib/temporalio/worker/activity_runner.rb +92 -0
  311. data/lib/temporalio/worker/activity_worker.rb +138 -0
  312. data/lib/temporalio/worker/reactor.rb +46 -0
  313. data/lib/temporalio/worker/runner.rb +63 -0
  314. data/lib/temporalio/worker/sync_worker.rb +88 -0
  315. data/lib/temporalio/worker/thread_pool_executor.rb +51 -0
  316. data/lib/temporalio/worker.rb +198 -0
  317. data/lib/temporalio/workflow/execution_info.rb +54 -0
  318. data/lib/temporalio/workflow/execution_status.rb +36 -0
  319. data/lib/temporalio/workflow/id_reuse_policy.rb +36 -0
  320. data/lib/temporalio/workflow/query_reject_condition.rb +33 -0
  321. data/lib/temporalio.rb +12 -1
  322. data/lib/thermite_patch.rb +23 -0
  323. data/temporalio.gemspec +45 -0
  324. metadata +566 -9
  325. data/lib/temporal/version.rb +0 -3
  326. data/lib/temporal.rb +0 -4
  327. data/temporal.gemspec +0 -20
@@ -0,0 +1,751 @@
1
+ use crate::{
2
+ ClientOptions, ListClosedFilters, ListOpenFilters, Namespace, Result, RetryConfig,
3
+ StartTimeFilter, WorkflowClientTrait, WorkflowOptions,
4
+ };
5
+ use backoff::{backoff::Backoff, exponential::ExponentialBackoff, Clock, SystemClock};
6
+ use futures_retry::{ErrorHandler, FutureRetry, RetryPolicy};
7
+ use std::{fmt::Debug, future::Future, sync::Arc, time::Duration};
8
+ use temporal_sdk_core_protos::{
9
+ coresdk::workflow_commands::QueryResult,
10
+ temporal::api::{
11
+ common::v1::{Header, Payload, Payloads},
12
+ enums::v1::WorkflowTaskFailedCause,
13
+ failure::v1::Failure,
14
+ query::v1::WorkflowQuery,
15
+ workflowservice::v1::*,
16
+ },
17
+ TaskToken,
18
+ };
19
+ use tonic::Code;
20
+
21
+ /// List of gRPC error codes that client will retry.
22
+ pub const RETRYABLE_ERROR_CODES: [Code; 7] = [
23
+ Code::DataLoss,
24
+ Code::Internal,
25
+ Code::Unknown,
26
+ Code::ResourceExhausted,
27
+ Code::Aborted,
28
+ Code::OutOfRange,
29
+ Code::Unavailable,
30
+ ];
31
+ const LONG_POLL_FATAL_GRACE: Duration = Duration::from_secs(60);
32
+ /// Must match the method name in [crate::raw::WorkflowService]
33
+ const POLL_WORKFLOW_METH_NAME: &str = "poll_workflow_task_queue";
34
+ /// Must match the method name in [crate::raw::WorkflowService]
35
+ const POLL_ACTIVITY_METH_NAME: &str = "poll_activity_task_queue";
36
+
37
+ /// A wrapper for a [WorkflowClientTrait] or [crate::WorkflowService] implementor which performs
38
+ /// auto-retries
39
+ #[derive(Debug, Clone)]
40
+ pub struct RetryClient<SG> {
41
+ client: SG,
42
+ retry_config: Arc<RetryConfig>,
43
+ }
44
+
45
+ impl<SG> RetryClient<SG> {
46
+ /// Use the provided retry config with the provided client
47
+ pub fn new(client: SG, retry_config: RetryConfig) -> Self {
48
+ Self {
49
+ client,
50
+ retry_config: Arc::new(retry_config),
51
+ }
52
+ }
53
+ }
54
+
55
+ impl<SG> RetryClient<SG> {
56
+ /// Return the inner client type
57
+ pub fn get_client(&self) -> &SG {
58
+ &self.client
59
+ }
60
+
61
+ /// Return the inner client type mutably
62
+ pub fn get_client_mut(&mut self) -> &mut SG {
63
+ &mut self.client
64
+ }
65
+
66
+ /// Disable retry and return the inner client type
67
+ pub fn into_inner(self) -> SG {
68
+ self.client
69
+ }
70
+
71
+ /// Wraps a call to the underlying client with retry capability.
72
+ ///
73
+ /// This is the "old" path used by higher-level [WorkflowClientTrait] implementors
74
+ pub(crate) async fn call_with_retry<R, F, Fut>(
75
+ &self,
76
+ factory: F,
77
+ call_name: &'static str,
78
+ ) -> Result<R>
79
+ where
80
+ F: Fn() -> Fut + Unpin,
81
+ Fut: Future<Output = Result<R>>,
82
+ {
83
+ let rtc = self.get_retry_config(call_name);
84
+ let res = Self::make_future_retry(rtc, factory, call_name).await;
85
+ Ok(res.map_err(|(e, _attempt)| e)?.0)
86
+ }
87
+
88
+ pub(crate) fn get_retry_config(&self, call_name: &'static str) -> RetryConfig {
89
+ match CallType::from_call_name(call_name) {
90
+ CallType::Normal => (*self.retry_config).clone(),
91
+ CallType::LongPoll => RetryConfig::poll_retry_policy(),
92
+ }
93
+ }
94
+
95
+ pub(crate) fn make_future_retry<R, F, Fut>(
96
+ rtc: RetryConfig,
97
+ factory: F,
98
+ call_name: &'static str,
99
+ ) -> FutureRetry<F, TonicErrorHandler<SystemClock>>
100
+ where
101
+ F: FnMut() -> Fut + Unpin,
102
+ Fut: Future<Output = Result<R>>,
103
+ {
104
+ FutureRetry::new(
105
+ factory,
106
+ TonicErrorHandler::new(rtc, RetryConfig::throttle_retry_policy(), call_name),
107
+ )
108
+ }
109
+ }
110
+
111
+ #[derive(Debug)]
112
+ pub(crate) struct TonicErrorHandler<C: Clock> {
113
+ backoff: ExponentialBackoff<C>,
114
+ throttle_backoff: ExponentialBackoff<C>,
115
+ max_retries: usize,
116
+ call_type: CallType,
117
+ call_name: &'static str,
118
+ }
119
+ impl TonicErrorHandler<SystemClock> {
120
+ fn new(cfg: RetryConfig, throttle_cfg: RetryConfig, call_name: &'static str) -> Self {
121
+ Self::new_with_clock(
122
+ cfg,
123
+ throttle_cfg,
124
+ call_name,
125
+ SystemClock::default(),
126
+ SystemClock::default(),
127
+ )
128
+ }
129
+ }
130
+ impl<C> TonicErrorHandler<C>
131
+ where
132
+ C: Clock,
133
+ {
134
+ fn new_with_clock(
135
+ cfg: RetryConfig,
136
+ throttle_cfg: RetryConfig,
137
+ call_name: &'static str,
138
+ clock: C,
139
+ throttle_clock: C,
140
+ ) -> Self {
141
+ Self {
142
+ max_retries: cfg.max_retries,
143
+ call_type: CallType::from_call_name(call_name),
144
+ call_name,
145
+ backoff: cfg.into_exp_backoff(clock),
146
+ throttle_backoff: throttle_cfg.into_exp_backoff(throttle_clock),
147
+ }
148
+ }
149
+ const fn should_log_retry_warning(&self, cur_attempt: usize) -> bool {
150
+ // Warn on more than 5 retries for unlimited retrying
151
+ if self.max_retries == 0 && cur_attempt > 5 {
152
+ return true;
153
+ }
154
+ // Warn if the attempts are more than 50% of max retries
155
+ if self.max_retries > 0 && cur_attempt * 2 >= self.max_retries {
156
+ return true;
157
+ }
158
+ false
159
+ }
160
+ }
161
+ #[doc(hidden)]
162
+ #[derive(Clone, Copy, Debug, Eq, PartialEq, Hash)]
163
+ pub enum CallType {
164
+ Normal,
165
+ LongPoll,
166
+ }
167
+ impl CallType {
168
+ fn from_call_name(call_name: &str) -> Self {
169
+ match call_name {
170
+ POLL_WORKFLOW_METH_NAME | POLL_ACTIVITY_METH_NAME => CallType::LongPoll,
171
+ _ => CallType::Normal,
172
+ }
173
+ }
174
+ }
175
+
176
+ impl<C> ErrorHandler<tonic::Status> for TonicErrorHandler<C>
177
+ where
178
+ C: Clock,
179
+ {
180
+ type OutError = tonic::Status;
181
+
182
+ fn handle(&mut self, current_attempt: usize, e: tonic::Status) -> RetryPolicy<tonic::Status> {
183
+ // 0 max retries means unlimited retries
184
+ if self.max_retries > 0 && current_attempt >= self.max_retries {
185
+ return RetryPolicy::ForwardError(e);
186
+ }
187
+
188
+ let is_long_poll = self.call_type == CallType::LongPoll;
189
+ // Long polls are OK with being cancelled or running into the timeout because there's
190
+ // nothing to do but retry anyway
191
+ let long_poll_allowed =
192
+ is_long_poll && [Code::Cancelled, Code::DeadlineExceeded].contains(&e.code());
193
+
194
+ if RETRYABLE_ERROR_CODES.contains(&e.code()) || long_poll_allowed {
195
+ if current_attempt == 1 {
196
+ debug!(error=?e, "gRPC call {} failed on first attempt", self.call_name);
197
+ } else if self.should_log_retry_warning(current_attempt) {
198
+ warn!(error=?e, "gRPC call {} retried {} times", self.call_name, current_attempt);
199
+ }
200
+
201
+ match self.backoff.next_backoff() {
202
+ None => RetryPolicy::ForwardError(e), // None is returned when we've ran out of time
203
+ Some(backoff) => {
204
+ // We treat ResourceExhausted as a special case and backoff more
205
+ // so we don't overload the server
206
+ if e.code() == Code::ResourceExhausted {
207
+ let extended_backoff =
208
+ backoff.max(self.throttle_backoff.next_backoff().unwrap_or_default());
209
+ RetryPolicy::WaitRetry(extended_backoff)
210
+ } else {
211
+ RetryPolicy::WaitRetry(backoff)
212
+ }
213
+ }
214
+ }
215
+ } else if is_long_poll && self.backoff.get_elapsed_time() <= LONG_POLL_FATAL_GRACE {
216
+ // We permit "fatal" errors while long polling for a while, because some proxies return
217
+ // stupid error codes while getting ready, among other weird infra issues
218
+ RetryPolicy::WaitRetry(self.backoff.max_interval)
219
+ } else {
220
+ RetryPolicy::ForwardError(e)
221
+ }
222
+ }
223
+ }
224
+
225
+ macro_rules! retry_call {
226
+ ($myself:ident, $call_name:ident) => { retry_call!($myself, $call_name,) };
227
+ ($myself:ident, $call_name:ident, $($args:expr),*) => {{
228
+ let call_name_str = stringify!($call_name);
229
+ let fact = || { $myself.get_client().$call_name($($args,)*)};
230
+ $myself.call_with_retry(fact, call_name_str).await
231
+ }}
232
+ }
233
+
234
+ // Ideally, this would be auto-implemented for anything that implements the raw client, but that
235
+ // breaks all our retry clients which use a mock since it's based on this trait currently. Ideally
236
+ // we would create an automock for the WorkflowServiceClient copy-paste trait and use that, but
237
+ // that's a huge pain. Maybe one day tonic will provide traits.
238
+ #[async_trait::async_trait]
239
+ impl<SG> WorkflowClientTrait for RetryClient<SG>
240
+ where
241
+ SG: WorkflowClientTrait + Send + Sync + 'static,
242
+ {
243
+ async fn start_workflow(
244
+ &self,
245
+ input: Vec<Payload>,
246
+ task_queue: String,
247
+ workflow_id: String,
248
+ workflow_type: String,
249
+ request_id: Option<String>,
250
+ options: WorkflowOptions,
251
+ ) -> Result<StartWorkflowExecutionResponse> {
252
+ retry_call!(
253
+ self,
254
+ start_workflow,
255
+ input.clone(),
256
+ task_queue.clone(),
257
+ workflow_id.clone(),
258
+ workflow_type.clone(),
259
+ request_id.clone(),
260
+ options.clone()
261
+ )
262
+ }
263
+
264
+ async fn reset_sticky_task_queue(
265
+ &self,
266
+ workflow_id: String,
267
+ run_id: String,
268
+ ) -> Result<ResetStickyTaskQueueResponse> {
269
+ retry_call!(
270
+ self,
271
+ reset_sticky_task_queue,
272
+ workflow_id.clone(),
273
+ run_id.clone()
274
+ )
275
+ }
276
+
277
+ async fn complete_activity_task(
278
+ &self,
279
+ task_token: TaskToken,
280
+ result: Option<Payloads>,
281
+ ) -> Result<RespondActivityTaskCompletedResponse> {
282
+ retry_call!(
283
+ self,
284
+ complete_activity_task,
285
+ task_token.clone(),
286
+ result.clone()
287
+ )
288
+ }
289
+
290
+ async fn record_activity_heartbeat(
291
+ &self,
292
+ task_token: TaskToken,
293
+ details: Option<Payloads>,
294
+ ) -> Result<RecordActivityTaskHeartbeatResponse> {
295
+ retry_call!(
296
+ self,
297
+ record_activity_heartbeat,
298
+ task_token.clone(),
299
+ details.clone()
300
+ )
301
+ }
302
+
303
+ async fn cancel_activity_task(
304
+ &self,
305
+ task_token: TaskToken,
306
+ details: Option<Payloads>,
307
+ ) -> Result<RespondActivityTaskCanceledResponse> {
308
+ retry_call!(
309
+ self,
310
+ cancel_activity_task,
311
+ task_token.clone(),
312
+ details.clone()
313
+ )
314
+ }
315
+
316
+ async fn fail_activity_task(
317
+ &self,
318
+ task_token: TaskToken,
319
+ failure: Option<Failure>,
320
+ ) -> Result<RespondActivityTaskFailedResponse> {
321
+ retry_call!(
322
+ self,
323
+ fail_activity_task,
324
+ task_token.clone(),
325
+ failure.clone()
326
+ )
327
+ }
328
+
329
+ async fn fail_workflow_task(
330
+ &self,
331
+ task_token: TaskToken,
332
+ cause: WorkflowTaskFailedCause,
333
+ failure: Option<Failure>,
334
+ ) -> Result<RespondWorkflowTaskFailedResponse> {
335
+ retry_call!(
336
+ self,
337
+ fail_workflow_task,
338
+ task_token.clone(),
339
+ cause,
340
+ failure.clone()
341
+ )
342
+ }
343
+
344
+ async fn signal_workflow_execution(
345
+ &self,
346
+ workflow_id: String,
347
+ run_id: String,
348
+ signal_name: String,
349
+ payloads: Option<Payloads>,
350
+ request_id: Option<String>,
351
+ ) -> Result<SignalWorkflowExecutionResponse> {
352
+ retry_call!(
353
+ self,
354
+ signal_workflow_execution,
355
+ workflow_id.clone(),
356
+ run_id.clone(),
357
+ signal_name.clone(),
358
+ payloads.clone(),
359
+ request_id.clone()
360
+ )
361
+ }
362
+
363
+ async fn signal_with_start_workflow_execution(
364
+ &self,
365
+ input: Option<Payloads>,
366
+ task_queue: String,
367
+ workflow_id: String,
368
+ workflow_type: String,
369
+ request_id: Option<String>,
370
+ options: WorkflowOptions,
371
+ signal_name: String,
372
+ signal_input: Option<Payloads>,
373
+ signal_header: Option<Header>,
374
+ ) -> Result<SignalWithStartWorkflowExecutionResponse> {
375
+ retry_call!(
376
+ self,
377
+ signal_with_start_workflow_execution,
378
+ input.clone(),
379
+ task_queue.clone(),
380
+ workflow_id.clone(),
381
+ workflow_type.clone(),
382
+ request_id.clone(),
383
+ options.clone(),
384
+ signal_name.clone(),
385
+ signal_input.clone(),
386
+ signal_header.clone()
387
+ )
388
+ }
389
+
390
+ async fn query_workflow_execution(
391
+ &self,
392
+ workflow_id: String,
393
+ run_id: String,
394
+ query: WorkflowQuery,
395
+ ) -> Result<QueryWorkflowResponse> {
396
+ retry_call!(
397
+ self,
398
+ query_workflow_execution,
399
+ workflow_id.clone(),
400
+ run_id.clone(),
401
+ query.clone()
402
+ )
403
+ }
404
+
405
+ async fn describe_workflow_execution(
406
+ &self,
407
+ workflow_id: String,
408
+ run_id: Option<String>,
409
+ ) -> Result<DescribeWorkflowExecutionResponse> {
410
+ retry_call!(
411
+ self,
412
+ describe_workflow_execution,
413
+ workflow_id.clone(),
414
+ run_id.clone()
415
+ )
416
+ }
417
+
418
+ async fn get_workflow_execution_history(
419
+ &self,
420
+ workflow_id: String,
421
+ run_id: Option<String>,
422
+ page_token: Vec<u8>,
423
+ ) -> Result<GetWorkflowExecutionHistoryResponse> {
424
+ retry_call!(
425
+ self,
426
+ get_workflow_execution_history,
427
+ workflow_id.clone(),
428
+ run_id.clone(),
429
+ page_token.clone()
430
+ )
431
+ }
432
+
433
+ async fn respond_legacy_query(
434
+ &self,
435
+ task_token: TaskToken,
436
+ query_result: QueryResult,
437
+ ) -> Result<RespondQueryTaskCompletedResponse> {
438
+ retry_call!(
439
+ self,
440
+ respond_legacy_query,
441
+ task_token.clone(),
442
+ query_result.clone()
443
+ )
444
+ }
445
+
446
+ async fn cancel_workflow_execution(
447
+ &self,
448
+ workflow_id: String,
449
+ run_id: Option<String>,
450
+ reason: String,
451
+ request_id: Option<String>,
452
+ ) -> Result<RequestCancelWorkflowExecutionResponse> {
453
+ retry_call!(
454
+ self,
455
+ cancel_workflow_execution,
456
+ workflow_id.clone(),
457
+ run_id.clone(),
458
+ reason.clone(),
459
+ request_id.clone()
460
+ )
461
+ }
462
+
463
+ async fn terminate_workflow_execution(
464
+ &self,
465
+ workflow_id: String,
466
+ run_id: Option<String>,
467
+ ) -> Result<TerminateWorkflowExecutionResponse> {
468
+ retry_call!(
469
+ self,
470
+ terminate_workflow_execution,
471
+ workflow_id.clone(),
472
+ run_id.clone()
473
+ )
474
+ }
475
+
476
+ async fn list_namespaces(&self) -> Result<ListNamespacesResponse> {
477
+ retry_call!(self, list_namespaces,)
478
+ }
479
+
480
+ async fn describe_namespace(&self, namespace: Namespace) -> Result<DescribeNamespaceResponse> {
481
+ retry_call!(self, describe_namespace, namespace.clone())
482
+ }
483
+
484
+ async fn list_open_workflow_executions(
485
+ &self,
486
+ maximum_page_size: i32,
487
+ next_page_token: Vec<u8>,
488
+ start_time_filter: Option<StartTimeFilter>,
489
+ filters: Option<ListOpenFilters>,
490
+ ) -> Result<ListOpenWorkflowExecutionsResponse> {
491
+ retry_call!(
492
+ self,
493
+ list_open_workflow_executions,
494
+ maximum_page_size,
495
+ next_page_token.clone(),
496
+ start_time_filter.clone(),
497
+ filters.clone()
498
+ )
499
+ }
500
+
501
+ async fn list_closed_workflow_executions(
502
+ &self,
503
+ maximum_page_size: i32,
504
+ next_page_token: Vec<u8>,
505
+ start_time_filter: Option<StartTimeFilter>,
506
+ filters: Option<ListClosedFilters>,
507
+ ) -> Result<ListClosedWorkflowExecutionsResponse> {
508
+ retry_call!(
509
+ self,
510
+ list_closed_workflow_executions,
511
+ maximum_page_size,
512
+ next_page_token.clone(),
513
+ start_time_filter.clone(),
514
+ filters.clone()
515
+ )
516
+ }
517
+
518
+ async fn list_workflow_executions(
519
+ &self,
520
+ page_size: i32,
521
+ next_page_token: Vec<u8>,
522
+ query: String,
523
+ ) -> Result<ListWorkflowExecutionsResponse> {
524
+ retry_call!(
525
+ self,
526
+ list_workflow_executions,
527
+ page_size,
528
+ next_page_token.clone(),
529
+ query.clone()
530
+ )
531
+ }
532
+
533
+ fn get_options(&self) -> &ClientOptions {
534
+ self.client.get_options()
535
+ }
536
+
537
+ fn namespace(&self) -> &str {
538
+ self.client.namespace()
539
+ }
540
+ }
541
+
542
+ #[cfg(test)]
543
+ mod tests {
544
+ use super::*;
545
+ use crate::MockWorkflowClientTrait;
546
+ use assert_matches::assert_matches;
547
+ use backoff::Clock;
548
+ use std::{ops::Add, time::Instant};
549
+ use tonic::Status;
550
+
551
+ /// Predefined retry configs with low durations to make unit tests faster
552
+ const TEST_RETRY_CONFIG: RetryConfig = RetryConfig {
553
+ initial_interval: Duration::from_millis(1),
554
+ randomization_factor: 0.0,
555
+ multiplier: 1.1,
556
+ max_interval: Duration::from_millis(2),
557
+ max_elapsed_time: None,
558
+ max_retries: 10,
559
+ };
560
+
561
+ #[tokio::test]
562
+ async fn non_retryable_errors() {
563
+ for code in [
564
+ Code::InvalidArgument,
565
+ Code::NotFound,
566
+ Code::AlreadyExists,
567
+ Code::PermissionDenied,
568
+ Code::FailedPrecondition,
569
+ Code::Cancelled,
570
+ Code::DeadlineExceeded,
571
+ Code::Unauthenticated,
572
+ Code::Unimplemented,
573
+ ] {
574
+ let mut mock_client = MockWorkflowClientTrait::new();
575
+ mock_client
576
+ .expect_cancel_activity_task()
577
+ .returning(move |_, _| Err(Status::new(code, "non-retryable failure")))
578
+ .times(1);
579
+ let retry_client = RetryClient::new(mock_client, TEST_RETRY_CONFIG);
580
+ let result = retry_client
581
+ .cancel_activity_task(vec![1].into(), None)
582
+ .await;
583
+ // Expecting an error after a single attempt, since there was a non-retryable error.
584
+ assert!(result.is_err());
585
+ }
586
+ }
587
+
588
+ struct FixedClock(Instant);
589
+ impl Clock for FixedClock {
590
+ fn now(&self) -> Instant {
591
+ self.0
592
+ }
593
+ }
594
+
595
+ #[tokio::test]
596
+ async fn long_poll_non_retryable_errors() {
597
+ for code in [
598
+ Code::InvalidArgument,
599
+ Code::NotFound,
600
+ Code::AlreadyExists,
601
+ Code::PermissionDenied,
602
+ Code::FailedPrecondition,
603
+ Code::Unauthenticated,
604
+ Code::Unimplemented,
605
+ ] {
606
+ for call_name in [POLL_WORKFLOW_METH_NAME, POLL_ACTIVITY_METH_NAME] {
607
+ let mut err_handler = TonicErrorHandler {
608
+ max_retries: TEST_RETRY_CONFIG.max_retries,
609
+ call_type: CallType::LongPoll,
610
+ call_name,
611
+ backoff: TEST_RETRY_CONFIG.into_exp_backoff(FixedClock(Instant::now())),
612
+ throttle_backoff: TEST_RETRY_CONFIG
613
+ .into_exp_backoff(FixedClock(Instant::now())),
614
+ };
615
+ let result = err_handler.handle(1, Status::new(code, "Ahh"));
616
+ assert_matches!(result, RetryPolicy::WaitRetry(_));
617
+ err_handler.backoff.clock.0 = err_handler
618
+ .backoff
619
+ .clock
620
+ .0
621
+ .add(LONG_POLL_FATAL_GRACE + Duration::from_secs(1));
622
+ let result = err_handler.handle(2, Status::new(code, "Ahh"));
623
+ assert_matches!(result, RetryPolicy::ForwardError(_));
624
+ }
625
+ }
626
+ }
627
+
628
+ #[tokio::test]
629
+ async fn long_poll_retryable_errors_never_fatal() {
630
+ for code in RETRYABLE_ERROR_CODES {
631
+ for call_name in [POLL_WORKFLOW_METH_NAME, POLL_ACTIVITY_METH_NAME] {
632
+ let mut err_handler = TonicErrorHandler {
633
+ max_retries: TEST_RETRY_CONFIG.max_retries,
634
+ call_type: CallType::LongPoll,
635
+ call_name,
636
+ backoff: TEST_RETRY_CONFIG.into_exp_backoff(FixedClock(Instant::now())),
637
+ throttle_backoff: TEST_RETRY_CONFIG
638
+ .into_exp_backoff(FixedClock(Instant::now())),
639
+ };
640
+ let result = err_handler.handle(1, Status::new(code, "Ahh"));
641
+ assert_matches!(result, RetryPolicy::WaitRetry(_));
642
+ err_handler.backoff.clock.0 = err_handler
643
+ .backoff
644
+ .clock
645
+ .0
646
+ .add(LONG_POLL_FATAL_GRACE + Duration::from_secs(1));
647
+ let result = err_handler.handle(2, Status::new(code, "Ahh"));
648
+ assert_matches!(result, RetryPolicy::WaitRetry(_));
649
+ }
650
+ }
651
+ }
652
+
653
+ #[tokio::test]
654
+ async fn retryable_errors() {
655
+ // Take out retry exhausted since it gets a special policy which would make this take ages
656
+ for code in RETRYABLE_ERROR_CODES
657
+ .iter()
658
+ .copied()
659
+ .filter(|p| p != &Code::ResourceExhausted)
660
+ {
661
+ let mut mock_client = MockWorkflowClientTrait::new();
662
+ mock_client
663
+ .expect_cancel_activity_task()
664
+ .returning(move |_, _| Err(Status::new(code, "retryable failure")))
665
+ .times(3);
666
+ mock_client
667
+ .expect_cancel_activity_task()
668
+ .returning(|_, _| Ok(Default::default()))
669
+ .times(1);
670
+
671
+ let retry_client = RetryClient::new(mock_client, TEST_RETRY_CONFIG);
672
+ let result = retry_client
673
+ .cancel_activity_task(vec![1].into(), None)
674
+ .await;
675
+ // Expecting successful response after retries
676
+ assert!(result.is_ok());
677
+ }
678
+ }
679
+
680
+ #[tokio::test]
681
+ async fn retry_resource_exhausted() {
682
+ let mut err_handler = TonicErrorHandler {
683
+ max_retries: TEST_RETRY_CONFIG.max_retries,
684
+ call_type: CallType::Normal,
685
+ call_name: POLL_WORKFLOW_METH_NAME,
686
+ backoff: TEST_RETRY_CONFIG.into_exp_backoff(FixedClock(Instant::now())),
687
+ throttle_backoff: RetryConfig {
688
+ initial_interval: Duration::from_millis(2),
689
+ randomization_factor: 0.0,
690
+ multiplier: 4.0,
691
+ max_interval: Duration::from_millis(10),
692
+ max_elapsed_time: None,
693
+ max_retries: 10,
694
+ }
695
+ .into_exp_backoff(FixedClock(Instant::now())),
696
+ };
697
+ let result = err_handler.handle(1, Status::new(Code::ResourceExhausted, "leave me alone"));
698
+ match result {
699
+ RetryPolicy::WaitRetry(duration) => assert_eq!(duration, Duration::from_millis(2)),
700
+ _ => panic!(),
701
+ }
702
+ err_handler.backoff.clock.0 = err_handler.backoff.clock.0.add(Duration::from_millis(10));
703
+ err_handler.throttle_backoff.clock.0 = err_handler
704
+ .throttle_backoff
705
+ .clock
706
+ .0
707
+ .add(Duration::from_millis(10));
708
+ let result = err_handler.handle(2, Status::new(Code::ResourceExhausted, "leave me alone"));
709
+ match result {
710
+ RetryPolicy::WaitRetry(duration) => assert_eq!(duration, Duration::from_millis(8)),
711
+ _ => panic!(),
712
+ }
713
+ }
714
+
715
+ #[tokio::test]
716
+ async fn long_poll_retries_forever() {
717
+ // A bit odd, but we don't need a real client to test the retry client passes through the
718
+ // correct retry config
719
+ let fake_retry = RetryClient::new((), TEST_RETRY_CONFIG);
720
+ for i in 1..=50 {
721
+ for call in [POLL_WORKFLOW_METH_NAME, POLL_ACTIVITY_METH_NAME] {
722
+ let mut err_handler = TonicErrorHandler::new(
723
+ fake_retry.get_retry_config(call),
724
+ fake_retry.get_retry_config(call),
725
+ call,
726
+ );
727
+ let result = err_handler.handle(i, Status::new(Code::Unknown, "Ahh"));
728
+ assert_matches!(result, RetryPolicy::WaitRetry(_));
729
+ }
730
+ }
731
+ }
732
+
733
+ #[tokio::test]
734
+ async fn long_poll_retries_deadline_exceeded() {
735
+ let fake_retry = RetryClient::new((), TEST_RETRY_CONFIG);
736
+ // For some reason we will get cancelled in these situations occasionally (always?) too
737
+ for code in [Code::Cancelled, Code::DeadlineExceeded] {
738
+ for call in [POLL_WORKFLOW_METH_NAME, POLL_ACTIVITY_METH_NAME] {
739
+ let mut err_handler = TonicErrorHandler::new(
740
+ fake_retry.get_retry_config(call),
741
+ fake_retry.get_retry_config(call),
742
+ call,
743
+ );
744
+ for i in 1..=5 {
745
+ let result = err_handler.handle(i, Status::new(code, "retryable failure"));
746
+ assert_matches!(result, RetryPolicy::WaitRetry(_));
747
+ }
748
+ }
749
+ }
750
+ }
751
+ }