modrun 1.1.0

Modular application composer for Tokio: domain modules, typed wiring, lifecycle
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82

# Changelog

All notable changes to this project are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## Unreleased

## [1.1.0] - 2026-09-18

### Added

* **`env-filter` feature** — `RUST_LOG` / per-target filtering for `modrun::logging` is now a separate feature (implies `logging`). Default features include it, so behavior is unchanged for existing default-feature users. Use `default-features = false` + `features = ["logging"]` for fx-style console output without the `regex-automata` / `matchers` dependencies; [`try_init`](https://docs.rs/modrun/latest/modrun/logging/fn.try_init.html) then installs a global `INFO` max level instead.

### Changed

* Container: skip ancestor-chain walks for scopes with no private bindings, reducing dependency-resolution overhead in deep module trees.
* Container: eliminate `ArcBox` alias allocation and streamline construction access paths.

## [1.0.2] - 2026-09-15

### Fixed

* Pin dev-dependency `criterion` to 0.7 (0.8 requires Rust 1.86; this crate's MSRV is 1.85).

## [1.0.1] - 2026-09-15

Maintenance release; no application API changes.

### Changed

* Dev-dependency `criterion` upgraded to 0.8 (benchmarks only).

## [1.0.0] - 2026-09-02

First stable release on [crates.io](https://crates.io/crates/modrun). Application-facing API is frozen; see [CONTRIBUTING.md](CONTRIBUTING.md)
for the stability promise and semver rules. Type-erased wiring in [`modrun::__wiring`](https://docs.rs/modrun/latest/modrun/__wiring/index.html)
remains intentionally unstable relative to typed `provide` / `invoke`.

### Added

* [`Group<T>`](https://docs.rs/modrun/latest/modrun/struct.Group.html): multiple modules contribute values of the same type; inject `Group<T>` or `Arc<Group<T>>`. Register members with `provide_group` / `provide_group_result` / `provide_group_async` / `provide_group_result_async`, `supply_group`, or hidden `provide_group_dyn`. Empty groups need [`init_group`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.init_group) or [`require_group`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.require_group) (`require_group` also rejects emptiness at build time). Members require `T: Clone`. `handlers` example.
* [`ModrunBuilder::render_dot`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.render_dot) and [`.dot_graph(path)`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.dot_graph): export the dependency graph as Graphviz DOT after validation, without running constructors or invokers.
* [`task`](https://docs.rs/modrun/latest/modrun/fn.task.html) / [`Stopped`](https://docs.rs/modrun/latest/modrun/struct.Stopped.html) for long-running OnStart work. OnStop signals the task and joins; drop aborts leftover work.
* [`task_with`](https://docs.rs/modrun/latest/modrun/fn.task_with.html) / [`PreparedTask`](https://docs.rs/modrun/latest/modrun/struct.PreparedTask.html): await setup (bind/listen) during OnStart so those failures fail start, then spawn the rest.
* [`logging::try_init`](https://docs.rs/modrun/latest/modrun/logging/fn.try_init.html) / `try_init_with_filter` so callers can detect an existing subscriber.
* Structured tracing fields (`constructor`, `module`, `elapsed`, `error`, …) on framework events, while the `logging` helper still prints fx-style console lines.
* `worker` example: async constructors, primary/replica newtypes, and a `task` that selects on [`Stopped`](https://docs.rs/modrun/latest/modrun/struct.Stopped.html).
* `swap` example: `supply` a test double at the composition root instead of `provide` inside a module.
* Chinese README (`README_zh.md`).

### Changed

* **Breaking:** removed all public `*_mut` builder methods (`provide_mut`, `module_mut`, `build_timeout_mut`, …). Chain on consuming `self` instead.
* **Breaking:** removed `Module::new`; use `Module::builder("name")` (symmetric with `Modrun::builder()`).
* Positioning and docs: modular application **composer** (not generic DI); API matrix and three common patterns (domain module / group / wrapper) in README.
* Type-erased wiring moved to hidden [`modrun::__wiring`](https://docs.rs/modrun/latest/modrun/__wiring/index.html); `provide_dyn` / `invoke_dyn` / `provide_group_dyn` are `#[doc(hidden)]`.
* MSRV lowered from 1.88 to **1.85** (edition 2024 floor; let-chains are unused). CI checks the library with `cargo test` (not `--all-targets`) so examples/benches are not bound to that MSRV.
* [`logging::init`](https://docs.rs/modrun/latest/modrun/logging/fn.init.html) is a no-op when a tracing subscriber is already installed (it no longer panics). The helper writes to stderr; ANSI follows stderr (TTY only).
* Default startup banner is printed to stderr, and only when stderr is a TTY. [`.banner(text)`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.banner) still prints custom text to stderr even when not a TTY.
* [`MultipleStopError`](https://docs.rs/modrun/latest/modrun/struct.MultipleStopError.html) is `#[non_exhaustive]`; use accessors (`count()`, `summary()`, `errors()`).
* `std::io::Error` no longer converts with `From`. Use [`Error::io`](https://docs.rs/modrun/latest/modrun/enum.Error.html#method.io) with a context label.
* Panic during invoke / construct / OnStart / OnStop is traced as `panicked`, not `cancelled`.
* Background [`task`](https://docs.rs/modrun/latest/modrun/fn.task.html) join failures include the task name.
* [`task`](https://docs.rs/modrun/latest/modrun/fn.task.html) / [`task_with`](https://docs.rs/modrun/latest/modrun/fn.task_with.html) request [`Shutdowner::shutdown`](https://docs.rs/modrun/latest/modrun/struct.Shutdowner.html) when the background future returns `Err` or panics, so `run()` does not wait forever for a signal.
* [`Hook::name`](https://docs.rs/modrun/latest/modrun/trait.Hook.html#method.name) now returns `&'static str` instead of `Option<&'static str>`. Unnamed hooks use the sentinel `"unnamed"`. Override the default (via the trait or [`hook().name(...)`](https://docs.rs/modrun/latest/modrun/fn.hook.html)) for clearer logs and errors. Hook trace labels are `{name} (#{index})` (e.g. `unnamed (#0)`, `http (#1)`).
* Named lifecycle hooks and fallible invokers include their name in [`Error`](https://docs.rs/modrun/latest/modrun/enum.Error.html) (`hook 'http' failed`, `invoker my::boot failed`). Unnamed hooks use `hook 'unnamed' failed`. [`Error::Io`](https://docs.rs/modrun/latest/modrun/enum.Error.html) and other non-`Hook` variants keep their identity.
* A [`task`](https://docs.rs/modrun/latest/modrun/fn.task.html) failure during start is an error from [`run`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.run), not a graceful `Ok(())`. If unwind then times out, both are retained on [`Error::CleanupAfterFailure`](https://docs.rs/modrun/latest/modrun/enum.Error.html). [`start`](https://docs.rs/modrun/latest/modrun/struct.ModrunBuilder.html#method.start) still succeeds; observe the failure from `stop()` or [`Shutdowner`](https://docs.rs/modrun/latest/modrun/struct.Shutdowner.html).

### Fixed

* OS signal listeners no longer treat a closed signal stream (`recv() == None`) as Ctrl-C / SIGTERM.
* OnStart `Err` unwinds stop-only hooks that sit after a start hook that never ran, matching shutdown/timeout cancel.

[1.1.0]: https://github.com/shmy/modrun/releases/tag/v1.1.0

[1.0.2]: https://github.com/shmy/modrun/releases/tag/v1.0.2

[1.0.1]: https://github.com/shmy/modrun/releases/tag/v1.0.1

[1.0.0]: https://github.com/shmy/modrun/releases/tag/v1.0.0