D8FTW: Unit testing for realsies

Code testing: It's like exercise. It's good for you, but most people really don't want to do it. Unless you develop a habit for it and feel the benefit, most people will try to avoid it. And if it's too hard to do it becomes easy to avoid.

That's really unfortunate, as good testing can have a huge improvement on the quality of a system and, over time, even improve how fast a system can be developed because you spend less time finding and fighting old bugs and more time building things right the first time.

Drupal 7 introduced testing to the Drupal world for the first time, but not really unit testing. Unit testing, specifically, is testing one "unit" of a larger system in isolation. If you can verify that one unit works as designed you can confirm that it doesn't have a bug and move on to finding bugs elsewhere. If your tests are automated, you can get notified that you have a bug early, before you even commit code.

The problem with Drupal 7 is that it doesn't really have units. Drupal's historically procedural codebase has made isolating specific portions of code to test extremely difficult, meaning that to test one small bit of functionality we've needed to automate installing the entirety of Drupal, create for-reals content, test that a button works, and then tear the whole thing down again. That is horribly inefficient as well as quite challenging to do at times, especially given the poor home-grown testing framework Drupal 7 ships with. As a result, many many developers simply don't bother. It's too hard, so it's easier to avoid.

Now fast forward to Drupal 8 and we find the situation has changed:

That historically procedural codebase is now largely object-oriented, which means every class forms a natural "unit" candidate. (Class and "testable unit" are not always synonymous, but it's a good approximation.)
Because most of those classes leverage their constructors properly to pass in dependencies rather than calling out to them we can easily change what objects are passed for testing purposes.
In addition to Simpletest, Drupal now includes the PHP-industry standard PHPUnit testing framework.

All of that adds up to the ability to write automated tests for Drupal in less time, that run faster, are more effective, and are, in short, actually worth doing.

Smallest testable unit

Let's try and test the custom breadcrumb builder we wrote back in episode 1 (The Phantom Service). Here it is again, for reference:

<?php // newsbreadcrumb/src/NewsBreadcrumbBuilder.php namespace Drupal\newsbreadcrumb; use Drupal\Core\Breadcrumb\BreadcrumbBuilderBase;class NewsBreadcrumbBuilder extends BreadcrumbBuilderBase {   /**    * {@inheritdoc}    */   public function applies(array $attributes) {     if ($attributes['_route'] == 'node_page') {       return $attributes['node']->bundle() == 'news';     }   }  /**    * {@inheritdoc}    */   public function build(array $attributes) {     $breadcrumb[] = $this->l($this->t('Home'), NULL);     $breadcrumb[] = $this->l($this->t('News'), 'news');    return $breadcrumb;   } } ?>

We want to test that the logic in this class works as expected but without testing the entirety of Drupal, or even the entirety of the breadcrumb system if we can avoid it. We just want to test this code. Can we? With good OOP design and PHPUnit, we can!

First, let's create a new testing class in our newsbreadcrumb module. This class does not go in the same directory as our code itself. Instead, it goes in a separate "tests" directory but follows the same file/name pattern.

<?php // newsbreadcrumb/tests/src/NewsBreadcrumbBuilderTest.php namespace Drupal\newsbreadcrumb\Tests;use Drupal\Tests\UnitTestCase;use Drupal\newsbreadcrumb\NewsBreadcrumbBuilder;/** * Tests the News breadcrumb builder. */ class NewsBreadcrumbBuilderTest extends UnitTestCase {  public static function getInfo() {     return array(       'name' => 'News breadcrumb tests',       'description' => 'Tests the news breadcrumbs',       'group' => 'News breadcrumb',     );   }} ?>

It should look fairly familiar for anyone who's written a Drupal 7 test. The main difference is that we're extending UnitTestCase, which is a very thin extension of PHPUnit's main base class for tests. Now we can define some test methods. As in Drupal 7, a test method is one that begins with test. Rather than assume we have a complete Drupal install and making actual HTTP calls against it, though, we'll just test our class directly.

<?php   public function testApplicablePage() {     $node_stub = $this->getMockBuilder('\Drupal\node\Entity\Node')       ->disableOriginalConstructor()       ->getMock();     $node_stub->expects($this->once())       ->method('bundle')       ->will($this->returnValue('news'));    $attributes = [       'node' => $node_stub,       '_route' => 'node_page',     ];    $builder = new NewsBreadcrumbBuilder();

Original Article:

D8FTW: Unit testing for realsies