docs: Add to user guide and changelog

Author: paulbalandan

user_guide_src/source/changelogs/v4.3.0.rst

@@ -128,6 +128,8 @@ Testing
 - The CITestStreamFilter filter class now implements methods for adding a filter to streams. See :ref:`testing-cli-output`.
 - Added the ``PhpStreamWrapper`` to make it easier to work with setting data to ``php://stdin``. See :ref:`testing-cli-input`.
 - Added method :ref:`benchmark-timer-record` to measure performance in a callable. Also enhanced common function ``timer()`` to accept optional callable.
+- A boolean third parameter ``$useExactComparison`` is added to ``TestLogger::didLog()`` which sets whether log messages are checked verbatim. This defaults to ``true``.
+- Added method ``CIUnitTestCase::assertLogContains()`` which compares log messages by parts instead of the whole of the message.
 
 Database
 ========

user_guide_src/source/testing/overview.rst

@@ -126,7 +126,12 @@ Additional Assertions
 assertLogged($level, $expectedMessage)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Ensure that something you expected to be logged actually was:
+Ensure that something you expected to be logged was actually logged:
+
+assertLogContains($level, $logMessage)
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Ensure that there's a record in the logs which contains a message part.
 
 .. literalinclude:: overview/007.php
 

user_guide_src/source/testing/overview/007.php

@@ -1,9 +1,13 @@
 <?php
 
-$config = new LoggerConfig();
-$logger = new Logger($config);
+$config = new Config\Logger();
+$logger = new CodeIgniter\Log\Logger($config);
 
-// ... do something that you expect a log entry from
+// check verbatim the log message
 $logger->log('error', "That's no moon");
-
 $this->assertLogged('error', "That's no moon");
+
+// check that a portion of the message is found in the logs
+$exception = new RuntimeException('Hello world.');
+$logger->log('error', $exception->getTraceAsString());
+$this->assertLogContains('error', '{main}');