From 4a28936eb2dd6ce3a7a4d1df58d13ec1aba9cbe8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Branislav=20Zahradn=C3=ADk?= <happy.barney@gmail.com>
Date: Tue, 17 Jun 2025 06:11:27 +0200
Subject: [PATCH] New action `report-perl`

Trivial action just to make list of steps to look fancy.
---
 README.md              | 26 ++++++++++++++++++++++++++
 report-perl/action.yml | 13 +++++++++++++
 2 files changed, 39 insertions(+)
 create mode 100644 report-perl/action.yml

diff --git a/README.md b/README.md
index df7722e..c90a56d 100644
--- a/README.md
+++ b/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`.
diff --git a/report-perl/action.yml b/report-perl/action.yml
new file mode 100644
index 0000000..3ea3adc
--- /dev/null
+++ b/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 }}"