Initial version of perl-versions

Author: happy-barney

.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+# be tolerant to others, configure your editor's tab-width with
+# your preferred value (mine is 4)
+[*.js]
+charset = utf-8
+indent_style = tab
+
+[*.yml]
+indent_style = space
+indent_size = 2

README.md

@@ -0,0 +1,49 @@
+
+# perl-versions
+
+Github action for your matrix to generate list of perls since given.
+
+## Parameters
+
+### since-perl
+
+Required parameter.
+
+For list of available perl versions check
+[docker-perl-tester](https://github.com/Perl/docker-perl-tester#using-docker-images-for-your-projects)
+
+Returns perl versions since this (including).
+
+When unknown version is provided, returns empty list.
+
+### with-devel
+
+Default: `false`
+
+When set to `true`, returned list will also include current `devel` version of Perl,
+if available.
+
+## Usage
+
+```
+jobs:
+  perl-versions:
+    runs-on: ubuntu-latest
+    name: List perl versions
+    outputs:
+      perl-versions: ${{ steps.action.outputs.perl-versions }}
+    steps:
+      - name: Perl versions action step
+        id: action
+        uses: happy-barney/github-workflows/perl-versions@main
+        with:
+          since-perl: "v5.20"
+
+  test:
+    needs:
+      - perl-versions
+    strategy:
+      matrix:
+        perl-versions: ${{ fromJson (needs.perl-versions.outputs.perl-versions }}
+
+```

action.yml

@@ -0,0 +1,17 @@
+name: 'Perl versions'
+description: 'Generate Perl versions list for your matrix'
+inputs:
+  since-perl:
+    description: "List all Perl versions since this (including this). Example: 5.10"
+    type: string
+    required: true
+  with-devel:
+    description: "Whether to include also 'devel' Perl"
+    type: boolean
+    default: false
+outputs:
+  perl-versions:
+    description: "JSON containing list of perl versions"
+runs:
+  using: node16
+  main: perl-versions.js

perl-versions.js

@@ -0,0 +1,30 @@
+
+const core   = require('@actions/core');
+const github = require('@actions/github');
+
+try {
+	const since_perl = core.getInput('since-perl');
+	const with_devel = core.getInput('with-devel') == "true";
+
+	let found = false;
+	let available = [
+		"5.8",
+		"5.10", "5.12", "5.14", "5.16", "5.18",
+		"5.20", "5.22", "5.24", "5.26", "5.28",
+		"5.30", "5.32", "5.34", "5.36", "5.38",
+		"devel",
+	];
+
+	let filtered = available.filter (
+		(item) => {
+			if (item == "devel") { return with_devel; }
+			if (! found) { found = (item == since_perl); }
+			return found;
+		}
+	);
+
+	console.log('perl-versions', JSON.stringify(filtered));
+	core.setOutput('perl-versions', JSON.stringify(filtered));
+} catch (error) {
+	core.setFailed(error.message);
+}