Merge branch 'master' into onefile

Author: Burgyn

CLAUDE.md

@@ -0,0 +1,76 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+TeaPie is a lightweight CLI-based API testing framework for >=.NET 8. It executes tests defined as `.http` files with optional C# scripts (`.csx`) for pre-request setup and post-response validation. Installed as a dotnet global tool (`TeaPie.Tool`).
+
+## Build & Test Commands
+
+```sh
+dotnet restore                    # Restore dependencies
+dotnet build                      # Build all projects
+dotnet build -warnaserror         # Build as CI does (warnings are errors)
+dotnet test                       # Run all tests
+dotnet test --filter "FullyQualifiedName~ClassName.MethodName"  # Run a single test
+```
+
+Tests use **xUnit** with **FluentAssertions** and **NSubstitute** for mocking. Test project: `tests/TeaPie.Tests/`.
+
+CI builds with `dotnet build --configuration Release --no-restore -warnaserror` — all warnings must be resolved before merging.
+
+## Solution Structure
+
+- **`src/TeaPie/`** — Core library (NuGet package `TeaPie`). Contains all framework logic.
+- **`src/TeaPie.DotnetTool/`** — CLI entry point (NuGet tool `TeaPie.Tool`). Thin wrapper with Spectre.Console CLI commands (`test`, `explore`, `generate`, `init`, `compile-script`, `clear-cache`).
+- **`tests/TeaPie.Tests/`** — Unit tests with demo fixtures in `Demo/` subdirectories.
+
+## Architecture
+
+### Pipeline Pattern
+
+The core execution model is a **pipeline of steps** (`IPipelineStep`). `ApplicationBuilder` configures DI services and assembles the pipeline via `ApplicationStepsFactory`, which creates different step sequences for different modes (test execution, structure exploration, script compilation).
+
+Steps execute sequentially against an `ApplicationContext`. The pipeline supports dynamic step insertion during execution.
+
+### Key Subsystems (all under `src/TeaPie/`)
+
+- **`Pipelines/`** — Pipeline infrastructure (`IPipeline`, `IPipelineStep`, `StepsCollection`)
+- **`StructureExploration/`** — Discovers and organizes test collections from the file system. Maps `.http` files and their associated scripts into a `CollectionStructure` tree.
+- **`Http/`** — Parses `.http` files, executes HTTP requests, handles auth (`Auth/`), retries (`Retrying/`), headers
+- **`Scripts/`** — Loads, pre-processes (resolves `#load` and `#r "nuget:..."` directives), compiles, and executes `.csx` C# scripts via Roslyn
+- **`TestCases/`** — Manages test case lifecycle (init/execute/finish). A test case = `.http` file + optional `-init.csx` and `-test.csx` scripts
+- **`Testing/`** — Test execution engine, test directives, assertions (extends xUnit Assert), result tracking
+- **`Variables/`** — Variable system for sharing state between scripts and across requests
+- **`Environments/`** — Environment configuration (env.json files, environment switching)
+- **`Reporting/`** — Test result reporters (console, JUnit XML, custom)
+- **`Functions/`** — Built-in functions available to scripts
+
+### Test Case Convention
+
+A test case is a group of files sharing a base name:
+
+- `{name}-req.http` — The HTTP request definition (required)
+- `{name}-init.csx` — Pre-request C# script (optional)
+- `{name}-test.csx` — Post-response validation C# script (optional)
+
+### DI & Service Registration
+
+Each subsystem has its own `Setup.cs` file with extension methods for `IServiceCollection`. The root `Setup.cs` in `src/TeaPie/` orchestrates all registrations via `AddTeaPie()`.
+
+## Code Style
+
+- .NET 8, C# with nullable enabled, implicit usings
+- Central package version management (`ManagePackageVersionsCentrally`)
+- Roslynator analyzers enforced; `EnforceCodeStyleInBuild` is on
+- `.editorconfig`: 4-space indent, CRLF line endings for C# files, UTF-8 with BOM
+- Uses file-scoped namespaces, expression-bodied members, and pattern matching throughout
+
+## Branch Naming
+
+Use `feature/`, `bugfix/`, `refactoring/`, or `docs/` prefixes. Main branch is `master`.
+
+## Documentation
+
+DocFX-based docs live in `docs/`. Build with `docfx "./docs/docfx.json"`, serve with `docfx serve _site`.

tests/TeaPie.Tests/Http/HttpMessagesExtensionsShould.cs

