Initium — Service Core Foundation

Introduction

Initium is a library for simplifying .NET API development, offering standardized service operations, flexible routing, and seamless chaining of service results for cleaner and more maintainable code.

• Streamlined API Controllers: Simplifies response handling with attributes like [ApiResponse], providing clear and consistent HTTP status documentation.
• Centralized Result Management: ServiceResult enables clear success or failure status, making error handling and conditional logic seamless.
• Exception Handling Made Easy: ApiException provides a straightforward way to handle specific HTTP error codes, improving code clarity.
• Result Chaining: Methods return ServiceResult or typed results, allowing for intuitive chaining and cleaner service logic.
• Enhanced Maintainability: Standardized patterns reduce boilerplate code, making APIs easier to build, understand, and maintain.

Getting Started

To get started with Initium, just add the package using NuGet:

dotnet add package Initium

How does it Work?

Here's how to create a controller :

public class CoffeeController(CoffeeService service) : ApiController { [HttpPost] [ApiResponse(200, "Coffee prepared successfully.")] [ApiResponse(400, "An error occurred during the preparation process.")] public ActionResult PrepareCoffee() => service.PrepareCoffee(); }

And here's how to create an action in a service, each function returns a ServiceResult, and can be chained.

public class CoffeeService { public ServiceResult DoSomething() { return ServiceResult.Error("Something happened!", HttpStatusCode.Conflict); } public ServiceResult PrepareCoffee() { var doSomethingResult = DoSomething(); if (doSomethingResult == false) return doSomethingResult; return ServiceResult.Ok("The coffee is now DONE!"); } }

Contribute to Initium

See CONTRIBUTING.md for best practices and instructions on setting up your development environment to work on Initium.