AKI.Utils 1.0.7

AKI.Utils

A comprehensive utility library collection for .NET applications, providing common functionality across multiple domains.

📦 Available Packages

Package	Description	NuGet
AKI.Utils	Core utilities (string, collections, extensions)
AKI.Utils.Csv	CSV parsing and manipulation utilities
AKI.Utils.Excel	Excel file operations
AKI.Utils.Configuration	Configuration utilities
AKI.Utils.Culture	Culture and localization utilities
AKI.Utils.Services	Service-oriented utilities (TLD, IP, URL patterns)

🚀 Installation

Install individual packages based on your needs:

# Core utilities
dotnet add package AKI.Utils

# CSV utilities
dotnet add package AKI.Utils.Csv

# Excel utilities
dotnet add package AKI.Utils.Excel

# Configuration utilities
dotnet add package AKI.Utils.Configuration

💻 Usage

Each package provides utilities in their respective domains:

using AKI.Utils;
using AKI.Utils.Csv;

// Core utilities
var safeString = StringUtils.FormatSafely("Hello {0}", "World");

// CSV utilities
var csvResult = CsvParser.Parse<MyModel>(csvContent);

🛠️ Development

Prerequisites

• .NET 8.0 SDK
• Visual Studio 2022 or VS Code

Building

dotnet restore
dotnet build --configuration Release

Testing

dotnet test --configuration Release

Code Quality

# Format code
dotnet format

# Run full quality gates
dotnet format --verify-no-changes
dotnet build --configuration Release
dotnet test --configuration Release

🤝 Contributing

1. Follow the guidelines in CLAUDE.md
2. All changes must pass the quality gates (format, build, tests)
3. Use conventional commits for commit messages
4. Add unit tests for new functionality

🚀 Deployment

Automatic Deployment

Packages are automatically deployed to NuGet.org when:

• Tagged releases: Push a tag like v1.2.3 to trigger deployment
• Manual workflow: Use GitHub Actions workflow_dispatch with version input

# Create and push a tag for release
git tag v1.2.3
git push origin v1.2.3

GitHub Actions Workflows

• Continuous Integration: Runs on all pushes and PRs to validate build and tests
• NuGet Deploy: Deploys all packages to NuGet.org on tagged releases

Required Secrets

Configure these secrets in your GitHub repository:

• NUGET_API_KEY: Your NuGet.org API key for package publishing

📄 License

MIT License - see the LICENSE file for details.

🏗️ Architecture

See ARCHITECTURE.md for detailed technical architecture and design decisions.

🗺️ Roadmap

Check ROADMAP.md for current development priorities and upcoming features.