requence 0.8.1.dev72__tar.gz → 0.8.1.dev76__tar.gz

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 (78) hide show
  1. {requence-0.8.1.dev72/requence.egg-info → requence-0.8.1.dev76}/PKG-INFO +1 -1
  2. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/pyproject.toml +1 -1
  3. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/__init__.py +40 -3
  4. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/wire.py +12 -0
  5. {requence-0.8.1.dev72 → requence-0.8.1.dev76/requence.egg-info}/PKG-INFO +1 -1
  6. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/MANIFEST.in +0 -0
  7. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/README.md +0 -0
  8. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/__init__.py +0 -0
  9. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/callbacks/__init__.py +0 -0
  10. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/callbacks/context.py +0 -0
  11. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/callbacks/handler.py +0 -0
  12. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/client_properties.py +0 -0
  13. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/context.py +0 -0
  14. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/exceptions.py +0 -0
  15. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/__init__.py +0 -0
  16. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/errors.py +0 -0
  17. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/handlers/__init__.py +0 -0
  18. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/handlers/claim_check_handler.py +0 -0
  19. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/handlers/context.py +0 -0
  20. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/handlers/file_handler.py +0 -0
  21. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/handlers/stream_handler.py +0 -0
  22. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/pending_uploads.py +0 -0
  23. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/requence_file.py +0 -0
  24. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/requence_stream.py +0 -0
  25. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/sanitize_log_data.py +0 -0
  26. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/stream_framing.py +0 -0
  27. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/files/transport.py +0 -0
  28. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/internal_types.py +0 -0
  29. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/logger.py +0 -0
  30. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/obfuscase.py +0 -0
  31. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/py.typed +0 -0
  32. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/reachable.py +0 -0
  33. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/requence_callback.py +0 -0
  34. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/requence_file.py +0 -0
  35. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/requence_stream.py +0 -0
  36. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/boundary.py +0 -0
  37. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/callback_growth.py +0 -0
  38. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/cli.py +0 -0
  39. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/durable_callback.py +0 -0
  40. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/surface_handler.py +0 -0
  41. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/transformer.py +0 -0
  42. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/types.py +0 -0
  43. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/ui.py +0 -0
  44. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/service/ui_watch.py +0 -0
  45. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/store.py +0 -0
  46. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/__init__.py +0 -0
  47. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/abort_task.py +0 -0
  48. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/ack_task.py +0 -0
  49. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/cli.py +0 -0
  50. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/get_task.py +0 -0
  51. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/ingress.py +0 -0
  52. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/protect_task.py +0 -0
  53. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/task.py +0 -0
  54. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/task_watcher.py +0 -0
  55. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/types.py +0 -0
  56. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/updates.py +0 -0
  57. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/task/utils.py +0 -0
  58. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/__init__.py +0 -0
  59. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/context.py +0 -0
  60. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/errors.py +0 -0
  61. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/guards.py +0 -0
  62. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/message_handler.py +0 -0
  63. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/transform.py +0 -0
  64. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/value_handler.py +0 -0
  65. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/transformer/walk.py +0 -0
  66. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/utils.py +0 -0
  67. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence/wire_codec.py +0 -0
  68. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence.egg-info/SOURCES.txt +0 -0
  69. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence.egg-info/dependency_links.txt +0 -0
  70. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence.egg-info/entry_points.txt +0 -0
  71. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence.egg-info/requires.txt +0 -0
  72. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/requence.egg-info/top_level.txt +0 -0
  73. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/setup.cfg +0 -0
  74. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/tests/test_client_properties.py +0 -0
  75. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/tests/test_logger.py +0 -0
  76. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/tests/test_store_parity.py +0 -0
  77. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/tests/test_wire.py +0 -0
  78. {requence-0.8.1.dev72 → requence-0.8.1.dev76}/tests/test_wire_codec.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: requence
3
- Version: 0.8.1.dev72
3
+ Version: 0.8.1.dev76
4
4
  Summary: Requence Service
5
5
  Author: Torsten Blindert
6
6
  Requires-Python: >=3.12
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "requence"
7
- version = "0.8.1.dev72"
7
+ version = "0.8.1.dev76"
8
8
  description = "Requence Service"
9
9
  readme = { file = "README.md", content-type = "text/markdown" }
10
10
  authors = [{ name = "Torsten Blindert" }]
@@ -25,6 +25,7 @@ from ..wire import (
25
25
  DEFAULT_SURFACE_ID,
26
26
  DURABLE_CALLBACK_QUEUE_ARGUMENTS,
27
27
  MAX_SURFACE_INTERACTION_ERROR_CHARS,
28
+ NODE_RESUME_HEADER,
28
29
  REFERENCE_TAG_KEY,
29
30
  SURFACE_HANDLER_QUEUE_ARGUMENTS,
30
31
  SURFACE_HANDLER_TAG,
@@ -827,11 +828,15 @@ class Service:
827
828
  headers: dict[str, Any],
828
829
  failure_label: str,
829
830
  announce: Optional[str] = None,
831
+ correlation_id: Optional[str] = None,
830
832
  ):
