| commit | b18c73e981ca5f533fdc19a5b5c9db0aaf21eccf | [log] [tgz] |
|---|---|---|
| author | Lasse R.H. Nielsen <lrn@google.com> | Wed Mar 23 17:02:26 2022 |
| committer | GitHub <noreply@github.com> | Wed Mar 23 17:02:26 2022 |
| tree | e72ce9122000df6f01e3132d0fac8839fe367cd2 | |
| parent | 9309ebe322b0420dd23e3cdc8775bfc80cecc368 [diff] |
Deprecate `AsyncCache.fetchStream`. (#209) * Deprecate `AsyncCache.fetchStream`. The feature complicates the `AsyncCache` class, and would be a better fit for a separate class. The functionality is not great. Since it returns the "same" stream each time the cache is queried (until evaluated), it actually caches all stream events The invalidation is tricky because the timer doesn't start until you *listen* to the stream. In practice, people will usually listen to the stream they fetch. It also seems that no-one ever used the functionality. There is no use inside Google, or in [Github](https://github.com/search?q=%22.fetchStream%22+language%3ADart+-filename%3Aasync_cache.dart+-filename%3Aasync_cache_test.dart&type=code), outside of the package's own tests. It's a better fit for a separate class, but it also appears to not be used anywhere
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 futures 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 Futures and Streams.
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 StreamTransformers. 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 StreamSinks, StreamSinkTransformer.
The SubscriptionStream class wraps a StreamSubscription so it can be re-used as a Stream.