Adding client-level cookie container and use it with the new way to add cookies to the request headers

Author: alexeyzimarev

src/RestSharp/Options/RestClientOptions.cs

@@ -136,6 +136,12 @@ public RestClientOptions(string baseUrl) : this(new Uri(Ensure.NotEmptyString(ba
     /// </summary>
     public string? BaseHost { get; set; }
 
+    /// <summary>
+    /// Custom cookie container to be used for requests. RestSharp will not assign the container to the message handler,
+    /// but will fetch cookies from it and set them on the request.
+    /// </summary>
+    public CookieContainer? CookieContainer { get; set; }
+
     /// <summary>
     /// Maximum request duration in milliseconds. When the request timeout is specified using <seealso cref="RestRequest.Timeout"/>,
     /// the lowest value between the client timeout and request timeout will be used.

src/RestSharp/RestClient.Async.cs

@@ -106,11 +106,15 @@ async Task<HttpResponse> ExecuteRequestAsync(RestRequest request, CancellationTo
             // Make sure we have a cookie container if not provided in the request
             var cookieContainer = request.CookieContainer ??= new CookieContainer();
 
-            var headers = new RequestHeaders();
-                headers.AddHeaders(request.Parameters);
-                headers.AddHeaders(DefaultParameters);
-                headers.AddAcceptHeader(AcceptedContentTypes);
-                headers.AddCookieHeaders(cookieContainer, url);
+            if (Options.CookieContainer != null) {
+                cookieContainer.Add(Options.CookieContainer.GetCookies(url));
+            }
+
+            var headers = new RequestHeaders()
+                .AddHeaders(request.Parameters)
+                .AddHeaders(DefaultParameters)
+                .AddAcceptHeader(AcceptedContentTypes)
+                .AddCookieHeaders(cookieContainer, url);
             message.AddHeaders(headers);
 
             if (request.OnBeforeRequest != null) await request.OnBeforeRequest(message).ConfigureAwait(false);

src/RestSharp/RestClient.Extensions.Params.cs

@@ -13,14 +13,17 @@
 // limitations under the License.
 // 
 
+using System.Net;
+using System.Text;
+
 namespace RestSharp;
 
 public static partial class RestClientExtensions {
     /// <summary>
     /// Add a parameter to use on every request made with this client instance
     /// </summary>
-    /// <param name="client">RestClient instance</param>
-    /// <param name="parameter">Parameter to add</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
+    /// <param name="parameter"><see cref="Parameter"/> to add</param>
     /// <returns></returns>
     public static IRestClient AddDefaultParameter(this IRestClient client, Parameter parameter) {
         client.DefaultParameters.AddParameter(parameter);
@@ -31,7 +34,7 @@ public static IRestClient AddDefaultParameter(this IRestClient client, Parameter
     /// Adds a default HTTP parameter (QueryString for GET, DELETE, OPTIONS and HEAD; Encoded form for POST and PUT)
     /// Used on every request made by this client instance
     /// </summary>
-    /// <param name="client"><see cref="RestClientOptions"/> instance</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
     /// <param name="name">Name of the parameter</param>
     /// <param name="value">Value of the parameter</param>
     /// <returns>This request</returns>
@@ -46,7 +49,7 @@ public static IRestClient AddDefaultParameter(this IRestClient client, string na
     /// - RequestBody: Used by AddBody() (not recommended to use directly)
     /// Used on every request made by this client instance
     /// </summary>
-    /// <param name="client"><see cref="RestClientOptions"/> instance</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
     /// <param name="name">Name of the parameter</param>
     /// <param name="value">Value of the parameter</param>
     /// <param name="type">The type of parameter to add</param>
@@ -57,7 +60,7 @@ public static IRestClient AddDefaultParameter(this IRestClient client, string na
     /// <summary>
     /// Adds a default header to the RestClient. Used on every request made by this client instance.
     /// </summary>
-    /// <param name="client"><see cref="RestClientOptions"/> instance</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
     /// <param name="name">Name of the header to add</param>
     /// <param name="value">Value of the header to add</param>
     /// <returns></returns>
@@ -79,7 +82,7 @@ public static IRestClient AddDefaultHeaders(this IRestClient client, Dictionary<
     /// <summary>
     /// Adds a default URL segment parameter to the RestClient. Used on every request made by this client instance.
     /// </summary>
-    /// <param name="client"><see cref="RestClientOptions"/> instance</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
     /// <param name="name">Name of the segment to add</param>
     /// <param name="value">Value of the segment to add</param>
     /// <returns></returns>
@@ -89,7 +92,7 @@ public static IRestClient AddDefaultUrlSegment(this IRestClient client, string n
     /// <summary>
     /// Adds a default URL query parameter to the RestClient. Used on every request made by this client instance.
     /// </summary>
-    /// <param name="client"><see cref="RestClientOptions"/> instance</param>
+    /// <param name="client"><see cref="RestClient"/> instance</param>
     /// <param name="name">Name of the query parameter to add</param>
     /// <param name="value">Value of the query parameter to add</param>
     /// <returns></returns>