Keywordify 0.0.1

Keywordify

Keywordify is a small, focused C# utility library that provides convenient extension methods for safely casting and converting object values. It is designed to make common casting patterns explicit, safe, and easy to read.

Features

• As<T>(this object?) where T : class — Equivalent to the C# as operator; returns null on failure.
• SafeAs<T>(this object?) — Pattern-matching safe cast; returns default(T) when the cast fails.
• Cast<T>(this object?) — Explicit cast that throws InvalidCastException on failure; returns default when obj is null and T is nullable or a reference type.
• TryCast<T>(this object?, out T? result) — Try-style cast returning true on success and false otherwise while providing the cast result via an out parameter.

Getting started

Add a project reference to the src/System.Keywordify.csproj in your solution, or install the package from NuGet (if published):

dotnet add package System.Keywordify

Examples

using System;
using System.Keywordify;

class Demo
{
    static void Main()
    {
        object a = "hello";
        string? s = a.As<string>(); // "hello"

        object n = 123;
        string? s2 = n.SafeAs<string>(); // null
        int? x = n.SafeAs<int>(); // 123

        Console.WriteLine($"As<string>: {(s is null ? "null" : s)}");
        Console.WriteLine($"SafeAs<string> from int: {(s2 is null ? "null" : s2)}");
        Console.WriteLine($"SafeAs<int> from int: {x}");

        // Cast (throws on invalid cast)
        object boxed = 42;
        int y = boxed.Cast<int>(); // 42

        // TryCast
        if (boxed.TryCast<int>(out var result))
        {
            Console.WriteLine($"TryCast succeeded: {result}");
        }
        else
        {
            Console.WriteLine("TryCast failed");
        }
    }
}

Contributing & building

• Clone the repository and run dotnet build at the solution root to build the library and the test project.
• The sample/test project is located in the test folder and demonstrates usage via a ProjectReference.

License

This project is licensed under the MIT License — see the LICENSE file for details.

Contact

Please open issues or pull requests on the repository for questions, bug reports, or contributions.