function SemVer::minimizeConstraints

Minimizes two constraints.

Compares two constraints and determines if one is a subset of the other. If this is the case, the constraint that is a subset is returned. For example, if called with '^6.2' and '^6.3' the function will return '^6.3'. If neither constraint is a subset then the constraints are compacted and the intersection is returned. For example, if called with ">=10.3" and "^10.4 || ^11" the function will return ">=10.4.0.0-dev, <12.0.0.0-dev".

Parameters

\Composer\Semver\VersionParser $version_parser: A version parser.

string $constraint_a: A constraint to compact.

string $constraint_b: A constraint to compact.

Return value

string The compacted constraint.

Throws

\LogicException Thrown when the provided constraints have no intersection.

4 calls to SemVer::minimizeConstraints()
SemVerTest::testMinimizeConstraints in core/tests/Drupal/Tests/Composer/Plugin/Unpack/SemVerTest.php
@testWith ["^6.1", "^6.3", "^6.3"][[api-linebreak]] ["*", "^6.3", "^6.3"][[api-linebreak]] ["^6@dev", "^6.3", "^6.3"][[api-linebreak]]
SemVerTest::testMinimizeConstraintsWhichAreNotSubsets in core/tests/Drupal/Tests/Composer/Plugin/Unpack/SemVerTest.php
@testWith ["^6.1 || ^4.0", "^6.3 || ^7.4", ">=6.3.0.0-dev, <7.0.0.0-dev"][[api-linebreak]]
SemVerTest::testMinimizeConstraintsWhichDoNotIntersect in core/tests/Drupal/Tests/Composer/Plugin/Unpack/SemVerTest.php
@testWith ["^6.1", "^5.1", ">=6.3.0.0-dev, <7.0.0.0-dev"][[api-linebreak]]
Unpacker::updateComposerJsonPackages in composer/Plugin/RecipeUnpack/Unpacker.php
Updates the composer.json content with the package being unpacked.

File

composer/Plugin/RecipeUnpack/SemVer.php, line 42

Class

SemVer
Helper class to manipulate semantic versioning constraints.

Namespace

Drupal\Composer\Plugin\RecipeUnpack

Code

public static function minimizeConstraints(VersionParser $version_parser, string $constraint_a, string $constraint_b) : string {
  $constraint_object_a = $version_parser->parseConstraints($constraint_a);
  $constraint_object_b = $version_parser->parseConstraints($constraint_b);
  if (Intervals::isSubsetOf($constraint_object_a, $constraint_object_b)) {
    return $constraint_a;
  }
  if (Intervals::isSubsetOf($constraint_object_b, $constraint_object_a)) {
    return $constraint_b;
  }
  $constraint = Intervals::compactConstraint(new MultiConstraint([
    $constraint_object_a,
    $constraint_object_b,
  ]));
  if ($constraint instanceof MatchNoneConstraint) {
    throw new \LogicException(sprintf('The constraints "%s" and "%s" do not intersect and cannot be minimized.', $constraint_a, $constraint_b));
  }
  return sprintf('%s%s, %s%s', $constraint->getLowerBound()
    ->isInclusive() ? '>=' : '>', $constraint->getLowerBound()
    ->getVersion(), $constraint->getUpperBound()
    ->isInclusive() ? '<=' : '<', $constraint->getUpperBound()
    ->getVersion());
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.