docs: add comparison + 'that-depends or modern-di?' pages by lesnik512 · Pull Request #232 · modern-python/modern-di · GitHub
Skip to content

docs: add comparison + 'that-depends or modern-di?' pages#232

Merged
lesnik512 merged 1 commit into
mainfrom
docs/positioning
Jun 24, 2026
Merged

docs: add comparison + 'that-depends or modern-di?' pages#232
lesnik512 merged 1 commit into
mainfrom
docs/positioning

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Adds two positioning pages under Introduction (the docs had none).

introduction/comparison.md — modern-di vs other libraries

  • Opens with "Do you even need a DI container?" — honestly points single-service FastAPI/Litestar users at native Depends/Provide, and names the break-even triggers (second entrypoint; typed app-scoped singletons; off-request resolution; whole-app test overrides).
  • A landscape table (modern-di / Dishka / dependency-injector / injector / Depends).
  • Honest per-competitor prose: Dishka is the closest library and an excellent choice for custom scopes / async / breadth; modern-di's real edges are the first-party pytest plugin, sync-only simplicity, and the all-official MIT stack. dependency-injector noted as actively maintained again after an earlier hiatus.

introduction/that-depends-or-modern-di.md — the chooser

  • New project → modern-di; existing that-depends → maintained and production-proven, migrate only for scopes / no-global-state. Diff table + "choose X if…", linking the existing migration guide.

Verified: mkdocs build --strict passes; both pages added to the Introduction nav; no link warnings.

Part of the modern-python promotion strategy (DI positioning backbone).

Two positioning pages under Introduction:
- comparison: honest 'do you even need a container?' + modern-di vs
  Dishka / dependency-injector / injector / framework-native.
- that-depends-or-modern-di: a chooser between the two sibling
  frameworks, linking the existing migration guide.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit 82e2a8d into main Jun 24, 2026
7 checks passed
@lesnik512 lesnik512 deleted the docs/positioning branch June 24, 2026 15:11
lesnik512 added a commit that referenced this pull request Jun 25, 2026
Docs (#231 roadmap, #232 comparison pages) + tag-driven release tooling
(#233). No modern_di/ source change since 2.19.1 — the wheel is functionally
identical; notes say so explicitly.

Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant