starting work on help generation and table class

src/App/Application.php

@@ -222,6 +222,21 @@ function($params) use ($version, $title) {
 		$this->command($command);
 	}
 
+	protected function buildMainHelpCommand(): void {
+		$command_help = $this->Help->buildHelpOutPut($this->Application_Object);
+
+		$command = Command::create('help')
+			->about('Prints this help information')
+			->action(function () use ($command_help) {
+				printf($command_help);
+				return;
+			})
+			->save();
+
+		$this->command($command);
+
+	}
+
 	/**
 	 * Before run completes this should be done
 	 *
@@ -230,6 +245,10 @@ function($params) use ($version, $title) {
 	protected function before(): void {
 		$this->argv = $_SERVER['argv'];
 		$this->buildVersionCommand();
+
+		if(empty($this->Application_Object->commands['help'])) {
+			$this->buildMainHelpCommand();
+		}
 	}
 
 	/**

src/App/Request/Request_Response.php

@@ -2,7 +2,7 @@
 namespace Clyde\Request;
 
 /**
- * @phpstan-type RRes array{'body'?: mixed, 'error'?: mixed}
+ * @template RRes of array{'body'?: mixed, 'error'?: mixed}
  */
 class Request_Response
 {
@@ -30,9 +30,9 @@ class Request_Response
 	/**
 	 * construct
 	 *
-	 * @param boolean     $success successful
-	 * @param string      $message message to attach
-	 * @param array<RRes> $data    any additional data
+	 * @param boolean $success successful
+	 * @param string  $message message to attach
+	 * @param RRes    $data    any additional data
 	 */
 	public function __construct(bool $success, string $message = '', array $data = []) {
 		$this->success = $success;

src/App/Templates/help.txt

@@ -1,7 +1,8 @@
 #application_name#
 -----------------------------------------------
-#version#
-#author#
-#website#
+#version# #author# #website#
 
 #about#
+
+#commands#
+

src/App/Tools/Help.php

@@ -2,6 +2,7 @@
 namespace Clyde\Tools;
 
 use Clyde\Objects\Application_Object;
+use Clyde\Tools\Table;
 use Exception;
 
 class Help
@@ -53,6 +54,19 @@ public function buildHelpOutPut(Application_Object $Application_Object): string
 
 		$file = preg_replace($this->help_lexemes, $help_data, $file_contents);
 
+		$this->Table = new Table;
+		$rows = [];
+		foreach ($Application_Object->commands as $command) {
+			$rows[] = [$command->command_name, $command->about];
+		}
+
+		$help_info = $this->Table->printTable([
+			'headers' => ['Command', 'Description'],
+			'rows' => $rows
+		]);
+
+		$file = preg_replace('%\#commands\#%', $help_info, $file);
+
 		return $file;
 	}
 }

src/App/Tools/Table.php

@@ -1,16 +1,64 @@
 <?php
 namespace Clyde\Tools;
 
+/**
+ * @phpstan-type THColumn array<string>
+ * @phpstan-type TableHeader array<THColumn>
+ * @phpstan-type TableColumn array<string>
+ * @phpstan-type TableRow array<TableColumn>
+ */
 class Table
 {
 	/**
 	 * Eventually this will have a print table helper method
 	 *
-	 * @param array $table the table data	 
-	 * @return void
+	 * @param array{0:TableHeader, 1: TableRow} $table the table data	 
+	 * @return string
 	 */
-	public function printTable(array $table): void {
-		// table should be an array of rows/columns
-		// str_pad to get longest in column
+	public function printTable(array $table): string {
+		$column_lengths = [];
+
+		foreach ($table['headers'] as $row_key => $value) {
+			$length = strlen($value) + 2;
+			if (empty($column_lengths[$row_key]) || $column_lengths[$row_key] < $length) {
+				$column_lengths[$row_key] = $length;
+			}
+		}
+		foreach ($table['rows'] as $key => $row){
+			foreach($row as $row_key => $value) {
+				$length = strlen($value) + 2;
+				if (empty($column_lengths[$row_key]) || $column_lengths[$row_key] < $length) {
+					$column_lengths[$row_key] = $length;
+				}
+			}
+		}
+		$output = '';
+		foreach($table['headers'] as $row_key => $value) {
+			$value = str_pad($value, $column_lengths[$row_key], ' ');
+			$output .= '|' . $value;
+			if (array_key_last($table['headers']) === $row_key) {
+				$output .=  '|';
+			}
+		}
+		$output .= PHP_EOL;
+		foreach ($column_lengths as $key => $length) {
+			$output_row = '|';
+			$row_cur = str_pad($output_row, (int)$length + 1, '-');
+			$output .= $row_cur;
+		}
+		$output .=  '|';
+		$output .= PHP_EOL;
+		foreach($table['rows'] as $key => $row) {
+			foreach ($row as $row_key => $value) {
+				$value = str_pad($value, $column_lengths[$row_key], ' ');
+				$output .= '|' . $value;
+				if (array_key_last($row) === $row_key) {
+					$output .=  '|';
+				}
+			}
+			$output .= PHP_EOL;
+		}
+
+		return $output;
 	}
 }