blob: 0d9fa2f41043725e76b223a90249c2b236cc5612 [file] [log] [blame]
// Copyright (c) 2018, 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.
/// Implementation of Dart language experiment option handling for dartdoc.
/// See
library dartdoc.experiment_options;
import 'package:analyzer/src/dart/analysis/experiments.dart';
import 'package:dartdoc/src/dartdoc_options.dart';
abstract class DartdocExperimentOptionContext
implements DartdocOptionContextBase {
List<String> get enableExperiment =>
ExperimentStatus get experimentStatus =>
// TODO(jcollins-g): Implement YAML parsing for these flags and generation
// of [DartdocExperimentOptionContext], once a YAML file is available.
Future<List<DartdocOption>> createExperimentOptions() async {
return <DartdocOption>[
// TODO(jcollins-g): Consider loading experiment values from dartdoc_options.yaml?
new DartdocOptionArgOnly<List<String>>('enable-experiment', [],
help: 'Enable or disable listed experiments.\n' +
.where((e) => e.documentation != null)
.map((e) =>
' [no-]${e.enableString}: ${e.documentation} (default: ${e.isEnabledByDefault})')
new DartdocOptionSyntheticOnly<ExperimentStatus>(
(option, dir) => new ExperimentStatus.fromStrings(