DryFish.ILib.Random 2026.1.0

DryFish.ILib.Random

Random generation utilities for DryFish.ILib - strings, numbers, characters, colors, dates and more.

✨ Features

• 📝 String Array Random - Random element from user-provided array
• 🔢 Number Generation - Integers, longs, doubles, booleans
• 🔤 Character Generation - Letters, digits, custom ranges
• 🎨 Color Generation - Hex colors, console colors
• 📅 GUID Generation - Random unique identifiers
• 📚 Collection Utilities - Random items from lists
• 🔒 Thread-Safe - Safe for multi-threaded applications
• ⚡ Lightweight - Zero external dependencies
• 🔧 Cross-Platform - Supports .NET 6/7/8, .NET Standard 2.0, .NET Framework 4.6.2+

📦 Installation

.NET CLI

dotnet add package DryFish.ILib.Random

Package Manager

NuGet\Install-Package DryFish.ILib.Random

PackageReference

<PackageReference Include="DryFish.ILib.Random" Version="2026.1.0" />

🚀 Quick Start

using DryFish.ILib.Random;

// User provides their own array
string[] names = { "an", "binh", "chi" };
int[] numbers = { 1, 2, 3, 4, 5 };
char[] letters = { 'A', 'B', 'C', 'D', 'E' };

// Random from user's array
string randomName = ILibRandom.IRandomFromArray(names);     // returns "binh"
int randomNumber = ILibRandom.IRandomFromArray(numbers);    // returns 3
char randomLetter = ILibRandom.IRandomFromArray(letters);   // returns 'D'

// Random numbers
int dice = ILibRandom.IRandomInt(1, 6);                     // returns 4
long bigNum = ILibRandom.IRandomLong(1000, 9999);          // returns 5432
double percent = ILibRandom.IRandomDouble(0.0, 1.0);       // returns 0.73
bool isHeads = ILibRandom.IRandomBool();                   // returns true

// Random characters
char upper = ILibRandom.IRandomUppercase();                 // returns 'X'
char lower = ILibRandom.IRandomLowercase();                 // returns 'm'
char alphabet = ILibRandom.IRandomAlphabet('A', 'Z');      // returns 'G'

// Random colors
string hexColor = ILibRandom.IRandomHexColor();             // returns "#FF5733"
string consoleColor = ILibRandom.IRandomConsoleColor();     // returns "cyan"

// Random GUID
string guid = ILibRandom.IRandomGuid();                     // returns "a1b2c3d4-..."

// Random from List
var cities = new List<string> { "Hanoi", "Saigon", "Danang" };
string city = ILibRandom.IRandomItem(cities);               // returns "Saigon"

📚 API Reference

Array Methods

Number Methods

Character Methods

Collection Methods

Color Methods

Utility Methods

💡 Examples

Basic Usage

using DryFish.ILib.Random;

// User provides their own name array
string[] names = { "An", "Binh", "Chi", "Dung" };
string winner = ILibRandom.IRandomFromArray(names);
Console.WriteLine($"Winner: {winner}");

Random Dice Roll

int dice = ILibRandom.IRandomInt(1, 6);
Console.WriteLine($"You rolled: {dice}");

Random Password Generator

string[] chars = { "A", "B", "C", "1", "2", "3", "!", "@", "#" };
string password = "";
for (int i = 0; i < 8; i++)
{
    password += ILibRandom.IRandomFromArray(chars);
}
Console.WriteLine($"Password: {password}");

Random Color Chooser

string color = ILibRandom.IRandomConsoleColor();
Console.WriteLine($"Random color: {color}");

🔧 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

🤝 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

📄 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 Standard 2.0
• Thread-safe random implementation
• Inspired by DryFish.ILib

Made with ❤️ by DryFish