Merge pull request #3 from bmazzarol/response_builder

feat: support for response building [ci]

Author: bmazzarol

.github/workflows/cd-build.yml

@@ -20,6 +20,7 @@ jobs:
       matrix:
         project-name:
           - HttpBuildR.Request
+          - HttpBuildR.Response
     steps:
       - uses: actions/checkout@v3
       - name: Setup .NET

.github/workflows/ci-build.yml

@@ -12,6 +12,7 @@ jobs:
       matrix:
         project-name:
           - HttpBuildR.Request
+          - HttpBuildR.Response
     steps:
       - uses: actions/checkout@v3
       - name: Setup .NET

.github/workflows/report-coverage.yml

@@ -14,6 +14,7 @@ jobs:
       matrix:
         project-name:
           - HttpBuildR.Request
+          - HttpBuildR.Response
     steps:
       - uses: actions/checkout@v3
       - name: Setup .NET

HttpBuildR.Request.Tests/RequestTests.cs

@@ -65,4 +65,14 @@ public static void Case4() =>
                     Version = HttpVersion.Version11
                 }
             );
+
+    [Fact(DisplayName = "2 builders can be run one after the other, with independent results")]
+    public static void Case5()
+    {
+        var req1 = Req.Get.To(new Uri("Http://some-host")).WithHeader("a", "1");
+        var req2 = req1.WithHeader("b", "2");
+
+        req1.Headers.Should().HaveCount(1);
+        req2.Headers.Should().HaveCount(2);
+    }
 }

HttpBuildR.Request/GlobalUsings.cs

@@ -0,0 +1 @@
+global using System.Diagnostics.Contracts;

HttpBuildR.Request/README.md

