basicsetupdart 1.0.0+1

A comprehensive Flutter utility library providing essential functions for date operations, validations, and common tasks.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.0+1 - 2023-12-15

Added

• DateUtils: Comprehensive date utility functions

  • getCurrentDateTime() - Get current date/time in custom formats
  • stringToDate() - Convert string to DateTime with custom format support
  • dateToString() - Convert DateTime to string with custom format support
  • getDateDifference() - Calculate date differences in various units (timestamp, days, hours, minutes, seconds)
  • addDays(), addMonths(), addYears() - Date arithmetic operations
  • isLeapYear() - Leap year validation
  • getDaysInMonth() - Get number of days in a month
  • startOfDay(), endOfDay() - Get start/end of day
  • isToday(), isYesterday(), isTomorrow() - Date comparison utilities
  • getAge() - Calculate age from birth date

• ValidationUtils: Comprehensive validation functions

  • checkValidLength() - String length validation
  • checkValidUrl() - URL validation
  • checkValidPanNumber() - Indian PAN number validation
  • checkValidGSTNumber() - Indian GST number validation
  • checkValidEmail() - Email address validation
  • checkValidPhoneNumber() - Phone number validation with configurable length
  • checkValidIndianMobileNumber() - Indian mobile number validation
  • checkValidAadhaarNumber() - Indian Aadhaar validation using Verhoeff algorithm
  • checkValidCreditCardNumber() - Credit card validation using Luhn algorithm
  • checkValidPassword() - Password strength validation with configurable requirements
  • checkValidIFSCCode() - Indian IFSC code validation
  • checkValidUPIId() - UPI ID validation
  • isAlphabetsOnly(), isNumbersOnly(), isAlphanumeric() - String type validations
  • isEmpty(), isNotEmpty() - Null/empty checks

• StringUtils: String manipulation and analysis functions

  • capitalizeWords(), capitalizeFirst() - Text capitalization
  • toCamelCase(), toSnakeCase(), toKebabCase() - Case conversions
  • removeWhitespace(), removeSpecialCharacters() - Text cleaning
  • reverse() - String reversal
  • isPalindrome() - Palindrome detection
  • countOccurrences() - Substring counting
  • truncate() - String truncation with suffix support
  • generateRandomString() - Random string generation
  • maskString() - Sensitive data masking
  • extractNumbers(), extractEmails(), extractUrls() - Data extraction
  • formatCurrency() - Currency formatting
  • toSlug() - URL-friendly slug generation
  • startsWithAny(), endsWithAny() - Prefix/suffix checking

• NumberUtils: Mathematical and number formatting functions

  • formatWithCommas(), formatWithCommasDouble() - Number formatting
  • numberToWords() - Number to words conversion (Indian format)
  • toOrdinal() - Ordinal number conversion
  • roundToDecimalPlaces() - Decimal rounding
  • isEven(), isOdd(), isPrime() - Number property checks
  • factorial() - Factorial calculation
  • gcd(), lcm() - Greatest common divisor and least common multiple
  • randomInt(), randomDouble() - Random number generation
  • calculatePercentage() - Percentage calculation
  • calculateCompoundInterest(), calculateSimpleInterest() - Interest calculations
  • convertTemperature(), convertLength(), convertWeight() - Unit conversions

• FileUtils: File and path utility functions

  • getFileExtension(), getFileName(), getFileNameWithoutExtension() - File path parsing
  • getDirectoryPath() - Directory path extraction
  • hasValidExtension() - File extension validation
  • getHumanReadableFileSize() - File size formatting
  • generateUniqueFileName() - Unique file name generation
  • sanitizeFileName() - File name sanitization
  • isImageFile(), isVideoFile(), isAudioFile(), isDocumentFile() - File type detection
  • getMimeType() - MIME type identification
  • formatFilePathForDisplay() - Path formatting for display
  • isAbsolutePath() - Absolute path checking
  • joinPath(), normalizePath() - Path manipulation

• NetworkUtils: Network and URL utility functions

  • isValidIPAddress(), isValidIPv4Address(), isValidIPv6Address() - IP address validation
  • isValidMACAddress() - MAC address validation
  • extractDomain(), extractProtocol(), extractPort(), extractPath() - URL parsing
  • extractQueryParameters(), buildUrlWithQueryParams() - Query parameter handling
  • isHttps(), isHttp() - Protocol checking
  • generateRandomUserAgent() - User agent generation
  • isValidEmailDomain() - Domain validation
  • getDefaultPort() - Default port lookup
  • isValidPort(), isWellKnownPort(), isRegisteredPort(), isDynamicPort() - Port validation
  • parseHttpStatusCode() - HTTP status code parsing
  • isSuccessStatusCode(), isClientErrorStatusCode(), isServerErrorStatusCode() - Status code checking
  • generateRandomIPAddress() - Random IP generation
  • ipToInt(), intToIP() - IP address conversions

• Example App: Complete example application demonstrating all utility functions

• Comprehensive Documentation: Detailed README with usage examples and API reference

• MIT License: Open source license for maximum compatibility

Technical Details

• Built with Flutter SDK ^3.9.2
• No external dependencies (pure Dart implementation)
• Comprehensive test coverage for all utility functions
• Indian-specific validations and formatting support
• Cross-platform compatibility (iOS, Android, Web, Desktop)

Performance

• Optimized algorithms for validation functions
• Efficient string manipulation methods
• Memory-efficient implementations
• Fast execution for all utility functions

Documentation

• Complete API documentation
• Usage examples for all functions
• Code comments and documentation strings
• Example app with live demonstrations