Markdown/Markdown Extra Test Suite
MDTest is a Markdown test suite derived from the older MarkdownTest by John Gruber. MDTest is primarily used for the developement of PHP Markdown but is strucutred in a way that can test and benchmark various implementations.
MDTest splits its tests into "mdtest" folders. The MDTest command line tool will run the test for the specified test suite if specified, or all of them if unspecified.
The Markdown test suite folder contains the original Markdown test suite from MarkdownTest. It was written by John Gruber to test Markdown.pl.
The PHP Markdown test suite folder contains complementary tests for PHP Markdown not included in the Markdown test suite.
The PHP Markdown Extra test suite folder contains tests for features added to PHP Markdown Extra and not present in regular Markdown.
This library package should be run with PHP 5.3 or later.
To run MDTest you need a Markdown parser. You can supply the parser as a function to call after loading a PHP library or as an executable script taking input from STDIN and emiting its output to STDOUT.
For instance, if you are testing PHP Markdown, use this command:
./mdtest.php -f \\Michelf\\Markdown::defaultTransform
This will make MDTest autoload the
\Michelf\Markdown class and call its
defaultTransform static method. (Note that you need to escape backslashes on the shell by prefixing them with another backslash. You may also want to run
git submodule init to get PHP Markdown Lib installed in your Implementations folder.)
For external scripts that need to run as a separate process you pass the path to the script instead:
./mdtest.php -s path/to/parser-executable
By default, MDTest will run tests from all folders with a
.mdtest extension it can find in the current directory. If no script or function is specified, it tries to
-? option to get a complete list of available options.
index.php file provides a rudimentary web interface for MDTest. It let you choose from a list of implementations in the Implementaiton folder and displays the output of the test script.
Please file bugs in the Github issue tracker.
Copyright (c) 2007-2013 Michel Fortin
Derived from Markdown Test
Copyright (c) 2004 John Gruber
Includes PHP Diff
Copyright (c) 2003 Daniel Unterberger
Copyright (c) 2005 Nils Knappmeier
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.