AssertWithIs 1.2.0

Minimalistic Assertion Extensions for .NET

Simple. Readable. Opinionated.

Is is a lightweight assertion library for .NET that focuses on readable, minimal, and fail-fast test expectations — no assertion clutter, no dependencies, no test framework lock-in.

✅ Why use Is?

• 📘 Concise: One word. One assertion.
• 💥 Opinionated: Less is more. Only core assertions relevant for real-world use cases, just fast failure and clarity.
• 🧪 Test-framework agnostic: Works with xUnit, NUnit, MSTest, or none at all.
• ⚙️ Self-contained: No dependencies, no configuration, just drop it in.

📦 Get It on NuGet

The package is published on NuGet under the name AssertWithIs because shorter IDs like Is or Is.Assertions were already taken or reserved.
Despite the package name, the library itself uses the concise Is namespace and generates a single Is.dll, so your code stays clean and expressive:

🔍 Available Methods

All public methods in Is are:

• ❗️ Extension methods, designed to be used fluently (value.Is(...))
• 🔤 Named consistently: Every method starts with Is, making them easy to discover with IntelliSense
• ✂️ Minimal and deliberate: Only a small, opinionated set of assertions is exposed

Method Categories

Exception Assertions

Methods that assert conditions related to exceptions.

Type Assertions

Methods that assert conditions related to the type of an object.

Equality Assertions

Methods that assert conditions related to equality.

Collection Assertions

Methods that assert conditions related to collections and sequences.

Comparison Assertions

Methods that assert conditions related to comparisons.

String Assertions

Methods that assert conditions related to strings.

Boolean Assertions

Methods that assert conditions related to boolean values.

Null Assertions

Methods that assert conditions related to null values.

✅ Because all methods start with Is, you can type . and just filter by Is in IntelliSense. Fast and frictionless.

🔧 Usage Examples

Basic value checks

42.Is(42);       // ✅ passes
42.Is(41);       // ❌ throws IsNotException: 42 (System.Int32) is not 41 (System.Int32)
42.Is(42.0);     // ❌ throws IsNotException: 42 (System.Int32) is not 42 (System.Double)

"test".Is("test");               // ✅ passes

Collection checks

new[] { 1, 2, 3 }.Is(1, 2, 3);   // ✅ passes (enumerable values check)

new List<int> { 1, 2, 3, 4, 5, 6 }.Where(i => i % 2 == 0).Is(2, 4, 6);     // ✅ passes
new List<int> { 1, 2, 3, 4, 5, 6 }.Where(i => i % 3 == 0).Is(3, 6);        // ✅ passes
new List<int> { 1, 2, 3, 4, 5, 6 }.Where(i => i % 4 == 0).Is(4);           // ✅ passes

new List<int> { 1, 2, 3, 4 }.IsContaining(1, 2);    // ✅ passes
new List<int> { 1, 2 }.IsIn(1, 2, 3, 4);            // ✅ passes

Type checks

"hello".Is<string>();     // ✅ passes
"hello".Is<int>();        // ❌ throws IsNotException: "hello" (System.String) is no System.Int32

Numeric comparisons

2.999999f.Is(3f)         // ✅ passes
783.0123.Is(783.0124)    // ✅ passes

5.IsSmallerThan(6);      // ✅ passes
6.IsGreaterThan(5.0);    // ✅ passes
5.IsGreaterThan(6);      // ❌ throws IsNotException: 5 (System.Int32) is not greater than 6 (System.Int32)
2.IsBetween(1, 3);       // ✅ passes

(0.1 + 0.2).Is(0.3);                // ✅ passes
(0.1 + 0.2).IsExactly(0.3);         // ❌ fails
(0.1 + 0.2).IsApproximately(0.3);   // ✅ passes

(1.0 / 3.0).Is(0.333333);     // ✅ passes
(1.0 / 3.0).Is(0.33333);      // ❌ throws IsNotException: 0,33333 (System.Double) is not close to 0,3333333333333333 (System.Double)

Exception assertions

static int DivideByZero(int value) => value / 0;
Action action = () => _ = DivideByZero(1);
action.IsThrowing<DivideByZeroException>();  // ✅ passes

Action action = () => 5.IsGreaterThan(6);
action.IsThrowing<IsNotException>("is not greater than");    // ✅ passes

String checks

var groups = "hello world".IsMatching("(.*) (.*)");  // ✅ passes
groups[1].Value.Is("hello");  // ✅ passes
groups[2].Value.Is("world");  // ✅ passes

"hello world".IsContaining("hello");    // ✅ passes

❌ Error messages

Exception messages

• uses colors to highlight important parts
• displays the source of the error (line number and code)

⚖️ Design Philosophy

• ❌ No .Should(), no fluent bloat
• ✅ All positive assertions (Is, IsNull, IsTrue, etc.)
• 📢 Failure messages like: 42 (System.Int32) is not 41 (System.Int32)
• 🧠 Designed to make tests read like intentions, not machinery

🔍 Key Advantages of Is

• 🧠 Ultra-Concise Syntax with Natural Readability
• 🧵 Minimal Dependencies / Fast Startup
  • Lean and dependency-free — ideal for CI pipelines or constrained environments.
• 🧪 Focused on Behavior, Not Chaining
  • Prioritizes clarity over fluent DSL chaining.
• 🔧 Extensible and Easy to Maintain
  • Simple to audit, fork, and adapt for your team or test infrastructure.

📝 License

MIT – use freely.

🙌 Contributing

Ideas, bug reports, or pull requests are always welcome.

❤️ Author

Developed with care by chrismo80