20 lines
1.2 KiB
Markdown
20 lines
1.2 KiB
Markdown
# Tests and Experiments
|
|
|
|
This directory contains automated tests, manual diagnostic programs, and standalone experiments. It is separate from `src` so test-only dependencies and exploratory code are not included in production assemblies.
|
|
|
|
## Directory map
|
|
|
|
| Directory | Purpose |
|
|
| --- | --- |
|
|
| `StgSharpDebug` | Executable test harness for manual debugging and stress testing of allocators, matrices, rendering, NGRA, and other subsystems. This is not an automated unit-test suite. |
|
|
| `STgSharpTest` | Older MSTest-based tests for the former Script/EXPRESS and related projects. Some references and machine-specific test data are legacy and may require repair before the project can run. |
|
|
| `SingleFile` | Standalone source experiments and generated-code samples that are not part of a project or the normal build. |
|
|
|
|
Run the active debug harness directly when investigating a subsystem:
|
|
|
|
```powershell
|
|
dotnet run --project test/StgSharpDebug/StgSharpDebug.csproj
|
|
```
|
|
|
|
New repeatable tests should use a test project and avoid machine-specific paths, external mutable data, and dependencies on previous test execution. Keep one-off investigations in `SingleFile` or the manual debug harness until their expected behavior is stable enough for automation.
|