class PluginBaseUnitTest

Tests code of the views plugin base class.

Hierarchy

Expanded class hierarchy of PluginBaseUnitTest

See also

\Drupal\views\Plugin\views\PluginBase.

File

drupal/core/modules/views/lib/Drupal/views/Tests/PluginBaseUnitTest.php, line 18
Contains \Drupal\views\Tests\PluginBaseUnitTest.

Namespace

Drupal\views\Tests
View source
class PluginBaseUnitTest extends DrupalUnitTestBase {
  public static function getInfo() {
    return array(
      'name' => 'Plugin base unit tests',
      'description' => 'Tests code of the views plugin base class.',
      'group' => 'Views Plugins',
    );
  }

  /**
   * Tests the unpackOptions method.
   *
   * @see \Drupal\views\Plugin\views\PluginBase::unpackOptions.
   */
  public function testUnpackOptions() {
    $plugin = $this
      ->getTestPlugin();
    $test_parameters = array();

    // Set a storage but no value, so the storage value should be kept.
    $test_parameters[] = array(
      'storage' => array(
        'key' => 'value',
      ),
      'options' => array(),
      'definition' => array(
        'key' => array(
          'default' => 'value2',
        ),
      ),
      'expected' => array(
        'key' => 'value',
      ),
    );

    // Set a storage and a option value, so the option value should be kept.
    $test_parameters[] = array(
      'storage' => array(
        'key' => 'value',
      ),
      'options' => array(
        'key' => 'value2',
      ),
      'definition' => array(
        'key' => array(
          'default' => 'value3',
        ),
      ),
      'expected' => array(
        'key' => 'value2',
      ),
      '',
    );

    // Set no storage but an options value, so the options value should be kept.
    $test_parameters[] = array(
      'options' => array(
        'key' => 'value',
      ),
      'definition' => array(
        'key' => array(
          'default' => 'value2',
        ),
      ),
      'expected' => array(
        'key' => 'value',
      ),
    );

    // Set additional options, which aren't part of the definition, so they
    // should be ignored if all is set.
    $test_parameters[] = array(
      'options' => array(
        'key' => 'value',
        'key2' => 'value2',
      ),
      'definition' => array(
        'key' => array(
          'default' => 'value2',
        ),
      ),
      'expected' => array(
        'key' => 'value',
      ),
    );
    $test_parameters[] = array(
      'options' => array(
        'key' => 'value',
        'key2' => 'value2',
      ),
      'definition' => array(
        'key' => array(
          'default' => 'value2',
        ),
      ),
      'expected' => array(
        'key' => 'value',
        'key2' => 'value2',
      ),
      'all' => TRUE,
    );

    // Provide multiple options with their corresponding definition.
    $test_parameters[] = array(
      'options' => array(
        'key' => 'value',
        'key2' => 'value2',
      ),
      'definition' => array(
        'key' => array(
          'default' => 'value2',
        ),
        'key2' => array(
          'default' => 'value3',
        ),
      ),
      'expected' => array(
        'key' => 'value',
        'key2' => 'value2',
      ),
    );

    // Set a complex definition structure with a zero and a one level structure.
    $test_parameters[] = array(
      'options' => array(
        'key0' => 'value',
        'key1' => array(
          'key1:1' => 'value1',
          'key1:2' => 'value2',
        ),
      ),
      'definition' => array(
        'key0' => array(
          'default' => 'value0',
        ),
        'key1' => array(
          'contains' => array(
            'key1:1' => array(
              'default' => 'value1:1',
            ),
          ),
        ),
      ),
      'expected' => array(
        'key0' => 'value',
        'key1' => array(
          'key1:1' => 'value1',
        ),
      ),
    );

    // Setup a two level structure.
    $test_parameters[] = array(
      'options' => array(
        'key2' => array(
          'key2:1' => array(
            'key2:1:1' => 'value0',
            'key2:1:2' => array(
              'key2:1:2:1' => 'value1',
            ),
          ),
        ),
      ),
      'definition' => array(
        'key2' => array(
          'contains' => array(
            'key2:1' => array(
              'contains' => array(
                'key2:1:1' => array(
                  'default' => 'value2:1:2:1',
                ),
                'key2:1:2' => array(
                  'contains' => array(
                    'key2:1:2:1' => array(
                      'default' => 'value2:1:2:1',
                    ),
                  ),
                ),
              ),
            ),
          ),
        ),
      ),
      'expected' => array(
        'key2' => array(
          'key2:1' => array(
            'key2:1:1' => 'value0',
            'key2:1:2' => array(
              'key2:1:2:1' => 'value1',
            ),
          ),
        ),
      ),
    );
    foreach ($test_parameters as $parameter) {
      $parameter += array(
        'storage' => array(),
      );
      $plugin
        ->unpackOptions($parameter['storage'], $parameter['options'], $parameter['definition'], !empty($parameter['all']));
      $this
        ->assertEqual($parameter['storage'], $parameter['expected']);
    }
  }

