commit | 77198b96dfb5aee50db394be839186eda541dd2a | [log] [tgz] |
---|---|---|
author | Lasse R.H. Nielsen <lrn@google.com> | Tue Jan 17 17:01:00 2023 +0100 |
committer | Lasse R.H. Nielsen <lrn@google.com> | Tue Jan 17 17:07:36 2023 +0100 |
tree | 0bd3d43187d3b0e502d58996b0ab56337a02d08a | |
parent | 85e987cf1b8aaba60bdc8b16dd1ee6233436549f [diff] |
Changes to Equality classes. `MapEquality` and `SetEquality` now expects the provided equalities to be compatible with the inherent equals (and hash) of the map or set. That allows using `Map.operator[]` and `Set.lookup` to match entries/elements from one collection with those of the other, instead of building an extra hash-map on the side to count occurrences. This helps `DeepCollectionEquality` which is likely to traverse a larger collection structure (mainly maps) and do repeated equals/hash code on sup-components. For unordered `DeepCollectionEquality`, a cache of computed values is added to avoid repeating the same computation during the traversal of a map-structure. Also adds `JsonEquality` which is tuned to JSON-like map/list/basic-value structures, and which assumes everything uses default `==` equality.
Contains utility functions and classes in the style of dart:collection
to make working with collections easier.
The package contains functions that operate on lists.
It contains ways to shuffle a List
, do binary search on a sorted List
, and various sorting algorithms.
The package provides a way to specify the equality of elements and collections.
Collections in Dart have no inherent equality. Two sets are not equal, even if they contain exactly the same objects as elements.
The Equality
interface provides a way to define such an equality. In this case, for example, const SetEquality(IdentityEquality())
is an equality that considers two sets equal exactly if they contain identical elements.
Equalities are provided for Iterable
s, List
s, Set
s, and Map
s, as well as combinations of these, such as:
const MapEquality(IdentityEquality(), ListEquality());
This equality considers maps equal if they have identical keys, and the corresponding values are lists with equal (operator==
) values.
Utilities for “zipping” a list of iterables into an iterable of lists.
An interface and implementation of a priority queue.
The package contains classes that “wrap” a collection.
A wrapper class contains an object of the same type, and it forwards all methods to the wrapped object.
Wrapper classes can be used in various ways, for example to restrict the type of an object to that of a supertype, or to change the behavior of selected functions on an existing object.
Please file feature requests and bugs at the issue tracker.