DryFish.ILib 2026.9.0

DryFish.ILib

A simple, lightweight C# library for console operations, logging, delays, and application control.

✨ Features

• 📝 Multiple Log Levels - Notice, Warning, Info, Error, Debug, Complete
• 🎨 Colored Console - Set foreground and background colors by name
• ⏱️ Delays - Both synchronous and asynchronous delay methods
• ⌨️ User Input - ReadLine and ReadKey with null safety
• 🧹 Console Control - Clear console screen with exception handling
• 🌍 Timezone Support - Cross-platform timezone conversion (IANA & Windows)
• 🔧 Configurable - Toggle timestamps, custom formats, debug mode
• 📦 Lightweight - Zero external dependencies
• 🚪 Exit - Controlled application exit with status codes

📦 Installation

.NET CLI

dotnet add package DryFish.ILib

Package Manager

NuGet\Install-Package DryFish.ILib

PackageReference

<PackageReference Include="DryFish.ILib" Version="2026.9.0" />

🚀 Quick Start

using DryFish.ILib;

// Optional configuration
ILib.ISetDebug(true);
ILib.TimestampFormat = "HH:mm:ss";

ILib.INotice("Application starting...");
ILib.ILogInfo("Initializing components");

// Get user input
string name = ILib.IReadLine("Enter your name: ");
ILib.ILogComplete($"Welcome, {name}!");

// Timezone example
string vnTime = ILib.IGetTimeZone("Asia/Ho_Chi_Minh");
ILib.ILogInfo($"Vietnam time: {vnTime}");

📚 API Reference

Logging Methods

Console Output Methods

Control Methods

Input Methods

Console Methods

Console Color Methods

Supported colors: black, darkblue, darkgreen, darkcyan, darkred, darkmagenta, darkyellow, gray, grey, darkgray, darkgrey, blue, green, cyan, red, magenta, yellow, white

Timezone Methods

Timezone offset formats: "+7", "-5", "+730", "+7:30", "+0530"

Configuration

💡 Examples

Basic Logging

ILib.INotice("Server started");
ILib.ILogInfo("User logged in: admin");
ILib.ILogError("Database connection failed");
ILib.ILogComplete("Backup completed");

Colored Logging

// Using ILogColor with auto prefix
ILib.ILogColor("red", "This is an error message");
ILib.ILogColor("green", "Operation completed successfully");
ILib.ILogColor("yellow", "Warning: Low disk space");
ILib.ILogColor("cyan", "Debug: Variable x = 42");

// Using ILogColor with custom prefix
ILib.ILogColor("magenta", "AUTH", "User logged in");
ILib.ILogColor("blue", "DB", "Connected to database");

Console Colors

// Set only foreground
ILib.ISetConsoleColor("cyan");
ILib.INotice("Cyan text");

// Set only background
ILib.ISetBgColor("blue");
ILib.INotice("Text on blue background");

// Set both foreground and background
ILib.ISetConsoleColor("yellow", "blue");
ILib.INotice("Yellow text on blue background");

// Reset colors
ILib.IResetBgColor();      // Reset only background
ILib.IResetConsoleColor(); // Reset both

Clear Console

ILib.INotice("Press any key to clear screen...");
ILib.IReadKey();
ILib.IClearConsole();
ILib.INotice("Screen cleared!");

User Input

string name = ILib.IReadLine("Enter your name: ");
ILib.ILogInfo($"Hello, {name}!");

ConsoleKeyInfo? key = ILib.IReadKey("Press Y to continue: ");
if (key?.Key == ConsoleKey.Y)
{
    ILib.ILogComplete("Continuing...");
}

Direct Console Output

// Write without newline
ILib.IWrite("Enter your age: ");
string age = ILib.IReadLine();

// Write line
ILib.IWriteLine($"You entered: {age}");

Timezone Examples

// Using UTC offset
string vietnam = ILib.IGetTimeUtc("+7");
string ny = ILib.IGetTimeUtc("-5");
string india = ILib.IGetTimeUtc("+5:30");

// Using IANA timezone (cross-platform)
string vn = ILib.IGetTimeZone("Asia/Ho_Chi_Minh");
string jp = ILib.IGetTimeZone("Asia/Tokyo");
string uk = ILib.IGetTimeZone("Europe/London");

// Custom format
string time = ILib.IGetTimeZone("Asia/Ho_Chi_Minh", "HH:mm dd/MM/yyyy");

Configuration

// Disable timestamps
ILib.ShowTimestamps = false;
ILib.ILogInfo("No timestamp"); // Output: [INFO] - No timestamp

// Custom timestamp format
ILib.TimestampFormat = "HH:mm:ss";
ILib.ILogInfo("With time only"); // Output: [INFO] 14:30:45 - With time only

// Enable debug mode
ILib.ISetDebug(true);
ILib.ILogDebug("This will show");

Async Delay

async Task ProcessData()
{
    ILib.ILogInfo("Processing started");
    await ILib.IDelayAsync(2000);
    ILib.ILogComplete("Processing completed");
}

Progress Simulation

for (int i = 0; i <= 100; i += 20)
{
    ILib.ILogInfo($"Progress: {i}%");
    ILib.IDelay(500);
}
ILib.ILogComplete("Complete!");

🧪 Running Tests

# Clone repository
git clone https://github.com/dryfish09/ILib.git

# Restore dependencies
dotnet restore

# Run tests
dotnet test

# Run tests with coverage
dotnet test --collect:"XPlat Code Coverage"

🔧 Building from Source

# Build all frameworks
dotnet build src/main/DryFish.ILib.csproj --configuration Release

# Pack NuGet package
dotnet pack src/main/DryFish.ILib.csproj --configuration Release --output ./artifacts

# Include symbols for debugging
dotnet pack src/main/DryFish.ILib.csproj --configuration Release --output ./artifacts --include-symbols

📁 Project Structure

ILib/
├── src/
│   ├── main/
│   │   ├── DryFish.ILib.csproj
│   │   └── ILib.cs
│   └── test/
│       ├── DryFish.ILib.Test.csproj
│       └── ILibTest.cs
├── .github/
│   ├── workflows/
│   │   └── build.yml
│   └── dependabot.yml
├── global.json
├── README.md
├── LICENSE
└── DryFish.ILib.sln

📋 Requirements

• .NET 6.0 or later
• .NET Core 6.0+
• .NET Framework 4.6.2+
• .NET Standard 2.0
• Compatible with Windows, Linux, and macOS

🗺️ Roadmap

• Basic logging (Notice, Warn, Info, Error, Complete)
• Colored console output (foreground & background)
• Sync/Async delays
• User input methods
• Direct console output (IWrite, IWriteLine)
• Clear console screen
• Cross-platform timezone
• Debug mode
• Configurable timestamps
• Colored logging (ILogColor)
• Background color control (ISetBgColor, IResetBgColor)

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

Guidelines:

• Follow existing code style
• Add tests for new features
• Update documentation
• Ensure all tests pass

📄 License

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

👤 Author

DryFish

• GitHub: @dryfish09

🙏 Acknowledgments

• Built with .NET 6/7/8 and .NET Framework 4.6.2+
• Tested with xUnit
• CI/CD with GitHub Actions
• Cross-platform timezone support
• Dependabot for automated dependency updates

📞 Support

• 📧 Create an Issue
• ⭐ Star the repository if you find it useful!
• 🔔 Watch for updates and new releases

Made with ❤️ by DryFish