Merge pull request #64 from s4u/mvn-3.9.5

Maven 3.9.5 as default

.github/workflows/test.yml

@@ -18,14 +18,14 @@ jobs:
     strategy:
       matrix:
         os: [ 'ubuntu-latest', 'windows-latest', 'macOS-latest' ]
-        java: [ '8', '11', '17' ]
-        maven: [ '3.6.3', '3.8.7', '3.9.2' ]
+        java: [ '8', '11', '17', '21' ]
+        maven: [ '3.8.8', '3.9.5' ]
       fail-fast: false
 
     runs-on: ${{ matrix.os }}
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - uses: ./
         with:
@@ -41,13 +41,11 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v3
+      - uses: actions/checkout@v4
 
       - uses: ./
-        with:
-          java-version: 8
 
-      - run: mvn -V validate -Drequire.java=8 -Drequire.maven=3.9.2
+      - run: mvn -V validate -Drequire.java=17 -Drequire.maven=3.9.5
         shell: bash
 
   test-ok:

README.md

@@ -9,37 +9,37 @@ This is composite action which help to prepare GitHub Actions environment for Ma
 - [stCarolas/setup-maven](https://github.com/marketplace/actions/setup-maven)
 - [s4u/maven-settings-action](https://github.com/marketplace/actions/maven-settings-action)
 
-# Contributions
+:exclamation: You **should not** include above actions in your configuration - in other case  those will be **called twice**. :exclamation:
 
-- Contributions are welcome!
-- Give :star: - if you want to encourage me to work on a project
-- Don't hesitate to create issues for new features you dream of or if you suspect some bug
+For default values you only need:
 
-# Project versioning
+```yml
+    steps:
 
-This project uses [Semantic Versioning](https://semver.org/).
-We recommended using the latest and specific release version.
-
-In order to keep your project dependencies up to date you can watch this repository *(Releases only)*
-or use automatic tools like [Dependabot](https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates).
+      - name: Setup Maven Action
+        uses: s4u/setup-maven-action@< version >
 
+      - run: mvn -V ...
+```
+ 
 # Params mapping for sub actions
 
-**Notice** when used this action you should not used mentioned below actions again.
-
 ## checkout
 
-| params                       | destination         | default |
-|------------------------------|---------------------|---------|
-| checkout-fetch-depth         | fetch-depth         |         |
-| checkout-path                | path                |         |
-| checkout-persist-credentials | persist-credentials | false   |
+| params                       | destination         | default                  |
+|------------------------------|---------------------|--------------------------|
+| checkout-fetch-depth         | fetch-depth         |                          |
+| checkout-path                | path                |                          |
+| checkout-ref                 | ref                 |                          |
+| checkout-repository          | repository          | ${{ github.repository }} |
+| checkout-token               | token               | ${{ github.token }}      |
+| checkout-persist-credentials | persist-credentials | false                    |
 
 ## setup-java
 
 | params            | destination  | default |
 |-------------------|--------------|---------|
-| java-version      | java-version |         |
+| java-version      | java-version | 17      |
 | java-distribution | distribution | temurin |
 
 ## cache
@@ -60,6 +60,7 @@ So we can use for action:
 
 | params         | description                                              |
 |----------------|----------------------------------------------------------|
+| cache-enabled  | enable cache. Default true                               |
 | cache-path     | default cache path for Maven with value ~/.m2/repository | 
 | cache-path-add | additional value for cache path                          |
 | cache-prefix   | prefix value for `key` and `restore-keys` cache params   |
@@ -69,7 +70,7 @@ So we can use for action:
 
 | params        | destination   | default |
 |---------------|---------------|---------|
-| maven-version | maven-version | 3.9.2   |
+| maven-version | maven-version | 3.9.5   |
 
 ## maven-settings-action
 
@@ -90,7 +91,7 @@ jobs:
 
     strategy:
       matrix:
-        maven: [ '3.6.3', '3.8.7', '3.9.2' ]
+        maven: [ '3.8.8', '3.9.5' ]
 
     name: Maven ${{ matrix.maven }} sample
 
@@ -105,6 +106,20 @@ jobs:
       - run: mvn -V ...
 ```
 
+# Contributions
+
+- Contributions are welcome!
+- Give :star: - if you want to encourage me to work on a project
+- Don't hesitate to create issues for new features you dream of or if you suspect some bug
+
+# Project versioning
+
+This project uses [Semantic Versioning](https://semver.org/).
+We recommended using the latest and specific release version.
+
+In order to keep your project dependencies up to date you can watch this repository *(Releases only)*
+or use automatic tools like [Dependabot](https://docs.github.com/en/code-security/supply-chain-security/keeping-your-dependencies-updated-automatically/about-dependabot-version-updates).
+
 # License
 
 The scripts and documentation in this project are released under the [MIT License](LICENSE)

action.yml

@@ -21,11 +21,25 @@ inputs:
     default: 'false'
     required: false
 
+  checkout-ref:
+    description: 'The branch, tag, or SHA of the repository to clone'
+    required: false
+
+  checkout-repository:
+    description: 'The repository to checkout if not the repository that triggered the action. For use when building GitHub Apps'
+    required: false
+    default: ${{ github.repository }}
+
+  checkout-token:
+    description: 'Token to use for checkout if checking out a repository out of scope for GITHUB_TOKEN'
+    required: false
+    default: ${{ github.token }}
 
   # java jdk params
 
   java-version:
     description: 'The Java version to set up'
+    default: '17'
     required: true
 
   java-distribution:
@@ -34,6 +48,11 @@ inputs:
     required: false
 
   # cache
+  cache-enabled:
+    description: 'Enable cache'
+    default: 'true'
+    required: false
+
   cache-prefix:
     description: 'Cache key prefix'
     required: false
@@ -50,7 +69,7 @@ inputs:
   # maven version
   maven-version:
     description: 'The Maven version to set up'
-    default: '3.9.2'
+    default: '3.9.5'
     required: false
 
   # maven settings.xml
@@ -75,11 +94,14 @@ runs:
 
   steps:
 
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
       with:
         fetch-depth: '${{ inputs.checkout-fetch-depth }}'
         path: '${{ inputs.checkout-path }}'
         persist-credentials: '${{ inputs.checkout-persist-credentials }}'
+        ref: '${{ inputs.checkout-ref }}'
+        repository: '${{ inputs.checkout-repository }}'
+        token: '${{ inputs.checkout-token }}'
 
     - uses: actions/setup-java@v3
       with:
@@ -88,6 +110,7 @@ runs:
         distribution: '${{ inputs.java-distribution }}'
 
     - uses: actions/cache@v3
+      if: inputs.cache-enabled == 'true'
       with:
         path: |
           ${{ inputs.cache-path }}