Elect - .NET Core Utility Library Collection

🚀 Overview

Elect is a powerful ecosystem of mini-libraries that significantly speeds up .NET Core development by providing:

🔧 Essential Utilities - Core helper methods and extensions for common tasks
⚡ Rapid Development - Pre-built solutions to reduce project setup time
🔄 Always Updated - Continuously maintained with the latest .NET versions
🌐 Cross-Platform - Works seamlessly on Windows, Mac, and Linux
📦 Modular Design - Use only what you need with independent packages

📦 Installation

All Elect modules are available on NuGet. Install individual packages as needed:

# Core utilities (foundation)
dotnet add package Elect.Core

# Dependency injection
dotnet add package Elect.DI

# Entity Framework utilities
dotnet add package Elect.Data.EF

# File and image processing
dotnet add package Elect.Data.IO

# Background job processing
dotnet add package Elect.Job.Hangfire

# Location services
dotnet add package Elect.Location.Google

# Web utilities
dotnet add package Elect.Web
dotnet add package Elect.Web.DataTable
dotnet add package Elect.Web.Middlewares
dotnet add package Elect.Web.HttpDetection

🔧 Quick Start

// Example: Using Elect.Core utilities
using Elect.Core.StringUtils;
using Elect.Core.ObjUtils;

// Generate unique IDs
string uniqueId = IdHelper.NewId();

// Object utilities
var config = new AppConfig();
config.SetValue("ConnectionString", "Data Source=...");

// Example: Using Elect.DI for service registration
[TransientDependency]
public class MyService : IMyService
{
    // Your implementation
}

// Services are automatically registered by assembly scanning

📚 Library Modules

Elect provides a comprehensive set of specialized modules, each designed to handle specific aspects of .NET Core development:

🏗️ Core Foundation

Package	Description	NuGet
Elect.Core	Essential utilities and foundation of the ecosystem

🔧 Dependency Injection

Package	Description	NuGet
Elect.DI	Attribute-based service registration with assembly scanning

🗃️ Data Access

Package	Description	NuGet
Elect.Data.EF	Entity Framework with Unit of Work & Repository patterns
Elect.Data.IO	File system utilities, image processing (resize, compress)

🌐 Web Development

Package	Description	NuGet
Elect.Web	ASP.NET Core utilities with beautiful paged collections
Elect.Web.Middlewares	Performance & optimization middlewares
Elect.Web.DataTable	Server-side jQuery DataTable with advanced features
Elect.Web.HttpDetection	Device & location detection via HTTP requests

⚙️ Background Processing

Package	Description	NuGet
Elect.Job.Hangfire	Enhanced Hangfire with easier setup & security

📍 Location Services

Package	Description	NuGet
Elect.Location.Models	Common location data models
Elect.Location.Coordinate	Coordinate calculations and clustering
Elect.Location.Google	Google Maps API integration

🛠️ Requirements

.NET 9.0 or later
Visual Studio 2022 or JetBrains Rider (recommended)
Cross-platform: Windows, macOS, Linux

📖 Documentation & Samples

📁 Sample Projects - Comprehensive examples for each library
📄 Module Documentation - Detailed documentation for each package
🚀 Contributing Guide - How to contribute to the project

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details on:

How to submit issues and feature requests
Development setup and coding standards
Pull request process

📊 Project Stats

🧪 1,400+ Unit Tests with 90%+ coverage
📦 13 NuGet Packages with consistent versioning
🔄 Continuous Integration with automated testing
📈 Production Ready - Used in enterprise applications

📄 License

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

🙏 Acknowledgments

Built with ❤️ by Top Nguyen
Special thanks to all contributors
Powered by the .NET ecosystem

⭐ If you find this project useful, please give it a star! ⭐

Open Source - Elect