831
833
  """A publish on the ordinary result exchange that is NOT a result for any
832
- dispatch: no correlation id, no index, no place in the ordered dispatch
833
- buffer. The operator answers these messages' marker headers before it looks
834
- for either.
834
+ dispatch: no index and no place in the ordered dispatch buffer. The operator
835
+ answers these messages' marker headers before it looks for either.
836
+
837
+ ``correlation_id`` is for the one of these that does belong to a message: a
838
+ resume announcement (#271) names the run it re-attached to. The other two
839
+ belong to no message at all and pass none.
835
840
 
836
841
  Always JSON, unlike a reply: there is no dispatch here whose codec could be
837
842
  echoed. Encoded through ``wire_codec`` all the same, so the SDK keeps its one
@@ -849,6 +854,7 @@ class Service:
849
854
  properties=pika.BasicProperties(
850
855
  content_type=content_type,
851
856
  delivery_mode=pika.DeliveryMode.Persistent,
857
+ correlation_id=correlation_id,
852
858
  headers=headers,
853
859
  ),
854
860
  )
@@ -882,6 +888,32 @@ class Service:
882
888
  )
883
889
  )
884
890
 
891
+ def __announce_resume(self, task_id: str, message_id: str):
892
+ """Say that this process has re-attached to a deferred node (#271) — the
893
+ moment the node starts working again.
894
+
895
+ Nobody else can say it. The operator dispatched this message days ago and
896
+ hears nothing when someone picks it up: ``act()`` publishes no ``begin``,
897
+ and there is no ``defer`` on its actor API, so a run defers at most once and
898
+ without this the defer runs to the end of the run. A form deferred three
899
+ days whose handler then spends four minutes building a PDF reported one
900
+ second of work.
901
+
902
+ Carries **no index**, which is why it is a side channel at all: the
903
+ announcement takes no place in the message's ordered output stream, and a
904
+ ``begin`` — the other way to say this — lands on the operator's
905
+ begin-rewind, which resets a deferred message's index space and is what
906
+ keeps a re-attach's render from being discarded as a duplicate."""
907
+ self.__schedule(
908
+ functools.partial(
909
+ self.__publish_side_channel,
910
+ {"messageId": message_id},
911
+ {"taskId": task_id, NODE_RESUME_HEADER: True},
912
+ f"announce the resume of message |{message_id}|",
913
+ correlation_id=message_id,
914
+ )
915
+ )
916
+
885
917
  def __publish_bundle_swap(self, ui: RequenceUI[Any]):
886
918
  """The dev loop (#108): a rebuilt component is a **bundle swap**, not a
887
919
  render.
@@ -1981,6 +2013,11 @@ class Service:
1981
2013
  "render": render
1982
2014
  }
1983
2015
 
2016
+ # Before the actor, so the row that closes the defer segment sits ahead of
2017
+ # everything the actor publishes — including work it does before its first
2018
+ # send, which is the whole stretch this exists to make measurable.
2019
+ self.__announce_resume(task_id, message_id)
2020
+
1984
2021
  result = actor(api)
1985
2022
 
1986
2023
  if inspect.isgenerator(result):
@@ -354,6 +354,18 @@ MAX_SURFACE_INTERACTION_ERROR_CHARS: Final = 500
354
354
  # dispatch buffer.
355
355
  UI_REBUILD_HEADER: Final = "uiRebuild"
356
356
 
357
+ # Marks a service message as ``act()`` announcing that it has re-attached to a
358
+ # deferred node (#271). Answered before a result is looked for, for the one reason
359
+ # the two headers above share: it carries **no index**, so it has no place in the
360
+ # ordered dispatch buffer. Unlike them it does belong to a message of the
361
+ # operator's — that is the whole of what it says — so it travels with a correlation
362
+ # id as well as the id in its body.
363
+ #
364
+ # Nothing else says a deferred run picked up again: ``act()`` publishes no
365
+ # ``begin``, and there is no ``defer`` on its actor API, so without this the defer
366
+ # runs to the end of the run and the work after it is invisible.
367
+ NODE_RESUME_HEADER: Final = "nodeResume"
368
+
357
369
 
358
370
  def service_handler_queue_name(dispatch_queue: str) -> str:
359
371
  """The per-version **handler queue**: where a durable invocation waits until
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: requence
3
- Version: 0.8.1.dev72
3
+ Version: 0.8.1.dev76
4
4
  Summary: Requence Service
5
5
  Author: Torsten Blindert
6
6
  Requires-Python: >=3.12
File without changes
File without changes