# more 2.3.0 More Dart — Literally. Collecting, iterating, caching, mathematics, matching, ordering, and formatting easily. ## Installing ``` export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com flutter pub add 'more:2.3.0' ``` Published: 2020-05-21T11:06:37.502805Z Expected archive SHA-256: 2df9a5775e2536a8017fdaa0e2f1c758e04e91b634e39cf90f0b498c50c806f4 Available in cache; verification: upstream_checksum ## Direct dependencies - collection: ^1.14.0 - meta: ^1.1.0 ## Package README (untrusted upstream documentation) More Dart — Literally ===================== [![Pub Package](https://img.shields.io/pub/v/more.svg)](https://pub.dev/packages/more) [![Build Status](https://travis-ci.org/renggli/dart-more.svg)](https://travis-ci.org/renggli/dart-more) [![Coverage Status](https://coveralls.io/repos/renggli/dart-more/badge.svg)](https://coveralls.io/r/renggli/dart-more) [![GitHub Issues](https://img.shields.io/github/issues/renggli/dart-more.svg)](https://github.com/renggli/dart-more/issues) [![GitHub Forks](https://img.shields.io/github/forks/renggli/dart-more.svg)](https://github.com/renggli/dart-more/network) [![GitHub Stars](https://img.shields.io/github/stars/renggli/dart-more.svg)](https://github.com/renggli/dart-more/stargazers) [![GitHub License](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/renggli/dart-more/master/LICENSE) Various extensions that make Dart a better place: - `cache.dart` is a collection of different caching strategies and their expiry policy. - `char_matcher.dart` is a model for character classes, their composition and operations on strings. - `collection.dart` is a collection of collection types: bi-map, bit-list, multi-set, set and list multi-map, range, and string. - `iterable.dart` is a collection of iterables and iterators. - `math.dart` is a collection of common mathematical functions. - `number.dart` provides fractional, complex and quaternion arithmetic. - `ordering.dart` a fluent interface for building comparator functions. - `printer.dart` a fluent interface for configuring sophisticated formatter. - `tuple.dart` a generic sequence of typed values. And there are more to come ... This library is open source, stable and well tested. Development happens on [GitHub](https://github.com/renggli/dart-more). Feel free to report issues or create a pull-request there. General questions are best asked on [StackOverflow](http://stackoverflow.com/questions/tagged/more+dart). The package is hosted on [dart packages](https://pub.dev/packages/more). Up-to-date [class documentation](https://pub.dev/documentation/more/) is created with every release. Misc ---- ### Installation Follow the installation instructions on [dart packages](https://pub.dev/packages/more#-installing-tab-). Import one or more of the packages into your Dart code using: ```dart import 'package:more/cache.dart'; import 'package:more/char_matcher.dart'; import 'package:more/collection.dart'; import 'package:more/hash.dart'; import 'package:more/iterable.dart'; import 'package:more/math.dart'; import 'package:more/number.dart'; import 'package:more/ordering.dart'; import 'package:more/printer.dart'; import 'package:more/tuple.dart'; ``` ### Contributing The goal of the library is to provide a loose collection of carefully curated utilities that are not provided by the Dart standard library. All features must be well tested. New features must have significant advantages over alternatives, such as code reduction, readability improvement, speed increase, memory reduction, or improved accuracy. In case of doubt, consider filing a feature request before filing a pull request. ### History This library started in April 2013 as I was working through the puzzles of [Project Euler](https://projecteuler.net/) and encountered some missing features in Dart. Over time the library grew and became _more_ useful in many other places, so I created this reusable library. Some parts of this library are inspired by similar APIs in [Google Guava](https://github.com/google/guava) (Google core libraries for Java) and [Apache Commons](https://commons.apache.org/) (a repository of reusable Java components). ### License The MIT License, see [LICENSE](https://github.com/renggli/dart-more/raw/master/LICENSE). ## Changelog # Changelog ## 2.3.0 * Add `ListMultimap` and `SetMultimap`. * Mark `CharMatcher`, `Cache` and `Ordering` as immutable. * Improve documentation, which still included pre Dart 2.0 examples. * Add extension methods to convert `Comparator` to `Ordering`. ## 2.2.0 * Made `truncateToPeriod` and `periodical` extension methods of `DateTime`. * Add extension methods to convert * a `Map` to a `BiMap`, * an `Iterable` to a `BitList`, * and an `Iterable` to a `Multiset`. ## 2.1.0 * Cleanup `Tuple` class to be more readable and better typed. ## 2.0.0 * Dart 2.7 compatibility and requirement. * Cleaned up deprecated code. * Iterables * Converted most helpers to extension methods. * Removed `fold` and `fib`, as they are not generally useful. * Moved `digits` to `package:more/math`. * Collections * Add extension method to `int` and `double` to create ranges, i.e. `0.to(20)`. * Move the string lists to `String.toList()` extension method. * Math * Move all numerical operators to `num`, `ìnt` and/or `BigInt` (new). ## 1.18.0 * Dart 2.4 compatibility and requirement. * Add a tuple data type. ## 1.17.0 * Dart 2.3 compatibility and requirement. * Various code improvements and optimizations. ## 1.16.0 * Dart 2.2 compatibility and requirement. ## 1.15.0 * Deprecated `package:more/int_math` package, and moved all not-deprecated code to `package:more/math.dart`. * Add 'polyfills' for hyperbolic functions to the math package. * Add functionality for combining hash codes. ## 1.14.0 * Quaternion numbers. ## 1.13.0 * Rename `Range.stop` to `Range.end` to be consistent with Dart naming conventions. * Rename `partition` to `chunked` to be more consistent with Dart nomenclature. * Add the `zip` iterable. ## 1.12.0 * Add the number package. * Move `Fraction` class into this package. * Add support for `Complex` numbers. * Add the `groupBy` iterable. ## 1.11.0 * Add the printer package. ## 1.10.0 * Drop Dart 1.0 compatibility. ## 1.9.0 * Dart 2.0 strong-mode compatibility required the following breaking changes: * Replace callers of `range()` with either `IntegerRange()` or `DoubleRange()`. * Removed padding argument from `partition()`. To migrate replace broken calls-sites with `partitionWithPadding()`. ## 1.8.1 * Removed empty(), emptyIterator(), emptyIterable() since these are part of the core library now. * Add periodic iterable tools (monthly, weekly, daily, hourly, ...). ## 1.8.0 * Ordering.reversed, Ordering.nullsFirst, Ordering.nullsLast, and Ordering.lexicographical are now properties for consistency with the Iterable protocol. * Various optimization and improvements on the Range class. ## 1.7.2 * Cleanup after micro library migration. * Move to latest Dart provided mixins. ## 1.7.1 * Cleanup after micro library migration. * Address linter warnings. * Better test coverage. ## 1.7.0 * Migrate to micro libraries. * Add caching library. ## 1.6.0 * Use generic method syntax. ## 1.5.3 * Fix pubspec SDK constraints. ## 1.5.2 * Fix linter warnings. * Improve documentation. ## 1.5.1 * Strong compiler compliant. ## 1.5.0 * Fix various typos and linter issues. * Reformat documentation. ## 1.4.0 * Migrate to Travis.