HardPoint.Testing 0.1.0-preview.2

HardPoint.Testing

Playwright, MSTest and Reqnroll building blocks for a browser and API test suite: a per-scenario driver, JSON configuration with environment overrides, ExtentReports integration, and scenario hooks that open the application and capture failure artifacts.

Install

dotnet add package HardPoint.Testing --prerelease
pwsh bin/Debug/net10.0/playwright.ps1 install chromium

The package depends on Microsoft.Playwright, Reqnroll.MSTest and ExtentReports. Target framework is net10.0.

What it provides

Configuration contract

The framework reads appsettings.json from the test output directory. appsettings.CI.json is used instead when the CI environment variable is true or 1 and that file exists. Copy both with CopyToOutputDirectory=PreserveNewest.

{
  "browserType": "chromium",
  "applicationUrl": "http://localhost:5168",
  "enforceScenarioTags": false,
  "outputDirectory": "",
  "browserOptions": { "headless": true },
  "apiOptions": { "BaseURL": "http://localhost:5044/api/", "IgnoreHTTPSErrors": true }
}

TEST_-prefixed environment variables override the file: TEST_Headless=true matches the headless key wherever it appears, and TEST_APIRequestNewContextOptions__BaseURL=... addresses a nested setting by its property path (__ separates levels). TEST_CONFIG_FILE replaces the file entirely; a relative value is resolved against the test output directory. An override can only change a key that the file already contains.

A missing or malformed file fails with a message naming the resolved path and the remedy.

Requirements on the consuming test assembly

• Parallelism is not inherited from the package. Assembly-level attributes configure the assembly that declares them, so declare it in your test project:

  [assembly: Parallelize(Scope = ExecutionScope.MethodLevel)]
  

• Bindings. BaseHook carries [Binding] and Reqnroll discovers it from the package reference with only "bindingAssemblies": [] (verified with Reqnroll 3.3.4). If a future Reqnroll version stops scanning package assemblies, add the framework assembly:

  { "bindingAssemblies": ["HardPoint.Testing"] }
  

Artifacts

TestReports.html is written to the artifact directory at the end of the run. traces/ holds a Playwright trace archive per failed @ui scenario; open one with playwright show-trace <file>.zip. screenshots/ holds screenshots attached to the report. ArtifactDirectory is public if your own hooks need the same paths.