[sdk] Expose the ctor on Batch<T> which accepts a single item (open-telemetry#5642)

Co-authored-by: Cijo Thomas <[email protected]>

Author: CodeBlanch

src/OpenTelemetry/.publicApi/Stable/PublicAPI.Unshipped.txt

@@ -1,3 +1,4 @@
+OpenTelemetry.Batch<T>.Batch(T! item) -> void
 OpenTelemetry.Metrics.MetricStreamConfiguration.CardinalityLimit.get -> int?
 OpenTelemetry.Metrics.MetricStreamConfiguration.CardinalityLimit.set -> void
 OpenTelemetry.OpenTelemetrySdk

src/OpenTelemetry/Batch.cs

@@ -35,9 +35,13 @@ public Batch(T[] items, int count)
         this.Count = this.targetCount = count;
     }
 
-    internal Batch(T item)
+    /// <summary>
+    /// Initializes a new instance of the <see cref="Batch{T}"/> struct.
+    /// </summary>
+    /// <param name="item">The item to store in the batch.</param>
+    public Batch(T item)
     {
-        Debug.Assert(item != null, $"{nameof(item)} was null.");
+        Guard.ThrowIfNull(item);
 
         this.item = item;
         this.Count = this.targetCount = 1;

src/OpenTelemetry/CHANGELOG.md

@@ -36,6 +36,10 @@ Notes](../../RELEASENOTES.md).
   There is NO ability to revert to old behavior.
   ([#5909](https://github.com/open-telemetry/opentelemetry-dotnet/pull/5909))
 
+* Exposed a `public` constructor on `Batch<T>` which accepts a single instance
+  of `T` to be contained in the batch.
+  ([#5642](https://github.com/open-telemetry/opentelemetry-dotnet/pull/5642))
+
 ## 1.10.0-beta.1
 
 Released 2024-Sep-30

test/OpenTelemetry.Tests/Trace/BatchTest.cs

@@ -14,6 +14,8 @@ public void CheckConstructorExceptions()
         Assert.Throws<ArgumentNullException>(() => new Batch<string>((string[]?)null!, 0));
         Assert.Throws<ArgumentOutOfRangeException>(() => new Batch<string>(Array.Empty<string>(), -1));
         Assert.Throws<ArgumentOutOfRangeException>(() => new Batch<string>(Array.Empty<string>(), 1));
+
+        Assert.Throws<ArgumentNullException>(() => new Batch<string>(null!));
     }
 
     [Fact]