9907372175

Committed 12 Jul 2024 11:49AM UTC coverage: 61.142% (-0.02%) from 61.162%

Build # 9907372175

Build Type

push

github

Committed by

hohwille

Commit Message

fixed tests

Run Details

1997 of 3595 branches covered (55.55%)

Branch coverage included in aggregate %.

5296 of 8333 relevant lines covered (63.55%)

2.8 hits per line

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

47.06

cli/src/main/java/com/devonfw/tools/ide/tool/PluginBasedCommandlet.java

package com.devonfw.tools.ide.tool;

import java.nio.file.Files;
import java.nio.file.Path;
import java.util.List;
import java.util.Set;

import com.devonfw.tools.ide.cli.CliException;
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.ide.IdeToolCommandlet;
import com.devonfw.tools.ide.tool.ide.PluginDescriptor;
import com.devonfw.tools.ide.tool.ide.PluginDescriptorImpl;

/**
 * Base class for {@link LocalToolCommandlet}s that support plugins. It can automatically install configured plugins for the tool managed by this commandlet.
 */
public abstract class PluginBasedCommandlet extends LocalToolCommandlet {

  private PluginMaps pluginsMap;

  /**
   * The constructor.
   *
   * @param context the {@link IdeContext}.
   * @param tool the {@link #getName() tool name}.
   * @param tags the {@link #getTags() tags} classifying the tool. Should be created via {@link Set#of(Object) Set.of} method.
   */
  public PluginBasedCommandlet(IdeContext context, String tool, Set<Tag> tags) {

    super(context, tool, tags);
  }

  protected PluginMaps getPluginsMap() {

    if (this.pluginsMap == null) {
      PluginMaps map = new PluginMaps(this.context);

      // Load project-specific plugins
      Path pluginsPath = getPluginsConfigPath();
      loadPluginsFromDirectory(map, pluginsPath);

      // Load user-specific plugins, this is done after loading the project-specific plugins so the user can potentially
      // override plugins (e.g. change active flag).
      Path userPluginsPath = getUserHomePluginsConfigPath();
      loadPluginsFromDirectory(map, userPluginsPath);

      this.pluginsMap = map;
    }

    return this.pluginsMap;
  }

  private void loadPluginsFromDirectory(PluginMaps map, Path pluginsPath) {

    List<Path> children = this.context.getFileAccess()
        .listChildren(pluginsPath, p -> p.getFileName().toString().endsWith(IdeContext.EXT_PROPERTIES));
    for (Path child : children) {
      PluginDescriptor descriptor = PluginDescriptorImpl.of(child, this.context, isPluginUrlNeeded());
      map.add(descriptor);
    }
  }

  /**
   * @return {@code true} if {@link PluginDescriptor#getUrl() plugin URL} property is needed, {@code false} otherwise.
   */
  protected boolean isPluginUrlNeeded() {

    return false;
  }

  /**
   * @return the {@link Path} to the folder with the plugin configuration files inside the settings.
   */
  protected Path getPluginsConfigPath() {

    return this.context.getSettingsPath().resolve(this.tool).resolve(IdeContext.FOLDER_PLUGINS);
  }

  private Path getUserHomePluginsConfigPath() {

    return this.context.getUserHomeIde().resolve("settings").resolve(this.tool).resolve(IdeContext.FOLDER_PLUGINS);
  }

  /**
   * @return the {@link Path} where the plugins of this {@link IdeToolCommandlet} shall be installed.
   */
  public Path getPluginsInstallationPath() {

    return this.context.getPluginsPath().resolve(this.tool);
  }

  /**
   * @param plugin the {@link PluginDescriptor} to install.
   */
  public abstract void installPlugin(PluginDescriptor plugin);

  /**
   * @param plugin the {@link PluginDescriptor} to uninstall.
   */
  public void uninstallPlugin(PluginDescriptor plugin) {

    Path pluginsPath = getPluginsInstallationPath();
    if (!Files.isDirectory(pluginsPath)) {
      this.context.debug("Omitting to uninstall plugin {} ({}) as plugins folder does not exist at {}",
          plugin.getName(), plugin.getId(), pluginsPath);
      return;
    }
    FileAccess fileAccess = this.context.getFileAccess();
    Path match = fileAccess.findFirst(pluginsPath, p -> p.getFileName().toString().startsWith(plugin.getId()), false);
    if (match == null) {
      this.context.debug("Omitting to uninstall plugin {} ({}) as plugins folder does not contain a match at {}",
          plugin.getName(), plugin.getId(), pluginsPath);
      return;
    }
    fileAccess.delete(match);
  }