  /**
   * Tests the setOptionDefault method.
   *
   * @see \Drupal\views\Plugin\views\PluginBase::setOptionDefaults.
   */
  public function testSetOptionDefault() {
    $plugin = $this
      ->getTestPlugin();
    $test_parameters = array();

    // No definition mustn't change anything on the storage.
    $test_parameters[] = array(
      'definition' => array(),
      'expected' => array(),
    );

    // Set a single definition, which should be picked up.
    $test_parameters[] = array(
      'definition' => array(
        'key' => array(
          'default' => 'value',
        ),
      ),
      'expected' => array(
        'key' => 'value',
      ),
    );

    // Set multiple keys, all should be picked up.
    $test_parameters[] = array(
      'definition' => array(
        'key' => array(
          'default' => 'value',
        ),
        'key2' => array(
          'default' => 'value2',
        ),
        'key3' => array(
          'default' => 'value3',
        ),
      ),
      'expected' => array(
        'key' => 'value',
        'key2' => 'value2',
        'key3' => 'value3',
      ),
    );

    // Setup a definition with multiple levels.
    $test_parameters[] = array(
      'definition' => array(
        'key' => array(
          'default' => 'value',
        ),
        'key2' => array(
          'contains' => array(
            'key2:1' => array(
              'default' => 'value2:1',
            ),
            'key2:2' => array(
              'default' => 'value2:2',
            ),
          ),
        ),
      ),
      'expected' => array(
        'key' => 'value',
        'key2' => array(
          'key2:1' => 'value2:1',
          'key2:2' => 'value2:2',
        ),
      ),
    );
    foreach ($test_parameters as $parameter) {
      $parameter += array(
        'storage' => array(),
      );
      $plugin
        ->testSetOptionDefaults($parameter['storage'], $parameter['definition']);
      $this
        ->assertEqual($parameter['storage'], $parameter['expected']);
    }
  }

  /**
   * Sets up and returns a basic instance of a plugin.
   *
   * @return \Drupal\views\Tests\TestHelperPlugin
   *   A test plugin instance.
   */
  protected function getTestPlugin() {
    return new TestHelperPlugin(array(), 'default', array());
  }

}

Members

