Skip to content

Fixed the external stream suite on time-skipping and the pydoctor build. - #37

Open
moedash wants to merge 2 commits into
moe/AI-198-ch-pyext-2-channel-surfacefrom
moe/AI-198-if-pyext-1-tooling
Open

moedash wants to merge 2 commits into
moe/AI-198-ch-pyext-2-channel-surfacefrom
moe/AI-198-if-pyext-1-tooling

Conversation

@moedash

@moedash moedash commented Oct 3, 2026

Copy link
Copy Markdown
Owner

This PR fixes two pieces of tooling on the external-streams branch: the time-skipping test run and the docs build.

What changed?

  • The external stream conftest.py skips the server-backed cases when the suite runs on the time-skipping server. Offline cases still run there.
  • Docstrings in contrib/external_workflow_streams and worker/_workflow.py use double backticks for literal text, and the two error tables are realigned.

Part of AI-198 (epic AI-37).

Why?

The server-backed cases measure real-server timing: how long a task was held open, how often a wake sweep runs, how long a shutdown waits. The time-skipping server advances the clock whenever workers go idle, so those cases fail there, and which ones fail changes from run to run. The dev-server step still runs all of them. pydoctor reads single backticks as symbol references, so it failed on shell words, tuples and file names, and it broke the two tables.

How did you test it?

Link to a test plan if any -

  • Unit Tests
  • Staging
  • End to End Tests

Before the change, a handoff case timed out on the time-skipping server. After it, the suite is green there with the server-backed cases skipped, and it's green in full on the dev server. pydoctor exited with errors on this package before and runs clean after. poe lint is clean.

These cases measure real-server timing, which the time-skipping server takes
away, so which of them fail there drifts run to run. Offline cases still run
on both environments.
pydoctor resolves single-backtick prose as symbol references, so shell words,
tuples and file names were read as missing targets. Two tables also lost
their column alignment because pydoctor rewrites role references before
parsing.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

skip-changelog Changelog entry rides another PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant