v2.6.0 d7eeada

Author: eine

README.md

@@ -113,7 +113,24 @@ See, for instance:
     - uses: msys2/setup-msys2@v2
       with:
         msystem: ${{matrix.sys}}
-        install: mingw-w64-${{matrix.env}}-toolchain
+        install: mingw-w64-${{matrix.env}}-openssl
+```
+
+Alternatively, option `pacboy` allows using a single matrix variable:
+
+```yml
+  strategy:
+    matrix:
+      sys:
+        - mingw64
+        - mingw32
+        - ucrt64  # Experimental!
+        - clang64 # Experimental!
+  steps:
+    - uses: msys2/setup-msys2@v2
+      with:
+        msystem: ${{matrix.sys}}
+        pacboy: openssl:p
 ```
 
 Find similar patterms in the following workflows:
@@ -176,38 +193,80 @@ This option corresponds to the `MSYS2_PATH_TYPE` setting in MSYS2; hence it can
 See [msys2/MSYS2-packages: filesystem/profile](https://github.com/msys2/MSYS2-packages/blob/915946a637e1f2b7e26e32782f3af322009293db/filesystem/profile#L28-L45)
 for further details about the configuration of each option.
 
-#### release
+#### update
 
-By default (`true`), retrieve and extract base installation from upstream GitHub Releases.
-If set to `false`, the installation available in the virtual environment is used:
+By default, the installation is not updated; hence package versions are those of the installation tarball.
+By setting option `update` to `true`, the action will try to update the runtime and packages cleanly:
 
 ```yaml
   - uses: msys2/setup-msys2@v2
     with:
-      release: false
+      update: true
 ```
 
-#### update
+#### install
 
-By default, the installation is not updated; hence package versions are those of the installation tarball.
-By setting option `update` to `true`, the action will try to update the runtime and packages cleanly:
+Installing additional packages after updating the system is supported through option `install`.
+The package or list of packages are installed through `pacman --noconfirm -S --needed --overwrite *`.
 
 ```yaml
   - uses: msys2/setup-msys2@v2
     with:
       update: true
+      install: >-
+        git
+        base-devel
 ```
 
-#### install
+#### pacboy
 
-Installing additional packages after updating the system is supported through option `install`.
-The package or list of packages are installed through `pacman --noconfirm -S --needed`.
+Installing additional packages with [pacboy](https://www.msys2.org/docs/package-management/#avoiding-writing-long-package-names) after updating the system is supported through option `pacboy`.
+The package or list of packages are installed through `pacboy --noconfirm -S --needed`.
 
 ```yaml
+  strategy:
+    fail-fast: false
+    matrix:
+      sys: [ MINGW64, MINGW32, UCRT64, CLANG64 ]
+  steps:
   - uses: msys2/setup-msys2@v2
     with:
-      update: true
+      msystem: ${{matrix.sys}}
       install: >-
         git
         base-devel
+      pacboy: >-
+        openssl:p
+```
+
+#### release
+
+By default (`true`), retrieve and extract base installation from upstream GitHub Releases.
+If set to `false`, the installation available in the virtual environment is used:
+
+```yaml
+  - uses: msys2/setup-msys2@v2
+    with:
+      release: false
+```
+
+#### location
+
+Specify the location where to install msys2:
+
+```yaml
+  - uses: msys2/setup-msys2@v2
+    with:
+      location: D:\
+```
+
+#### platform-check-severity
+
+By default (`fatal`), throw an error if the runner OS is not Windows.
+If set to `warn`, simply log a message and skip the rest:
+
+```yaml
+  - uses: msys2/setup-msys2@v2
+    with:
+      platform-check-severity: warn
 ```

action.yml

@@ -12,18 +12,30 @@ inputs:
     description: 'Default value for MSYS2_PATH_TYPE environment variable: strict, inherit or minimal'
     required: false
     default: 'minimal'
-  release:
-    description: 'Retrieve and extract base installation from upstream GitHub Releases'
-    required: false
-    default: true
   update:
     description: 'Update MSYS2 installation through pacman'
     required: false
     default: false
   install:
-    description: 'Install packages after installation through pacman'
+    description: 'After installation and/or update, install additional packages through pacman'
+    required: false
+    default: false
+  pacboy:
+    description: 'After installation and/or update, install additional packages through pacboy'
     required: false
     default: false
+  release:
+    description: 'Retrieve and extract base installation from upstream GitHub Releases'
+    required: false
+    default: true
+  location:
+    description: 'Where to install MSYS2'
+    required: false
+    default: 'RUNNER_TEMP'
+  platform-check-severity:
+    description: 'What to do when run on an incompatible runner: fatal, warn'
+    required: false
+    default: 'fatal'
 runs:
   using: 'node12'
   main: 'index.js'