Merge pull request #24 from happy-barney/hpb/action-report-perl

New action `report-perl`

Author: oalders

README.md

@@ -61,6 +61,7 @@ job:
     ...
     steps:
 	  ...
+      - uses: perl-actions/ci-perl-tester-helpers/report-perl@main
       - uses: perl-actions/ci-perl-tester-helpers/install-test-helper-deps@main
       - uses: perl-actions/ci-perl-tester-helpers/cpan-install-build-deps@main
       - uses: perl-actions/ci-perl-tester-helpers/build-dist@main
@@ -88,6 +89,31 @@ Install dependencies required by ci-perl-tester-helpers
 
 - `cpm` - required version min `0.997014`
 
+## perl-actions/ci-perl-tester-helpers/report-perl@main
+
+Report version and configuration of available Perl
+
+Despite being simple `perl -V` (for now) naming it shows intention what
+you want to do.
+
+### Inputs
+
+- `artifact` (optional): When specified, output will be written also to this file.
+
+### Examples
+
+Basic usage:
+```yaml
+- uses: perl-actions/ci-perl-tester-helpers/report-perl@main
+```
+
+Save output to a file:
+```yaml
+- uses: perl-actions/ci-perl-tester-helpers/report-perl@main
+  with:
+    artifact: perl-version.txt
+```
+
 ## perl-actions/ci-perl-tester-helpers/test-dist@main
 
 Tests your distribution using `prove` with `--state save`.

report-perl/action.yml

@@ -0,0 +1,13 @@
+---
+name: 'perl -V'
+inputs:
+  artifact:
+    description: 'File name where to save output of command'
+    required: false
+    default: '/dev/null'
+runs:
+  using: "composite"
+  steps:
+    - shell: bash
+      run: |
+        perl -V | tee "${{ inputs.artifact }}"