@@ -17,14 +17,14 @@ it from [NuGet](https://www.nuget.org/packages/HttpBuildR.Request/), and add
 this to the top of each `.cs` file that needs it:
 
 ```C#
-using static HttpBuildR.Request;
+using HttpBuildR;
 using Req = HttpMethod;
 ```
 
 Then get building!,
 
 ```c#
-using static HttpBuildR.Request;
+using HttpBuildR;
 
 // its helpful to alias this for readability
 using Req = HttpMethod;

HttpBuildR.Request/Request.Content.cs

@@ -18,6 +18,7 @@ public static partial class Request
     /// <param name="request">request</param>
     /// <param name="content">request content</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithContent(
         this HttpRequestMessage request,
         HttpContent content
@@ -30,6 +31,7 @@ HttpContent content
     /// <param name="content">request content</param>
     /// <param name="options">json serializer options</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithJsonContent<T>(
         this HttpRequestMessage request,
         T content,
@@ -48,6 +50,7 @@ private sealed class Utf8StringWriter : StringWriter
         public override Encoding Encoding => Encoding.UTF8;
     }
 
+    [Pure]
     private static string SerializeToXml<T>(
         this XmlSerializer serializer,
         T content,
@@ -68,6 +71,7 @@ private static string SerializeToXml<T>(
     /// <param name="serializer">xml serializer to use</param>
     /// <param name="settings">optional settings</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithXmlContent<T>(
         this HttpRequestMessage request,
         T content,
@@ -90,6 +94,7 @@ public static HttpRequestMessage WithXmlContent<T>(
     /// <param name="settings">optional settings</param>
     /// <param name="defaultNamespace">default namespace</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithXmlContent<T>(
         this HttpRequestMessage request,
         T content,
@@ -105,6 +110,7 @@ public static HttpRequestMessage WithXmlContent<T>(
     /// <param name="content">request content</param>
     /// <param name="mediaTypeName">media type of the text content, defaults to text/plain</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithTextContent(
         this HttpRequestMessage request,
         string content,
@@ -120,6 +126,7 @@ public static HttpRequestMessage WithTextContent(
     /// <param name="request">request</param>
     /// <param name="content">request content</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithFormUrlContent(
         this HttpRequestMessage request,
         params KeyValuePair<string, string>[] content
@@ -131,6 +138,7 @@ params KeyValuePair<string, string>[] content
     /// <param name="request">request</param>
     /// <param name="content">request content</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithFormUrlContent(
         this HttpRequestMessage request,
         IDictionary<string, string> content

HttpBuildR.Request/Request.Headers.cs

@@ -14,6 +14,7 @@ public static partial class Request
     /// <param name="request">request</param>
     /// <param name="action">header modification action</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithHeaderModifications(
         this HttpRequestMessage request,
         Action<HttpRequestHeaders> action
@@ -26,6 +27,7 @@ Action<HttpRequestHeaders> action
     /// <param name="name">header name</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithHeader(
         this HttpRequestMessage request,
         string name,
@@ -39,6 +41,7 @@ public static HttpRequestMessage WithHeader(
     /// <param name="name">header name</param>
     /// <param name="values">values</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithHeader(
         this HttpRequestMessage request,
         string name,
@@ -52,6 +55,7 @@ params string[] values
     /// <param name="scheme">authentication scheme</param>
     /// <param name="parameter">authentication parameter</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithAuthorization(
         this HttpRequestMessage request,
         string scheme,
@@ -68,6 +72,7 @@ string parameter
     /// <param name="scheme">authentication scheme</param>
     /// <param name="parameter">authentication parameter</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithProxyAuthorization(
         this HttpRequestMessage request,
         string scheme,
@@ -83,6 +88,7 @@ string parameter
     /// <param name="request">request</param>
     /// <param name="token">bearer token</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithBearerToken(
         this HttpRequestMessage request,
         string token
@@ -94,6 +100,7 @@ string token
     /// <param name="request">request</param>
     /// <param name="token">basic token</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithBasicToken(
         this HttpRequestMessage request,
         string token
@@ -105,6 +112,7 @@ string token
     /// <param name="request">request</param>
     /// <param name="value">cache control value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithCacheControl(
         this HttpRequestMessage request,
         CacheControlHeaderValue value
@@ -116,6 +124,7 @@ CacheControlHeaderValue value
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithConnectionClose(
         this HttpRequestMessage request,
         bool? value
@@ -127,6 +136,7 @@ public static HttpRequestMessage WithConnectionClose(
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithDate(
         this HttpRequestMessage request,
         DateTimeOffset? value
@@ -139,6 +149,7 @@ public static HttpRequestMessage WithDate(
     /// <param name="value">value</param>
     /// <param name="quality">quality</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithAccept(
         this HttpRequestMessage request,
         string value,
@@ -159,6 +170,7 @@ public static HttpRequestMessage WithAccept(
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithIfModifiedSince(
         this HttpRequestMessage request,
         DateTimeOffset? value
@@ -170,6 +182,7 @@ public static HttpRequestMessage WithIfModifiedSince(
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithIfRange(
         this HttpRequestMessage request,
         DateTimeOffset value
@@ -181,6 +194,7 @@ DateTimeOffset value
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithIfRange(
         this HttpRequestMessage request,
         EntityTagHeaderValue value
@@ -192,6 +206,7 @@ EntityTagHeaderValue value
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithIfUnmodifiedSince(
         this HttpRequestMessage request,
         DateTimeOffset? value
@@ -203,6 +218,7 @@ public static HttpRequestMessage WithIfUnmodifiedSince(
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithMaxForwards(this HttpRequestMessage request, int? value) =>
         request.WithHeaderModifications(x => x.MaxForwards = value);
 
@@ -213,6 +229,7 @@ public static HttpRequestMessage WithMaxForwards(this HttpRequestMessage request
     /// <param name="from">The position at which to start sending data.</param>
     /// <param name="to">The position at which to stop sending data.</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithRange(
         this HttpRequestMessage request,
         long? from,
@@ -225,6 +242,7 @@ public static HttpRequestMessage WithRange(
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithReferrer(this HttpRequestMessage request, string value) =>
         request.WithReferrer(new Uri(value));
 
@@ -234,6 +252,7 @@ public static HttpRequestMessage WithReferrer(this HttpRequestMessage request, s
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithReferrer(this HttpRequestMessage request, Uri value) =>
         request.WithHeaderModifications(x => x.Referrer = value);
 
@@ -243,6 +262,7 @@ public static HttpRequestMessage WithReferrer(this HttpRequestMessage request, U
     /// <param name="request">request</param>
     /// <param name="value">value</param>
     /// <returns>request</returns>
+    [Pure]
     public static HttpRequestMessage WithTransferEncodingChunked(
         this HttpRequestMessage request,
         bool? value

HttpBuildR.Request/Request.cs

@@ -1,5 +1,4 @@
 // ReSharper disable once CheckNamespace
-
 namespace HttpBuildR;
 
 /// <summary>
@@ -14,6 +13,7 @@ public static partial class Request
     /// <param name="uri">uri</param>
     /// <param name="version">http version, default is 2.0</param>
     /// <returns>request message</returns>
+    [Pure]
     public static HttpRequestMessage To(
         this HttpMethod method,
         string uri,
@@ -27,18 +27,37 @@ public static HttpRequestMessage To(
     /// <param name="uri">uri</param>
     /// <param name="version">http version, default is 2.0</param>
     /// <returns>request message</returns>
+    [Pure]
     public static HttpRequestMessage To(
         this HttpMethod method,
         Uri uri,
         Version? version = default
     ) => new(method, uri) { Version = version ?? new Version(2, 0) };
 
+    [Pure]
+    private static HttpRequestMessage Clone(this HttpRequestMessage request)
+    {
+        HttpRequestMessage clone =
+            new(request.Method, request.RequestUri)
+            {
+                Version = request.Version,
+                Content = request.Content // without async cloning content will not work
+            };
+
+        foreach (var kvp in request.Headers)
+            clone.Headers.TryAddWithoutValidation(kvp.Key, kvp.Value);
+
+        return clone;
+    }
+
+    [Pure]
     private static HttpRequestMessage Modify(
         this HttpRequestMessage request,
         Action<HttpRequestMessage> modifyAction
     )
     {
-        modifyAction(request);
-        return request;
+        var clone = request.Clone();
+        modifyAction(clone);
+        return clone;
     }
 }

HttpBuildR.Response.Tests/GlobalUsings.cs

@@ -0,0 +1,4 @@
+global using BunsenBurner;
+global using FluentAssertions;
+global using Xunit;
+global using Scenario = BunsenBurner.Scenario<BunsenBurner.Syntax.Aaa>;