  /**
   * @param key the filename of the properties file configuring the requested plugin (typically excluding the ".properties" extension).
   * @return the {@link PluginDescriptor} for the given {@code key}.
   */
  public PluginDescriptor getPlugin(String key) {

    if (key == null) {
      return null;
    }
    if (key.endsWith(IdeContext.EXT_PROPERTIES)) {
      key = key.substring(0, key.length() - IdeContext.EXT_PROPERTIES.length());
    }

    PluginMaps pluginMaps = getPluginsMap();
    PluginDescriptor pluginDescriptor = pluginMaps.getByName(key);
    if (pluginDescriptor == null) {
      throw new CliException(
          "Could not find plugin " + key + " at " + getPluginsConfigPath().resolve(key) + ".properties");
    }
    return pluginDescriptor;
  }


  @Override
  protected boolean doInstall(boolean silent) {

    boolean newlyInstalled = super.doInstall(silent);
    // post installation...
    boolean installPlugins = newlyInstalled;
    Path pluginsInstallationPath = getPluginsInstallationPath();
    if (newlyInstalled) {
      this.context.getFileAccess().delete(pluginsInstallationPath);
    } else if (!Files.isDirectory(pluginsInstallationPath)) {
      installPlugins = true;
    }
    if (installPlugins) {
      PluginMaps pluginMaps = getPluginsMap();
      for (PluginDescriptor plugin : pluginMaps.getPlugins()) {
        if (plugin.isActive()) {
          installPlugin(plugin);
        } else {
          handleInstall4InactivePlugin(plugin);
        }
      }
    }
    return newlyInstalled;
  }

  /**
   * @param plugin the in{@link PluginDescriptor#isActive() active} {@link PluginDescriptor} that is skipped for regular plugin installation.
   */
  protected void handleInstall4InactivePlugin(PluginDescriptor plugin) {

    this.context.debug("Omitting installation of inactive plugin {} ({}).", plugin.getName(), plugin.getId());
  }
}

