fakhravari 0.0.4

Dart extension methods for String and num types, providing utilities like capitalization, number formatting, and validation.

Fakhravari

A collection of useful Dart and Flutter extension methods for working with String, int, double, DateTime, and encryption.
This package provides helpers for formatting, validation, Persian/Arabic date conversions, and more.

---

✨ Features

• Format numbers with commas, check even/odd, convert seconds to time string.
• Double extensions for trimming decimals, meters to feet, km to miles.
• String extensions for capitalization, masking, email validation, etc.
• AES encryption/decryption with CBC mode.
• Persian number and character conversions.
• Convert between Persian (Jalali), Gregorian, and Hijri dates.

---

📦 Installation

Add this to your pubspec.yaml:

dependencies:
  fakhravari: ^0.0.1

Then run:

flutter pub get

---

🚀 Usage Examples

🔢 IntExtensions

void main() {
  print(1234567.formatWithCommas()); // 1,234,567
  print(4.isEvenNumber()); // true
  print(5.isOddNumber()); // true
  print(125.toTimeString()); // 02:05
}

---

🔢 DoubleExtensions

void main() {
  print(12.3400.toStringAsFixedTrimmed(3)); // 12.34
  print(10.0.metersToFeet()); // 32.8084
  print(5.0.kmToMiles()); // 3.106855
}

---

🔤 StringExtensions

void main() {
  print('hello'.capitalize()); // Hello
  print('abc123'.containsDigit()); // true
  print('[e-mail]'.isValidEmail()); // true
  print('1234567890'.mask()); // 1234****90
}

---

🔐 SecureExtensions (AES Encrypt/Decrypt)

void main() {
  final encrypted = 'HelloWorld'.encryptAes();
  print(encrypted); // متن رمزنگاری شده

  final decrypted = encrypted.decryptAes();
  print(decrypted); // HelloWorld
}

---

🇮🇷 PersianExtensions

void main() {
  print('123456'.en2fa()); // ۱۲۳۴۵۶
  print('۱۲۳۴۵۶'.fa2en()); // 123456
  print('يكد'.fixPersianChars()); // یکد
  print('1403/05/16'.toGregorian()); // 2024-08-06 00:00:00.000
}

---

🗓 PersianDateTimeExtensions

void main() {
  final now = DateTime.now();
  print(now.toPersianDate()); // 1403/05/16
  print(now.toPersianDateTime()); // 1403/05/16 14:23:45
}

---

🕌 HijriDateExtensions

void main() {
  final now = DateTime.now();
  print(now.toHijriDate()); // 1446/01/22
  print(now.toHijriWithMonthName()); // 22 Muharram 1446
}

---

📜 License

MIT License © 2025 Mohammad Hossein Fakhravari