# notorious-coding/notorious-test architecture

> Architecture diagram of the GitHub repository notorious-coding/notorious-test, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/notorious-coding/notorious-test
- Repository: https://github.com/notorious-coding/notorious-test

## Overview

NotoriousTest is a .NET integration-testing framework that provisions isolated dependencies, shares their configuration with applications under test, resets state between tests, and tears resources down. The principal flow is test framework fixture → environment orchestration → infrastructure lifecycle → test use, with registry/watchdog recovery alongside it. README capabilities include multiple test-framework adapters and database, container, web, and Azure Functions integrations. Several integration nodes are documented but their implementations were not sampled; their relationships are shown only where documented.

Main entry points: [`NotoriousTest.Core/Environments/EnvironmentBase.cs`](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Environments/EnvironmentBase.cs) (Environment orchestration), [`NotoriousTest.Database/DatabaseInfrastructureBase.cs`](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/DatabaseInfrastructureBase.cs) (Database lifecycle), [`NotoriousTest.Core/Infrastructures/Infrastructure.cs`](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Infrastructures/Infrastructure.cs) (Infrastructure lifecycle), [`NotoriousTest.Internal.SqlLiteRegistry/SqliteRegistryProvider.cs`](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.SqlLiteRegistry/SqliteRegistryProvider.cs) (Infrastructure registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Test entry points"]
  node_tests["Integration tests<br/>[README.md]"]
  node_frameworks["Framework adapters"]
  node_fixture["Test fixtures<br/>[Fixture.cs]"]
end

subgraph group_core["Environment lifecycle"]
  node_environment["Environment orchestration<br/>[EnvironmentBase.cs]"]
  node_infrastructure["Infrastructure lifecycle<br/>[Infrastructure.cs]"]
  node_configuration["Shared configuration"]
  node_requirements["Requirements and dependencies"]
  node_settings["Runtime settings"]
end

subgraph group_infra["Infrastructure integrations"]
  node_database["Database lifecycle"]
  node_docker_db["Docker databases"]
  node_external_db["External databases"]
  node_sqlite["SQLite provider"]
  node_sql_providers["SQL providers"]
  node_postgres["PostgreSQL provider"]
  node_containers["Container infrastructure"]
  node_web["ASP.NET integration<br/>[WebApplication.cs]"]
  node_azure["Azure Functions"]
  node_function_tools["Azure tooling dependency"]
end

subgraph group_recovery["Crash recovery"]
  node_registry[("Infrastructure registry")]
  node_watchdog["Watchdog service"]
  node_doggy["Recovery process<br/>[Program.cs]"]
end

node_engineer(("Test author"))

node_engineer -->|"writes"| node_tests
node_tests -->|"runs through"| node_frameworks
node_frameworks -.->|"uses"| node_fixture
node_fixture -->|"creates"| node_environment
node_environment -->|"initializes"| node_infrastructure
node_environment -->|"verifies and installs"| node_requirements
node_environment -->|"aggregates"| node_configuration
node_infrastructure -->|"registers and updates"| node_registry
node_database -->|"extends lifecycle"| node_infrastructure
node_docker_db -->|"starts container then initializes"| node_database
node_external_db -->|"initializes from settings"| node_database
node_sqlite -->|"extends provider"| node_external_db
node_sql_providers -.->|"provides SQL infrastructure"| node_database
node_postgres -.->|"extends provider"| node_external_db
node_containers -.->|"provides containers"| node_infrastructure
node_web -.->|"receives shared settings"| node_configuration
node_azure -->|"uses tooling dependency"| node_function_tools
node_environment -->|"ensures registry"| node_registry
node_environment -->|"starts and signals"| node_watchdog
node_watchdog -->|"configures registry access"| node_registry
node_doggy -->|"loads registry"| node_registry
node_doggy -.->|"runs recovery"| node_watchdog
node_environment -.->|"receives settings"| node_settings
node_environment -->|"supports reset between tests"| node_tests
node_environment -->|"destroys resources"| node_infrastructure
node_database -->|"publishes connection settings"| node_configuration
node_database -->|"resets database state"| node_infrastructure
node_environment -->|"recovers after crashes"| node_doggy

click node_tests "https://github.com/notorious-coding/notorious-test/blob/develop/README.md"
click node_frameworks "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.XUnit/IntegrationTestBase.cs"
click node_fixture "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Fixture.cs"
click node_environment "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Environments/EnvironmentBase.cs"
click node_infrastructure "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Infrastructures/Infrastructure.cs"
click node_configuration "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Configuration/ConfigurationEntry.cs"
click node_requirements "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Infrastructures/Dependencies/IInfrastructureDependency.cs"
click node_database "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/DatabaseInfrastructureBase.cs"
click node_docker_db "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/DockerDatabaseInfrastructure.cs"
click node_external_db "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/ExternalDatabaseInfrastructure.cs"
click node_sqlite "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Sqlite/SqliteInfrastructure.cs"
click node_sql_providers "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.SqlServer/SqlServerInfrastructure.cs"
click node_postgres "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.PostgreSql/PostgreInfrastructure.cs"
click node_containers "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.TestContainers/DockerContainerInfrastructure.cs"
click node_web "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Web/Applications/WebApplication.cs"
click node_azure "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Web.AzureFunctions/AzureFunctionWebApplication.cs"
click node_registry "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.SqlLiteRegistry/SqliteRegistryProvider.cs"
click node_watchdog "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.Watchdog/DoggyDogWatchDog.cs"
click node_doggy "https://github.com/notorious-coding/notorious-test/blob/develop/DoggyDog/Program.cs"
click node_settings "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.TestSettings/TestSettingsProvider.cs"
click node_function_tools "https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Dependencies.Azure.FunctionCoreTools/AzureFunctionCoreToolsDependency.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_tests,node_frameworks,node_fixture toneBlue
class node_environment,node_infrastructure,node_configuration,node_requirements,node_settings toneAmber
class node_database,node_docker_db,node_external_db,node_sqlite,node_sql_providers,node_postgres,node_containers,node_web,node_azure,node_function_tools toneMint
class node_registry,node_watchdog,node_doggy toneRose
class node_engineer toneIndigo
```

## Components

### Test entry points

- [Integration tests](https://github.com/notorious-coding/notorious-test/blob/develop/README.md): `README.md`
- [Framework adapters](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.XUnit/IntegrationTestBase.cs): `NotoriousTest.XUnit/IntegrationTestBase.cs`
- [Test fixtures](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Fixture.cs): `NotoriousTest.Core/Fixture.cs`

### Environment lifecycle

- [Environment orchestration](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Environments/EnvironmentBase.cs): `NotoriousTest.Core/Environments/EnvironmentBase.cs`
- [Infrastructure lifecycle](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Infrastructures/Infrastructure.cs): `NotoriousTest.Core/Infrastructures/Infrastructure.cs`
- [Shared configuration](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Configuration/ConfigurationEntry.cs): `NotoriousTest.Core/Configuration/ConfigurationEntry.cs`
- [Requirements and dependencies](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Core/Infrastructures/Dependencies/IInfrastructureDependency.cs): `NotoriousTest.Core/Infrastructures/Dependencies/IInfrastructureDependency.cs`
- [Runtime settings](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.TestSettings/TestSettingsProvider.cs): `NotoriousTest.Internal.TestSettings/TestSettingsProvider.cs`

### Infrastructure integrations

- [Database lifecycle](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/DatabaseInfrastructureBase.cs): `NotoriousTest.Database/DatabaseInfrastructureBase.cs`
- [Docker databases](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/DockerDatabaseInfrastructure.cs): `NotoriousTest.Database/DockerDatabaseInfrastructure.cs`
- [External databases](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Database/ExternalDatabaseInfrastructure.cs): `NotoriousTest.Database/ExternalDatabaseInfrastructure.cs`
- [SQLite provider](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Sqlite/SqliteInfrastructure.cs): `NotoriousTest.Sqlite/SqliteInfrastructure.cs`
- [SQL providers](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.SqlServer/SqlServerInfrastructure.cs): `NotoriousTest.SqlServer/SqlServerInfrastructure.cs`
- [PostgreSQL provider](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.PostgreSql/PostgreInfrastructure.cs): `NotoriousTest.PostgreSql/PostgreInfrastructure.cs`
- [Container infrastructure](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.TestContainers/DockerContainerInfrastructure.cs): `NotoriousTest.TestContainers/DockerContainerInfrastructure.cs`
- [ASP.NET integration](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Web/Applications/WebApplication.cs): `NotoriousTest.Web/Applications/WebApplication.cs`
- [Azure Functions](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Web.AzureFunctions/AzureFunctionWebApplication.cs): `NotoriousTest.Web.AzureFunctions/AzureFunctionWebApplication.cs`
- [Azure tooling dependency](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Dependencies.Azure.FunctionCoreTools/AzureFunctionCoreToolsDependency.cs): `NotoriousTest.Dependencies.Azure.FunctionCoreTools/AzureFunctionCoreToolsDependency.cs`

### Crash recovery

- [Infrastructure registry](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.SqlLiteRegistry/SqliteRegistryProvider.cs): `NotoriousTest.Internal.SqlLiteRegistry/SqliteRegistryProvider.cs`
- [Watchdog service](https://github.com/notorious-coding/notorious-test/blob/develop/NotoriousTest.Internal.Watchdog/DoggyDogWatchDog.cs): `NotoriousTest.Internal.Watchdog/DoggyDogWatchDog.cs`
- [Recovery process](https://github.com/notorious-coding/notorious-test/blob/develop/DoggyDog/Program.cs): `DoggyDog/Program.cs`

### Other components

- **Test author**

## Connections

- Test author → Integration tests: writes (evidence: `README.md`)
- Integration tests → Framework adapters: runs through (evidence: `README.md`)
- Framework adapters → Test fixtures: uses
- Test fixtures → Environment orchestration: creates (evidence: `NotoriousTest.Core/Fixture.cs`)
- Environment orchestration → Infrastructure lifecycle: initializes (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Environment orchestration → Requirements and dependencies: verifies and installs (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Environment orchestration → Shared configuration: aggregates (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Infrastructure lifecycle → Infrastructure registry: registers and updates (evidence: `NotoriousTest.Core/Infrastructures/Infrastructure.cs`)
- Database lifecycle → Infrastructure lifecycle: extends lifecycle (evidence: `NotoriousTest.Database/DatabaseInfrastructureBase.cs`)
- Docker databases → Database lifecycle: starts container then initializes (evidence: `NotoriousTest.Database/DockerDatabaseInfrastructure.cs`)
- External databases → Database lifecycle: initializes from settings (evidence: `NotoriousTest.Database/ExternalDatabaseInfrastructure.cs`)
- SQLite provider → External databases: extends provider (evidence: `NotoriousTest.Sqlite/SqliteInfrastructure.cs`)
- SQL providers → Database lifecycle: provides SQL infrastructure
- PostgreSQL provider → External databases: extends provider (evidence: `NotoriousTest.PostgreSql/PostgreInfrastructure.cs`)
- Container infrastructure → Infrastructure lifecycle: provides containers
- ASP.NET integration → Shared configuration: receives shared settings (evidence: `README.md`)
- Azure Functions → Azure tooling dependency: uses tooling dependency (evidence: `NotoriousTest.Web.AzureFunctions/AzureFunctionWebApplication.cs`)
- Environment orchestration → Infrastructure registry: ensures registry (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Environment orchestration → Watchdog service: starts and signals (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Watchdog service → Infrastructure registry: configures registry access (evidence: `NotoriousTest.Internal.Watchdog/DoggyDogWatchDog.cs`)
- Recovery process → Infrastructure registry: loads registry (evidence: `DoggyDog/Program.cs`)
- Recovery process → Watchdog service: runs recovery
- Environment orchestration → Runtime settings: receives settings
- Environment orchestration → Integration tests: supports reset between tests (evidence: `README.md`)
- Environment orchestration → Infrastructure lifecycle: destroys resources (evidence: `NotoriousTest.Core/Environments/EnvironmentBase.cs`)
- Database lifecycle → Shared configuration: publishes connection settings (evidence: `README.md`)
- Database lifecycle → Infrastructure lifecycle: resets database state (evidence: `NotoriousTest.Database/DatabaseInfrastructureBase.cs`)
- Environment orchestration → Recovery process: recovers after crashes (evidence: `README.md`)
