Changes before error encountered

Co-authored-by: swissspidy <841956+swissspidy@users.noreply.github.com>

Author: Copilot

examples/incremental-table.php

@@ -0,0 +1,64 @@
+<?php
+
+require_once 'common.php';
+
+/**
+ * Example demonstrating the incremental table row display feature.
+ * This shows how to display a table header once and then add rows incrementally in a loop.
+ */
+
+echo "Example 1: Using displayRow() to add rows incrementally\n";
+echo "=========================================================\n\n";
+
+$table = new \cli\Table();
+$table->setHeaders(array('Item', 'Status', 'Progress'));
+$table->display();
+
+// Simulate processing items in a loop
+$items = array(
+	array('Processing file 1', 'Done', '100%'),
+	array('Processing file 2', 'Done', '100%'),
+	array('Processing file 3', 'Done', '100%'),
+	array('Processing file 4', 'Done', '100%'),
+);
+
+foreach ($items as $item) {
+	// Add some delay to simulate processing
+	usleep(200000); // 0.2 seconds
+	$table->displayRow($item);
+}
+
+echo "\n\nExample 2: Using resetRows() to clear and update table data\n";
+echo "==============================================================\n\n";
+
+$table2 = new \cli\Table();
+$table2->setHeaders(array('Name', 'Age', 'City'));
+$table2->addRow(array('Alice', '30', 'New York'));
+$table2->addRow(array('Bob', '25', 'London'));
+$table2->display();
+
+echo "\nClearing rows and adding new data...\n\n";
+
+$table2->resetRows();
+$table2->addRow(array('Charlie', '35', 'Paris'));
+$table2->addRow(array('Diana', '28', 'Tokyo'));
+$table2->display();
+
+echo "\n\nExample 3: Incremental display with Tabular renderer (for piped output)\n";
+echo "========================================================================\n\n";
+
+$table3 = new \cli\Table();
+$table3->setRenderer(new \cli\table\Tabular());
+$table3->setHeaders(array('ID', 'Name', 'Email'));
+$table3->display();
+
+$users = array(
+	array('1', 'John Doe', 'john@example.com'),
+	array('2', 'Jane Smith', 'jane@example.com'),
+	array('3', 'Bob Johnson', 'bob@example.com'),
+);
+
+foreach ($users as $user) {
+	usleep(100000); // 0.1 seconds
+	$table3->displayRow($user);
+}

lib/cli/Table.php

@@ -27,6 +27,7 @@ class Table {
 	protected $_footers = array();
 	protected $_width = array();
 	protected $_rows = array();
+	protected $_displayed = false;
 
 	/**
 	 * Initializes the `Table` class.
@@ -79,6 +80,18 @@ public function resetTable()
 		$this->_width = array();
 		$this->_rows = array();
 		$this->_footers = array();
+		$this->_displayed = false;
+		return $this;
+	}
+
+	/**
+	 * Resets only the rows in the table, keeping headers, footers, and width information.
+	 *
+	 * @return $this
+	 */
+	public function resetRows()
+	{
+		$this->_rows = array();
 		return $this;
 	}
 
@@ -125,6 +138,31 @@ public function display() {
 		foreach( $this->getDisplayLines() as $line ) {
 			Streams::line( $line );
 		}
+		$this->_displayed = true;
+	}
+
+	/**
+	 * Display a single row without headers or top border.
+	 *
+	 * This method is useful for adding rows incrementally to an already-rendered table.
+	 * It will display the row with side borders and a bottom border (if using Ascii renderer).
+	 *
+	 * @param array $row The row data to display.
+	 */
+	public function displayRow(array $row) {
+		$row = $this->checkRow($row);
+		$this->_renderer->setWidths($this->_width, $fallback = true);
+		
+		$rendered_row = $this->_renderer->row($row);
+		$row_lines = explode( PHP_EOL, $rendered_row );
+		foreach ( $row_lines as $line ) {
+			Streams::line( $line );
+		}
+		
+		$border = $this->_renderer->border();
+		if (isset($border)) {
+			Streams::line( $border );
+		}
 	}
 
 	/**

tests/Test_Table.php

@@ -289,4 +289,67 @@ public function test_null_values_are_handled() {
 		];
 		$this->assertSame( $expected, $out, 'Null values should be safely converted to empty strings in table output.' );
 	}
+
+	public function test_resetRows() {
+		$table = new cli\Table();
+		$table->setHeaders( array( 'Name', 'Age' ) );
+		$table->addRow( array( 'Alice', '30' ) );
+		$table->addRow( array( 'Bob', '25' ) );
+		
+		$this->assertEquals( 2, $table->countRows() );
+		
+		$table->resetRows();
+		
+		$this->assertEquals( 0, $table->countRows() );
+		
+		// Headers should still be intact
+		$out = $table->getDisplayLines();
+		$this->assertGreaterThan( 0, count( $out ) );
+	}
+
+	public function test_displayRow_ascii() {
+		$mockFile = tempnam(sys_get_temp_dir(), 'temp');
+		$resource = fopen($mockFile, 'wb');
+		\cli\Streams::setStream('out', $resource);
+		
+		$table = new cli\Table();
+		$renderer = new cli\Table\Ascii();
+		$table->setRenderer( $renderer );
+		$table->setHeaders( array( 'Name', 'Age' ) );
+		
+		// Display a single row
+		$table->displayRow( array( 'Alice', '30' ) );
+		
+		$output = file_get_contents($mockFile);
+		unlink($mockFile);
+		
+		// Should contain the row data
+		$this->assertStringContainsString( 'Alice', $output );
+		$this->assertStringContainsString( '30', $output );
+		
+		// Should contain borders
+		$this->assertStringContainsString( '|', $output );
+		$this->assertStringContainsString( '+', $output );
+	}
+
+	public function test_displayRow_tabular() {
+		$mockFile = tempnam(sys_get_temp_dir(), 'temp');
+		$resource = fopen($mockFile, 'wb');
+		\cli\Streams::setStream('out', $resource);
+		
+		$table = new cli\Table();
+		$renderer = new cli\Table\Tabular();
+		$table->setRenderer( $renderer );
+		$table->setHeaders( array( 'Name', 'Age' ) );
+		
+		// Display a single row
+		$table->displayRow( array( 'Alice', '30' ) );
+		
+		$output = file_get_contents($mockFile);
+		unlink($mockFile);
+		
+		// Should contain the row data with tabs
+		$this->assertStringContainsString( 'Alice', $output );
+		$this->assertStringContainsString( '30', $output );
+	}
 }