Skip to content

Installation

Requirements

  • Python 3.12 or later
  • Pydantic v2 (automatically installed)

Install

pip install attack-on-domain

Or with uv:

uv add attack-on-domain

Testing Utilities (optional)

The testing utilities (aod.testing — fakes, spies, stubs, and assertion helpers) live in a separate package attack-on-domain-testing. Install it in your development environment:

pip install "attack-on-domain[testing]"

Or with uv:

uv add "attack-on-domain[testing]"

You can also install the testing package directly. It is not needed in production.

Verify

import aod
print(aod.__version__)

Dependencies

attack-on-domain requires:

  • pydantic>=2.12.4 — Core validation and serialization
  • polyfactory>=3.3.0 — Test data generation
  • typing-inspect>=0.9.0 — Type inspection utilities

Next Steps

Quick Start

Build your first domain in 5 minutes

DDD Concepts

Learn the theory behind Domain-Driven Design