commit | 5a4373458bfc902e4a4064427c619c2b41783f0d | [log] [tgz] |
---|---|---|
author | Jacob MacDonald <jakemac@google.com> | Wed Jul 08 08:57:51 2020 -0700 |
committer | GitHub <noreply@github.com> | Wed Jul 08 08:57:51 2020 -0700 |
tree | 8fd71e25b3f85ae053f05f6943fbf0f71e8c4ac4 | |
parent | e0c41e0c1fb70ba606dc81335c981af7c00987c6 [diff] |
Merge null_safety branch into master (#125) Migrates this package to null safety and prepares for a null safety pre-release, once we have landed the package internally and in the SDK to verify its accuracy.
Contains utility classes in the style of dart:async
to work with asynchronous computations.
The AsyncCache
class allows expensive asynchronous computations values to be cached for a period of time.
The AsyncMemoizer
class makes it easy to only run an asynchronous operation once on demand.
The CancelableOperation
class defines an operation that can be canceled by its consumer. The producer can then listen for this cancellation and stop producing the future when it's received. It can be created using a CancelableCompleter
.
The delegating wrapper classes allow users to easily add functionality on top of existing instances of core types from dart:async
. These include DelegatingFuture
, DelegatingStream
, DelegatingStreamSubscription
, DelegatingStreamConsumer
, DelegatingSink
, DelegatingEventSink
, and DelegatingStreamSink
.
The FutureGroup
class makes it easy to wait until a group of features that may change over time completes.
The LazyStream
class allows a stream to be initialized lazily when .listen()
is first called.
The NullStreamSink
class is an implementation of StreamSink
that discards all events.
The RestartableTimer
class extends Timer
with a reset()
method.
The Result
class that can hold either a value or an error. It provides various utilities for converting to and from Future
s and Stream
s.
The StreamGroup
class merges a collection of streams into a single output stream.
The StreamQueue
class allows a stream to be consumed event-by-event rather than being pushed whichever events as soon as they arrive.
The StreamSplitter
class allows a stream to be duplicated into multiple identical streams.
The StreamZip
class combines multiple streams into a single stream of lists of events.
This package contains a number of StreamTransformer
s. SingleSubscriptionTransformer
converts a broadcast stream to a single-subscription stream, and typedStreamTransformer
casts the type of a Stream
. It also defines a transformer type for StreamSink
s, StreamSinkTransformer
.
The SubscriptionStream
class wraps a StreamSubscription
so it can be re-used as a Stream
.