Support inexact (prefix-based) version specifications

Author: oprypin

.github/workflows/main.yml

@@ -20,11 +20,14 @@ jobs:
           - {shards: false}
           - {shards: true}
           - {shards: '0.12.0', crystal: '0.35.1'}
+          - {shards: '0.14', crystal: '1.2'}
           - {shards: latest, crystal: latest}
           - {shards: nightly, crystal: nightly}
         exclude:
           - os: windows-latest
             config: {shards: '0.12.0', crystal: '0.35.1'}
+          - os: windows-latest
+            config: {shards: '0.14', crystal: '1.2'}
           - os: windows-latest
             config: {shards: latest, crystal: latest}
 
@@ -51,11 +54,11 @@ jobs:
           ls '${{ steps.install.outputs.path }}/src/prelude.cr'
       - run: |
           v='${{ steps.install.outputs.crystal }}'
-          crystal --version | grep "${v:0:9}"
+          crystal --version | grep "${v:0:9}\\b"
         if: ${{ runner.os != 'Windows' }}
       - run: |
           v='${{ matrix.config.crystal }}'
-          crystal --version | grep "$v"
+          crystal --version | grep -E "${v}\\b"
         if: ${{ contains(matrix.config.crystal, '.') }}
       - run: |
           crystal eval 'require "yaml"; require "xml"; require "big"; require "openssl"'
@@ -66,11 +69,11 @@ jobs:
       - run: |
           v='${{ steps.install.outputs.shards }}'
           v="${v#v}"
-          shards --version | grep "${v:0:9}"
+          shards --version | grep -E "${v:0:9}\\b"
         if: ${{ !contains('true|false|nightly', matrix.config.shards) }}
       - run: |
           v='${{ matrix.config.shards }}'
-          shards --version | grep "$v"
+          shards --version | grep -E "${v}\\b"
         if: ${{ contains(matrix.config.shards, '.') }}
       - run: |
           ! shards --version

.github/workflows/release.yml

@@ -20,11 +20,14 @@ jobs:
           - {shards: false}
           - {shards: true}
           - {shards: '0.12.0', crystal: '0.35.1'}
+          - {shards: '0.14', crystal: '1.2'}
           - {shards: latest, crystal: latest}
           - {shards: nightly, crystal: nightly}
         exclude:
           - os: windows-latest
             config: {shards: '0.12.0', crystal: '0.35.1'}
+          - os: windows-latest
+            config: {shards: '0.14', crystal: '1.2'}
           - os: windows-latest
             config: {shards: latest, crystal: latest}
 
@@ -51,11 +54,11 @@ jobs:
           ls '${{ steps.install.outputs.path }}/src/prelude.cr'
       - run: |
           v='${{ steps.install.outputs.crystal }}'
-          crystal --version | grep "${v:0:9}"
+          crystal --version | grep "${v:0:9}\\b"
         if: ${{ runner.os != 'Windows' }}
       - run: |
           v='${{ matrix.config.crystal }}'
-          crystal --version | grep "$v"
+          crystal --version | grep -E "${v}\\b"
         if: ${{ contains(matrix.config.crystal, '.') }}
       - run: |
           crystal eval 'require "yaml"; require "xml"; require "big"; require "openssl"'
@@ -66,11 +69,11 @@ jobs:
       - run: |
           v='${{ steps.install.outputs.shards }}'
           v="${v#v}"
-          shards --version | grep "${v:0:9}"
+          shards --version | grep -E "${v:0:9}\\b"
         if: ${{ !contains('true|false|nightly', matrix.config.shards) }}
       - run: |
           v='${{ matrix.config.shards }}'
-          shards --version | grep "$v"
+          shards --version | grep -E "${v}\\b"
         if: ${{ contains(matrix.config.shards, '.') }}
       - run: |
           ! shards --version

README.md

@@ -22,7 +22,7 @@ steps:
   - uses: actions/checkout@v2
   - uses: crystal-lang/install-crystal@v1
     with:
