#31: implement tool commandlet for node package manager

cli/src/main/java/com/devonfw/tools/ide/commandlet/CommandletManagerImpl.java

@@ -23,6 +23,7 @@
 import com.devonfw.tools.ide.tool.kotlinc.KotlincNative;
 import com.devonfw.tools.ide.tool.mvn.Mvn;
 import com.devonfw.tools.ide.tool.node.Node;
+import com.devonfw.tools.ide.tool.npm.Npm;
 import com.devonfw.tools.ide.tool.oc.Oc;
 import com.devonfw.tools.ide.tool.quarkus.Quarkus;
 import com.devonfw.tools.ide.tool.terraform.Terraform;
@@ -69,6 +70,7 @@ public CommandletManagerImpl(IdeContext context) {
     add(new Helm(context));
     add(new Java(context));
     add(new Node(context));
+    add(new Npm(context));
     add(new Mvn(context));
     add(new GcViewer(context));
     add(new Gradle(context));

cli/src/main/java/com/devonfw/tools/ide/io/FileAccessImpl.java

@@ -1,21 +1,12 @@
 package com.devonfw.tools.ide.io;
 
-import java.io.BufferedOutputStream;
-import java.io.FileInputStream;
-import java.io.FileOutputStream;
-import java.io.IOException;
-import java.io.InputStream;
-import java.io.OutputStream;
+import java.io.*;
 import java.net.URI;
 import java.net.http.HttpClient;
 import java.net.http.HttpClient.Redirect;
 import java.net.http.HttpRequest;
 import java.net.http.HttpResponse;
-import java.nio.file.FileSystemException;
-import java.nio.file.Files;
-import java.nio.file.LinkOption;
-import java.nio.file.NoSuchFileException;
-import java.nio.file.Path;
+import java.nio.file.*;
 import java.nio.file.attribute.BasicFileAttributes;
 import java.nio.file.attribute.PosixFilePermission;
 import java.nio.file.attribute.PosixFilePermissions;
@@ -543,7 +534,7 @@ private void unpack(Path file, Path targetDir, Function<InputStream, ArchiveInpu
           mkdirs(entryPath.getParent());
           Files.copy(ais, entryPath);
         }
-        if (isTar) {
+        if (isTar && !this.context.getSystemInfo().isWindows()) {
           Set<PosixFilePermission> permissions = PosixFilePermissions.fromString(permissionStr);
           Files.setPosixFilePermissions(entryPath, permissions);
         }

cli/src/main/java/com/devonfw/tools/ide/tool/npm/Npm.java

@@ -0,0 +1,58 @@
+package com.devonfw.tools.ide.tool.npm;
+
+import java.nio.file.Path;
+import java.util.Set;
+
+import com.devonfw.tools.ide.common.Tag;
+import com.devonfw.tools.ide.context.IdeContext;
+import com.devonfw.tools.ide.io.FileAccess;
+import com.devonfw.tools.ide.tool.LocalToolCommandlet;
+import com.devonfw.tools.ide.tool.ToolCommandlet;
+import com.devonfw.tools.ide.tool.node.Node;
+
+/**
+ * {@link ToolCommandlet} for <a href="https://nodejs.org/">node</a>.
+ */
+
+public class Npm extends LocalToolCommandlet {
+
+  /**
+   * The constructor.
+   *
+   * @param context the {@link IdeContext}.
+   */
+  public Npm(IdeContext context) {
+
+    super(context, "npm", Set.of(Tag.JAVA_SCRIPT, Tag.RUNTIME));
+  }
+
+  @Override
+  public boolean install(boolean silent) {
+
+    getCommandlet(Node.class).install();
+    return super.doInstall(silent);
+  }
+
+  @Override
+  public void postInstall() {
+
+    super.postInstall();
+
+    FileAccess fileAccess = context.getFileAccess();
+    Path nodeHomePath = this.context.getSoftwarePath().resolve("node/");
+    Path npmBinBath = nodeHomePath.resolve("node_modules/npm/bin/");
+    String npm = "npm";
+    String npx = "npx";
+    String cmd = ".cmd";
+
+    fileAccess.delete(nodeHomePath.resolve(npm));
+    fileAccess.delete(nodeHomePath.resolve(npm + cmd));
+    fileAccess.delete(nodeHomePath.resolve(npx));
+    fileAccess.delete(nodeHomePath.resolve(npx + cmd));
+
+    fileAccess.copy(npmBinBath.resolve(npm), nodeHomePath.resolve(npm));
+    fileAccess.copy(npmBinBath.resolve(npm + cmd), nodeHomePath.resolve(npm + cmd));
+    fileAccess.copy(npmBinBath.resolve(npx), nodeHomePath.resolve(npx));
+    fileAccess.copy(npmBinBath.resolve(npx + cmd), nodeHomePath.resolve(npx + cmd));
+  }
+}

cli/src/main/resources/nls/Ide.properties

@@ -24,6 +24,7 @@ cmd-list-editions=List the available editions of the selected tool.
 cmd-list-versions=List the available versions of the selected tool.
 cmd-mvn=Tool commandlet for Maven (Build-Tool)
 cmd-node=Tool commandlet for Node.js (JavaScript runtime)
+cmd-npm=Tool commandlet for Npm
 cmd-oc=Tool commandlet for Openshift CLI (Kubernetes Management Tool)
 cmd-quarkus=Tool commandlet for Quarkus (Framework for cloud-native apps)
 cmd-set-edition=Set the edition of the selected tool.

cli/src/main/resources/nls/Ide_de.properties

@@ -22,6 +22,7 @@ cmd-list-editions=Listet die verfügbaren Editionen des selektierten Werkzeugs a
 cmd-list-versions=Listet die verfügbaren Versionen des selektierten Werkzeugs auf.
 cmd-mvn=Werkzeug Kommando für Maven (Build-Werkzeug)
 cmd-node=Werkzeug Kommando für Node.js (JavaScript Laufzeitumgebung)
+cmd-npm=Werkzeug Kommando für Npm
 cmd-oc=Werkzeug Kommando für Openshift CLI (Kubernetes Management Tool)
 cmd-quarkus=Werkzeug Kommando für Quarkus (Framework für Cloud-native Anwendungen)
 cmd-set-edition=Setzt die Edition des selektierten Werkzeugs.

cli/src/test/java/com/devonfw/tools/ide/tool/npm/NpmTest.java

@@ -0,0 +1,7 @@
+package com.devonfw.tools.ide.tool.npm;
+
+import com.devonfw.tools.ide.context.AbstractIdeContextTest;
+
+public class NpmTest extends AbstractIdeContextTest {
+
+}

documentation/IDEasy-usage.asciidoc

@@ -16,6 +16,7 @@ include::cli.asciidoc[leveloffset=2]
 
 include::docker-desktop-alternative.asciidoc[leveloffset=3]
 include::jmc.asciidoc[leveloffset=3]
+include::npm.asciidoc[leveloffset=3]
 
 <<<<
 

documentation/npm.asciidoc

@@ -0,0 +1,21 @@
+:toc:
+toc::[]
+
+= npm
+
+The `npm` commandlet allows to install, configure, and launch https://www.npmjs.com/[npm]. Calling `devon npm «args»` is more or less the same as calling `npm «args»` but with the benefit that the version of npm preferred by your project is used (and will be installed if not yet available).
+
+The arguments (`devon npm «args»`) are explained by the following table:
+
+.Usage of `devon npm`
+[options="header"]
+|=======================
+|*Argument(s)*             |*Meaning*
+|                          |run default build, link:configuration.asciidoc[configurable] via `NPM_BUILD_OPTS`
+|`setup`                   |setup NPM (install and verify), link:configuration.asciidoc[configurable] via `NPM_VERSION`
+|`get-version`             |print the version of your current project
+|`set-version «nv» [«cv»]` |set the version of your current project to `«nv»` (assuming your current version is `«cv»`)
+|`check-top-level-project` |check if you are running on a top-level project or fail if in a module or no NPM project at all
+|`release`                 |Start a clean deploy release build, link:configuration.asciidoc[configurable] via `NPM_RELEASE_OPTS`
+|`«args»`                  |run NPM with the given arguments (`«args»`)
+|=======================