annotate core/tests/Drupal/Tests/Component/Version/ConstraintTest.php @ 19:fa3358dc1485 tip

Add ndrum files

<?php

namespace Drupal\Tests\Component\Version;

use Drupal\Component\Version\Constraint;
use PHPUnit\Framework\TestCase;

/**
 * @coversDefaultClass \Drupal\Component\Version\Constraint
 * @group Version
 */
class ConstraintTest extends TestCase {

  /**
   * @covers ::isCompatible
   * @dataProvider providerIsCompatible
   */
  public function testIsCompatible(Constraint $version_info, $current_version, $result) {
    $this->assertSame($result, $version_info->isCompatible($current_version));
  }

  /**
   * Provider for testIsCompatible.
   */
  public function providerIsCompatible() {
    $tests = [];

    $tests['no-dependencies'] = [new Constraint('', '8.x'), '8.1.x', TRUE];

    // Stable version.
    $stable = new Constraint('8.x-1.0', '8.x');
    $tests['(=8.x-1.0)-1.0'] = [$stable, '1.0', TRUE];
    $tests['(=8.x-1.0)-1.1'] = [$stable, '1.1', FALSE];
    $tests['(=8.x-1.0)-0.9'] = [$stable, '0.9', FALSE];

    // Alpha version.
    $alpha = new Constraint('8.x-1.1-alpha12', '8.x');
    $tests['(8.x-1.1-alpha12)-alpha12'] = [$alpha, '1.1-alpha12', TRUE];
    $tests['(8.x-1.1-alpha12)-alpha10'] = [$alpha, '1.1-alpha10', FALSE];
    $tests['(8.x-1.1-alpha12)-beta1'] = [$alpha, '1.1-beta1', FALSE];

    // Beta version.
    $beta = new Constraint('8.x-1.1-beta8', '8.x');
    $tests['(8.x-1.1-beta8)-beta8'] = [$beta, '1.1-beta8', TRUE];
    $tests['(8.x-1.1-beta8)-beta4'] = [$beta, '1.1-beta4', FALSE];

    // RC version.
    $rc = new Constraint('8.x-1.1-rc11', '8.x');
    $tests['(8.x-1.1-rc11)-rc11'] = [$rc, '1.1-rc11', TRUE];
    $tests['(8.x-1.1-rc11)-rc2'] = [$rc, '1.1-rc2', FALSE];

    // Test greater than.
    $greater = new Constraint('>8.x-1.x', '8.x');
    $tests['(>8.x-1.x)-2.0'] = [$greater, '2.0', TRUE];
    $tests['(>8.x-1.x)-1.1'] = [$greater, '1.1', FALSE];
    $tests['(>8.x-1.x)-0.9'] = [$greater, '0.9', FALSE];

    // Test greater than or equal.
    $greater_or_equal = new Constraint('>=8.x-1.0', '8.x');
    $tests['(>=8.x-1.0)-1.1'] = [$greater_or_equal, '1.1', TRUE];
    $tests['(>=8.x-1.0)-1.0'] = [$greater_or_equal, '1.0', TRUE];
    $tests['(>=8.x-1.1)-1.0'] = [new Constraint('>=8.x-1.1', '8.x'), '1.0', FALSE];

    // Test less than.
    $less = new Constraint('<8.x-1.1', '8.x');
    $tests['(<8.x-1.1)-1.1'] = [$less, '1.1', FALSE];
    $tests['(<8.x-1.1)-1.1'] = [$less, '1.0', TRUE];
    $tests['(<8.x-1.0)-1.0'] = [new Constraint('<8.x-1.0', '8.x'), '1.1', FALSE];

    // Test less than or equal.
    $less_or_equal = new Constraint('<= 8.x-1.x', '8.x');
    $tests['(<= 8.x-1.x)-2.0'] = [$less_or_equal, '2.0', FALSE];
    $tests['(<= 8.x-1.x)-1.9'] = [$less_or_equal, '1.9', TRUE];
    $tests['(<= 8.x-1.x)-1.1'] = [$less_or_equal, '1.1', TRUE];
    $tests['(<= 8.x-1.x)-0.9'] = [$less_or_equal, '0.9', TRUE];

    // Test greater than and less than.
    $less_and_greater = new Constraint('<8.x-4.x,>8.x-1.x', '8.x');
    $tests['(<8.x-4.x,>8.x-1.x)-4.0'] = [$less_and_greater, '4.0', FALSE];
    $tests['(<8.x-4.x,>8.x-1.x)-3.9'] = [$less_and_greater, '3.9', TRUE];
    $tests['(<8.x-4.x,>8.x-1.x)-2.1'] = [$less_and_greater, '2.1', TRUE];
    $tests['(<8.x-4.x,>8.x-1.x)-1.9'] = [$less_and_greater, '1.9', FALSE];

    // Test a nonsensical greater than and less than - no compatible versions.
    $less_and_greater = new Constraint('>8.x-4.x,<8.x-1.x', '8.x');
    $tests['(<8.x-4.x,>8.x-1.x)-4.0'] = [$less_and_greater, '4.0', FALSE];
    $tests['(<8.x-4.x,>8.x-1.x)-3.9'] = [$less_and_greater, '3.9', FALSE];
    $tests['(<8.x-4.x,>8.x-1.x)-2.1'] = [$less_and_greater, '2.1', FALSE];
    $tests['(<8.x-4.x,>8.x-1.x)-1.9'] = [$less_and_greater, '1.9', FALSE];

    return $tests;
  }

  /**
   * @covers ::toArray
   * @group legacy
   * @expectedDeprecation Drupal\Component\Version\Constraint::toArray() only exists to provide a backwards compatibility layer. See https://www.drupal.org/node/2756875
   */
  public function testToArray() {
    $constraint = new Constraint('<8.x-4.x,>8.x-1.x', '8.x');
    $this->assertSame([
      ['op' => '<', 'version' => '4.x'],
      ['op' => '>', 'version' => '2.x'],
    ], $constraint->toArray());
  }

}