2021-04-15 10:10:20 +00:00
|
|
|
#!/usr/bin/env python3
|
2019-02-07 18:46:31 +00:00
|
|
|
# Copyright (c) 2019, 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 argparse
|
|
|
|
import sys
|
|
|
|
import utils
|
|
|
|
|
2019-08-05 20:34:31 +00:00
|
|
|
|
2019-02-07 18:46:31 +00:00
|
|
|
def ParseArgs(args):
|
2019-08-05 20:34:31 +00:00
|
|
|
args = args[1:]
|
|
|
|
parser = argparse.ArgumentParser(
|
|
|
|
description='A script to write a custom dartdoc_options.yaml to a file')
|
2019-02-07 18:46:31 +00:00
|
|
|
|
2019-08-05 20:34:31 +00:00
|
|
|
parser.add_argument(
|
|
|
|
'--output', '-o', type=str, required=True, help='File to write')
|
2019-02-07 18:46:31 +00:00
|
|
|
|
2019-08-05 20:34:31 +00:00
|
|
|
return parser.parse_args(args)
|
2019-02-07 18:46:31 +00:00
|
|
|
|
|
|
|
|
|
|
|
def Main(argv):
|
2019-08-05 20:34:31 +00:00
|
|
|
args = ParseArgs(argv)
|
|
|
|
# TODO(jcollins-g): switch to version numbers when github has its tags synced
|
|
|
|
revision = utils.GetGitRevision()
|
|
|
|
if revision is None:
|
|
|
|
revision = 'master'
|
|
|
|
output = '''dartdoc:
|
2019-02-07 18:46:31 +00:00
|
|
|
categoryOrder: ["Core", "VM", "Web"]
|
|
|
|
linkToSource:
|
|
|
|
root: '.'
|
|
|
|
uriTemplate: 'https://github.com/dart-lang/sdk/blob/%s/sdk/%%f%%#L%%l%%'
|
2021-06-29 19:31:28 +00:00
|
|
|
errors:
|
|
|
|
# Default errors of dartdoc:
|
|
|
|
- duplicate-file
|
|
|
|
- invalid-parameter
|
|
|
|
- no-defining-library-found
|
|
|
|
- tool-error
|
|
|
|
- unresolved-export
|
|
|
|
# Warnings that are elevated to errors:
|
|
|
|
- ambiguous-doc-reference
|
|
|
|
- ambiguous-reexport
|
|
|
|
- broken-link
|
|
|
|
- category-order-gives-missing-package-name
|
|
|
|
- deprecated
|
|
|
|
- ignored-canonical-for
|
|
|
|
- missing-from-search-index
|
|
|
|
- no-canonical-found
|
|
|
|
- no-documentable-libraries
|
|
|
|
- no-library-level-docs
|
|
|
|
- not-implemented
|
|
|
|
- orphaned-file
|
|
|
|
- reexported-private-api-across-packages
|
|
|
|
# - unknown-directive # Disabled due to https://github.com/dart-lang/dartdoc/issues/2353
|
|
|
|
- unknown-file
|
|
|
|
- unknown-macro
|
|
|
|
- unresolved-doc-reference
|
2019-02-07 18:46:31 +00:00
|
|
|
''' % revision
|
2019-08-05 20:34:31 +00:00
|
|
|
with open(args.output, 'w') as f:
|
|
|
|
f.write(output)
|
|
|
|
return 0
|
|
|
|
|
2019-02-07 18:46:31 +00:00
|
|
|
|
|
|
|
if __name__ == '__main__':
|
2019-08-05 20:34:31 +00:00
|
|
|
sys.exit(Main(sys.argv))
|