benchmark_di is a flexible benchmarking suite to compare DI containers (like cherrypick and get_it) on synthetic, deep, and real-world dependency scenarios – chains, factories, async, named, override, etc.

Features:

Universal registration layer and modular scenario setup (works with any DI)
Built-in support for cherrypick and get_it
Clean CLI for matrix runs and output formats (Markdown, CSV, JSON, pretty)
Reports metrics: timings, memory (RSS, peak), statistical spreads, and more
Extendable via your own DIAdapter or benchmark scenarios

Benchmark Scenarios

registerSingleton: Simple singleton registration/resolution
chainSingleton: Resolution of long singleton chains (A→B→C...)
chainFactory: Chain resolution via factories (new instances each time)
asyncChain: Async chain (with async providers)
named: Named/qualified resolution (e.g. from multiple implementations)
override: Resolution and override in subScopes/child adapters

Supported DI

cherrypick (default)
get_it
Easy to add your own DI by creating a DIAdapter

Switch DI with the CLI option: --di

How to Run

Install dependencies:
```
dart pub get
```
Run all benchmarks (default: all scenarios, 2 warmup, 2 repeats):
```
dart run bin/main.dart --benchmark=all --format=markdown
```

For get_it:

dart run bin/main.dart --di=getit --benchmark=all --format=markdown

Show all CLI options:
```
dart run bin/main.dart --help
```

CLI Parameters

--di — DI implementation: cherrypick (default) or getit
--benchmark, -b — Scenario: registerSingleton, chainSingleton, chainFactory, asyncChain, named, override, all
--chainCount, -c — Number of parallel chains (e.g. 10,100)
--nestingDepth, -d — Chain depth (e.g. 5,10)
--repeat, -r — Measurement repeats (default: 2)
--warmup, -w — Warmup runs (default: 1)
--format, -f — Output: pretty, csv, json, markdown
--help, -h — Usage

Run Examples

All benchmarks for cherrypick:

dart run bin/main.dart --di=cherrypick --benchmark=all --format=markdown

For get_it (all scenarios):

dart run bin/main.dart --di=getit --benchmark=all --format=markdown

Specify chains/depth matrix:

dart run bin/main.dart --benchmark=chainSingleton --chainCount=10,100 --nestingDepth=5,10 --repeat=3 --format=csv

How to Add Your Own DI

Implement a class extending DIAdapter (lib/di_adapters/your_adapter.dart)
Register it in CLI (see cli/benchmark_cli.dart)
Add registration logic to di_universal_registration.dart to build chains for your DI

Architecture

classDiagram
    class BenchmarkCliRunner {
        +run(args)
    }
    class UniversalChainBenchmark {
        +setup()
        +run()
        +teardown()
    }
    class UniversalChainAsyncBenchmark {
        +setup()
        +run()
        +teardown()
    }
    class DIAdapter {
        <<interface>>
        +setupDependencies(cb)
        +resolve<T>(named)
        +resolveAsync<T>(named)
        +teardown()
        +openSubScope(name)
        +waitForAsyncReady()
    }
    class CherrypickDIAdapter
    class GetItAdapter
    class UniversalChainModule {
        +builder(scope)
        +chainCount
        +nestingDepth
        +bindingMode
        +scenario
    }
    class UniversalService {
        <<interface>>
        +value
        +dependency
    }
    class UniversalServiceImpl {
        +UniversalServiceImpl(value, dependency)
    }
    class di_universal_registration {
        +getUniversalRegistration(adapter, ...)
    }
    class Scope
    class UniversalScenario
    class UniversalBindingMode

    %% Relationships
    
    BenchmarkCliRunner --> UniversalChainBenchmark
    BenchmarkCliRunner --> UniversalChainAsyncBenchmark

    UniversalChainBenchmark *-- DIAdapter
    UniversalChainAsyncBenchmark *-- DIAdapter

    DIAdapter <|.. CherrypickDIAdapter
    DIAdapter <|.. GetItAdapter

    CherrypickDIAdapter ..> Scope
    GetItAdapter ..> GetIt: "uses GetIt"

    DIAdapter o--> UniversalChainModule : setupDependencies

    UniversalChainModule ..> UniversalScenario
    UniversalChainModule ..> UniversalBindingMode

    UniversalChainModule o-- UniversalServiceImpl : creates
    UniversalService <|.. UniversalServiceImpl
    UniversalServiceImpl --> UniversalService : dependency

    BenchmarkCliRunner ..> di_universal_registration : uses
    di_universal_registration ..> DIAdapter

    UniversalChainBenchmark ..> di_universal_registration : uses registrar
    UniversalChainAsyncBenchmark ..> di_universal_registration : uses registrar

Metrics

Always collected:

Timings (microseconds): mean, median, stddev, min, max
Memory: RSS difference, peak RSS

License

MIT

README.md Unescape Escape

benchmark_di

Overview