Home

Pudu Mediator

pudu-lang-mediator is in-process messaging for Pudu, written in Pudu. The parts of a program talk through a mediator instead of calling each other: a request is answered by exactly one handler, a notification reaches every handler of its kind, and a stream request answers a sequence of items. Every message runs through a pipeline of behaviors, processors, and exception components composed once when the mediator is built, and every answer is an Outcome — a value, or a Failure saying why there is none. Nothing is thrown.

This wiki documents the 0.1.0 API. Every program in it was checked with pudu check and run with pudu run against @chrismichaelps/pudu-lang-mediator@0.1.0 on Pudu 0.1.3. The versioned design notes live in the repository wiki/ directory.

Reading the book

The chapters follow the order in which you meet the API. New readers should begin with Getting Started, then continue through Parts I–III. The Reference Index lists every module on one page.

Part I — Asking

1. Getting Started
2. Requests And Commands
3. Pipeline Behaviors
4. Processors And Exceptions

Part II — Announcing and streaming

5. Notifications
6. Streams
7. Context And Cancellation

Part III — Beyond one call site

8. Untyped Dispatch
9. Senders, Publishers, And Testing
10. Integrations

The Worked Programs appendix lists the complete programs in the repository's examples/ directory, ready to run.

Repository

• Source
• Release 0.1.0
• Pudu language