extender_dart 0.0.1

A utility library for Dart developers, offering an extensive range of commonly used operations and aliases. Designed to streamline daily coding tasks and enhance productivity.

Extender Dart

Extender Dart is a utility library for Dart developers. It offers a range of commonly used operations and aliases, including extensions for Lists and Maps to perform immutable add, remove, update, and insert operations. Designed to streamline everyday tasks, this library helps prevent accidental in-place modifications.

Features

• Common Operations: Execute frequently-used operations with ease.
• Alias Collection: Simplify and accelerate your development with intuitive aliases for various data types, including time-based aliases for int and type conversion checks for String.
• List Extensions: Extend your Lists with immutable operations to prevent accidental in-place modifications.
• Map Extensions: Perform immutable operations on your Maps to prevent unintended in-place changes.
• Sort Operations: Easily sort your collections in various orders, including by property and with special handling for null values.

Installation

dependencies:
  extender_dart: latest_version

Then, run:

pub get

Usage

Common Operations

... [Insert previous examples if any]

Aliases

Int Aliases

These aliases allow you to use integers as durations with great simplicity.

import 'package:extender_dart/extender_dart.dart';

var fiveMinutes = 5.minutes;  // Equivalent to Duration(minutes: 5)
var twoHours = 2.h;  // Equivalent to Duration(hours: 2)

String Aliases

Make type conversions and validations a breeze with these string aliases.

import 'package:extender_dart/extender_dart.dart';

var integerValue = "123".toIntOrNull();  // Converts the string to integer, if valid
bool isItDouble = "12.34".isDouble;  // Checks if the string is a valid double representation

var dateTimeValue = "2023-10-12T14:30:00Z".toDateTimeOrNull();  // Converts the string to DateTime, if valid

List Extensions

import 'package:extender_dart/extender_dart.dart';

var myList = [1, 2, 3];

// Add an element immutably
var extendedList = myList.addWith(4);  // [1, 2, 3, 4]

// Remove an element immutably
var reducedList = myList.removeWith(2);  // [1, 3]

// Insert an element at a specific index immutably
var insertedList = myList.insertWith(1, 10);  // [1, 10, 2, 3]

// Remove an element at a specific index immutably
var removedList = myList.removeAtWith(0);  // [2, 3]

Map Extensions

import 'package:extender_dart/extender_dart.dart';

var myMap = {'a': 1, 'b': 2};

// Add a key-value pair immutably
var extendedMap = myMap.addWith('c', 3);  // {'a': 1, 'b': 2, 'c': 3}

// Add a MapEntry immutably
var extendedWithEntryMap = myMap.addEntryWith(MapEntry('d', 4));  // {'a': 1, 'b': 2, 'd': 4}

// Remove a key-value pair immutably
var reducedMap = myMap.removeWith('a');  // {'b': 2}

// Update a value for a key immutably
var updatedMap = myMap.updateWith('b', (value) => value * 2);  // {'a': 1, 'b': 4}

Sort Operations

Extender Dart provides easy-to-use sorting utilities, making it simple to sort your lists in various orders.

Ascending & Descending

You can easily sort your lists in ascending or descending order.

import 'package:extender_dart/extender_dart.dart';

List<int> numbers = [1, 3, 5, 4, 2];
numbers.sort(SortOrder.asc);  // [1, 2, 3, 4, 5]
numbers.sort(SortOrder.desc); // [5, 4, 3, 2, 1]

Property Sorting

For more complex types like Maps, you can pick a property to sort by.

List<Map<String, int>> persons = [
  {"age": 20},
  {"age": 30},
  {"age": 10},
];
persons.sort(SortOrder.pick<Map>((e) => e["age"]).asc);  // [{"age": 10}, {"age": 20}, {"age": 30}]

Handling Nulls

The library also provides utilities for sorting lists that contain null values.

List<int?> numbersWithNulls = [1, 3, null, null, 2];
numbersWithNulls.sort(SortOrder.nullsFirst); // [null, null, 1, 2, 3]
numbersWithNulls.sort(SortOrder.nullsLast);  // [1, 2, 3, null, null]

Contributing

Extender Dart is an open-source project and is designed to be extensible. If you have ideas for new type extensions or improvements to existing ones, we warmly welcome your contributions. Not only are bug reports, feature requests, and questions appreciated, but we also encourage you to add extensions for other data types and share them with the community.

License

[MIT] - see the LICENSE file for details.