add utilities

scribu · scribu · commit cc883cb2f82c · 2013-01-02T10:16:53.000+02:00
diff --git a/_utils/cmd-list.php b/_utils/cmd-list.php
@@ -0,0 +1,26 @@
+<?php
+
+# Given a list of commands as JSON on STDIN, generates an HTML table with the
+# top-level commands.
+#
+# Example usage:
+#
+# wp --cmd-dump --path=/path/to/wp | php _utils/cmd-list.php
+
+include __DIR__ . '/utils.php';
+
+$wp = read_json();
+
+foreach ( $wp['subcommands'] as $command ) {
+	if ( !$command['internal'] )
+		continue;
+
+	echo <<<EOB
+	<tr>
+		<td><a href="https://github.com/wp-cli/wp-cli/blob/master/php/commands/{$command['name']}.php">{$command['name']}</a></td>
+		<td>{$command['description']}</td>
+	</tr>
+
+EOB;
+}
+
diff --git a/_utils/compare-cmd b/_utils/compare-cmd
@@ -0,0 +1,22 @@
+#!/bin/bash
+
+# utility for comparing commands between two different wp-cli versions.
+
+if [ $# -lt 3 ]; then
+	echo 'usage: <version-a> <version-b> <wp-path>'
+	exit 1
+fi
+
+wp_path=$3
+
+get_syn_list() {
+	git checkout $1
+	wp --path=$wp_path --cmd-dump | php $(dirname $0)/syn-list.php
+}
+
+get_syn_list $1 > /tmp/wp-cli-a
+get_syn_list $2 > /tmp/wp-cli-b
+
+diff /tmp/wp-cli-a /tmp/wp-cli-b > cmd.diff
+
+echo 'Generated cmd.diff'
diff --git a/_utils/syn-list.php b/_utils/syn-list.php
@@ -0,0 +1,26 @@
+<?php
+# Given a list of commands as JSON on STDIN, generates a list of synopses.
+#
+# Example usage:
+#
+# wp --cmd-dump --path=/path/to/wp | php _utils/syn-list.php
+
+include __DIR__ . '/utils.php';
+
+function generate_synopsis( $command, $path = '' ) {
+	if ( isset( $command['internal'] ) && !$command['internal'] )
+		continue;
+
+	$full_path = $path . ' ' . $command['name'];
+
+	if ( !isset( $command['subcommands'] ) ) {
+		echo $full_path . ' ' . $command['synopsis'] . "\n";
+	} else {
+		foreach ( $command['subcommands'] as $subcommand ) {
+			generate_synopsis( $subcommand, $full_path );
+		}
+	}
+}
+
+generate_synopsis( read_json() );
+
diff --git a/_utils/utils.php b/_utils/utils.php
@@ -0,0 +1,18 @@
+<?php
+
+function read_json() {
+	$input = '';
+
+	while ( false !== ( $line = fgets( STDIN ) ) ) {
+		$input .= $line;
+	}
+
+	$json = json_decode( $input, true );
+	if ( !$json ) {
+		echo "Invalid JSON.";
+		exit(1);
+	}
+
+	return $json;
+}
+
