mayr_dart_extensions 1.0.0 
mayr_dart_extensions: ^1.0.0 copied to clipboard
mayrlabs.comA comprehensive set of handy Dart extensions to make your code cleaner, shorter, and more expressive. Pure Dart package with zero Flutter dependencies.
mayr_dart_extensions #
A comprehensive collection of Dart extension methods to make your code cleaner, shorter, and more expressive.
Pure Dart package with zero Flutter dependencies. For Flutter-specific extensions, check out mayr_flutter_extensions.
📦 Installation #
Add to your pubspec.yaml:
dependencies:
mayr_dart_extensions: ^1.0.0
Or install via command line:
dart pub add mayr_dart_extensions
Then import:
import 'package:mayr_dart_extensions/mayr_dart_extensions.dart';
✨ Features at a Glance #
| Extension Type | Key Features |
|---|---|
| String | Case conversion, validation, formatting, masking, pattern matching |
| Number | Clamping, random generation, formatting, duration conversion |
| DateTime | Time checks, manipulation, age calculation, formatting |
| Duration | Delays, readable strings, comparisons |
| List/Iterable | Safe access, transformations, aggregations, mutations |
| Map | Safe access, transformations, merging |
| Set | Toggle, intersections, subset operations |
| Bool | Conditional selection, conversions |
| Object | Functional operations (let, also) |
| Humanize | Convert data to human-readable formats |
📚 Documentation #
String Extensions #
Case Conversion
'hello world'.camelCase; // 'helloWorld'
'hello world'.pascalCase; // 'HelloWorld'
'hello world'.snakeCase; // 'hello_world'
'hello world'.kebabCase; // 'hello-world'
'hello world'.titleCase; // 'Hello World'
'hello world'.capitalised; // 'Hello world'
Validation & Pattern Matching
'test@example.com'.isEmail; // true
'https://example.com'.isURL; // true
'192.168.1.1'.isIPAddress; // true
'#FF5733'.isHexColor; // true
'01ABZ23C4D5EF6GH7J8K9M'.isUlid; // true
'550e8400-e29b-41d4-a716-446655440000'.isUuid; // true
'hello-world-123'.isSlug; // true
'12345'.isNumericOnly; // true
'hello'.isAlphabetOnly; // true
String Utilities
'hello'.reverse(); // 'olleh'
' '.isBlank; // true
'hello world'.removeWhitespace(); // 'helloworld'
'hello world'.countOccurrences('l'); // 3
'The quick brown fox'.truncate(10); // 'The quick...'
'text'.wrap('"'); // '"text"'
'08012345678'.mask(); // '08*******78'
'long text'.limit(5); // 'long…'
Type Conversion
'true'.toBool; // true
'2025-01-15'.toDateTime(); // DateTime object
'[a-z]+'.toRegExp(); // RegExp object
'https://example.com'.toUri(); // Uri object
Pretty Printing
'{"name":"John","age":30}'.prettyJson();
'<root><item>value</item></root>'.prettyXml();
'name: John\nage: 30'.prettyYaml();
Number Extensions #
Comparisons & Checks
5.isBetween(1, 10); // true
5.isPositive; // true
-5.isNegativeNumber; // true
0.isZero; // true
4.isEvenNumber; // true
5.isOddNumber; // true
Clamping
5.clampMin(10); // 10
20.clampMax(15); // 15
Formatting
3.14159.toDecimalPlaces(2); // 3.14
1234.5.formatAsCurrency(locale: 'en_US', symbol: '\$'); // \$1,234.50
1234567.humanizeNumber(); // '1.2M'
1024.humanizeFileSize(); // '1.0 KB'
1.humanizeOrdinal(); // '1st'
21.humanizeOrdinal(); // '21st'
3.humanizeCount('item'); // '3 items'
Duration Conversion
2.days; // Duration(days: 2)
3.hours; // Duration(hours: 3)
30.minutes; // Duration(minutes: 30)
45.seconds; // Duration(seconds: 45)
Random Generation
10.randomLess(); // Random int < 10
5.randomMore(20); // Random int between 5 and 20
Iteration
3.times(() => print('Hello')); // Prints 'Hello' 3 times
3.timesIndexed((i) => print('Index: $i')); // Prints indices 0, 1, 2
DateTime Extensions #
Time of Day Checks
final now = DateTime.now();
now.isMorning; // Before 12 PM
now.isAfternoon; // 12 PM - 6 PM
now.isEvening; // 6 PM - 12 AM
now.isNight; // 12 AM - 6 AM
Date Checks
now.isToday; // true
now.isTomorrow; // false
now.isYesterday; // false
now.isInPast; // false
now.isInFuture; // false
now.isSameDay(DateTime(2025, 1, 15)); // Compare dates
Date Manipulation
now.addDays(5);
now.addMonths(2);
now.addYears(1);
now.addHours(3);
now.subDays(2);
now.startOfDay(); // Midnight of the same day
Age Calculations
DateTime(1990, 1, 1).toAge(); // Age in years
DateTime(1990, 1, 1).isAgeOlder(30); // true
DateTime(2010, 1, 1).isAgeYounger(18); // true
DateTime(2000, 1, 1).isAgeBetween(20, 30); // true
Formatting
now.format(MayrDateTimeFormats.usDate); // '2025-01-15'
now.format(MayrDateTimeFormats.ukDate); // '15/01/2025'
now.toTimeString(); // '14:30:00'
now.toShortDate(); // 'Wed 15th Jan'
now.toDayOrdinal(); // '15th'
now.toTimeAgoString(); // '2 hours ago'
now.humanize(); // 'just now'
Duration Extensions #
final duration = Duration(hours: 2, minutes: 30);
duration.toReadableString(); // '2h 30m'
duration.humanize(); // '2 hours, 30 minutes'
duration.isLongerThan(Duration(hours: 1)); // true
duration.isShorterThan(Duration(hours: 5)); // true
// Delay execution
await 2.seconds.delay();
await 2.seconds.delay(() => print('Done!'));
Bool Extensions #
true.choose('Yes', 'No'); // 'Yes'
false.choose('Yes', 'No'); // 'No'
true.toInt(); // 1
false.toInt(); // 0
true.toYesNo(); // 'Yes'
false.toYesNo(trueString: 'On', falseString: 'Off'); // 'Off'
true.not; // false
List & Iterable Extensions #
Safe Access
[1, 2, 3].firstOrNull(); // 1
[].firstOrNull(); // null
[1, 2, 3].lastOrNull(); // 3
[1, 2, 3].getOrNull(5); // null
[1, 2, 3].getOrDefault(5, 0); // 0
[1, 2, 3].singleWhereOrNull((e) => e == 2); // 2
Transformations
[1, 2, 3, 4, 5].chunked(2); // [[1, 2], [3, 4], [5]]
['a', 'b'].mapIndexed((i, e) => '$i:$e'); // ['0:a', '1:b']
[1, null, 2].whereNotNull(); // [1, 2]
[[1, 2], [3]].flatten(); // [1, 2, 3]
[1, 2, 3].flip(); // [3, 2, 1]
Aggregations
[1, 2, 3, 4, 5].sumBy((e) => e); // 15
[1, 2, 3, 4, 5].averageBy((e) => e); // 3.0
[3, 1, 4, 1, 5].min(); // 1
[3, 1, 4, 1, 5].max(); // 5
[1, 2, 3, 4, 5].countWhere((e) => e > 3); // 2
Mutations (Returns New List)
[1, 2, 3].insertIf(true, 4); // [1, 2, 3, 4]
[1, 2, 2, 3].replaceWhere((e) => e == 2, 5); // [1, 5, 5, 3]
[1, 2, 3].append(4); // [1, 2, 3, 4]
[1, 2, 2, 3].unique(); // [1, 2, 3]
Map Extensions #
final map = {'a': 1, 'b': 2};
map.getOrNull('c'); // null
map.getOrDefault('c', 0); // 0
map.mapKeys((k, v) => k.toUpperCase()); // {'A': 1, 'B': 2}
map.mapValues((k, v) => v * 2); // {'a': 2, 'b': 4}
map.invert(); // {1: 'a', 2: 'b'}
map.merge({'b': 3, 'c': 4}); // {'a': 1, 'b': 3, 'c': 4}
{'name': 'John', 'age': '30'}.toQueryString(); // 'name=John&age=30'
Set Extensions #
{1, 2, 3}.toggle(2); // {1, 3}
{1, 2, 3}.toggle(4); // {1, 2, 3, 4}
{1, 2, 3}.intersects({2, 3, 4}); // true
{1, 2}.isSubsetOf({1, 2, 3}); // true
{1, 2}.unionAll([{2, 3}, {3, 4}]); // {1, 2, 3, 4}
Object Extensions #
// let - Transform object inline
final result = 'hello'.let((it) => it.toUpperCase()); // 'HELLO'
// also - Execute side effects while maintaining value
final user = User('John')
.also((it) => print('Created user: ${it.name}'))
.also((it) => log.info('User logged'));
Dynamic Extensions #
// Debug mode helpers (pure Dart - no Flutter required)
final userId = getUserId().nullOnDebug<String>(); // null in debug
final debugInfo = getDebugInfo().onlyOnDebug<String>(); // value only in debug
// Random null simulation
final value = 'Simulate'.maybe(probability: 0.3); // 30% chance of null
// Safe default value
String? name = null;
name.orDefault('Guest'); // 'Guest'
🛠️ Tools #
MayrDateTimeFormats #
Common date/time format patterns:
MayrDateTimeFormats.ukDate; // 'dd/MM/yyyy'
MayrDateTimeFormats.ukDateTime; // 'dd/MM/yyyy HH:mm:ss'
MayrDateTimeFormats.usDate; // 'yyyy-MM-dd'
MayrDateTimeFormats.usDateTime; // 'yyyy-MM-dd HH:mm:ss'
MayrDateTimeFormats.time; // 'HH:mm:ss'
MayrDateTimeFormats.timeNoSecs; // 'HH:mm'
🤝 Contributing #
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
📄 License #
This project is licensed under the MIT License - see the LICENSE file for details.
🏢 About MayR Labs #
mayr_dart_extensions is maintained by MayR Labs.
- 🌐 Website: https://mayrlabs.com
- 💻 GitHub: https://github.com/MayR-Labs
- 📦 More packages: Check out our other Dart and Flutter packages!
🌟 Support #
If you find this package helpful:
- ⭐ Star the repository
- 🐛 Report issues or suggest features
- 📢 Share with the community
- 🤝 Contribute improvements
📦 Related Packages #
- mayr_flutter_extensions - Flutter-specific extensions (BuildContext, Widget, etc.)
Made with ❤️ by MayR Labs
Metadata
1
likes
160
points
15
downloads
Documentation
Publisher
Weekly Downloads
Metadata
A comprehensive set of handy Dart extensions to make your code cleaner, shorter, and more expressive. Pure Dart package with zero Flutter dependencies.
Repository (GitHub)
View/report issues
Contributing
Topics
#extensions #utilities #dart #productivity #toolkit
License
MIT (license)
Dependencies
get_time_ago, intl, xml, yaml