Namesort descending Modifiers Type Description Overrides
DrupalUnitTestBase::$keyValueFactory protected property A KeyValueMemoryFactory instance to use when building the container.
DrupalUnitTestBase::$moduleFiles private property
DrupalUnitTestBase::$modules public static property Modules to enable. 51
DrupalUnitTestBase::$themeData private property
DrupalUnitTestBase::$themeFiles private property
DrupalUnitTestBase::containerBuild public function Sets up the base service container for this test. 1
DrupalUnitTestBase::disableModules protected function Disables modules for this test.
DrupalUnitTestBase::enableModules protected function Enables modules for this test.
DrupalUnitTestBase::installConfig protected function Installs default configuration for a given list of modules.
DrupalUnitTestBase::installSchema protected function Installs a specific table from a module schema definition.
DrupalUnitTestBase::setUp protected function Sets up Drupal unit test environment. Overrides UnitTestBase::setUp 44
DrupalUnitTestBase::tearDown protected function Deletes created files, database tables, and reverts all environment changes. Overrides TestBase::tearDown 2
DrupalUnitTestBase::__construct function Overrides \Drupal\simpletest\UnitTestBase::__construct(). Overrides UnitTestBase::__construct
PluginBaseUnitTest::getInfo public static function
PluginBaseUnitTest::getTestPlugin protected function Sets up and returns a basic instance of a plugin.
PluginBaseUnitTest::testSetOptionDefault public function Tests the setOptionDefault method.
PluginBaseUnitTest::testUnpackOptions public function Tests the unpackOptions method.
TestBase::$assertions protected property Assertions thrown in that test case.
TestBase::$configImporter protected property The config importer that can used in a test. 1
TestBase::$container protected property The dependency injection container used in the test. 1
TestBase::$databasePrefix protected property The database prefix of this test run.
TestBase::$dieOnFail public property Whether to die in case any test assertion fails.
TestBase::$originalFileDirectory protected property The original file directory, before it was changed for testing purposes.
TestBase::$originalPrefix protected property The original database prefix when running inside Simpletest.
TestBase::$originalSettings protected property The settings array.
TestBase::$public_files_directory protected property The public file directory for the test environment.
TestBase::$results public property Current results of this test case.
TestBase::$setup protected property Flag to indicate whether the test has been set up.
TestBase::$setupDatabasePrefix protected property
TestBase::$setupEnvironment protected property
TestBase::$skipClasses protected property This class is skipped when looking for the source of an assertion.
TestBase::$testId protected property The test run ID.
TestBase::$timeLimit protected property Time limit for the test.
TestBase::$verbose protected property TRUE if verbose debugging is enabled.
TestBase::$verboseClassName protected property Safe class name for use in verbose output filenames.
TestBase::$verboseDirectory protected property Directory where verbose output files are put.
TestBase::$verboseDirectoryUrl protected property URL to the verbose output file directory.
TestBase::$verboseId protected property Incrementing identifier for verbose output filenames.
TestBase::assert protected function Internal helper: stores the assert.
TestBase::assertEqual protected function Check to see if two values are equal.
TestBase::assertFalse protected function Check to see if a value is false (an empty string, 0, NULL, or FALSE).
TestBase::assertIdentical protected function Check to see if two values are identical.
TestBase::assertIdenticalObject protected function Checks to see if two objects are identical.
TestBase::assertNotEqual protected function Check to see if two values are not equal.
TestBase::assertNotIdentical protected function Check to see if two values are not identical.
TestBase::assertNotNull protected function Check to see if a value is not NULL.
TestBase::assertNull protected function Check to see if a value is NULL.
TestBase::assertTrue protected function Check to see if a value is not false (not an empty string, 0, NULL, or FALSE).
TestBase::changeDatabasePrefix protected function Changes the database connection to the prefixed one.
TestBase::checkRequirements protected function Checks the matching requirements for Test. 4
TestBase::configImporter public function Returns a ConfigImporter object to import test importing of configuration. 1
TestBase::copyConfig public function Copies configuration objects from source storage to target storage.
TestBase::deleteAssert public static function Delete an assertion record by message ID.
TestBase::error protected function Fire an error assertion. 1
TestBase::errorHandler public function Handle errors during test runs.
TestBase::exceptionHandler protected function Handle exceptions.
TestBase::fail protected function Fire an assertion that is always negative.
TestBase::filePreDeleteCallback public static function Ensures test files are deletable within file_unmanaged_delete_recursive().
TestBase::generatePermutations public static function Converts a list of possible parameters into a stack of permutations.
TestBase::getAssertionCall protected function Cycles through backtrace until the first non-assertion method is found.
TestBase::getDatabaseConnection public static function Returns the database connection to the site running Simpletest.
TestBase::insertAssert public static function Store an assertion from outside the testing context.
TestBase::pass protected function Fire an assertion that is always positive.
TestBase::prepareConfigDirectories protected function Create and set new configuration directories. 1
TestBase::prepareDatabasePrefix protected function Generates a database prefix for running tests.
TestBase::prepareEnvironment protected function Prepares the current environment for running the test.
TestBase::randomName public static function Generates a random string containing letters and numbers.
TestBase::randomObject public static function Generates a random PHP object.
TestBase::randomString public static function Generates a random string of ASCII characters of codes 32 to 126.
TestBase::rebuildContainer protected function Rebuild drupal_container(). 1
TestBase::run public function Run all tests in this class.
TestBase::settingsSet protected function Changes in memory settings.
TestBase::verbose protected function Logs verbose message in a text file.
UnitTestBase::$configDirectories protected property