powersemmi / ruststream / 33705318769

98%

Build Type

push

github

Committed by web-flow

Commit Message

Unify the manual path behind one Handle trait and rewrite the macros onto the same rails (#274)

* docs: bring the Cursor rules back in line with the current API

The rules under .cursor/rules had drifted past several redesigns and were
teaching APIs that no longer exist: include_publishing / include_on for
mounting, a publisher built from broker.publisher() at the include site, and an
interior-mutability broker whose connect took &self.

Rewritten against the examples and the broker-authors guide: include is the one
mounting call with its .publisher / .out / .mount chain, publishing goes through
the message builder and the Out slots, the broker contract is the consuming
lifecycle ladder with PublishPolicy and DefaultPublish, and the header types
carry their current names. The core rules also gained the compile-time
invariants ladder, which the project treats as a standing convention and the
file did not mention at all.

* docs: teach the service rules through the prelude

The usage rules spelled out an explicit import list in every snippet, which is
not how a service on this crate is meant to be written: the prelude exists to be
the one glob, and on a broker crate globbing that crate's prelude is the
service's broker statement.

Every snippet now opens on the glob, and only what genuinely sits outside it
stays explicit - the in-core broker, codecs, the optional feature modules, and
the few runtime items the prelude deliberately leaves out. Swapping the broker
reads as swapping the glob, which is the point.

* docs: settle through the constructors and cover the rest of the publish surface

The snippets returned the bare `HandlerResult::Ack` variant, which reads
differently from every nack and does not chain, so they now use `ack()` next to
`retry()`, `drop()` and `retry_after(..)`.

Adds what the rules had no entry for at all: post-settle continuations
(`and_after`, its `Settle` return and its at-most-once contract), the `Out`
slot's typing surface en... (continued)

Coverage Stats

1815 of 1864 new or added lines in 61 files covered. (97.37%)

4 existing lines in 2 files now uncovered.

12137 of 12435 relevant lines covered (97.6%)

293.04 hits per line