Home

Masterly.NonEmptyList

A simple and lightweight implementation of a non-empty list in C#, inspired by Scala's List, that ensures a collection always has at least one item.

Features

• Non-Empty Guarantee: Always contains at least one element
• Head/Tail Access: Convenient Head, Tail, Init, First, and Last properties
• Functional Operations: Map, FlatMap, Reduce, Fold, Zip, Partition, and more
• Pattern Matching: Match method and deconstruction support
• Async Support: Full async extension methods for all operations
• Immutable Variant: ImmutableNonEmptyList<T> for thread-safe scenarios
• JSON Serialization: Built-in System.Text.Json support
• EF Core Integration: Entity Framework Core support via separate package
• Equality Support: Implements IEquatable<T> with == and != operators
• Multi-targeting: Supports .NET 6.0 and .NET 8.0

Documentation

Getting Started

• Getting Started - Installation and basic usage
• Core Concepts - Properties and fundamentals

Creating Lists

• Creating NonEmptyList - Constructors and factory methods

Functional Programming

• Functional Operations - Map, FlatMap, Reduce, Fold, Zip, Partition
• Pattern Matching - Match method and deconstruction

Collection Operations

• Collection Operations - Concat, Prepend, Reverse, Sliding, Chunks
• Conversion Methods - ToArray, ToHashSet, ToDictionary
• Utility Methods - Random, MinBy, MaxBy, ForEachWithIndex

Validation & Safety

• Validation - Validate and TryValidate methods
• Error Handling - Exception behavior
• Thread Safety - Concurrency considerations

Async Support

• Async Operations - MapAsync, FilterAsync, FoldAsync

Variants

• ImmutableNonEmptyList - Immutable variant for thread-safe scenarios

Serialization & Integration

• JSON Serialization - System.Text.Json support
• EF Core Integration - Entity Framework Core support

Reference

• Equality and Comparison - Equality operators and comparers