DCA11Y-1145: Support standard Node version files

FORK_CHANGELOG.md

@@ -6,4 +6,14 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
-[unreleased]: https://github.com/olivierlacan/keep-a-changelog/compare/v1.1.1...HEAD
+### Added
+
+- [DCA11Y-1145]: Automatic version detection of the Node version from `.tool-versions`, `.node-version`, and `.nvmrc` files
+- [DCA11Y-1145]: The configuration property `nodeVersionFile` to specify a file that can be read in `install-node-and-npm`, `install-node-and-pnpm`, and `install-node-and-yarn`
+
+### Changed
+
+- [DCA11Y-1145]: Now tolerant of `v` missing or present at the start of a Node version
+
+[DCA11Y-1145]: https://hello.jira.atlassian.cloud/browse/DCA11Y-1145
+[unreleased]: https://github.com/olivierlacan/keep-a-changelog/compare/v1.15.0...HEAD

README.md

@@ -52,4 +52,24 @@ Only Atlassians may release a new version, [follow this guide](https://hello.atl
 
 ## Usage guidance
 
+### Format of the Node version
+
+It shouldn't matter if the `v` prefix is present, e.g. `14.8.0` and `v14.8.0`.
+
+Old, non-standard, and codename versions are also supported if they're [available](https://nodejs.org/dist), e.g. `latest-v12.x`.
+
+### Using Node version files
+
+The plugin should automatically detect the version from files like: `.node-version`, `.nvmrc`, and `.tool-versions`. Comments in the files should be ignored. If the file is not in the working directory, nor any of the parent directories, it can be manually set in the configuration like so:
+
+```xml
+<plugin>
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>frontend-maven-plugin</artifactId>
+    <configuration>
+        <nodeVersionFile>${project.basedir}/dotfiles/.nvmrc</nodeVersionFile>
+    </configuration>
+</plugin>
+```
+
 [![Cheers from Atlassian](https://raw.githubusercontent.com/atlassian-internal/oss-assets/master/banner-cheers-light.png)](https://www.atlassian.com)

frontend-maven-plugin/.nvmrc

@@ -0,0 +1,4 @@
+        # comment
+
+    v22.5.1      !   comment
+    // comment

frontend-maven-plugin/pom.xml

@@ -138,6 +138,12 @@
                   <goal>run</goal>
                   <goal>verify</goal>
                 </goals>
+                <configuration>
+                  <environmentVariables>
+                    <MISE_CONFIG_DIR>TESTDIR</MISE_CONFIG_DIR>
+                    <MISE_ENV>TESTPROFILE</MISE_ENV>
+                  </environmentVariables>
+                </configuration>
               </execution>
             </executions>
           </plugin>

frontend-maven-plugin/src/it/mise-config-file/.mise.toml

@@ -0,0 +1,10 @@
+[tools]
+java = "temurin-21"
+maven = "3.9"
+pre-commit = "latest"
+ktlint = "latest"
+python = "3.12"
+# node 22.5.1
+node = "22.5.1"
+# node 22.5.1
+yarn = "1.22.22"

frontend-maven-plugin/src/it/mise-config-file/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "example",
+  "version": "0.0.1"
+}

frontend-maven-plugin/src/it/mise-config-file/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <installDirectory>target</installDirectory>
+                </configuration>
+
+                <executions>
+
+                    <execution>
+                        <id>install node and npm</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/mise-config-file/verify.groovy

@@ -0,0 +1,5 @@
+assert new File(basedir, 'target/node').exists() : "Node was not installed in the custom install directory";
+
+String buildLog = new File(basedir, 'build.log').text
+assert buildLog.contains('.mise.toml') : 'The wrong file was used'
+assert buildLog.contains('Installing node version v22.5.1') : 'The correct node version was not detected'

frontend-maven-plugin/src/it/mise-env-config-file/TESTDIR/mise.TESTPROFILE.toml

@@ -0,0 +1,10 @@
+[tools]
+java = "temurin-21"
+maven = "3.9"
+pre-commit = "latest"
+ktlint = "latest"
+python = "3.12"
+# node 22.5.1
+node = "22.5.1"
+# node 22.5.1
+yarn = "1.22.22"

frontend-maven-plugin/src/it/mise-env-config-file/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "example",
+  "version": "0.0.1"
+}

frontend-maven-plugin/src/it/mise-env-config-file/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <installDirectory>target</installDirectory>
+                </configuration>
+
+                <executions>
+
+                    <execution>
+                        <id>install node and npm</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/mise-env-config-file/verify.groovy

@@ -0,0 +1,5 @@
+assert new File(basedir, 'target/node').exists() : "Node was not installed in the custom install directory";
+
+String buildLog = new File(basedir, 'build.log').text
+assert buildLog.contains(['TESTDIR','mise.TESTPROFILE.toml'].join(File.separator)) : 'The wrong file was used'
+assert buildLog.contains('Installing node version v22.5.1') : 'The correct node version was not detected'

frontend-maven-plugin/src/it/nested-project-nvmrc-file/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "example",
+  "version": "0.0.1"
+}

