correspond.testing

An in-memory channel for tests and rehearsals, and python -m correspond.testing: the CLI with it registered.

FakeChannel reads the conversations it was seeded with and records what it is asked to send. It implements Reader and Writer only, so every other operation raises NotSupported, exactly as a real channel without that operation does. Nothing it does leaves the process, which makes it the channel to rehearse a workflow on:

python -m correspond.testing read fake:example/demo
python -m correspond.testing send fake:example/demo "hello" --dry-run

>>> fake = demo_channel()
>>> [m.text for m in fake.read(fake.parse_ref("example/demo"))]
['The export drops the last row.', 'Seen it too, on the CSV export.']

Functions

demo_channel([name])	A FakeChannel seeded with one short conversation, example/demo.
demo_message(*[, conversation, text, ...])	A fictional message, for examples and tests.
main([argv])	The ordinary correspond CLI, with the demo fake channel registered as fake.

Classes

FakeChannel([name, conversations])

A channel held in memory: seeded conversations to read, and a record of sends (sent).

class correspond.testing.FakeChannel(name='fake', *, conversations=None)

Bases: object

A channel held in memory: seeded conversations to read, and a record of sends (sent).

property capabilities: Capabilities

Read and send, with a small text limit; nothing else.

parse_ref(id)

Any non-empty id of letters, digits and ._/#-.

Return type:

ConversationRef

prepare(ref, draft)

The draft as it will post: the notify mentions the text lacks added. Pure.

Return type:

Draft

read(ref, *, since=None, limit=None)

The seeded (and sent) messages of a conversation.

Return type:

list[Message]

send(ref, draft, *, dry_run=False)

Append to the conversation (or, with dry_run, say that it would).

draft.notify handles the text does not @mention are mentioned on a closing cc line, as a mention platform’s writer does (sent keeps the draft as given; the conversation holds the text as posted).

Return type:

SendResult

correspond.testing.demo_channel(name='fake')

A FakeChannel seeded with one short conversation, example/demo.

Return type:

FakeChannel

correspond.testing.demo_message(*, conversation='fake:example/demo', text='The export drops the last row.', message_id='m1', handle='ada', grade=Grade.PLATFORM, labels=(), is_self=False, reply_to=None, sent_at=datetime.datetime(2026, 9, 11, 9, 0, tzinfo=datetime.timezone.utc))

A fictional message, for examples and tests.

Return type:

Message

correspond.testing.main(argv=None)

The ordinary correspond CLI, with the demo fake channel registered as fake.

Return type:

None