LogifyNet 1.0.0.1

LogifyNet

💡 Introduction

Logify is a lightweight and developer-friendly logging library for .NET applications. It provides file-based logging, automatic log rotation, and global configuration via appsettings.json, without requiring heavy frameworks or complex setup.

Ideal for small to medium projects needing a simple, reliable, production-ready logging system.

✨ Features

✔ File-based logging

✔ Automatic log rotation (max size & file count)

✔ Thread-safe implementation

✔ Global configuration through appsettings.json

✔ Plug-and-play DI integration (IServiceCollection)

✔ Lightweight with zero external dependencies

✔ Supports Info, Warning, Error, Debug levels

🚀 Installation

Install from NuGet:

dotnet add package LogifyNet

Or via NuGet Package Manager:

Install-Package LogifyNet

⚙️ Configuration (appsettings.json)

Add a Logify section inside appsettings.json:

{
  "Logify": {
    "Path": "logs/app.log",
    "MaxFileSizeKb": 512,
    "MaxFiles": 5
  }
}

Configuration Options

| Key               | Description                                                                       |
| ----------------- | --------------------------------------------------------------------------------- |
| **Path**          | Log file path (folder + file name). Logify automatically creates missing folders. |
| **MaxFileSizeKb** | Maximum size before rotation occurs.                                              |
| **MaxFiles**      | Number of old log files to keep.                                                  |

🧩 Usage Example (Complete Setup) Program.cs (.NET 6/7/8)

var builder = WebApplication.CreateBuilder(args);

// Register Logify from configuration
builder.Services.AddLogify(builder.Configuration);

var app = builder.Build();

var logger = app.Services.GetRequiredService<ILogify>();
logger.Info("Application started.");
logger.Warning("This is a warning message.");
logger.Error("Error occurred.");
logger.Debug("Debug details...");

app.Run();

📘 API Reference

🔹 ILogify

Main logging interface:

void Info(string message);
void Warning(string message);
void Error(string message);
void Debug(string message);

🔹 FileLogger

Responsible for:

Writing logs to file

Ensuring thread safety

Handling rotation based on size and retention limit

🔹 LogifyOptions

Automatically bound from appsettings:

public class LogifyOptions
{
    public string Path { get; set; }
    public int MaxFileSizeKb { get; set; }
    public int MaxFiles { get; set; }
}

📄 Example Log Output

2025-01-20 12:41:33 [INFO] Application started.
2025-01-20 12:41:34 [WARNING] Disk usage is high.
2025-01-20 12:41:35 [ERROR] Failed to load configuration.
2025-01-20 12:41:36 [DEBUG] Loading module X...

🎯 Summary

Logify is a minimal, reliable, and easy-to-use logging solution for .NET applications. It’s designed to be simple enough for beginners but powerful enough for production environments.

📄 License

MIT License

💬 Author

Developed with ❤️ for clean, structured, and efficient .NET applications.

Developed by

Abdelwaheb AMMAR