1 | |
package org.apache.maven.plugins.shade.mojo; |
2 | |
|
3 | |
import java.util.ArrayList; |
4 | |
import java.util.Iterator; |
5 | |
import java.util.List; |
6 | |
|
7 | |
import org.apache.maven.plugin.AbstractMojo; |
8 | |
import org.apache.maven.plugin.MojoExecutionException; |
9 | |
|
10 | |
|
11 | |
|
12 | |
|
13 | |
|
14 | |
|
15 | |
|
16 | |
|
17 | |
|
18 | 0 | public class HelpMojo |
19 | |
extends AbstractMojo |
20 | |
{ |
21 | |
|
22 | |
|
23 | |
|
24 | |
|
25 | |
|
26 | |
private boolean detail; |
27 | |
|
28 | |
|
29 | |
|
30 | |
|
31 | |
|
32 | |
|
33 | |
private java.lang.String goal; |
34 | |
|
35 | |
|
36 | |
|
37 | |
|
38 | |
|
39 | |
|
40 | |
private int lineLength; |
41 | |
|
42 | |
|
43 | |
|
44 | |
|
45 | |
|
46 | |
|
47 | |
private int indentSize; |
48 | |
|
49 | |
|
50 | |
|
51 | |
public void execute() |
52 | |
throws MojoExecutionException |
53 | |
{ |
54 | 0 | if ( lineLength <= 0 ) |
55 | |
{ |
56 | 0 | getLog().warn( "The parameter 'lineLength' should be positive, using '80' as default." ); |
57 | 0 | lineLength = 80; |
58 | |
} |
59 | 0 | if ( indentSize <= 0 ) |
60 | |
{ |
61 | 0 | getLog().warn( "The parameter 'indentSize' should be positive, using '2' as default." ); |
62 | 0 | indentSize = 2; |
63 | |
} |
64 | |
|
65 | 0 | StringBuffer sb = new StringBuffer(); |
66 | |
|
67 | 0 | append( sb, "org.apache.maven.plugins:maven-shade-plugin:1.4", 0 ); |
68 | 0 | append( sb, "", 0 ); |
69 | |
|
70 | 0 | append( sb, "Maven Shade Plugin", 0 ); |
71 | 0 | append( sb, "Repackages the project classes together with their dependencies into a single uber-jar, optionally renaming classes or removing unused classes.", 1 ); |
72 | 0 | append( sb, "", 0 ); |
73 | |
|
74 | 0 | if ( goal == null || goal.length() <= 0 ) |
75 | |
{ |
76 | 0 | append( sb, "This plugin has 2 goals:", 0 ); |
77 | 0 | append( sb, "", 0 ); |
78 | |
} |
79 | |
|
80 | 0 | if ( goal == null || goal.length() <= 0 || "help".equals( goal ) ) |
81 | |
{ |
82 | 0 | append( sb, "shade:help", 0 ); |
83 | 0 | append( sb, "Display help information on maven-shade-plugin.\nCall\n\u00a0\u00a0mvn\u00a0shade:help\u00a0-Ddetail=true\u00a0-Dgoal=<goal-name>\nto display parameter details.", 1 ); |
84 | 0 | append( sb, "", 0 ); |
85 | 0 | if ( detail ) |
86 | |
{ |
87 | 0 | append( sb, "Available parameters:", 1 ); |
88 | 0 | append( sb, "", 0 ); |
89 | |
|
90 | 0 | append( sb, "detail (Default: false)", 2 ); |
91 | 0 | append( sb, "If true, display all settable properties for each goal.", 3 ); |
92 | 0 | append( sb, "", 0 ); |
93 | |
|
94 | 0 | append( sb, "goal", 2 ); |
95 | 0 | append( sb, "The name of the goal for which to show help. If unspecified, all goals will be displayed.", 3 ); |
96 | 0 | append( sb, "", 0 ); |
97 | |
|
98 | 0 | append( sb, "indentSize (Default: 2)", 2 ); |
99 | 0 | append( sb, "The number of spaces per indentation level, should be positive.", 3 ); |
100 | 0 | append( sb, "", 0 ); |
101 | |
|
102 | 0 | append( sb, "lineLength (Default: 80)", 2 ); |
103 | 0 | append( sb, "The maximum length of a display line, should be positive.", 3 ); |
104 | 0 | append( sb, "", 0 ); |
105 | |
} |
106 | |
} |
107 | |
|
108 | 0 | if ( goal == null || goal.length() <= 0 || "shade".equals( goal ) ) |
109 | |
{ |
110 | 0 | append( sb, "shade:shade", 0 ); |
111 | 0 | append( sb, "Mojo that performs shading delegating to the Shader component.", 1 ); |
112 | 0 | append( sb, "", 0 ); |
113 | 0 | if ( detail ) |
114 | |
{ |
115 | 0 | append( sb, "Available parameters:", 1 ); |
116 | 0 | append( sb, "", 0 ); |
117 | |
|
118 | 0 | append( sb, "artifactSet", 2 ); |
119 | 0 | append( sb, "Artifacts to include/exclude from the final artifact. Artifacts are denoted by composite identifiers of the general form groupId:artifactId:type:classifier. Since version 1.3, the wildcard characters \'*\' and \'?\' can be used within the sub parts of those composite identifiers to do pattern matching. For convenience, the syntax groupId is equivalent to groupId:*:*:*, groupId:artifactId is equivalent to groupId:artifactId:*:* and groupId:artifactId:classifier is equivalent to groupId:artifactId:*:classifier. For example:\n<artifactSet>\n\u00a0\u00a0<includes>\n\u00a0\u00a0\u00a0\u00a0<include>org.apache.maven:*</include>\n\u00a0\u00a0</includes>\n\u00a0\u00a0<excludes>\n\u00a0\u00a0\u00a0\u00a0<exclude>*:maven-core</exclude>\n\u00a0\u00a0</excludes>\n</artifactSet>\n", 3 ); |
120 | 0 | append( sb, "", 0 ); |
121 | |
|
122 | 0 | append( sb, "createDependencyReducedPom (Default: true)", 2 ); |
123 | 0 | append( sb, "Flag whether to generate a simplified POM for the shaded artifact. If set to true, dependencies that have been included into the uber JAR will be removed from the <dependencies> section of the generated POM. The reduced POM will be named dependency-reduced-pom.xml and is stored into the same directory as the shaded artifact.", 3 ); |
124 | 0 | append( sb, "", 0 ); |
125 | |
|
126 | 0 | append( sb, "createSourcesJar (Default: false)", 2 ); |
127 | 0 | append( sb, "When true, it will attempt to create a sources jar as well", 3 ); |
128 | 0 | append( sb, "", 0 ); |
129 | |
|
130 | 0 | append( sb, "filters", 2 ); |
131 | 0 | append( sb, "Archive Filters to be used. Allows you to specify an artifact in the form of a composite identifier as used by artifactSet and a set of include/exclude file patterns for filtering which contents of the archive are added to the shaded jar. From a logical perspective, includes are processed before excludes, thus it\'s possible to use an include to collect a set of files from the archive then use excludes to further reduce the set. By default, all files are included and no files are excluded. If multiple filters apply to an artifact, the intersection of the matched files will be included in the final JAR. For example:\n<filters>\n\u00a0\u00a0<filter>\n\u00a0\u00a0\u00a0\u00a0<artifact>junit:junit</artifact>\n\u00a0\u00a0\u00a0\u00a0<includes>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<include>org/junit/**</include>\n\u00a0\u00a0\u00a0\u00a0</includes>\n\u00a0\u00a0\u00a0\u00a0<excludes>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<exclude>org/junit/experimental/**</exclude>\n\u00a0\u00a0\u00a0\u00a0</excludes>\n\u00a0\u00a0</filter>\n</filters>\n", 3 ); |
132 | 0 | append( sb, "", 0 ); |
133 | |
|
134 | 0 | append( sb, "finalName", 2 ); |
135 | 0 | append( sb, "The name of the shaded artifactId. If you like to change the name of the native artifact, you may use the <build><finalName> setting. If this is set to something different than <build><finalName>, no file replacement will be performed, even if shadedArtifactAttached is being used.", 3 ); |
136 | 0 | append( sb, "", 0 ); |
137 | |
|
138 | 0 | append( sb, "keepDependenciesWithProvidedScope (Default: false)", 2 ); |
139 | 0 | append( sb, "When true, dependencies are kept in the pom but with scope \'provided\'; when false, the dependency is removed.", 3 ); |
140 | 0 | append( sb, "", 0 ); |
141 | |
|
142 | 0 | append( sb, "minimizeJar (Default: false)", 2 ); |
143 | 0 | append( sb, "When true, dependencies will be stripped down on the class level to only the transitive hull required for the artifact. Note: Usage of this feature requires Java 1.5 or higher.", 3 ); |
144 | 0 | append( sb, "", 0 ); |
145 | |
|
146 | 0 | append( sb, "outputDirectory (Default: ${project.build.directory})", 2 ); |
147 | 0 | append( sb, "The destination directory for the shaded artifact.", 3 ); |
148 | 0 | append( sb, "", 0 ); |
149 | |
|
150 | 0 | append( sb, "outputFile", 2 ); |
151 | 0 | append( sb, "The path to the output file for the shaded artifact. When this parameter is set, the created archive will neither replace the project\'s main artifact nor will it be attached. Hence, this parameter causes the parameters finalName, shadedArtifactAttached, shadedClassifierName and createDependencyReducedPom to be ignored when used.", 3 ); |
152 | 0 | append( sb, "", 0 ); |
153 | |
|
154 | 0 | append( sb, "promoteTransitiveDependencies (Default: false)", 2 ); |
155 | 0 | append( sb, "When true, transitive deps of removed dependencies are promoted to direct dependencies. This should allow the drop in replacement of the removed deps with the new shaded jar and everything should still work.", 3 ); |
156 | 0 | append( sb, "", 0 ); |
157 | |
|
158 | 0 | append( sb, "relocations", 2 ); |
159 | 0 | append( sb, "Packages to be relocated. For example:\n<relocations>\n\u00a0\u00a0<relocation>\n\u00a0\u00a0\u00a0\u00a0<pattern>org.apache</pattern>\n\u00a0\u00a0\u00a0\u00a0<shadedPattern>hidden.org.apache</shadedPattern>\n\u00a0\u00a0\u00a0\u00a0<includes>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<include>org.apache.maven.*</include>\n\u00a0\u00a0\u00a0\u00a0</includes>\n\u00a0\u00a0\u00a0\u00a0<excludes>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<exclude>org.apache.maven.Public*</exclude>\n\u00a0\u00a0\u00a0\u00a0</excludes>\n\u00a0\u00a0</relocation>\n</relocations>\nNote: Support for includes exists only since version 1.4.", 3 ); |
160 | 0 | append( sb, "", 0 ); |
161 | |
|
162 | 0 | append( sb, "shadedArtifactAttached (Default: false)", 2 ); |
163 | 0 | append( sb, "Defines whether the shaded artifact should be attached as classifier to the original artifact. If false, the shaded jar will be the main artifact of the project", 3 ); |
164 | 0 | append( sb, "", 0 ); |
165 | |
|
166 | 0 | append( sb, "shadedArtifactId (Default: ${project.artifactId})", 2 ); |
167 | 0 | append( sb, "The name of the shaded artifactId. So you may want to use a different artifactId and keep the standard version. If the original artifactId was \'foo\' then the final artifact would be something like foo-1.0.jar. So if you change the artifactId you might have something like foo-special-1.0.jar.", 3 ); |
168 | 0 | append( sb, "", 0 ); |
169 | |
|
170 | 0 | append( sb, "shadedClassifierName (Default: shaded)", 2 ); |
171 | 0 | append( sb, "The name of the classifier used in case the shaded artifact is attached.", 3 ); |
172 | 0 | append( sb, "", 0 ); |
173 | |
|
174 | 0 | append( sb, "shadedGroupFilter", 2 ); |
175 | 0 | append( sb, "If specified, this will include only artifacts which have groupIds which start with this.", 3 ); |
176 | 0 | append( sb, "", 0 ); |
177 | |
|
178 | 0 | append( sb, "transformers", 2 ); |
179 | 0 | append( sb, "Resource transformers to be used. Please see the \'Examples\' section for more information on available transformers and their configuration.", 3 ); |
180 | 0 | append( sb, "", 0 ); |
181 | |
} |
182 | |
} |
183 | |
|
184 | 0 | if ( getLog().isInfoEnabled() ) |
185 | |
{ |
186 | 0 | getLog().info( sb.toString() ); |
187 | |
} |
188 | 0 | } |
189 | |
|
190 | |
|
191 | |
|
192 | |
|
193 | |
|
194 | |
|
195 | |
|
196 | |
|
197 | |
|
198 | |
|
199 | |
private static String repeat( String str, int repeat ) |
200 | |
{ |
201 | 0 | StringBuffer buffer = new StringBuffer( repeat * str.length() ); |
202 | |
|
203 | 0 | for ( int i = 0; i < repeat; i++ ) |
204 | |
{ |
205 | 0 | buffer.append( str ); |
206 | |
} |
207 | |
|
208 | 0 | return buffer.toString(); |
209 | |
} |
210 | |
|
211 | |
|
212 | |
|
213 | |
|
214 | |
|
215 | |
|
216 | |
|
217 | |
|
218 | |
|
219 | |
private void append( StringBuffer sb, String description, int indent ) |
220 | |
{ |
221 | 0 | for ( Iterator it = toLines( description, indent, indentSize, lineLength ).iterator(); it.hasNext(); ) |
222 | |
{ |
223 | 0 | sb.append( it.next().toString() ).append( '\n' ); |
224 | |
} |
225 | 0 | } |
226 | |
|
227 | |
|
228 | |
|
229 | |
|
230 | |
|
231 | |
|
232 | |
|
233 | |
|
234 | |
|
235 | |
|
236 | |
|
237 | |
private static List toLines( String text, int indent, int indentSize, int lineLength ) |
238 | |
{ |
239 | 0 | List lines = new ArrayList(); |
240 | |
|
241 | 0 | String ind = repeat( "\t", indent ); |
242 | 0 | String[] plainLines = text.split( "(\r\n)|(\r)|(\n)" ); |
243 | 0 | for ( int i = 0; i < plainLines.length; i++ ) |
244 | |
{ |
245 | 0 | toLines( lines, ind + plainLines[i], indentSize, lineLength ); |
246 | |
} |
247 | |
|
248 | 0 | return lines; |
249 | |
} |
250 | |
|
251 | |
|
252 | |
|
253 | |
|
254 | |
|
255 | |
|
256 | |
|
257 | |
|
258 | |
|
259 | |
private static void toLines( List lines, String line, int indentSize, int lineLength ) |
260 | |
{ |
261 | 0 | int lineIndent = getIndentLevel( line ); |
262 | 0 | StringBuffer buf = new StringBuffer( 256 ); |
263 | 0 | String[] tokens = line.split( " +" ); |
264 | 0 | for ( int i = 0; i < tokens.length; i++ ) |
265 | |
{ |
266 | 0 | String token = tokens[i]; |
267 | 0 | if ( i > 0 ) |
268 | |
{ |
269 | 0 | if ( buf.length() + token.length() >= lineLength ) |
270 | |
{ |
271 | 0 | lines.add( buf.toString() ); |
272 | 0 | buf.setLength( 0 ); |
273 | 0 | buf.append( repeat( " ", lineIndent * indentSize ) ); |
274 | |
} |
275 | |
else |
276 | |
{ |
277 | 0 | buf.append( ' ' ); |
278 | |
} |
279 | |
} |
280 | 0 | for ( int j = 0; j < token.length(); j++ ) |
281 | |
{ |
282 | 0 | char c = token.charAt( j ); |
283 | 0 | if ( c == '\t' ) |
284 | |
{ |
285 | 0 | buf.append( repeat( " ", indentSize - buf.length() % indentSize ) ); |
286 | |
} |
287 | 0 | else if ( c == '\u00A0' ) |
288 | |
{ |
289 | 0 | buf.append( ' ' ); |
290 | |
} |
291 | |
else |
292 | |
{ |
293 | 0 | buf.append( c ); |
294 | |
} |
295 | |
} |
296 | |
} |
297 | 0 | lines.add( buf.toString() ); |
298 | 0 | } |
299 | |
|
300 | |
|
301 | |
|
302 | |
|
303 | |
|
304 | |
|
305 | |
|
306 | |
private static int getIndentLevel( String line ) |
307 | |
{ |
308 | 0 | int level = 0; |
309 | 0 | for ( int i = 0; i < line.length() && line.charAt( i ) == '\t'; i++ ) |
310 | |
{ |
311 | 0 | level++; |
312 | |
} |
313 | 0 | for ( int i = level + 1; i <= level + 4 && i < line.length(); i++ ) |
314 | |
{ |
315 | 0 | if ( line.charAt( i ) == '\t' ) |
316 | |
{ |
317 | 0 | level++; |
318 | 0 | break; |
319 | |
} |
320 | |
} |
321 | 0 | return level; |
322 | |
} |
323 | |
} |