| Index: lib/boolean_selector.dart
|
| diff --git a/lib/boolean_selector.dart b/lib/boolean_selector.dart
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..92eedbda5159f7e81168194e9e4875b8d9b84ddb
|
| --- /dev/null
|
| +++ b/lib/boolean_selector.dart
|
| @@ -0,0 +1,55 @@
|
| +// Copyright (c) 2016, 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.
|
| +
|
| +import 'package:source_span/source_span.dart';
|
| +
|
| +import 'src/all.dart';
|
| +import 'src/impl.dart';
|
| +import 'src/none.dart';
|
| +
|
| +/// A boolean expression that evaluates to `true` or `false` based on certain
|
| +/// inputs.
|
| +///
|
| +/// The syntax is mostly Dart's expression syntax restricted to boolean
|
| +/// operations. See [the README][] for full details.
|
| +///
|
| +/// [the README]: https://github.com/dart-lang/boolean_selector/blob/master/README.md
|
| +abstract class BooleanSelector {
|
| + /// A selector that accepts all inputs.
|
| + static const all = const All();
|
| +
|
| + /// A selector that accepts no inputs.
|
| + static const none = const None();
|
| +
|
| + /// All the variables in this selector, in the order they appear.
|
| + Iterable<String> get variables;
|
| +
|
| + /// Parses [selector].
|
| + ///
|
| + /// This will throw a [SourceSpanFormatException] if the selector is
|
| + /// malformed or if it uses an undefined variable.
|
| + factory BooleanSelector.parse(String selector) = BooleanSelectorImpl.parse;
|
| +
|
| + /// Returns whether the selector matches the given [semantics].
|
| + ///
|
| + /// The [semantics] define which variables evaluate to `true` or `false`. The
|
| + /// parameter can be either an `Iterable<String>` containing variables that
|
| + /// should evaluate to `true`, or a function `bool semantics(String variable)`
|
| + /// that returns a variable's value.
|
| + bool evaluate(semantics);
|
| +
|
| + /// Returns a new [BooleanSelector] that matches only inputs matched by both
|
| + /// [this] and [other].
|
| + BooleanSelector intersection(BooleanSelector other);
|
| +
|
| + /// Returns a new [BooleanSelector] that matches all inputs matched by either
|
| + /// [this] or [other].
|
| + BooleanSelector union(BooleanSelector other);
|
| +
|
| + /// Throws a [FormatException] if any variables are undefined.
|
| + ///
|
| + /// The [isDefined] function should return `true` for any variables that are
|
| + /// considered valid, and `false` for any invalid or undefined variables.
|
| + void validate(bool isDefined(String variable));
|
| +}
|
|
|