Skip to content

Pana Dartdoc Crashing #4180

@shawkyebrahim2514

Description

@shawkyebrahim2514

The issue is that dartdoc 9.0.2 has a bug (RangeError in _stripDocImports) that crashes when processing documentation comments, causing pana to fail the documentation check

  • Activated pana 0.23.8
  • dartdoc 9.0.2
WARNING: `dartdoc` failed:
                                    Discovering libraries...
                                    Linking elements...
                                    Precaching local docs for 931342 elements...
                                    dartdoc 9.0.2 (/C:/Users/cloudtest/AppData/Local/Temp/pana.1768941083324.4da2768/pub-cache/global_packages/dartdoc/bin/dartdoc.dart-3.10.7.snapshot) failed: ParallelWaitError: RangeError (end): Invalid value: Not in inclusive range 0..9088: 9201
                                    #0      RangeError.checkValidRange (dart:core/errors.dart:392:9)
                                    dart-lang/pub-dev#1      _StringBase.substring (dart:core-patch/string_patch.dart:440:27)
                                    dart-lang/pub-dev#2      DocumentationComment._stripDocImports (package:dartdoc/src/model/documentation_comment.dart:553:28)
                                    dart-lang/pub-dev#3      DocumentationComment.processComment (package:dartdoc/src/model/documentation_comment.dart:94:16)
                                    dart-lang/pub-dev#4      DocumentationComment._buildDocumentationBase (package:dartdoc/src/model/documentation_comment.dart:717:25)
                                    dart-lang/pub-dev#5      DocumentationComment.precacheLocalDocs (package:dartdoc/src/model/documentation_comment.dart:688:33)
                                    dart-lang/pub-dev#6      PackageGraph._precacheLocalDocs (package:dartdoc/src/model/package_graph.dart:173:27)
                                    dart-lang/pub-dev#7      PackageGraph.initializePackageGraph (package:dartdoc/src/model/package_graph.dart:119:11)
                                    dart-lang/pub-dev#8      PubPackageBuilder.buildPackageGraph (package:dartdoc/src/model/package_builder.dart:152:22)
                                    <asynchronous suspension>
                                    dart-lang/pub-dev#9      Dartdoc.generateDocsBase (package:dartdoc/src/dartdoc.dart:193:24)
                                    <asynchronous suspension>
                                    dart-lang/pub-dev#10     Dartdoc.generateDocs (package:dartdoc/src/dartdoc.dart:237:24)
                                    <asynchronous suspension>
                                    dart-lang/pub-dev#11     Dartdoc.executeGuarded.<anonymous closure> (package:dartdoc/src/dartdoc.dart:269:9)
                                    <asynchronous suspension>

## ✗ Provide documentation (10 / 20)
### [x] 0/10 points: 20% or more of the public API has dartdoc comments

OUT:
Discovering libraries...
Linking elements...
Precaching local docs for 931342 elements...
ERR:
dartdoc 9.0.2 (/C:/Users/cloudtest/AppData/Local/Temp/pana.1768986759630.29df6864/pub-cache/global_packages/dartdoc/bin/dartdoc.dart-3.10.7.snapshot) failed: ParallelWaitError: RangeError (end): [...]
#0      RangeError.checkValidRange (dart:core/errors.dart:392:9)
dart-lang/pub-dev#1      _StringBase.substring (dart:core-patch/string_patch.dart:440:27)
dart-lang/pub-dev#2      DocumentationComment._stripDocImports (package:dartdoc/src/model/documentation_comment.dart:553:28)
dart-lang/pub-dev#3      DocumentationComment.processComment (package:dartdoc/src/model/documentation_comment.dart:94:16)
dart-lang/pub-dev#4      DocumentationComment._buildDocumentationBase (package:dartdoc/src/model/documentation_comment.dart:717:25)
dart-lang/pub-dev#5      DocumentationComment.precacheLocalDocs (package:dartdoc/src/model/documentation_comment.dart:688:33)
dart-lang/pub-dev#6      PackageGraph._precacheLocalDocs (package:dartdoc/src/model/package_graph.dart:173:27)
dart-lang/pub-dev#7      PackageGraph.initializePackageGraph (package:dartdoc/src/model/package_graph.dart:119:11)
dart-lang/pub-dev#8      PubPackageBuilder.buildPackageGraph (package:dartdoc/src/model/package_builder.dart:152:22)
[7 more lines]

Metadata

Metadata

Assignees

No one assigned

    Labels

    needs-infoAdditional information needed from the issue author

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions