Skip to content

docs: explain replay-to-realtime transition - #740

Open
russlan23 wants to merge 2 commits into
Point72:mainfrom
russlan23:docs/replay-to-realtime-711
Open

docs: explain replay-to-realtime transition#740
russlan23 wants to merge 2 commits into
Point72:mainfrom
russlan23:docs/replay-to-realtime-711

Conversation

@russlan23

@russlan23 russlan23 commented Aug 5, 2026

Copy link
Copy Markdown

Closes #711.

What changed

Adds a focused "Replay Before Going Realtime" section to the execution-modes documentation. It explains how a past starttime and realtime=True produce a historical replay followed by a live handoff, and includes a Python 3.10-compatible example with an absolute future endtime.

The section also clarifies the roles of historical and realtime adapters and when to use csp.now() and csp.in_realtime().

Validation

  • Parsed all three Python code blocks in Execution-Modes.md with ast.parse.
  • Cross-checked timezone and end-time normalization against csp/impl/wiring/runtime.py.
  • Cross-checked the replay-to-live behavior against the existing test_csp_in_realtime coverage in csp/tests/test_engine.py.
  • Ran git diff --check.

This is a documentation-only change. The documentation lint workflow is awaiting the repository's first-time-contributor approval before it can run.

Signed-off-by: russlan23 <rrusslanjr@gmail.com>
@russlan23
russlan23 marked this pull request as ready for review August 5, 2026 05:37
Comment thread docs/wiki/concepts/Execution-Modes.md Outdated
Signed-off-by: russlan23 <rrusslanjr@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add docs about transitioning from replay to realtime by setting start date in the past

2 participants