• Home
  • Features
  • Pricing
  • Docs
  • Announcements
  • Sign In
Build has been canceled!

devonfw / IDEasy / 26275559811

22 May 2026 07:52AM UTC coverage: 70.961% (-0.1%) from 71.062%
26275559811

Pull #1913

github

web-flow
Merge 59c4a70ca into 58ae6752b
Pull Request #1913: 1719: Rust Integration

4468 of 6970 branches covered (64.1%)

Branch coverage included in aggregate %.

11548 of 15600 relevant lines covered (74.03%)

3.13 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

80.6
cli/src/main/java/com/devonfw/tools/ide/tool/LocalToolCommandlet.java
1
package com.devonfw.tools.ide.tool;
2

3
import java.nio.file.Files;
4
import java.nio.file.LinkOption;
5
import java.nio.file.Path;
6
import java.util.Collection;
7
import java.util.Set;
8

9
import org.slf4j.Logger;
10
import org.slf4j.LoggerFactory;
11

12
import com.devonfw.tools.ide.cli.CliOfflineException;
13
import com.devonfw.tools.ide.common.Tag;
14
import com.devonfw.tools.ide.context.IdeContext;
15
import com.devonfw.tools.ide.io.FileAccess;
16
import com.devonfw.tools.ide.log.IdeLogLevel;
17
import com.devonfw.tools.ide.process.ProcessContext;
18
import com.devonfw.tools.ide.step.Step;
19
import com.devonfw.tools.ide.tool.repository.ToolRepository;
20
import com.devonfw.tools.ide.url.model.file.json.ToolDependency;
21
import com.devonfw.tools.ide.version.GenericVersionRange;
22
import com.devonfw.tools.ide.version.VersionIdentifier;
23
import com.devonfw.tools.ide.version.VersionRange;
24

25
/**
26
 * {@link ToolCommandlet} that is installed locally into the IDEasy.
27
 */