frontend-maven-plugin/src/it/nested-project-nvmrc-file/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <installDirectory>target</installDirectory>
+                </configuration>
+
+                <executions>
+
+                    <execution>
+                        <id>install node and npm</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/nested-project-nvmrc-file/verify.groovy

@@ -0,0 +1,5 @@
+assert new File(basedir, 'target/node').exists() : "Node was not installed in the custom install directory";
+
+String buildLog = new File(basedir, 'build.log').text
+assert buildLog.contains(['frontend-maven-plugin','.nvmrc'].join(File.separator)) : 'The wrong file was used'
+assert buildLog.contains('Installing node version v22.5.1') : 'The correct node version was not detected'

frontend-maven-plugin/src/it/specified-node-version-file/dotfiles/.nvmrc

@@ -0,0 +1 @@
+v22.5.1

frontend-maven-plugin/src/it/specified-node-version-file/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "example",
+  "version": "0.0.1"
+}

frontend-maven-plugin/src/it/specified-node-version-file/pom.xml

@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <nodeVersionFile>${project.basedir}/dotfiles/.nvmrc</nodeVersionFile>
+                    <installDirectory>target</installDirectory>
+                </configuration>
+
+                <executions>
+
+                    <execution>
+                        <id>install node and npm</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/specified-node-version-file/verify.groovy

@@ -0,0 +1,5 @@
+assert new File(basedir, 'target/node').exists() : "Node was not installed in the custom install directory";
+
+String buildLog = new File(basedir, 'build.log').text
+assert buildLog.contains(['specified-node-version-file', 'dotfiles', '.nvmrc'].join(File.separator)) : 'The wrong file was used'
+assert buildLog.contains('Installing node version v22.5.1') : 'The correct node version was not detected'

frontend-maven-plugin/src/it/tool-versions-file/.tool-versions

@@ -0,0 +1 @@
+node v22.5.1

frontend-maven-plugin/src/it/tool-versions-file/package.json

@@ -0,0 +1,4 @@
+{
+  "name": "example",
+  "version": "0.0.1"
+}

frontend-maven-plugin/src/it/tool-versions-file/pom.xml

@@ -0,0 +1,34 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+
+    <groupId>com.github.eirslett</groupId>
+    <artifactId>example</artifactId>
+    <version>0</version>
+    <packaging>pom</packaging>
+
+    <build>
+        <plugins>
+            <plugin>
+                <groupId>com.github.eirslett</groupId>
+                <artifactId>frontend-maven-plugin</artifactId>
+                <!-- NB! Set <version> to the latest released version of frontend-maven-plugin, like in README.md -->
+                <version>@project.version@</version>
+
+                <configuration>
+                    <installDirectory>target</installDirectory>
+                </configuration>
+
+                <executions>
+
+                    <execution>
+                        <id>install node and npm</id>
+                        <goals>
+                            <goal>install-node-and-npm</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>

frontend-maven-plugin/src/it/tool-versions-file/verify.groovy

@@ -0,0 +1,5 @@
+assert new File(basedir, 'target/node').exists() : "Node was not installed in the custom install directory";
+
+String buildLog = new File(basedir, 'build.log').text
+assert buildLog.contains('.tool-versions') : 'The wrong file was used'
+assert buildLog.contains('Installing node version v22.5.1') : 'The correct node version was not detected'