Layout
What each Precept package holds. Installing is the shorter version of this table — which one to add for what you are testing.
| Package | What it is |
|---|---|
Precept.Core |
Attributes, ambient test context, settings, outcome exceptions, and the assertion engine. Referenced by test projects. |
Precept.TestPlatform |
The runner: discovery, parallel scheduling, retry, timeouts, result reporting. |
Precept.Reqnroll.Generator |
Reqnroll generator plugin (netstandard2.0, loaded by MSBuild). Turns .feature files into Precept test classes. Not a package of its own — it ships inside Precept.Reqnroll. |
Precept.Reqnroll.ReqnrollPlugin |
Reqnroll runtime plugin. Maps pending/ignored steps onto Precept outcomes. Packaged as Precept.Reqnroll. |
Precept.Web |
Playwright browser automation, isolated per scenario, with screenshot/trace/video capture on failure. |
Precept.Screenplay |
The screenplay pattern: actors, abilities, interactions and questions, with the browser bindings under Precept.Screenplay.Web. The one project that references another module rather than only Precept.Core. |
Precept.Api |
Fluent HTTP client and response assertions, with request/response logging into the test report. |
Precept.Data |
Provider-agnostic ADO.NET access for seeding and asserting against a database. |
Precept.TestData |
Environment-specific data sets, dynamic value generation, factories that create and clean up data, and pooled records leased to one test at a time. |
Precept.Files |
Excel, CSV, JSON and XML files: written from a data table or a query result, appended to, read back as rows, queried by path, validated against a schema, and attached to the test that wrote them. |
Precept.Grpc |
Pooled channels, typed clients, and assertions over status codes, deadlines and streaming. |
Precept.Containers |
Docker-backed dependencies for a run, via Testcontainers, overridable by configuration. |
Precept.Reporting.ReportPortal |
Reports a run to ReportPortal as a launch, with logs and captured files on each test item. |
Precept.Reporting.Teams |
Posts a summary Adaptive Card to a Teams channel at the end of a run, in one of four layouts. |
Precept.Reporting.AzureDevOps |
Files the results as an Azure DevOps test run, linked to the Test Case work items scenarios name. |
Precept.Mcp |
An MCP server that lets a coding agent diagnose a Precept project — the silent failure modes, environment resolution, effective parallelism, filter expressions, test data, and what every module offers. Packaged as a dotnet tool, not a library. |