This directory contains tools for developers of the Dart markdown package.
When you make a change to the package that might have subtle consequences on how Markdown is parsed, it would be really great to see how your output compares to the previous output, on a large collection of Markdown.
One such collection is the Dartdoc comments of any Dart package, which dartdoc translates into HTML, with the help of this markdown package. You can use the
dartdoc-compare.dart script to compare what changes your code will make to dartdoc‘s output. Here’s how it works:
Clone the dartdoc git repository.
Get a copy of some Dart code that you would like to use for the comparison.
dartdoc-compare.dart script like so:
$ dart tool/dartdoc-compare.dart \ --dartdoc-dir=<dartdoc repo> \ --before=<git SHA of "previous" code> \ <directory of dart code for comparison>
The tool will then walk through the following steps:
pubspec.yamlto depend on your “before” version of markdown, and run
pubspec.yamlto depend on your “after” version of markdown (defaults to HEAD), and run
In an effort to make this package CommonMark-compliant, we have a script that runs the package through the CommonMark specs. To see help:
$ dart tool/stats.dart --help