test(behat): add stable nextcloud log reader step

Signed-off-by: Vitor Mattos <1079143+vitormattos@users.noreply.github.com>

Author: vitormattos

tests/integration/features/bootstrap/MockWebServerContext.php

@@ -58,6 +58,26 @@ public function readTheLastRequestBodyFromMockWebServer(string $serverName): voi
 		}
 	}
 
+	/**
+	 * @When /^read the last Nextcloud log entry containing "([^"]*)"$/
+	 */
+	public function readTheLastNextcloudLogEntryContaining(string $needle): void {
+		$logPath = static::findParentDirContainingFile('console.php') . '/data/nextcloud.log';
+
+		$deadline = microtime(true) + 4;
+		do {
+			$entry = $this->findLastLogEntryContaining($logPath, $needle);
+			if ($entry !== null) {
+				self::$commandOutput = $entry;
+				return;
+			}
+
+			usleep(200000);
+		} while (microtime(true) < $deadline);
+
+		throw new RuntimeException('Nextcloud log does not contain: ' . $needle);
+	}
+
 	#[AfterScenario()]
 	public function stopMockWebServers(): void {
 		foreach ($this->mockServers as $server) {
@@ -95,4 +115,23 @@ private function getLastRequest(string $serverName): RequestInfo {
 
 		return $request;
 	}
+
+	private function findLastLogEntryContaining(string $logPath, string $needle): ?string {
+		if (!is_file($logPath)) {
+			throw new RuntimeException('Nextcloud log file not found at ' . $logPath);
+		}
+
+		$lines = file($logPath, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
+		if (!is_array($lines)) {
+			throw new RuntimeException('Unable to read Nextcloud log file at ' . $logPath);
+		}
+
+		for ($index = count($lines) - 1; $index >= 0; $index--) {
+			if (str_contains($lines[$index], $needle)) {
+				return $lines[$index];
+			}
+		}
+
+		return null;
+	}
 }