Add sorting and keying helpers to VersionData

Author: markrandall

src/Releases/VersionData.php

@@ -10,6 +10,7 @@
 use function array_key_last;
 use function array_reverse;
 use function get_active_branches;
+use function usort;
 use function version_compare;
 
 /* have to force these files to be included */
@@ -52,6 +53,36 @@ public static function Create(string $label): VersionData
         return self::$_cache[$label] ?? new VersionData($label);
     }
 
+    /**
+     * @param VersionData[] $releases
+     * @return array<string, VersionData>
+     */
+    public static function sort(array $releases, string $dir = 'asc'): array
+    {
+        if ($dir === 'asc') {
+            usort($releases, fn (VersionData $a, VersionData $b) => version_compare($a->label, $b->label));
+        } else {
+            usort($releases, fn (VersionData $a, VersionData $b) => version_compare($b->label, $a->label));
+        }
+
+        return $releases;
+    }
+
+
+    /**
+     * @param VersionData[] $releases
+     * @return array<string, VersionData>
+     */
+    public static function rekey(array $releases): array
+    {
+        $out = [];
+        foreach ($releases as $release) {
+            $out[$release->label] = $release;
+        }
+
+        return $out;
+    }
+
     /**
      * Returns an associative array of the latest versions of PHP
      *