28
public abstract class LocalToolCommandlet extends ToolCommandlet {
29

30
  private static final Logger LOG = LoggerFactory.getLogger(LocalToolCommandlet.class);
4✔
31

32
  /**
33
   * The constructor.
34
   *
35
   * @param context the {@link IdeContext}.
36
   * @param tool the {@link #getName() tool name}.
37
   * @param tags the {@link #getTags() tags} classifying the tool. Should be created via {@link Set#of(Object) Set.of} method.
38
   */
39
  public LocalToolCommandlet(IdeContext context, String tool, Set<Tag> tags) {
40

41
    super(context, tool, tags);
5✔
42
  }
1✔
43

44
  /**
45
   * @return the {@link Path} where the tool is located (installed).
46
   */
47
  @Override
48
  public Path getToolPath() {
49
    if (this.context.getSoftwarePath() == null) {
4!
50
      return null;
×
51
    }
52
    return this.context.getSoftwarePath().resolve(getName());
7✔
53
  }
54

55
  /**
56
   * @return the {@link Path} where the executables of the tool can be found. Typically, a "bin" folder inside {@link #getToolPath() tool path}.
57
   */
58
  public Path getToolBinPath() {
59

60
    Path toolPath = getToolPath();
3✔
61
    if (toolPath == null) {
2!
62
      return null;
×
63
    }
64
    Path binPath = toolPath.resolve(IdeContext.FOLDER_BIN);
4✔
65
    if (Files.isDirectory(binPath)) {
5✔
66
      return binPath;
2✔
67
    }
68
    return toolPath;
2✔
69
  }
70

71
  /**
72
   * @return {@code true} to ignore a missing {@link IdeContext#FILE_SOFTWARE_VERSION software version file} in an installation, {@code false} delete the broken
73
   *     installation (default).
74
   */
75
  protected boolean isIgnoreMissingSoftwareVersionFile() {
76

77
    return false;
×
78
  }
79

80

81
  @Override
82
  protected ToolInstallation doInstall(ToolInstallRequest request) {
83

84
    Step step = request.getStep();
3✔
85
    if (step == null) {
2!
86
      return doInstallStep(request);
4✔
87
    } else {
88
      return step.call(() -> doInstallStep(request),
×
89
          () -> createExistingToolInstallation(request));
×
90
    }
91
  }
92

93
  private ToolInstallation doInstallStep(ToolInstallRequest request) {
94

95
    // install configured version of our tool in the software repository if not already installed
96
    ToolInstallation installation = installTool(request);
4✔
97

98
    // check if we already have this version installed (linked) locally in IDE_HOME/software
99
    VersionIdentifier resolvedVersion = installation.resolvedVersion();
3✔
100
    if (request.isAlreadyInstalled()) {
3✔
101
      return installation;
2✔
102
    } else {
103
      LOG.debug("Installation from {} to {}.", request.getInstalled(), request.getRequested());
7✔
104
    }
105
    FileAccess fileAccess = this.context.getFileAccess();
4✔
106
    boolean ignoreSoftwareRepo = isIgnoreSoftwareRepo();
3✔
107
    Path toolPath = request.getToolPath();
3✔
108
    if (!ignoreSoftwareRepo) {
2✔
109
      // we need to link the version or update the link.
110
      if (Files.exists(toolPath, LinkOption.NOFOLLOW_LINKS)) {
9✔
111
        fileAccess.backup(toolPath);
4✔
112
      }
113
      fileAccess.mkdirs(toolPath.getParent());
4✔
114
      fileAccess.symlink(installation.linkDir(), toolPath);
5✔
115
    }
116
    if (!request.isExtraInstallation() && (installation.binDir() != null)) {
6!
117
      this.context.getPath().setPath(this.tool, installation.binDir());
8✔
118
    }
119
    postInstall(request);
3✔
120
    ToolEditionAndVersion installed = request.getInstalled();
3✔
121
    GenericVersionRange installedVersion = null;
2✔
122
    if (installed != null) {
2!
123
      installedVersion = installed.getVersion();
3✔
124
    }
125
    ToolEditionAndVersion requested = request.getRequested();
3✔
126
    ToolEdition toolEdition = requested.getEdition();
3✔
127
    Step step = request.getStep();
3✔
128
    if (installedVersion == null) {
2✔
129
      IdeLogLevel.SUCCESS.log(LOG, "Successfully installed {} in version {} at {}", toolEdition, resolvedVersion, toolPath);
19✔
130
    } else {
131
      IdeLogLevel.SUCCESS.log(LOG, "Successfully installed {} in version {} replacing previous version {} of {} at {}", toolEdition,
21✔
132
          resolvedVersion, installedVersion, installed.getEdition(), toolPath);
6✔
133
    }
134
    if (step != null) {
2!
135
      step.success(true);
×
136
    }
137
    return installation;
2✔
138
  }
139

140
  /**
141
   * Determines whether this tool should be installed directly in the software folder or in the software repository.
142
   *
143
   * @return {@code true} if the tool should be installed directly in the software folder, ignoring the central software repository; {@code false} if the tool
144
   *     should be installed in the central software repository (default behavior).
145
   */
146
  protected boolean isIgnoreSoftwareRepo() {
147

148
    return false;
2✔
149
  }
150

151
  /**
152
   * Performs the installation of the {@link #getName() tool} together with the environment context  managed by this
153
   * {@link com.devonfw.tools.ide.commandlet.Commandlet}.
154
   *
155
   * @param request the {@link ToolInstallRequest}.
156
   * @return the resulting {@link ToolInstallation}.
157
   */
158
  public ToolInstallation installTool(ToolInstallRequest request) {
159

160
    completeRequest(request); // most likely already done, but if installTool was called directly and not from install
3✔
161
    if (request.isInstallLoop()) {
3!
162
      return toolAlreadyInstalled(request);
×
163
    }
164
    ToolEditionAndVersion requested = request.getRequested();
3✔
165
    ToolEdition toolEdition = requested.getEdition();
3✔
166
    assert (toolEdition.tool().equals(this.tool)) : "Mismatch " + this.tool + " != " + toolEdition.tool();
7!
167
    String edition = toolEdition.edition();
3✔
168
    VersionIdentifier resolvedVersion = cveCheck(request);
4✔
169
    installToolDependencies(request);
3✔
170

171
    // cveCheck might have changed resolvedVersion so let us re-check...
172
    if (request.isAlreadyInstalled()) {
3✔
173
      return toolAlreadyInstalled(request);
4✔
174
    } else {
175
      ToolEditionAndVersion installed = request.getInstalled();
3✔
176
      LOG.debug("Installation from {} to {}.", installed, requested);
5✔
177
    }
178
    Path installationPath = getInstallationPath(edition, resolvedVersion);
5✔
179

180
    ProcessContext processContext = request.getProcessContext();
3✔
181
    boolean additionalInstallation = request.isAdditionalInstallation();
3✔
182
    boolean ignoreSoftwareRepo = isIgnoreSoftwareRepo();
3✔
183
    Path toolVersionFile = installationPath.resolve(IdeContext.FILE_SOFTWARE_VERSION);
4✔
184
    FileAccess fileAccess = this.context.getFileAccess();
4✔
185
    if (Files.isDirectory(installationPath)) {
5✔
186
      if (Files.exists(toolVersionFile)) {
5!
187
        if (!ignoreSoftwareRepo) {
2✔
188
          assert resolvedVersion.equals(getInstalledVersion(installationPath)) :
7!
189
              "Found version " + getInstalledVersion(installationPath) + " in " + toolVersionFile + " but expected " + resolvedVersion;
×
190
          LOG.debug("Version {} of tool {} is already installed at {}", resolvedVersion, toolEdition, installationPath);
17✔
191
          return createToolInstallation(installationPath, resolvedVersion, false, processContext, additionalInstallation);
8✔
192
        }
193
      } else {
194
        // Makes sure that IDEasy will not delete itself
195
        if (this.tool.equals(IdeasyCommandlet.TOOL_NAME)) {
×
196
          LOG.warn("Your IDEasy installation is missing the version file at {}", toolVersionFile);
×
197
          return createToolInstallation(installationPath, resolvedVersion, false, processContext, additionalInstallation);
×
198
        } else if (!isIgnoreMissingSoftwareVersionFile()) {
×
199
          LOG.warn("Deleting corrupted installation at {}", installationPath);
×
200
          fileAccess.delete(installationPath);
×
201
        }
202
      }
203
    }
204
    VersionIdentifier actualInstalledVersion = resolvedVersion;
2✔
205
    try {
206
      performToolInstallation(request, installationPath);
4✔
207
    } catch (CliOfflineException e) {
1✔
208
      // If we are offline and cannot download, check if we can continue with an existing installation
209
      ToolEditionAndVersion installed = request.getInstalled();
3✔
210
      if ((installed != null) && (installed.getResolvedVersion() != null)) {
5!
211
        LOG.warn("Cannot download {} in version {} because we are offline. Continuing with already installed version {}.", this.tool,
17✔
212
            resolvedVersion, installed.getResolvedVersion());
2✔
213
        // If offline and could not download, actualInstalledVersion will be the old version, not resolvedVersion
214
        // In that case, we need to recalculate the installation path for the actually installed version
215
        actualInstalledVersion = installed.getResolvedVersion();
3✔
216
        installationPath = getInstallationPath(edition, actualInstalledVersion);
6✔
217
      } else {
218
        // No existing installation available, re-throw the exception
219
        throw e;
2✔
220
      }
221
    }
1✔
222
    return createToolInstallation(installationPath, actualInstalledVersion, true, processContext, additionalInstallation);
8✔
223
  }
224

225
  /**
226
   * Performs the actual installation of the {@link #getName() tool} by orchestrating the installation steps:
227
   * dependency installation, tool-specific placement, versioning, and cleanup.
228
   * <p>
229
   * This method assumes that the version has already been resolved. It handles the lifecycle of
230
   * placing the tool into the appropriate installation directory by delegating the actual bit
231
   * placement to {@link #onInstall(ToolInstallRequest, Path, Path)}.
232
   *
233
   * @param request the {@link ToolInstallRequest}.
234
   * @param installationPath the target {@link Path} where the {@link #getName() tool} should be installed.
235
   */
236
  protected void performToolInstallation(ToolInstallRequest request, Path installationPath) {
237

238
    installDependencies(request);
3✔
239
    FileAccess fileAccess = this.context.getFileAccess();
4✔
240
    ToolEditionAndVersion requested = request.getRequested();
3✔
241
    VersionIdentifier resolvedVersion = requested.getResolvedVersion();
3✔
242
    Path downloadedToolFile = getDownloadedToolFile(request);
4✔
243

244
    if (Files.isDirectory(installationPath)) {
5!
245
      if (this.tool.equals(IdeasyCommandlet.TOOL_NAME)) {
×
246
        LOG.warn("Your IDEasy installation is missing the version file.");
×
247
      } else {
248
        fileAccess.backup(installationPath);
×
249
      }
250
    }
251
    fileAccess.mkdirs(installationPath.getParent());
4✔
252

253
    onInstall(request, installationPath, downloadedToolFile);
5✔
254

255
    this.context.writeVersionFile(resolvedVersion, installationPath);
5✔
256
    // fix macOS Gatekeeper blocking - must run after version file is written but before any executables are launched
257
    getMacOsHelper().removeQuarantineAttribute(installationPath);
4✔
258
    LOG.debug("Installed {} in version {} at {}", this.tool, resolvedVersion, installationPath);
18✔
259
  }
1✔
260

261
  /**
262
   * Performs the actual installation of the tool bits.
263
   *
264
   * @param request the {@link ToolInstallRequest}.
265
   * @param installationPath the target {@link Path} where the tool should be installed.
266
   * @param downloadedToolFile the {@link Path} to the downloaded tool file.
267
   */
268
  protected void onInstall(ToolInstallRequest request, Path installationPath, Path downloadedToolFile) {
269

270
    boolean extract = isExtract();
3✔
271
    if (!extract) {
2✔
272
      LOG.trace("Extraction is disabled for '{}' hence just moving the downloaded file {}.", this.tool, downloadedToolFile);
6✔
273
    }
274
    this.context.getFileAccess().extract(downloadedToolFile, installationPath, this::postExtract, extract);
9✔
275
  }
1✔
276

277
  /**
278
   * @param request the {@link ToolInstallRequest}.
279
   * @return the {@link Path} to the downloaded tool file.
280
   */
281
  protected Path getDownloadedToolFile(ToolInstallRequest request) {
282

283
    ToolEditionAndVersion requested = request.getRequested();
3✔
284
    VersionIdentifier resolvedVersion = requested.getResolvedVersion();
3✔
285
    return downloadTool(requested.getEdition().edition(), resolvedVersion);
7✔
286
  }
287

288
  /**
289
   * Hook to install dependencies of this tool.
290
   *
291
   * @param request the {@link ToolInstallRequest}.
292
   */
293
  protected void installDependencies(ToolInstallRequest request) {
294

295
    // nothing to do by default...
296
  }
1✔
297

298
  /**
299
   * @param edition the {@link #getConfiguredEdition() tool edition} to download.
300
   * @param resolvedVersion the resolved {@link VersionIdentifier version} to download.
301
   * @return the {@link Path} to the downloaded release file.
302
   */
303
  protected Path downloadTool(String edition, VersionIdentifier resolvedVersion) {
304
    return getToolRepository().download(this.tool, edition, resolvedVersion, this);
9✔
305
  }
306

307
  /**
308
   * Install this tool as dependency of another tool.
309
   *
310
   * @param versionRange the required {@link VersionRange}. See {@link ToolDependency#versionRange()}.
311
   * @param parentRequest the {@link ToolInstallRequest} of the tool causing this dependency.
312
   * @return the corresponding {@link ToolInstallation}.
313
   */
314
  public ToolInstallation installAsDependency(VersionRange versionRange, ToolInstallRequest parentRequest) {
315
    ToolInstallRequest request = new ToolInstallRequest(parentRequest);
5✔
316
    ToolEditionAndVersion requested = new ToolEditionAndVersion(getToolWithConfiguredEdition());
6✔
317
    request.setRequested(requested);
3✔
318
    VersionIdentifier configuredVersion = getConfiguredVersion();
3✔
319
    if (versionRange.contains(configuredVersion)) {
4✔
320
      // prefer configured version if contained in version range
321
      requested.setVersion(configuredVersion);
3✔
322
      // return install(true, configuredVersion, processContext, null);
323
      return install(request);
4✔
324
    } else {
325
      if (isIgnoreSoftwareRepo()) {
3!
326
        throw new IllegalStateException(
×
327
            "Cannot satisfy dependency to " + this.tool + " in version " + versionRange + " for " + parentRequest.getRequested()
×
328
                + " since it is conflicting with configured version "
329
                + configuredVersion
330
                + " and this tool does not support the software repository.");
331
      }
332
      LOG.info(
8✔
333
          "The tool {} requires {} in the version range {}, but your project uses version {}, which does not match."
334
              + " Therefore, we install a compatible version in that range.",
335
          parentRequest.getRequested().getEdition(), this.tool, versionRange, configuredVersion);
16✔
336
      requested.setVersion(versionRange);
3✔
337
      return installTool(request);
4✔
338
    }
339
  }
340

341
  /**
342
   * Installs the tool dependencies for the current tool.
343
   *
344
   * @param request the {@link ToolInstallRequest}.
345
   */
346
  protected void installToolDependencies(ToolInstallRequest request) {
347

348
    ToolEditionAndVersion requested = request.getRequested();
3✔
349
    VersionIdentifier version = requested.getResolvedVersion();
3✔
350
    ToolEdition toolEdition = requested.getEdition();
3✔
351
    Collection<ToolDependency> dependencies = getToolRepository().findDependencies(this.tool, toolEdition.edition(), version);
9✔
352
    int size = dependencies.size();
3✔
353
    LOG.debug("Tool {} has {} other tool(s) as dependency", toolEdition, size);
6✔
354
    for (ToolDependency dependency : dependencies) {
10✔
355
      LOG.trace("Ensuring dependency {} for tool {}", dependency.tool(), toolEdition);
6✔
356
      LocalToolCommandlet dependencyTool = this.context.getCommandletManager().getRequiredLocalToolCommandlet(dependency.tool());
7✔
357
      dependencyTool.installAsDependency(dependency.versionRange(), request);
6✔
358
    }
1✔
359
  }
1✔
360

361
  /**
362
   * Post-extraction hook that can be overridden to add custom processing after unpacking and before moving to the final destination folder.
363
   *
364
   * @param extractedDir the {@link Path} to the folder with the unpacked tool.
365
   */
366
  protected void postExtract(Path extractedDir) {
367

368
  }
1✔
369

370
  @Override
371
  public VersionIdentifier getInstalledVersion() {
372

373
    return getInstalledVersion(getToolPath());
5✔
374
  }
375

376
  /**
377
   * @param toolPath the installation {@link Path} where to find the version file.
378
   * @return the currently installed {@link VersionIdentifier version} of this tool or {@code null} if not installed.
379
   */
380
  protected VersionIdentifier getInstalledVersion(Path toolPath) {
381

382
    if (isToolNotInstalled(toolPath)) {
4✔
383
      return null;
2✔
384
    }
385
    Path versionLookupPath = getInstalledSoftwareRepoPath(toolPath, false);
5✔
386
    if (versionLookupPath == null) {
2✔
387
      versionLookupPath = toolPath;
2✔
388
    }
389
    Path toolVersionFile = versionLookupPath.resolve(IdeContext.FILE_SOFTWARE_VERSION);
4✔
390
    if (!Files.exists(toolVersionFile)) {
5✔
391
      Path legacyToolVersionFile = versionLookupPath.resolve(IdeContext.FILE_LEGACY_SOFTWARE_VERSION);
4✔
392
      if (Files.exists(legacyToolVersionFile)) {
5!
393
        toolVersionFile = legacyToolVersionFile;
3✔
394
      } else {
395
        LOG.warn("Tool {} is missing version file in {}", getName(), toolVersionFile);
×
396
        return null;
×
397
      }
398
    }
399
    String version = this.context.getFileAccess().readFileContent(toolVersionFile).trim();
7✔
400
    return VersionIdentifier.of(version);
3✔
401
  }
402

403
  @Override
404
  public String getInstalledEdition() {
405

406
    return getInstalledEdition(getToolPath());
5✔
407
  }
408

409
  /**
410
   * @param toolPath the installation {@link Path} where to find currently installed tool. The name of the parent directory of the real path corresponding
411
   *     to the passed {@link Path path} must be the name of the edition.
412
   * @return the installed edition of this tool or {@code null} if not installed.
413
   */
414
  protected String getInstalledEdition(Path toolPath) {
415
    if (isToolNotInstalled(toolPath)) {
4✔
416
      return null;
2✔
417
    }
418
    Path realPath = this.context.getFileAccess().toRealPath(toolPath);
6✔
419
    // if the realPath changed, a link has been resolved
420
    if (realPath.equals(toolPath)) {
4✔
421
      if (!isIgnoreSoftwareRepo()) {
3✔
422
        LOG.warn("Tool {} is not installed via software repository (maybe from devonfw-ide). Please consider reinstalling it.", this.tool);
5✔
423
      }
424
      // I do not see any reliable way how we could determine the edition of a tool that does not use software repo or that was installed by devonfw-ide
425
      return getConfiguredEdition();
3✔
426
    }
427
    Path toolRepoFolder = context.getSoftwareRepositoryPath().resolve(ToolRepository.ID_DEFAULT).resolve(this.tool);
9✔
428
    String edition = getEdition(toolRepoFolder, realPath);
5✔
429
    if (edition == null) {
2!
430
      edition = this.tool;
×
431
    }
432
    if (!getToolRepository().getSortedEditions(this.tool).contains(edition)) {
8✔
433
      LOG.warn("Undefined edition {} of tool {}", edition, this.tool);
6✔
434
    }
435
    return edition;
2✔
436
  }
437

438
  private String getEdition(Path toolRepoFolder, Path toolInstallFolder) {
439

440
    int toolRepoNameCount = toolRepoFolder.getNameCount();
3✔
441
    int toolInstallNameCount = toolInstallFolder.getNameCount();
3✔
442
    if (toolRepoNameCount < toolInstallNameCount) {
3!
443
      // ensure toolInstallFolder starts with $IDE_ROOT/_ide/software/default/«tool»
444
      for (int i = 0; i < toolRepoNameCount; i++) {
7✔
445
        if (!toolRepoFolder.getName(i).toString().equals(toolInstallFolder.getName(i).toString())) {
10!
446
          return null;
×
447
        }
448
      }
449
      return toolInstallFolder.getName(toolRepoNameCount).toString();
5✔
450
    }
451
    return null;
×
452
  }
453

454
  private Path getInstalledSoftwareRepoPath(Path toolPath) {
455
    return getInstalledSoftwareRepoPath(toolPath, false);
×
456
  }
457

458
  private Path getInstalledSoftwareRepoPath(Path toolPath, boolean logIfNotSoftwareRepo) {
459
    if (isToolNotInstalled(toolPath)) {
4!
460
      return null;
×
461
    }
462
    Path installPath = this.context.getFileAccess().toRealPath(toolPath);
6✔
463
    // if the installPath changed, a link has been resolved
464
    if (installPath.equals(toolPath)) {
4✔
465
      if (logIfNotSoftwareRepo && !isIgnoreSoftwareRepo()) {
2!
466
        LOG.warn("Tool {} is not installed via software repository (maybe from devonfw-ide). Please consider reinstalling it.", this.tool);
×
467
      }
468
      // I do not see any reliable way how we could determine the edition of a tool that does not use software repo or that was installed by devonfw-ide
469
      return null;
2✔
470
    }
471
    installPath = getValidInstalledSoftwareRepoPath(installPath, context.getSoftwareRepositoryPath());
7✔
472
    return installPath;
2✔
473
  }
474

475
  Path getValidInstalledSoftwareRepoPath(Path installPath, Path softwareRepoPath) {
476
    int softwareRepoNameCount = softwareRepoPath.getNameCount();
3✔
477
    int toolInstallNameCount = installPath.getNameCount();
3✔
478
    int targetToolInstallNameCount = softwareRepoNameCount + 4;
4✔
479

480
    // installPath can't be shorter than softwareRepoPath
481
    if (toolInstallNameCount < softwareRepoNameCount) {
3!
482
      LOG.warn("The installation path is not located within the software repository {}.", installPath);
×
483
      return null;
×
484
    }
485
    // ensure installPath starts with $IDE_ROOT/_ide/software/
486
    for (int i = 0; i < softwareRepoNameCount; i++) {
7✔
487
      if (!softwareRepoPath.getName(i).toString().equals(installPath.getName(i).toString())) {
10✔
488
        LOG.warn("The installation path is not located within the software repository {}.", installPath);
4✔
489
        return null;
2✔
490
      }
491
    }
492
    // return $IDE_ROOT/_ide/software/«id»/«tool»/«edition»/«version»
493
    if (toolInstallNameCount == targetToolInstallNameCount) {
3✔
494
      return installPath;
2✔
495
    } else if (toolInstallNameCount > targetToolInstallNameCount) {
3✔
496
      Path validInstallPath = installPath;
2✔
497
      for (int i = 0; i < toolInstallNameCount - targetToolInstallNameCount; i++) {
9✔
498
        validInstallPath = validInstallPath.getParent();
3✔
499
      }
500
      return validInstallPath;
2✔
501
    } else {
502
      LOG.warn("The installation path is faulty {}.", installPath);
4✔
503
      return null;
2✔
504
    }
505
  }
506

507
  private boolean isToolNotInstalled(Path toolPath) {
508

509
    if ((toolPath == null) || !Files.isDirectory(toolPath)) {
7!
510
      LOG.debug("Tool {} not installed in {}", this.tool, toolPath);
6✔
511
      return true;
2✔
512
    }
513
    return false;
2✔
514
  }
515

516
  @Override
517
  public void uninstall() {
518
    try {
519
      Path toolPath = getToolPath();
3✔
520
      if (!Files.exists(toolPath)) {
5!
521
        LOG.warn("An installed version of {} does not exist.", this.tool);
×
522
        return;
×
523
      }
524
      if (this.context.isForceMode() && !isIgnoreSoftwareRepo()) {
7!
525
        LOG.warn(
6✔
526
            "You triggered an uninstall of {} in version {} with force mode!\n"
527
                + "This will physically delete the currently installed version including its plugins from the machine.\n"
528
                + "This may cause issues with other projects, that use the same version of that tool."
529
            , this.tool, getInstalledVersion());
1✔
530
        uninstallPluginsOfTool();
2✔
531
        uninstallFromSoftwareRepository(toolPath);
3✔
532
      }
533
      performUninstall(toolPath);
3✔
534
      IdeLogLevel.SUCCESS.log(LOG, "Successfully uninstalled {}", this.tool);
11✔
535
    } catch (Exception e) {
×
536
      LOG.error("Failed to uninstall {}", this.tool, e);
×
537
    }
1✔
538
  }
1✔
539

540
  /**
541
   * Performs the actual uninstallation of this tool.
542
   *
543
   * @param toolPath the current {@link #getToolPath() tool path}.
544
   */
545
  protected void performUninstall(Path toolPath) {
546
    this.context.getFileAccess().delete(toolPath);
5✔
547
  }
1✔
548

549
  /**
550
   * Deletes the installed version of the tool from the shared software repository.
551
   */
552
  private void uninstallFromSoftwareRepository(Path toolPath) {
553
    Path repoPath = getInstalledSoftwareRepoPath(toolPath, true);
5✔
554
    if ((repoPath == null) || !Files.exists(repoPath)) {
7!
555
      LOG.warn("An installed version of {} does not exist in software repository.", this.tool);
×
556
      return;
×
557
    }
558
    LOG.info("Physically deleting {} as requested by the user via force mode.", repoPath);
4✔
559
    this.context.getFileAccess().delete(repoPath);
5✔
560
    IdeLogLevel.SUCCESS.log(LOG, "Successfully deleted {} from your computer.", repoPath);
10✔
561
  }
1✔
562

563
  /**
564
   * Deletes the installed plugins of the tool from the plugins path.
565
   */
566
  private void uninstallPluginsOfTool() {
567

568
    Path toolPluginsPath = this.context.getPluginsPath().resolve(this.tool);
7✔
569
    if (!Files.exists(toolPluginsPath)) {
5!
570
      LOG.info("There are no plugins of {} present to delete.", this.tool);
5✔
571
      return;
1✔
572
    }
573
    LOG.info("Physically deleting {} as requested by the user via force mode.", toolPluginsPath);
×
574
    this.context.getFileAccess().delete(toolPluginsPath);
×
575
    IdeLogLevel.SUCCESS.log(LOG, "Successfully deleted {} from your computer.", toolPluginsPath);
×
576
  }
×
577

578
  @Override
579
  protected Path getInstallationPath(String edition, VersionIdentifier resolvedVersion) {
580
    Path installationPath;
581
    if (isIgnoreSoftwareRepo()) {
3✔
582
      installationPath = getToolPath();
4✔
583
    } else {
584
      Path softwareRepositoryPath = this.context.getSoftwareRepositoryPath();
4✔
585
      if (softwareRepositoryPath == null) {
2!
586
        return null;
×
587
      }
588
      Path softwareRepoPath = softwareRepositoryPath.resolve(getToolRepository().getId()).resolve(this.tool).resolve(edition);
11✔
589
      installationPath = softwareRepoPath.resolve(resolvedVersion.toString());
5✔
590
    }
591
    return installationPath;
2✔
592
  }
593

594
  /**
595
   * @return {@link VersionIdentifier} with latest version of the tool}.
596
   */
597
  public VersionIdentifier getLatestToolVersion() {
598

599
    return this.context.getDefaultToolRepository().resolveVersion(this.tool, getConfiguredEdition(), VersionIdentifier.LATEST, this);
×
600
  }
601

602

603
  /**
604
   * Searches for a wrapper file in valid projects (containing a build file f.e. build.gradle or pom.xml) and returns its path.
605
   *
606
   * @param wrapperFileName the name of the wrapper file
607
   * @return Path of the wrapper file or {@code null} if none was found.
608
   */
609
  protected Path findWrapper(String wrapperFileName) {
610
    Path dir = this.context.getCwd();
4✔
611
    // traverse the cwd directory containing a build descriptor up till a wrapper file was found
612
    while ((dir != null) && (findBuildDescriptor(dir) != null)) {
6!
613
      Path wrapper = dir.resolve(wrapperFileName);
4✔
614
      if (Files.exists(wrapper)) {
5✔
615
        LOG.debug("Using wrapper: {}", wrapper);
4✔
616
        return wrapper;
2✔
617
      }
618
      dir = dir.getParent();
3✔
619
    }
1✔
620
    return null;
2✔
621
  }
622

623
  /**
624
   * @param directory the {@link Path} to the build directory.
625
   * @return the build configuration file for this tool or {@code null} if not found (or this is not a build tool).
626
   */
627
  public Path findBuildDescriptor(Path directory) {
628
    return null;
2✔
629
  }
630
}
STATUS · Troubleshooting · Open an Issue · Sales · Support · CAREERS · ENTERPRISE · START FREE · SCHEDULE DEMO
ANNOUNCEMENTS · TWITTER · TOS & SLA · Supported CI Services · What's a CI service? · Automated Testing

© 2026 Coveralls, Inc