cherrypick/benchmark_di/REPORT.md

Comparative DI Benchmark Report: cherrypick vs get_it vs riverpod

Benchmark Scenarios

1. RegisterSingleton — Registers and resolves a singleton. Baseline DI speed.
2. ChainSingleton — A dependency chain A → B → ... → N (singleton). Deep singleton chain resolution.
3. ChainFactory — All chain elements are factories. Stateless creation chain.
4. AsyncChain — Async chain (async factory). Performance on async graphs.
5. Named — Registers two bindings with names, resolves by name. Named lookup test.
6. Override — Registers a chain/alias in a child scope. Tests scope overrides.

---

Comparative Table: chainCount=10, nestingDepth=10 (Mean, PeakRSS)

Scenario	cherrypick Mean (us)	cherrypick PeakRSS	get_it Mean (us)	get_it PeakRSS	riverpod Mean (us)	riverpod PeakRSS
RegisterSingleton	13.00	273104	8.40	261872	9.80	268512
ChainSingleton	13.80	271072	2.00	262000	33.60	268784
ChainFactory	5.00	299216	4.00	297136	22.80	271296
AsyncChain	28.60	290640	24.60	342976	78.20	285920
Named	2.20	297008	0.20	449824	6.20	281136
Override	7.00	297024	0.00	449824	30.20	281152

Maximum Load: chainCount=100, nestingDepth=100 (Mean, PeakRSS)

Scenario	cherrypick Mean (us)	cherrypick PeakRSS	get_it Mean (us)	get_it PeakRSS	riverpod Mean (us)	riverpod PeakRSS
RegisterSingleton	4.00	271072	1.00	262000	2.00	268688
ChainSingleton	76.60	303312	2.00	297136	221.80	270784
ChainFactory	80.00	293952	39.20	342720	195.80	308640
AsyncChain	251.40	297008	18.20	450640	748.80	285968
Named	2.20	297008	0.00	449824	1.00	281136
Override	104.80	301632	2.20	477344	120.80	294752

---

Analysis

• get_it is the absolute leader in all scenarios, especially under deep/nested chains and async.
• cherrypick is highly competitive and much faster than riverpod on any complex graph.
• riverpod is only suitable for small/simple DI graphs due to major slowdowns with depth, async, or override.

Recommendations

• Use get_it for performance-critical and deeply nested graphs.
• Use cherrypick for scalable/testable apps if a small speed loss is acceptable.
• Use riverpod only if you rely on Flutter integration and your DI chains are simple.

---

Last updated: August 8, 2025.