[sdk] Expose the ctor on Batch<T> which accepts a single item

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

@@ -1,3 +1,4 @@
+OpenTelemetry.Batch<T>.Batch(T! item) -> void
 OpenTelemetry.Metrics.Exemplar
 OpenTelemetry.Metrics.Exemplar.DoubleValue.get -> double
 OpenTelemetry.Metrics.Exemplar.Exemplar() -> void

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

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+* 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.9.0-alpha.1
 
 Released 2024-May-20

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]