annotate vendor/composer/semver/src/Semver.php @ 19:fa3358dc1485 tip

Add ndrum files
author Chris Cannam
date Wed, 28 Aug 2019 13:14:47 +0100
parents 4c8ae668cc8c
children
rev   line source
Chris@0 1 <?php
Chris@0 2
Chris@0 3 /*
Chris@0 4 * This file is part of composer/semver.
Chris@0 5 *
Chris@0 6 * (c) Composer <https://github.com/composer>
Chris@0 7 *
Chris@0 8 * For the full copyright and license information, please view
Chris@0 9 * the LICENSE file that was distributed with this source code.
Chris@0 10 */
Chris@0 11
Chris@0 12 namespace Composer\Semver;
Chris@0 13
Chris@0 14 use Composer\Semver\Constraint\Constraint;
Chris@0 15
Chris@0 16 class Semver
Chris@0 17 {
Chris@0 18 const SORT_ASC = 1;
Chris@0 19 const SORT_DESC = -1;
Chris@0 20
Chris@0 21 /** @var VersionParser */
Chris@0 22 private static $versionParser;
Chris@0 23
Chris@0 24 /**
Chris@0 25 * Determine if given version satisfies given constraints.
Chris@0 26 *
Chris@0 27 * @param string $version
Chris@0 28 * @param string $constraints
Chris@0 29 *
Chris@0 30 * @return bool
Chris@0 31 */
Chris@0 32 public static function satisfies($version, $constraints)
Chris@0 33 {
Chris@0 34 if (null === self::$versionParser) {
Chris@0 35 self::$versionParser = new VersionParser();
Chris@0 36 }
Chris@0 37
Chris@0 38 $versionParser = self::$versionParser;
Chris@0 39 $provider = new Constraint('==', $versionParser->normalize($version));
Chris@0 40 $constraints = $versionParser->parseConstraints($constraints);
Chris@0 41
Chris@0 42 return $constraints->matches($provider);
Chris@0 43 }
Chris@0 44
Chris@0 45 /**
Chris@0 46 * Return all versions that satisfy given constraints.
Chris@0 47 *
Chris@0 48 * @param array $versions
Chris@0 49 * @param string $constraints
Chris@0 50 *
Chris@0 51 * @return array
Chris@0 52 */
Chris@0 53 public static function satisfiedBy(array $versions, $constraints)
Chris@0 54 {
Chris@0 55 $versions = array_filter($versions, function ($version) use ($constraints) {
Chris@0 56 return Semver::satisfies($version, $constraints);
Chris@0 57 });
Chris@0 58
Chris@0 59 return array_values($versions);
Chris@0 60 }
Chris@0 61
Chris@0 62 /**
Chris@0 63 * Sort given array of versions.
Chris@0 64 *
Chris@0 65 * @param array $versions
Chris@0 66 *
Chris@0 67 * @return array
Chris@0 68 */
Chris@0 69 public static function sort(array $versions)
Chris@0 70 {
Chris@0 71 return self::usort($versions, self::SORT_ASC);
Chris@0 72 }
Chris@0 73
Chris@0 74 /**
Chris@0 75 * Sort given array of versions in reverse.
Chris@0 76 *
Chris@0 77 * @param array $versions
Chris@0 78 *
Chris@0 79 * @return array
Chris@0 80 */
Chris@0 81 public static function rsort(array $versions)
Chris@0 82 {
Chris@0 83 return self::usort($versions, self::SORT_DESC);
Chris@0 84 }
Chris@0 85
Chris@0 86 /**
Chris@0 87 * @param array $versions
Chris@0 88 * @param int $direction
Chris@0 89 *
Chris@0 90 * @return array
Chris@0 91 */
Chris@0 92 private static function usort(array $versions, $direction)
Chris@0 93 {
Chris@0 94 if (null === self::$versionParser) {
Chris@0 95 self::$versionParser = new VersionParser();
Chris@0 96 }
Chris@0 97
Chris@0 98 $versionParser = self::$versionParser;
Chris@0 99 $normalized = array();
Chris@0 100
Chris@0 101 // Normalize outside of usort() scope for minor performance increase.
Chris@0 102 // Creates an array of arrays: [[normalized, key], ...]
Chris@0 103 foreach ($versions as $key => $version) {
Chris@0 104 $normalized[] = array($versionParser->normalize($version), $key);
Chris@0 105 }
Chris@0 106
Chris@0 107 usort($normalized, function (array $left, array $right) use ($direction) {
Chris@0 108 if ($left[0] === $right[0]) {
Chris@0 109 return 0;
Chris@0 110 }
Chris@0 111
Chris@0 112 if (Comparator::lessThan($left[0], $right[0])) {
Chris@0 113 return -$direction;
Chris@0 114 }
Chris@0 115
Chris@0 116 return $direction;
Chris@0 117 });
Chris@0 118
Chris@0 119 // Recreate input array, using the original indexes which are now in sorted order.
Chris@0 120 $sorted = array();
Chris@0 121 foreach ($normalized as $item) {
Chris@0 122 $sorted[] = $versions[$item[1]];
Chris@0 123 }
Chris@0 124
Chris@0 125 return $sorted;
Chris@0 126 }
Chris@0 127 }