| Index: lib/src/live_test.dart
|
| diff --git a/lib/src/live_test.dart b/lib/src/live_test.dart
|
| deleted file mode 100644
|
| index 1bb97573e4ee38a92fa01d7288d328bd152fdc35..0000000000000000000000000000000000000000
|
| --- a/lib/src/live_test.dart
|
| +++ /dev/null
|
| @@ -1,117 +0,0 @@
|
| -// Copyright (c) 2015, the Dart project authors. Please see the AUTHORS file
|
| -// for details. All rights reserved. Use of this source code is governed by a
|
| -// BSD-style license that can be found in the LICENSE file.
|
| -
|
| -library unittest.live_test;
|
| -
|
| -import 'dart:async';
|
| -
|
| -import 'state.dart';
|
| -import 'suite.dart';
|
| -import 'test.dart';
|
| -
|
| -/// A runnable instance of a test.
|
| -///
|
| -/// This is distinct from [Test] in order to keep [Test]. Running a test
|
| -/// requires state, and [LiveTest] provides a view of the state of the test as
|
| -/// it runs.
|
| -///
|
| -/// If the state changes, [state] will be updated before [onStateChange] fires.
|
| -/// Likewise, if an error is caught, it will be added to [errors] before being
|
| -/// emitted via [onError]. If an error causes a state change, [onStateChange]
|
| -/// will fire before [onError]. If an error or other state change causes the
|
| -/// test to complete, [onComplete] will complete after [onStateChange] and
|
| -/// [onError] fire.
|
| -abstract class LiveTest {
|
| - /// The suite within which this test is being run.
|
| - Suite get suite;
|
| -
|
| - /// The running test.
|
| - Test get test;
|
| -
|
| - /// The current state of the running test.
|
| - ///
|
| - /// This starts as [Status.pending] and [Result.success]. It will be updated
|
| - /// before [onStateChange] fires.
|
| - ///
|
| - /// Note that even if this is marked [Status.complete], the test may still be
|
| - /// running code asynchronously. A test is considered complete either once it
|
| - /// hits its first error or when all [expectAsync] callbacks have been called
|
| - /// and any returned [Future] has completed, but it's possible for further
|
| - /// processing to happen, which may cause further errors. It's even possible
|
| - /// for a test that was marked [Status.complete] and [Result.success] to be
|
| - /// marked as [Result.error] later.
|
| - State get state;
|
| -
|
| - /// Returns whether this test has completed.
|
| - ///
|
| - /// This is equivalent to [state.status] being [Status.complete].
|
| - ///
|
| - /// Note that even if this returns `true`, the test may still be
|
| - /// running code asynchronously. A test is considered complete either once it
|
| - /// hits its first error or when all [expectAsync] callbacks have been called
|
| - /// and any returned [Future] has completed, but it's possible for further
|
| - /// processing to happen, which may cause further errors.
|
| - bool get isComplete => state.status == Status.complete;
|
| -
|
| - // A stream that emits a new [State] whenever [state] changes.
|
| - //
|
| - // This will only ever emit a [State] if it's different than the previous
|
| - // [state]. It will emit an event after [state] has been updated. Note that
|
| - // since this is an asynchronous stream, it's possible for [state] not to
|
| - // match the [State] that it emits within the [Stream.listen] callback.
|
| - Stream<State> get onStateChange;
|
| -
|
| - /// An unmodifiable list of all errors that have been caught while running
|
| - /// this test.
|
| - ///
|
| - /// This will be updated before [onError] fires. These errors are not
|
| - /// guaranteed to have the same types as when they were thrown; for example,
|
| - /// they may need to be serialized across isolate boundaries. The stack traces
|
| - /// will be [Chain]s.
|
| - List<AsyncError> get errors;
|
| -
|
| - /// A stream that emits a new [AsyncError] whenever an error is caught.
|
| - ///
|
| - /// This will be emit an event after [errors] is updated. These errors are not
|
| - /// guaranteed to have the same types as when they were thrown; for example,
|
| - /// they may need to be serialized across isolate boundaries. The stack traces
|
| - /// will be [Chain]s.
|
| - Stream<AsyncError> get onError;
|
| -
|
| - /// A [Future] that completes once the test is complete.
|
| - ///
|
| - /// This will complete after [onStateChange] has fired, and after [onError]
|
| - /// has fired if the test completes because of an error. It's the same as the
|
| - /// [Future] returned by [run].
|
| - ///
|
| - /// Note that even once this completes, the test may still be running code
|
| - /// asynchronously. A test is considered complete either once it hits its
|
| - /// first error or when all [expectAsync] callbacks have been called and any
|
| - /// returned [Future] has completed, but it's possible for further processing
|
| - /// to happen, which may cause further errors.
|
| - Future get onComplete;
|
| -
|
| - /// Signals that this test should start running as soon as possible.
|
| - ///
|
| - /// A test may not start running immediately for various reasons specific to
|
| - /// the means by which it's defined. Until it starts running, [state] will
|
| - /// continue to be marked [Status.pending].
|
| - ///
|
| - /// This returns the same [Future] as [onComplete]. It may not be called more
|
| - /// than once.
|
| - Future run();
|
| -
|
| - /// Signals that this test should stop emitting events and release any
|
| - /// resources it may have allocated.
|
| - ///
|
| - /// Once [close] is called, [onComplete] will complete if it hasn't already
|
| - /// and [onStateChange] and [onError] will close immediately. This means that,
|
| - /// if the test was running at the time [close] is called, it will never emit
|
| - /// a [Status.complete] state-change event.
|
| - ///
|
| - /// This doesn't automatically happen after the test completes because there
|
| - /// may be more asynchronous work going on in the background that could
|
| - /// produce new errors.
|
| - Future close();
|
| -}
|
|
|