1	package com.devonfw.tools.ide.tool;
2
3	import java.nio.file.Files;
4	import java.nio.file.Path;
5	import java.util.List;
6	import java.util.Set;
7
8	import com.devonfw.tools.ide.cli.CliException;
9	import com.devonfw.tools.ide.common.Tag;
10	import com.devonfw.tools.ide.context.IdeContext;
11	import com.devonfw.tools.ide.io.FileAccess;
12	import com.devonfw.tools.ide.tool.ide.IdeToolCommandlet;
13	import com.devonfw.tools.ide.tool.ide.PluginDescriptor;
14	import com.devonfw.tools.ide.tool.ide.PluginDescriptorImpl;
15
16	/**
17	* Base class for {@link LocalToolCommandlet}s that support plugins. It can automatically install configured plugins for the tool managed by this commandlet.
18	*/
19	public abstract class PluginBasedCommandlet extends LocalToolCommandlet {
20
21	private PluginMaps pluginsMap;
22
23	/**
24	* The constructor.
25	*
26	* @param context the {@link IdeContext}.
27	* @param tool the {@link #getName() tool name}.
28	* @param tags the {@link #getTags() tags} classifying the tool. Should be created via {@link Set#of(Object) Set.of} method.
29	*/
30	public PluginBasedCommandlet(IdeContext context, String tool, Set<Tag> tags) {
31
32	super(context, tool, tags);	5✔
33	}	1✔
34
35	protected PluginMaps getPluginsMap() {
36
37	if (this.pluginsMap == null) {	3!
38	PluginMaps map = new PluginMaps(this.context);	6✔
39
40	// Load project-specific plugins
41	Path pluginsPath = getPluginsConfigPath();	3✔
42	loadPluginsFromDirectory(map, pluginsPath);	4✔
43
44	// Load user-specific plugins, this is done after loading the project-specific plugins so the user can potentially
45	// override plugins (e.g. change active flag).
46	Path userPluginsPath = getUserHomePluginsConfigPath();	3✔
47	loadPluginsFromDirectory(map, userPluginsPath);	4✔
48
49	this.pluginsMap = map;	3✔
50	}
51
52	return this.pluginsMap;	3✔
53	}
54
55	private void loadPluginsFromDirectory(PluginMaps map, Path pluginsPath) {
56
57	List<Path> children = this.context.getFileAccess()	5✔
58	.listChildren(pluginsPath, p -> p.getFileName().toString().endsWith(IdeContext.EXT_PROPERTIES));	8✔
59	for (Path child : children) {	10✔
60	PluginDescriptor descriptor = PluginDescriptorImpl.of(child, this.context, isPluginUrlNeeded());	7✔
61	map.add(descriptor);	3✔
62	}	1✔
63	}	1✔
64
65	/**
66	* @return {@code true} if {@link PluginDescriptor#getUrl() plugin URL} property is needed, {@code false} otherwise.
67	*/
68	protected boolean isPluginUrlNeeded() {
69
70	return false;	2✔
71	}
72
73	/**
74	* @return the {@link Path} to the folder with the plugin configuration files inside the settings.
75	*/
76	protected Path getPluginsConfigPath() {
77
78	return this.context.getSettingsPath().resolve(this.tool).resolve(IdeContext.FOLDER_PLUGINS);	9✔
79	}
80
81	private Path getUserHomePluginsConfigPath() {
82
83	return this.context.getUserHomeIde().resolve("settings").resolve(this.tool).resolve(IdeContext.FOLDER_PLUGINS);	11✔
84	}
85
86	/**
87	* @return the {@link Path} where the plugins of this {@link IdeToolCommandlet} shall be installed.
88	*/
89	public Path getPluginsInstallationPath() {
90
91	return this.context.getPluginsPath().resolve(this.tool);	7✔
92	}
93
94	/**
95	* @param plugin the {@link PluginDescriptor} to install.
96	*/
97	public abstract void installPlugin(PluginDescriptor plugin);
98
99	/**
100	* @param plugin the {@link PluginDescriptor} to uninstall.
101	*/
102	public void uninstallPlugin(PluginDescriptor plugin) {
103
104	Path pluginsPath = getPluginsInstallationPath();	×
105	if (!Files.isDirectory(pluginsPath)) {	×
106	this.context.debug("Omitting to uninstall plugin {} ({}) as plugins folder does not exist at {}",	×
107	plugin.getName(), plugin.getId(), pluginsPath);	×
108	return;	×
109	}
110	FileAccess fileAccess = this.context.getFileAccess();	×
111	Path match = fileAccess.findFirst(pluginsPath, p -> p.getFileName().toString().startsWith(plugin.getId()), false);	×
112	if (match == null) {	×
113	this.context.debug("Omitting to uninstall plugin {} ({}) as plugins folder does not contain a match at {}",	×
114	plugin.getName(), plugin.getId(), pluginsPath);	×
115	return;	×
116	}
117	fileAccess.delete(match);	×
118	}	×
119
120	/**
121	* @param key the filename of the properties file configuring the requested plugin (typically excluding the ".properties" extension).
122	* @return the {@link PluginDescriptor} for the given {@code key}.
123	*/
124	public PluginDescriptor getPlugin(String key) {
125
126	if (key == null) {	×
127	return null;	×
128	}
129	if (key.endsWith(IdeContext.EXT_PROPERTIES)) {	×
130	key = key.substring(0, key.length() - IdeContext.EXT_PROPERTIES.length());	×
131	}
132
133	PluginMaps pluginMaps = getPluginsMap();	×
134	PluginDescriptor pluginDescriptor = pluginMaps.getByName(key);	×
135	if (pluginDescriptor == null) {	×
136	throw new CliException(	×
137	"Could not find plugin " + key + " at " + getPluginsConfigPath().resolve(key) + ".properties");	×
138	}
139	return pluginDescriptor;	×
140	}
141
142
143	@Override
144	protected boolean doInstall(boolean silent) {
145
146	boolean newlyInstalled = super.doInstall(silent);	4✔
147	// post installation...
148	boolean installPlugins = newlyInstalled;	2✔
149	Path pluginsInstallationPath = getPluginsInstallationPath();	3✔
150	if (newlyInstalled) {	2✔
151	this.context.getFileAccess().delete(pluginsInstallationPath);	6✔
152	} else if (!Files.isDirectory(pluginsInstallationPath)) {	5!
153	installPlugins = true;	2✔
154	}
155	if (installPlugins) {	2!
156	PluginMaps pluginMaps = getPluginsMap();	3✔
157	for (PluginDescriptor plugin : pluginMaps.getPlugins()) {	7!
158	if (plugin.isActive()) {	×
159	installPlugin(plugin);	×
160	} else {
161	handleInstall4InactivePlugin(plugin);	×
162	}
163	}	×
164	}
165	return newlyInstalled;	2✔
166	}
167
168	/**
169	* @param plugin the in{@link PluginDescriptor#isActive() active} {@link PluginDescriptor} that is skipped for regular plugin installation.
170	*/
171	protected void handleInstall4InactivePlugin(PluginDescriptor plugin) {
172
173	this.context.debug("Omitting installation of inactive plugin {} ({}).", plugin.getName(), plugin.getId());	×
174	}	×
175	}

devonfw / IDEasy / 9907372175

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

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