EnumerablePrinter 1.1.0

EnumerablePrinter

Python‑inspired LINQ extensions for expressive, ergonomic collection handling in C#.

EnumerablePrinter brings the clarity and power of Python’s sequence operations to C#, with intuitive methods like Slice, Print, Chunk, and IsAlphabetical. Designed for developer ergonomics, deferred execution, and clean diagnostics.

✨ Latest Updates

• Unified Square‑Bracket Formatting – All collections now print using [ ... ] for a clean, modern, JSON‑adjacent style.
• Object Property Printing – Complex objects print their public properties automatically using a reflection‑based printer.
• Dictionary Improvements – Key/value pairs print inline with consistent bracket formatting.
• Nested Collection Support – Recursively prints arrays, lists, sets, and dictionaries with stable, predictable formatting.
• Char Enumerable Special Case – IEnumerable<char> prints as a string literal instead of a character list.
• Custom Formatting – User‑provided delegates are respected for all element types, including strings.
• Output Redirection – Print to any TextWriter (console, file, buffer, logger).
• Chunk Support – Split sequences into fixed‑size groups with lazy evaluation.
• CRLF/LF Stability – All scripts and examples normalized to LF for cross‑platform reliability.
• Automated Versioning – Repository scripts now auto‑increment semantic versions with cascading rollover.

✨ Features

🚀 Installation

dotnet add package EnumerablePrinter

🧪 Test

dotnet test

Sample expectation:

Enumerable.Empty<int>().Print();
// Output: [ ]

🧰 Usage

Add:

using EnumerablePrinter;

and you're ready to go.

➤ Basic Usage

new[] { 1, 2, 3 }.Print();
// Output: [ 1, 2, 3 ]

➤ Empty Collections

Enumerable.Empty<int>().Print();
// Output: [ ]

➤ Printing a Dictionary

var dict = new Dictionary<string, int>
{
    ["Wayne"] = 1,
    ["Lucius"] = 2,
    ["Alfred"] = 3
};
dict.Print();
// Output:
// [ "Wayne": 1, "Lucius": 2, "Alfred": 3 ]

➤ Printing Nested Collections

var nested = new List<int[]>
{
    new[] { 1, 2 },
    new[] { 3, 4 }
};

nested.Print();
// Output:
// [ [ 1, 2 ], [ 3, 4 ] ]

➤ Combining Dictionaries and Nested Collections

var complex = new Dictionary<string, object>
{
    ["Numbers"] = new[] { 1, 2, 3 },
    ["Matrix"] = new List<int[]>
    {
        new[] { 1, 2 },
        new[] { 3, 4 }
    }
};
complex.Print();
// Output:
// [ "Numbers": [ 1, 2, 3 ], "Matrix": [ [ 1, 2 ], [ 3, 4 ] ] ]

➤ Printing Objects (Property Printing)

var products = new[]
{
    new Product { id = "1", name = "Keyboard", description = "Mechanical" }
};

products.Print();
// Output:
// [ [ id: 1, name: Keyboard, description: Mechanical ] ]

➤ With Custom Formatting

var names = new List<string> { "Wayne", "Lucius", "Alfred" };
names.Print(n => $"[{n}]");
// Output: [ [Wayne], [Lucius], [Alfred] ]

➤ Redirecting Output (e.g., logs or buffer)

using var writer = new StringWriter();
names.Print(n => n.ToUpper(), writer);
Console.WriteLine(writer.ToString());
// Output: [ WAYNE, LUCIUS, ALFRED ]

➤ Chunk Example

var data = Enumerable.Range(1, 10);

foreach (var chunk in data.Chunk(3))
{
    chunk.Print();
}

Output:

[ 1, 2, 3 ]
[ 4, 5, 6 ]
[ 7, 8, 9 ]
[ 10 ]

➤ IsAlphabetical Example

var names = new[] { "Alice", "Bob", "Charlie" };
names.IsAlphabetical(); // true

var unsorted = new[] { "Charlie", "Alice", "Bob" };
unsorted.IsAlphabetical(); // false

var people = new[]
{
    new Person { Name = "Alice" },
    new Person { Name = "Bob" },
    new Person { Name = "Charlie" }
};
people.IsAlphabetical(p => p.Name); // true

➤ Slice Example

var data = Enumerable.Range(1, 10);

data.Slice(2, 8);        // 3, 4, 5, 6, 7, 8
data.Slice(-3, null);    // 8, 9, 10
data.Slice(0, null, 2);  // 1, 3, 5, 7, 9

🔗 Links

• NuGet Package: https://www.nuget.org/packages/EnumerablePrinter
• Source Code: https://github.com/wblackmon/EnumerablePrinter

📝 License

Licensed under the MIT License.