# Containers

> Throwaway Linux containers for .NET integration tests — on WSL Containers with no Docker installation, or on Docker.

A Testcontainers-style library for .NET with one API and two interchangeable backends: Microsoft WSL Containers (WSLC) with no Docker installation, or Docker through Testcontainers. Containers are created through backend-neutral abstractions (Purview.Containers.Core) and the backend is resolved at run time, so the same test code runs on WSLC (Purview.Containers.Wsl) or Docker (Purview.Containers.Docker) unchanged. The WSLC backend talks to the WSLC managed C# API directly — no wslc.exe, no docker CLI, no Docker.DotNet. Typed service modules add PostgreSQL, Redis, SQL Server, MySQL, RabbitMQ, Azurite, and NATS, each with its own defaults, configuration, readiness wait strategy, and connection-string helper. The umbrella package Purview.Containers brings the abstractions plus both backends in a single reference.

## Resources

- Repository: https://github.com/purview-dev/containers
- Package: https://www.nuget.org/packages/Purview.Containers
- Project page: https://purview.dev/projects/containers/
- Documentation: https://purview.dev/docs/containers/
- Full machine-readable content: https://purview.dev/projects/containers/llms-full.txt

## Documentation pages

- Containers: https://purview.dev/docs/containers/
- Getting Started: https://purview.dev/docs/containers/getting-started/
- Using it in your tests (auto): https://purview.dev/docs/containers/using-in-your-tests/
- Backends: WSL Containers or Docker: https://purview.dev/docs/containers/backends/
- Consumer Requirements: https://purview.dev/docs/containers/consumer-requirements/
- Architecture: https://purview.dev/docs/containers/architecture/
- Lifecycle: https://purview.dev/docs/containers/lifecycle/
- Networking: https://purview.dev/docs/containers/networking/
- Wait strategies: https://purview.dev/docs/containers/wait-strategies/
- Connection strings: https://purview.dev/docs/containers/connection-strings/
- Modules: https://purview.dev/docs/containers/modules/
- Testing: https://purview.dev/docs/containers/testing/
- Packaging: https://purview.dev/docs/containers/packaging/
- Release Flow: https://purview.dev/docs/containers/release-flow/
- Contributing a module: https://purview.dev/docs/containers/contributing-modules/
- Contributing: https://purview.dev/docs/containers/contributing/