add a few unit tests for DocParser

diff --git a/php/WP_CLI/DocParser.php b/php/WP_CLI/DocParser.php
index c5bfb16..f830285 100644 (file)
--- a/php/WP_CLI/DocParser.php
+++ b/php/WP_CLI/DocParser.php
@@ -17,6 +17,10 @@ class DocParser {
                return $matches[1];
        }
 
+       function get_longdesc() {
+               return false;
+       }
+
        function get_tag( $name ) {
                if ( preg_match( '/@' . $name . '\s+([a-z-_]+)/', $this->docComment, $matches ) )
                        return $matches[1];

diff --git a/tests/test-doc-parser.php b/tests/test-doc-parser.php
new file mode 100644 (file)
index 0000000..2026b3a
--- /dev/null
+++ b/tests/test-doc-parser.php
@@ -0,0 +1,75 @@
+<?php
+
+use WP_CLI\DocParser;
+
+class DocParserTests extends PHPUnit_Framework_TestCase {
+
+       function test_only_tags() {
+               $doc = new DocParser( <<<EOB
+/**
+ * @alias rock-on
+ */
+EOB
+               );
+
+               $this->assertFalse( $doc->get_shortdesc() );
+               $this->assertFalse( $doc->get_longdesc() );
+               $this->assertFalse( $doc->get_synopsis() );
+               $this->assertFalse( $doc->get_tag('foo') );
+               $this->assertEquals( 'rock-on', $doc->get_tag('alias') );
+       }
+
+       function test_no_longdesc() {
+               $doc = new DocParser( <<<EOB
+/**
+ * Rock and roll!
+ * @alias rock-on
+ */
+EOB
+               );
+
+               $this->assertEquals( 'Rock and roll!', $doc->get_shortdesc() );
+               $this->assertFalse( $doc->get_longdesc() );
+               $this->assertFalse( $doc->get_synopsis() );
+               $this->assertEquals( 'rock-on', $doc->get_tag('alias') );
+       }
+
+       function test_complete() {
+               $doc = new DocParser( <<<EOB
+/**
+ * Rock and roll!
+ *
+ * ## OPTIONS
+ *
+ * --volume=<number>
+ * : Sets the volume.
+ *
+ * ## EXAMPLES
+ *
+ * wp rock-on --volume=11
+ *
+ * @synopsis [--volume=<number>]
+ * @alias rock-on
+ */
+EOB
+               );
+
+               $this->assertEquals( 'Rock and roll!', $doc->get_shortdesc() );
+               $this->assertEquals( '[--volume=<number>]', $doc->get_synopsis() );
+               $this->assertEquals( 'rock-on', $doc->get_tag('alias') );
+
+               $longdesc = <<<EOB
+## OPTIONS
+
+--volume=<number>
+: Sets the volume.
+
+## EXAMPLES
+
+wp rock-on --volume=11
+EOB
+               ;
+               $this->assertEquals( $longdesc, $doc->get_longdesc() );
+       }
+}
+