Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
dioxide 2.0.1 documentation
Light Logo Dark Logo

Getting Started

  • Getting Started
  • Why dioxide?
  • Why dioxide Exists

User Guide

  • Understanding @service vs @adapter
  • Hexagonal Architecture with dioxide
  • Container Patterns: Global vs Instance
  • Package Scanning
  • Architecture Diagrams

Testing

  • Testing with dioxide
    • Testing Philosophy: Fakes Over Mocks
    • Testing Patterns
    • Test Fixtures
    • Framework Integration Testing
    • Troubleshooting
  • Testing Philosophy: Fakes Over Mocks
  • Testing Patterns
  • Test Fixtures
  • Framework Integration Testing
  • Troubleshooting

Advanced Topics

  • Choosing Between @service and @adapter
  • Scoping Guide
  • Lifecycle Methods: Async/Sync Patterns
  • Decorator Order Guide

Cookbook

  • Cookbook
    • FastAPI Integration
    • Testing Patterns
    • Configuration
    • Database Patterns
    • Building dioxide-Compatible Libraries
  • FastAPI Integration
  • Configuration
  • Database Patterns
  • Testing Patterns

Framework Integrations

  • Django and Django REST Framework Integration

Tutorials

  • Tutorial 1: Basic Dependency Injection
  • Tutorial 2: Email Service with Profiles
  • Tutorial 3: Multi-Tier Application
  • Tutorial 4: Lifecycle Management

API Reference

  • API Reference
    • dioxide
      • dioxide.adapter
      • dioxide.celery
      • dioxide.click
      • dioxide.container
      • dioxide.django
      • dioxide.exceptions
      • dioxide.fastapi
      • dioxide.flask
      • dioxide.lifecycle
      • dioxide.ninja
      • dioxide.profile_enum
      • dioxide.scope
      • dioxide.services
      • dioxide.testing

Troubleshooting

  • Troubleshooting
    • AdapterNotFoundError
    • ServiceNotFoundError
    • CircularDependencyError
    • ScopeError
    • CaptiveDependencyError

Contributing

  • Documentation Versioning Strategy
  • How to Use These Docs
  • Migrating from dependency-injector
  • Dioxide Design Principles
  • ADR-001: Container Architecture
  • ADR-002: PyO3 Binding Strategy
Back to top
View this page
Edit this page

API ReferenceΒΆ

This page contains auto-generated API reference documentation [1].

  • dioxide
    • dioxide.adapter
    • dioxide.celery
    • dioxide.click
    • dioxide.container
    • dioxide.django
    • dioxide.exceptions
    • dioxide.fastapi
    • dioxide.flask
    • dioxide.lifecycle
    • dioxide.ninja
    • dioxide.profile_enum
    • dioxide.scope
    • dioxide.services
    • dioxide.testing
[1]

Created with sphinx-autoapi

Next
dioxide
Previous
Tutorial 4: Lifecycle Management
Copyright © 2026, dioxide Contributors
Made with Sphinx and @pradyunsg's Furo