Differences

This shows you the differences between two versions of the page.

--- project:unittests [2025/08/03 03:35] – [Meta Section] mnewnham
+++ project:unittests [2025/08/05 16:54] (current) – [Prerequistes] mnewnham
@@ Line 4: / Line 4: @@
 ===== Prerequistes =====
-[[https://phpunit.de|PHPUnit]] Version 9 or higher must be installed to conduct the suite of tests.
+  * PHP 8.0 or higher
+  * [[https://phpunit.de|PHPUnit]] Version 9 or higher must be installed to conduct the suite of tests.
 ===== Setup =====
@@ Line 73: / Line 74: @@
 ==== Caching Section ====
-Unless explicitly enabled, cache functions such as //**CacheExecute()**// are skipped. Tests only currently support Filesystem based caching. To activate this, add the following section to adodb-unittest.ini:
+Unless explicitly enabled, cache functions such as //**CacheExecute()**// are skipped. Tests are supported using Filesystem based or memcache based caching. To activate this, add the following section to adodb-unittest.ini:
+=== Filesystem ===
 <code>
 [caching]
 cacheMethod=1
 cacheDir=c:/dev/cache
+</code>
+=== Memcache Based ===
+<code>
+[cache]
+cacheMethod=2
+cacheHost=192.168.1.50
 </code>
@@ Line 94: / Line 102: @@
 ===== Test Execution =====
-==== PHPUnit ====
+==== PHPUnit Version 9 ====
 <code>
 phpunit unittest --bootstrap unittest/dbconnector.php <driver>
@@ Line 108: / Line 116: @@
 It is not possible to pass the driver name as a run-time argument in this version. The driver to test must have the **active** flag defined in the driver section.
+===== Writing or Updating Tests =====
+  * Tests should be compliant with PHPunit version 9 and higher
+  * Tests should be compatible with all platforms supported by PHPunit
+  * Tests should be written to [[https://www.php-fig.org/psr/psr-12/|PSR 12]] standards when possible
+  * Wherever possible, write database agnostic tests. Only write driver specific tests when a feature is only supported by one or two DBMS
+  * Only add driver specific tests to the test file specifically labeled for that driver, e.g. //**MysqliDriverTest.php**//
+  * Do not add driver-based code branches inside the generic test code