Skip to content

dartdoc

A documentation generator for Dart.

Classes

ClassDescription
CategoryConfigurationA configuration class that can interpret category definitions from a YAML map.
CategoryDefinitionDefines the attributes of a category in the options file, corresponding to the 'categories' keyword in the options file, and populated by the CategoryConfiguration class.
ConstructedModelElementsKey
DartdocGenerates Dart documentation for all public Dart libraries in the given directory.
DartdocFileWriter
DartdocGeneratorOptionContextHelper class that consolidates option contexts for instantiating generators.
DartdocOption<T extends Object?>An abstract class for interacting with dartdoc options.
DartdocOptionArgFile<T>A DartdocOption that works with command line arguments and dartdoc_options files.
DartdocOptionArgOnly<T>A DartdocOption that only exists as a command line argument. --help is a good example.
DartdocOptionArgSynth<T>A class that defaults to a value computed from a closure, but can be overridden on the command line.
DartdocOptionContextAn DartdocOptionSet wrapped in nice accessors specific to Dartdoc, which automatically passes in the right directory for a given context.
DartdocOptionContextBaseAll DartdocOptionContext mixins should implement this, as well as any other DartdocOptionContext mixins they use for calculating synthetic options.
DartdocOptionFileOnly<T>
DartdocOptionFileSynth<T>A class that defaults to a value computed from a closure, but can be overridden by a file.
DartdocOptionRootThis is a DartdocOptionSet used as a root node.
DartdocOptionSetA DartdocOption that only contains other DartdocOptions and is not an option itself.
DartdocOptionSyntheticOnly<T>A synthetic option takes a closure at construction time that computes the value of the configuration option based on other configuration options. Does not protect against closures that self-reference. If mustExist and isDir or isFile is set, computed values will be resolved to canonical paths.
DartdocProgramOptionContext
DartDocResolvedLibraryContains the ResolvedLibraryResult and any additional information about the library.
DartdocResultsThe results of a Dartdoc.generateDocs call.
FileWriter
GeneratorA generator generates documentation for a given package.
InheritableElementsKey
NoFileWriterUsed for the generateDocs:false option.
PackageBuilderEverything you need to instantiate a PackageGraph object for documenting.
PackageGraph
PackageMetaDescribes a single package in the context of dartdoc.
PackageMetaProviderSets the supported way of constructing PackageMeta objects.
PubPackageBuilderA package builder that understands pub package format.
PubPackageMetaDefault implementation of PackageMeta depends on pub packages.

Exceptions

ExceptionDescription
DartdocFileMissing
DartdocOptionError
PackageMetaFailure

Enums

EnumDescription
Kind
OptionKindAn enum to specify the multiple different kinds of data an option might represent.

Mixins

MixinDescription
DartdocSyntheticOption<T>

Functions

FunctionDescription
clearPackageMetaCache
createDartdocOptionsInstantiate dartdoc's configuration file and options parser with the given command line arguments.
createDartdocProgramOptions
createGeneratorOptions
findPackageConfigDiscovers the package configuration for a Dart script.
findPackageConfigInDirectoryFinds a .dart_tool/package_config.json file in folder.
initHtmlGeneratorCreates a Generator with an HtmlGeneratorBackend backend.
initVitePressGeneratorCreates a Generator with a VitePressGeneratorBackend backend.
parseOptions

Properties

PropertyDescription
pubPackageMetaProvider

Constants

ConstantDescription
compileArgsTagName
dartdocVersion
programName

Typedefs

TypedefDescription
ConvertYamlToType<T>
OptionGenerator