-      crystal: 0.35.1
+      crystal: 1.2
   - run: shards install
   - run: crystal spec
 ```
@@ -56,9 +56,9 @@ Alternatively, you can use the container-based approach [as in the starter workf
 
 ### Inputs
 
- *   *  **`crystal: 0.35.1`** (not supported on Windows)
+ *   *  **`crystal: 1.1.0`**, **`crystal: 1.2`** (not supported on Windows)
 
-        Install a particular release of Crystal.
+        Install a particular release of Crystal (if the full version is specified), or the latest patch version of a release series.
 
      *  **`crystal: latest`** (default; not supported on Windows)
 
@@ -81,9 +81,9 @@ Alternatively, you can use the container-based approach [as in the starter workf
 
         Build and install the latest released version of Shards.
 
-     *  **`shards: 0.13.0`**
+     *  **`shards: 0.14.0`**, **`shards: 0.16`**
 
-        Build and install a particular release of Shards.
+        Build and install a particular release of Shards (if the full version is specified), or the latest patch version of a release series.
 
      *  **`shards: nightly`**
 

docs/configurator.md

@@ -56,7 +56,7 @@ jobs:
           - os: ubuntu-latest
           {%- if crystal_ver %}
           - os: ubuntu-latest
-            crystal: 1.0.0
+            crystal: 1.2
           {%- endif %}
           {%- if crystal_nightly %}
           - os: ubuntu-latest
@@ -73,7 +73,7 @@ jobs:
         os: [ubuntu-latest{% if os_mac %}, macos-latest{% endif %}{% if os_win %}, windows-latest{% endif %}]
         {%- endif %}
         {%- if crystal_nightly or crystal_ver %}
-        crystal: [{% if crystal_ver %}1.0.0, {% endif %}latest{% if crystal_nightly %}, nightly{% endif %}]
+        crystal: [{% if crystal_ver %}1.2, {% endif %}latest{% if crystal_nightly %}, nightly{% endif %}]
         {%- endif %}
         {%- endif %}
     {%- endif %}

index.js

@@ -87,7 +87,7 @@ const Latest = "latest";
 const Nightly = "nightly";
 const Any = "true";
 const None = "false";
-const NumericVersion = /^\d[.\d]+\d$/;
+const NumericVersion = /^\d([.\d]*\d)?$/;
 
 function checkVersion(version, allowed) {
     const numericVersion = NumericVersion.test(version) && version;
@@ -272,15 +272,45 @@ const RepoShards = {owner: "crystal-lang", repo: "shards"};
 const CircleApiBase = "https://circleci.com/api/v1.1/project/github/crystal-lang/crystal";
 
 async function findRelease({name, repo, tag}) {
-    Core.info(`Looking for ${name} release (${tag || "latest"})`);
-    const releasesResp = await (tag
-        ? github.rest.repos.getReleaseByTag({...repo, tag})
-        : github.rest.repos.getLatestRelease(repo));
+    if (!(/^\d+\.\d+\.\d\w*$/.test(tag))) {
+        tag = await getLatestTag({repo, prefix: tag});
+    }
+    Core.info(`Getting ${name} release (${tag})`);
+    const releasesResp = await github.rest.repos.getReleaseByTag({...repo, tag});
     const release = releasesResp.data;
     Core.info(`Found ${name} release ${release["html_url"]}`);
     return release;
 }
 
+async function getLatestTag({repo, prefix}) {
+    Core.info(`Looking for ${repo.owner}/${repo.owner} release (${prefix || "latest"})`);
+    const pages = github.repos.listReleases.endpoint.merge({
+        ...repo, "per_page": 50,
+    });
+
+    const tags = [];
+    let assurance = 25;
+    for await (const item of getItemsFromPages(pages)) {
+        const tag = item["tag_name"];
+        if (!prefix || tag === prefix || tag.startsWith(prefix + ".")) {
+            tags.push(tag);
+        }
+        if (tags.length) {
+            if (--assurance <= 0) {
+                break;
+            }
+        }
+    }
+    if (tags.length === 0) {
+        let error = `The repository "${repo.owner}/${repo.repo}" has no releases matching "${prefix}.*"`;
+        throw error;
+    }
+    tags.sort(cmpTags);
+    tags.reverse();
+    Core.debug(`Considered tags ${tags.join("|")}`);
+    return tags[0];
+}
+
 async function findLatestCommit({name, repo, branch = "master"}) {
     Core.info(`Looking for latest ${name} commit`);
     const commitsResp = await github.rest.repos.getCommit({
@@ -312,11 +342,14 @@ async function downloadCrystalRelease(suffix, version = null) {
 }
 
 async function findRef({name, repo, version}) {
+    const v = version.replace(/^v/, "");
     if (version === Nightly) {
         return findLatestCommit({name, repo});
     } else if (version === Latest) {
         const release = await findRelease({name, repo});
         return release["tag_name"];
+    } else if (NumericVersion.test(v) && !(/^\d+\.\d+\.\d\w*$/.test(v))) {
+        return getLatestTag({repo, prefix: version});
     }
     return version;
 }