function UpdateSemverContribTestBase::testUpdatesLegacyToSemver

Tests updates from legacy versions to the semver versions.

File

core/modules/update/tests/src/Functional/UpdateSemverContribTestBase.php, line 58

Class

UpdateSemverContribTestBase

Base class for Update manager semantic versioning tests of contrib projects.

Namespace

Code

public function testUpdatesLegacyToSemver() : void {
  // Test cases where the legacy branch is in the XML 'supported_branches' and
  // when it is not.
  foreach ([
    TRUE,
    FALSE,
  ] as $legacy_supported) {
    // Test 2 legacy majors.
    foreach ([
      7,
      8,
    ] as $legacy_major) {
      $semver_major = $legacy_major + 1;
      $installed_versions = [
        "8.x-{$legacy_major}.0-alpha1",
        "8.x-{$legacy_major}.0-beta1",
        "8.x-{$legacy_major}.0",
        "8.x-{$legacy_major}.1-alpha1",
        "8.x-{$legacy_major}.1-beta1",
        "8.x-{$legacy_major}.1",
      ];
      foreach ($installed_versions as $installed_version) {
        $this->setProjectInstalledVersion($installed_version);
        if ($legacy_supported) {
          $fixture = $legacy_major === 7 ? '8.1.0' : '9.1.0';
        }
        else {
          if ($legacy_major === 8) {
            continue;
          }
          $fixture = '8.1.0-legacy-unsupported';
        }
        $this->refreshUpdateStatus([
          $this->updateProject => $fixture,
        ]);
        $this->assertUpdateTableTextNotContains('Security update required!');
        $this->assertSession()
          ->elementTextContains('css', $this->updateTableLocator . " .project-update__title", $installed_version);
        if ($legacy_supported) {
          // All installed versions should indicate that there is an update
          // available for the next major version of the module.
          // '$legacy_major.1.0' is shown for the next major version because
          // it is the latest full release for that major.
          // @todo Determine if both 8.0.0 and 8.0.1 should be expected as
          // "Also available" releases in
          // https://www.drupal.org/project/node/3100115.
          $this->assertVersionUpdateLinks('Also available:', "{$semver_major}.1.0");
          if ($installed_version === "8.x-{$legacy_major}.1") {
            $this->assertUpdateTableTextContains('Up to date');
            $this->assertUpdateTableTextNotContains('Update available');
          }
          else {
            $this->assertUpdateTableTextNotContains('Up to date');
            $this->assertUpdateTableTextContains('Update available');
            // All installed versions besides 8.x-$legacy_major.1 should
            // recommend 8.x-$legacy_major.1 because it is the latest full
            // release for the major.
            $this->assertVersionUpdateLinks('Recommended version:', "8.x-{$legacy_major}.1");
          }
        }
        else {
          // If '8.x-7.' is not in the XML 'supported_branches' value then the
          // latest release for the next major should always be recommended.
          $this->assertVersionUpdateLinks('Recommended version:', "{$semver_major}.1.0");
        }
      }
    }
  }
}