>>> [!note] Migrated issue <!-- Drupal.org comment --> <!-- Migrated from issue #237959. --> Reported by: [boombatower](https://www.drupal.org/user/214218) >>> <p>Since the general cleanup of SimpleTest is just about finished I figured we could discuss the new task of unit testing. We still need the functional tests completed and go through and clean-up old tests, but the API changes and coding standards are just about done.</p> <p>I will layout what my current understand of the plan from conversations on IRC so that we can formal document the discussion and ensure that everyone is on the same page.</p> <!--break--><p> <b>Class Scope</b><br> There will be one class (test case) per file and one file per core file. This will provide a simple convention that makes sense for unit testing.</p> <p>Example:</p> <pre>block.admin.inc -&gt; block.admin.inc.test<br>block.module&nbsp;&nbsp;&nbsp; -&gt; block.module.test</pre><p>The classes will then be named in a similar fashion.</p> <pre>block.admin.inc -&gt; BlockAdminIncTestCase<br>block.module&nbsp;&nbsp;&nbsp; -&gt; BlockModuleTestCase</pre><p><b>Grouping</b><br> With the large number of unit tests a <a href="http://drupal.org/node/234409">better way of grouping tests</a> needs to be created.</p> <p><b>Function Names</b><br> Each test method should be related to the function it tests in a 1-to-1 relationship.</p> <p>Example:</p> <pre>db_query&nbsp; -&gt; test_db_query<br>_db_query -&gt; test__db_query&nbsp;&nbsp;&nbsp; &lt;- double underscore</pre><p><b>Implementation</b><br> To perform unit testing each function needs to be isolated from all other functions. To do this all "sub calls" to other drupal functions need be located and each drupal function needs to be overridden to return a static value. The current plan is to use runkit.</p> <p>There are several things that need to be figured in out for this to work.</p> <ul> <li>At what scope should functions be overridden? - Globally, per file, per function, or use a default and deviate where necessary?</li> <li>If functions are not overridden globally should they be reset after the current scope exits?</li> <li>How should functions be overridden? Using <code>runkit_function_[add|redefine]</code>? Or define the function in the file and use <code>runkit_function_rename</code>?</li> <li>If functions are overridden per test function how can we use <code>runkit_function_rename</code> since they will conflict when defined?</li> </ul> <p><b>Automation</b><br> I have <a href="http://drupal.org/project/simpletest_unit">created a module</a> that automates the majority of the above mentioned that is possible to automate. I will update it once a convention has been decided on. I will then generate all the test cases and commit them. This will provide a consistent base for tests to be filled in.</p> <p><b>References</b></p> <ul> <li>SimpleTest Coding Standards - <a href="http://drupal.org/node/234405">http://drupal.org/node/234405</a></li> <li>SimpleTest Group Convention - <a href="http://drupal.org/node/234409">http://drupal.org/node/234409</a></li> <li>PHP runkit - <a href="http://us.php.net/manual/en/ref.runkit.php">http://us.php.net/manual/en/ref.runkit.php</a></li> <li>SimpleTest Unit Testing - <a href="http://drupal.org/project/simpletest_unit">http://drupal.org/project/simpletest_unit</a></li> </ul>