@@ -311,24 +311,24 @@ private static void CompareDummies([NotNull] Dummy? result, Dummy? data)
     {
         NotNull(result);
         NotNull(data);
-        Equal(result.Id, data.Id);
-        Equal(result.Name, data.Name);
-        Equal(result.IsRegistered, data.IsRegistered);
-        Equal(result.Averages.Length, data.Averages.Length);
+        Equal(data.Id, result.Id);
+        Equal(data.Name, result.Name);
+        Equal(data.IsRegistered, result.IsRegistered);
+        Equal(data.Averages.Length, result.Averages.Length);
         for (var i = 0; i < result.Averages.Length; i++)
         {
-            Equal(result.Averages[i], data.Averages[i]);
+            Equal(data.Averages[i], result.Averages[i]);
         }
     }
 
     private static void CompareDynamic(dynamic real, Dummy expected)
     {
         NotNull(real);
         NotNull(expected);
-        Equal(real.Id, expected.Id);
-        Equal(real.Name, expected.Name);
-        Equal(real.IsRegistered, expected.IsRegistered);
-        Equal(real.Averages.Count, expected.Averages.Length);
+        Equal(expected.Id, real.Id);
+        Equal(expected.Name, real.Name);
+        Equal(expected.IsRegistered, real.IsRegistered);
+        Equal(expected.Averages.Length, real.Averages.Count);
         foreach (var (Expected, Real) in expected.Averages.Zip(((List<object>)real.Averages).Select(x => ((JValue)x).Value)))
         {
             Equal(Expected, Real);

tests/TeaPie.Tests/Json/JsonElementTypeConverterShould.cs

@@ -25,7 +25,7 @@ public void ResolveBooleanFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["booleanProperty"]);
 
-        Assert.Equal(resolved, true);
+        Assert.Equal(true, resolved);
     }
 
     [Fact]
@@ -34,7 +34,7 @@ public void ResolveIntegerFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["integerProperty"]);
 
-        Assert.Equal(resolved, 42);
+        Assert.Equal(42, resolved);
     }
 
     [Fact]
@@ -43,7 +43,7 @@ public void ResolveLongFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["longProperty"]);
 
-        Assert.Equal(resolved, 9223372036854775807L);
+        Assert.Equal(9223372036854775807L, resolved);
     }
 
     [Fact]
@@ -52,7 +52,7 @@ public void ResolveDecimalFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["decimalProperty"]);
 
-        Assert.Equal(resolved, 12345.6789m);
+        Assert.Equal(12345.6789m, resolved);
     }
 
     [Fact]
@@ -61,7 +61,7 @@ public void ResolveStringFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["stringProperty"]);
 
-        Assert.Equal(resolved, "Hello, World!");
+        Assert.Equal("Hello, World!", resolved);
     }
 
     [Fact]
@@ -70,7 +70,7 @@ public void ResolveGuidFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["guidProperty"]);
 
-        Assert.Equal(resolved, Guid.Parse("d2713b57-3494-4d0a-8e3b-2e587f3e8b3e"));
+        Assert.Equal(Guid.Parse("d2713b57-3494-4d0a-8e3b-2e587f3e8b3e"), resolved);
     }
 
     [Fact]
@@ -79,7 +79,7 @@ public void ResolveDateTimeOffsetFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["dateTimeOffsetProperty"]);
 
-        Assert.Equal(resolved, DateTimeOffset.Parse("2025-01-27T12:34:56+01:00"));
+        Assert.Equal(DateTimeOffset.Parse("2025-01-27T12:34:56+01:00"), resolved);
     }
 
     [Fact]
@@ -88,6 +88,6 @@ public void ResolveArrayFromJsonElementCorrectly()
         var deserialized = JsonSerializer.Deserialize<Dictionary<string, object>>(Json);
         var resolved = JsonElementTypeConverter.Convert(deserialized!["arrayProperty"]);
 
-        Assert.Equal(resolved, new List<object> { 1, 2, 3, 4, 5 });
+        Assert.Equal(new List<object> { 1, 2, 3, 4, 5 }, resolved);
     }
 }

tests/TeaPie.Tests/Json/JsonExtensionsShould.cs

@@ -28,14 +28,14 @@ public void ConvertJsonStringToCaseInsensitiveExpandoObjectCorrectly()
     {
         dynamic json = JsonString.ToExpando();
 
-        Assert.Equal(json.stringKey, "stringValue");
-        Assert.Equal(json.numberKey, 123);
+        Assert.Equal("stringValue", json.stringKey);
+        Assert.Equal(123, json.numberKey);
         Assert.True(json.BooleanKey);
-        Assert.Equal(json.arrayKey.Count, 3);
+        Assert.Equal(3, json.arrayKey.Count);
 
         Assert.NotNull(json.ObjectKey);
-        Assert.Equal(json.objectKey.NestedStringKey, "nestedValue");
-        Assert.Equal(json.objectKey.nestedNumberKey, 456);
+        Assert.Equal("nestedValue", json.objectKey.NestedStringKey);
+        Assert.Equal(456, json.objectKey.nestedNumberKey);
     }
 
     [Fact]