View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one
3    * or more contributor license agreements.  See the NOTICE file
4    * distributed with this work for additional information
5    * regarding copyright ownership.  The ASF licenses this file
6    * to you under the Apache License, Version 2.0 (the
7    * "License"); you may not use this file except in compliance
8    * with the License.  You may obtain a copy of the License at
9    *
10   *   http://www.apache.org/licenses/LICENSE-2.0
11   *
12   * Unless required by applicable law or agreed to in writing,
13   * software distributed under the License is distributed on an
14   * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15   * KIND, either express or implied.  See the License for the
16   * specific language governing permissions and limitations
17   * under the License.
18   */
19  package org.apache.maven.api;
20  
21  import org.apache.maven.api.annotations.Config;
22  
23  /**
24   * Configuration constants.
25   */
26  public final class Constants {
27  
28      /**
29       * Maven home.
30       *
31       * @since 3.0.0
32       */
33      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
34      public static final String MAVEN_HOME = "maven.home";
35  
36      /**
37       * Maven version.
38       *
39       * @since 3.0.0
40       */
41      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
42      public static final String MAVEN_VERSION = "maven.version";
43  
44      /**
45       * Maven major version: contains the major segment of this Maven version.
46       *
47       * @since 4.0.0
48       */
49      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
50      public static final String MAVEN_VERSION_MAJOR = "maven.version.major";
51  
52      /**
53       * Maven minor version: contains the minor segment of this Maven version.
54       *
55       * @since 4.0.0
56       */
57      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
58      public static final String MAVEN_VERSION_MINOR = "maven.version.minor";
59  
60      /**
61       * Maven patch version: contains the patch segment of this Maven version.
62       *
63       * @since 4.0.0
64       */
65      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
66      public static final String MAVEN_VERSION_PATCH = "maven.version.patch";
67  
68      /**
69       * Maven snapshot: contains "true" if this Maven is a snapshot version.
70       *
71       * @since 4.0.0
72       */
73      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
74      public static final String MAVEN_VERSION_SNAPSHOT = "maven.version.snapshot";
75  
76      /**
77       * Maven build version: a human-readable string containing this Maven version, buildnumber, and time of its build.
78       *
79       * @since 3.0.0
80       */
81      @Config(readOnly = true, source = Config.Source.SYSTEM_PROPERTIES)
82      public static final String MAVEN_BUILD_VERSION = "maven.build.version";
83  
84      /**
85       * Maven installation configuration directory.
86       *
87       * @since 4.0.0
88       */
89      @Config(defaultValue = "${maven.home}/conf")
90      public static final String MAVEN_INSTALLATION_CONF = "maven.installation.conf";
91  
92      /**
93       * Maven user configuration directory.
94       *
95       * @since 4.0.0
96       */
97      @Config(defaultValue = "${user.home}/.m2")
98      public static final String MAVEN_USER_CONF = "maven.user.conf";
99  
100     /**
101      * Maven project configuration directory.
102      *
103      * @since 4.0.0
104      */
105     @Config(defaultValue = "${session.rootDirectory}/.mvn")
106     public static final String MAVEN_PROJECT_CONF = "maven.project.conf";
107 
108     /**
109      * Maven local repository.
110      *
111      * @since 3.0.0
112      */
113     @Config(defaultValue = "${maven.user.conf}/repository")
114     public static final String MAVEN_REPO_LOCAL = "maven.repo.local";
115 
116     /**
117      * Maven central repository URL.
118      * The property will have the value of the <code>MAVEN_REPO_CENTRAL</code>
119      * environment variable if it is defined.
120      *
121      * @since 4.0.0
122      */
123     @Config(defaultValue = "https://repo.maven.apache.org/maven2")
124     public static final String MAVEN_REPO_CENTRAL = "maven.repo.central";
125 
126     /**
127      * Maven installation settings.
128      *
129      * @since 4.0.0
130      */
131     @Config(defaultValue = "${maven.installation.conf}/settings.xml")
132     public static final String MAVEN_INSTALLATION_SETTINGS = "maven.installation.settings";
133 
134     /**
135      * Maven user settings.
136      *
137      * @since 4.0.0
138      */
139     @Config(defaultValue = "${maven.user.conf}/settings.xml")
140     public static final String MAVEN_USER_SETTINGS = "maven.user.settings";
141 
142     /**
143      * Maven project settings.
144      *
145      * @since 4.0.0
146      */
147     @Config(defaultValue = "${maven.project.conf}/settings.xml")
148     public static final String MAVEN_PROJECT_SETTINGS = "maven.project.settings";
149 
150     /**
151      * Maven installation extensions.
152      *
153      * @since 4.0.0
154      */
155     @Config(defaultValue = "${maven.installation.conf}/extensions.xml")
156     public static final String MAVEN_INSTALLATION_EXTENSIONS = "maven.installation.extensions";
157 
158     /**
159      * Maven user extensions.
160      *
161      * @since 4.0.0
162      */
163     @Config(defaultValue = "${maven.user.conf}/extensions.xml")
164     public static final String MAVEN_USER_EXTENSIONS = "maven.user.extensions";
165 
166     /**
167      * Maven project extensions.
168      *
169      * @since 4.0.0
170      */
171     @Config(defaultValue = "${maven.project.conf}/extensions.xml")
172     public static final String MAVEN_PROJECT_EXTENSIONS = "maven.project.extensions";
173 
174     /**
175      * Maven installation toolchains.
176      *
177      * @since 4.0.0
178      */
179     @Config(defaultValue = "${maven.installation.conf}/toolchains.xml")
180     public static final String MAVEN_INSTALLATION_TOOLCHAINS = "maven.installation.toolchains";
181 
182     /**
183      * Maven user toolchains.
184      *
185      * @since 4.0.0
186      */
187     @Config(defaultValue = "${maven.user.conf}/toolchains.xml")
188     public static final String MAVEN_USER_TOOLCHAINS = "maven.user.toolchains";
189 
190     /**
191      * Extensions class path.
192      */
193     @Config
194     public static final String MAVEN_EXT_CLASS_PATH = "maven.ext.class.path";
195 
196     @Config(defaultValue = "${maven.user.conf}/settings-security4.xml")
197     public static final String MAVEN_SETTINGS_SECURITY = "maven.settings.security";
198 
199     public static final String MAVEN_SETTINGS_SECURITY_FILE_NAME = "settings-security4.xml";
200 
201     public static final String MAVEN_STYLE_PREFIX = "maven.style.";
202 
203     // Style Names
204     public static final String MAVEN_STYLE_TRANSFER_NAME = "transfer";
205     public static final String MAVEN_STYLE_TRACE_NAME = "trace";
206     public static final String MAVEN_STYLE_DEBUG_NAME = "debug";
207     public static final String MAVEN_STYLE_INFO_NAME = "info";
208     public static final String MAVEN_STYLE_WARNING_NAME = "warning";
209     public static final String MAVEN_STYLE_ERROR_NAME = "error";
210     public static final String MAVEN_STYLE_SUCCESS_NAME = "success";
211     public static final String MAVEN_STYLE_FAILURE_NAME = "failure";
212     public static final String MAVEN_STYLE_STRONG_NAME = "strong";
213     public static final String MAVEN_STYLE_MOJO_NAME = "mojo";
214     public static final String MAVEN_STYLE_PROJECT_NAME = "project";
215 
216     // Default Values
217     public static final String MAVEN_STYLE_TRANSFER_DEFAULT = "f:bright-black";
218     public static final String MAVEN_STYLE_TRACE_DEFAULT = "bold,f:magenta";
219     public static final String MAVEN_STYLE_DEBUG_DEFAULT = "bold,f:cyan";
220     public static final String MAVEN_STYLE_INFO_DEFAULT = "bold,f:blue";
221     public static final String MAVEN_STYLE_WARNING_DEFAULT = "bold,f:yellow";
222     public static final String MAVEN_STYLE_ERROR_DEFAULT = "bold,f:red";
223     public static final String MAVEN_STYLE_SUCCESS_DEFAULT = "bold,f:green";
224     public static final String MAVEN_STYLE_FAILURE_DEFAULT = "bold,f:red";
225     public static final String MAVEN_STYLE_STRONG_DEFAULT = "bold";
226     public static final String MAVEN_STYLE_MOJO_DEFAULT = "f:green";
227     public static final String MAVEN_STYLE_PROJECT_DEFAULT = "f:cyan";
228 
229     /**
230      * Maven output color mode.
231      * Allowed values are <code>auto</code>, <code>always</code>, <code>never</code>.
232      *
233      * @since 4.0.0
234      */
235     @Config(defaultValue = "auto")
236     public static final String MAVEN_STYLE_COLOR_PROPERTY = MAVEN_STYLE_PREFIX + "color";
237 
238     /**
239      * Color style for transfer messages.
240      * @since 4.0.0
241      */
242     @Config(defaultValue = MAVEN_STYLE_TRANSFER_DEFAULT)
243     public static final String MAVEN_STYLE_TRANSFER = MAVEN_STYLE_PREFIX + MAVEN_STYLE_TRANSFER_NAME;
244 
245     /**
246      * Color style for trace messages.
247      * @since 4.0.0
248      */
249     @Config(defaultValue = MAVEN_STYLE_TRACE_DEFAULT)
250     public static final String MAVEN_STYLE_TRACE = MAVEN_STYLE_PREFIX + MAVEN_STYLE_TRACE_NAME;
251 
252     /**
253      * Color style for debug messages.
254      * @since 4.0.0
255      */
256     @Config(defaultValue = MAVEN_STYLE_DEBUG_DEFAULT)
257     public static final String MAVEN_STYLE_DEBUG = MAVEN_STYLE_PREFIX + MAVEN_STYLE_DEBUG_NAME;
258 
259     /**
260      * Color style for info messages.
261      * @since 4.0.0
262      */
263     @Config(defaultValue = MAVEN_STYLE_INFO_DEFAULT)
264     public static final String MAVEN_STYLE_INFO = MAVEN_STYLE_PREFIX + MAVEN_STYLE_INFO_NAME;
265 
266     /**
267      * Color style for warning messages.
268      * @since 4.0.0
269      */
270     @Config(defaultValue = MAVEN_STYLE_WARNING_DEFAULT)
271     public static final String MAVEN_STYLE_WARNING = MAVEN_STYLE_PREFIX + MAVEN_STYLE_WARNING_NAME;
272 
273     /**
274      * Color style for error messages.
275      * @since 4.0.0
276      */
277     @Config(defaultValue = MAVEN_STYLE_ERROR_DEFAULT)
278     public static final String MAVEN_STYLE_ERROR = MAVEN_STYLE_PREFIX + MAVEN_STYLE_ERROR_NAME;
279 
280     /**
281      * Color style for success messages.
282      * @since 4.0.0
283      */
284     @Config(defaultValue = MAVEN_STYLE_SUCCESS_DEFAULT)
285     public static final String MAVEN_STYLE_SUCCESS = MAVEN_STYLE_PREFIX + MAVEN_STYLE_SUCCESS_NAME;
286 
287     /**
288      * Color style for failure messages.
289      * @since 4.0.0
290      */
291     @Config(defaultValue = MAVEN_STYLE_FAILURE_DEFAULT)
292     public static final String MAVEN_STYLE_FAILURE = MAVEN_STYLE_PREFIX + MAVEN_STYLE_FAILURE_NAME;
293 
294     /**
295      * Color style for strong messages.
296      * @since 4.0.0
297      */
298     @Config(defaultValue = MAVEN_STYLE_STRONG_DEFAULT)
299     public static final String MAVEN_STYLE_STRONG = MAVEN_STYLE_PREFIX + MAVEN_STYLE_STRONG_NAME;
300 
301     /**
302      * Color style for mojo messages.
303      * @since 4.0.0
304      */
305     @Config(defaultValue = MAVEN_STYLE_MOJO_DEFAULT)
306     public static final String MAVEN_STYLE_MOJO = MAVEN_STYLE_PREFIX + MAVEN_STYLE_MOJO_NAME;
307 
308     /**
309      * Color style for project messages.
310      * @since 4.0.0
311      */
312     @Config(defaultValue = MAVEN_STYLE_PROJECT_DEFAULT)
313     public static final String MAVEN_STYLE_PROJECT = MAVEN_STYLE_PREFIX + MAVEN_STYLE_PROJECT_NAME;
314 
315     /**
316      * Build timestamp format.
317      *
318      * @since 3.0.0
319      */
320     @Config(source = Config.Source.MODEL, defaultValue = "yyyy-MM-dd'T'HH:mm:ssXXX")
321     public static final String MAVEN_BUILD_TIMESTAMP_FORMAT = "maven.build.timestamp.format";
322 
323     /**
324      * User controlled relocations.
325      * This property is a comma separated list of entries with the syntax <code>GAV&gt;GAV</code>.
326      * The first <code>GAV</code> can contain <code>*</code> for any elem (so <code>*:*:*</code> would mean ALL, something
327      * you don't want). The second <code>GAV</code> is either fully specified, or also can contain <code>*</code>,
328      * then it behaves as "ordinary relocation": the coordinate is preserved from relocated artifact.
329      * Finally, if right hand <code>GAV</code> is absent (line looks like <code>GAV&gt;</code>), the left hand matching
330      * <code>GAV</code> is banned fully (from resolving).
331      * <br/>
332      * Note: the <code>&gt;</code> means project level, while <code>&gt;&gt;</code> means global (whole session level,
333      * so even plugins will get relocated artifacts) relocation.
334      * <br/>
335      * For example,
336      * <pre>maven.relocations.entries = org.foo:*:*>, \\<br/>    org.here:*:*>org.there:*:*, \\<br/>    javax.inject:javax.inject:1>>jakarta.inject:jakarta.inject:1.0.5</pre>
337      * means: 3 entries, ban <code>org.foo group</code> (exactly, so <code>org.foo.bar</code> is allowed),
338      * relocate <code>org.here</code> to <code>org.there</code> and finally globally relocate (see <code>&gt;&gt;</code> above)
339      * <code>javax.inject:javax.inject:1</code> to <code>jakarta.inject:jakarta.inject:1.0.5</code>.
340      *
341      * @since 4.0.0
342      */
343     @Config
344     public static final String MAVEN_RELOCATIONS_ENTRIES = "maven.relocations.entries";
345 
346     /**
347      * User property for version filter expression used in session, applied to resolving ranges: a semicolon separated
348      * list of filters to apply. By default, no version filter is applied (like in Maven 3).
349      * <br/>
350      * Supported filters:
351      * <ul>
352      *     <li>"h" or "h(num)" - highest version or top list of highest ones filter</li>
353      *     <li>"l" or "l(num)" - lowest version or bottom list of lowest ones filter</li>
354      *     <li>"s" - contextual snapshot filter</li>
355      *     <li>"e(G:A:V)" - predicate filter (leaves out G:A:V from range, if hit, V can be range)</li>
356      * </ul>
357      * Example filter expression: <code>"h(5);s;e(org.foo:bar:1)</code> will cause: ranges are filtered for "top 5" (instead
358      * full range), snapshots are banned if root project is not a snapshot, and if range for <code>org.foo:bar</code> is
359      * being processed, version 1 is omitted. Value in this property builds
360      * <code>org.eclipse.aether.collection.VersionFilter</code> instance.
361      *
362      * @since 4.0.0
363      */
364     @Config
365     public static final String MAVEN_VERSION_FILTER = "maven.session.versionFilter";
366 
367     /**
368      * User property for chained LRM: the new "head" local repository to use, and "push" the existing into tail.
369      * Similar to <code>maven.repo.local.tail</code>, this property may contain comma separated list of paths to be
370      * used as local repositories (combine with chained local repository), but while latter is "appending" this
371      * one is "prepending".
372      *
373      * @since 4.0.0
374      */
375     @Config
376     public static final String MAVEN_REPO_LOCAL_HEAD = "maven.repo.local.head";
377 
378     /**
379      * User property for chained LRM: list of "tail" local repository paths (separated by comma), to be used with
380      * <code>org.eclipse.aether.util.repository.ChainedLocalRepositoryManager</code>.
381      * Default value: <code>null</code>, no chained LRM is used.
382      *
383      * @since 3.9.0
384      */
385     @Config
386     public static final String MAVEN_REPO_LOCAL_TAIL = "maven.repo.local.tail";
387 
388     /**
389      * User property for chained LRM: whether to ignore "availability check" in tail or not. Usually you do want
390      * to ignore it. This property is mapped onto corresponding Resolver 2.x property, is like a synonym for it.
391      * Default value: <code>true</code>.
392      *
393      * @since 3.9.0
394      * @see <a href="https://maven.apache.org/resolver/configuration.html">Resolver Configuration: aether.chainedLocalRepository.ignoreTailAvailability</a>
395      */
396     @Config
397     public static final String MAVEN_REPO_LOCAL_TAIL_IGNORE_AVAILABILITY = "maven.repo.local.tail.ignoreAvailability";
398 
399     /**
400      * User property for reverse dependency tree. If enabled, Maven will record ".tracking" directory into local
401      * repository with "reverse dependency tree", essentially explaining WHY given artifact is present in local
402      * repository.
403      * Default: <code>false</code>, will not record anything.
404      *
405      * @since 3.9.0
406      */
407     @Config(defaultValue = "false")
408     public static final String MAVEN_REPO_LOCAL_RECORD_REVERSE_TREE = "maven.repo.local.recordReverseTree";
409 
410     /**
411      * User property for selecting dependency manager behaviour regarding transitive dependencies and dependency
412      * management entries in their POMs. Maven 3 targeted full backward compatibility with Maven2, hence it ignored
413      * dependency management entries in transitive dependency POMs. Maven 4 enables "transitivity" by default, hence
414      * unlike Maven2, obeys dependency management entries deep in dependency graph as well.
415      * <br/>
416      * Default: <code>"true"</code>.
417      *
418      * @since 4.0.0
419      */
420     @Config(defaultValue = "true")
421     public static final String MAVEN_RESOLVER_DEPENDENCY_MANAGER_TRANSITIVITY =
422             "maven.resolver.dependencyManagerTransitivity";
423 
424     /**
425      * Resolver transport to use.
426      * Can be <code>default</code>, <code>wagon</code>, <code>apache</code>, <code>jdk</code> or <code>auto</code>.
427      *
428      * @since 4.0.0
429      */
430     @Config(defaultValue = "default")
431     public static final String MAVEN_RESOLVER_TRANSPORT = "maven.resolver.transport";
432 
433     /**
434      * Plugin validation level.
435      *
436      * @since 3.9.2
437      */
438     @Config(defaultValue = "inline")
439     public static final String MAVEN_PLUGIN_VALIDATION = "maven.plugin.validation";
440 
441     /**
442      * Plugin validation exclusions.
443      *
444      * @since 3.9.6
445      */
446     @Config
447     public static final String MAVEN_PLUGIN_VALIDATION_EXCLUDES = "maven.plugin.validation.excludes";
448 
449     /**
450      * ProjectBuilder parallelism.
451      *
452      * @since 4.0.0
453      */
454     @Config(type = "java.lang.Integer", defaultValue = "cores/2 + 1")
455     public static final String MAVEN_MODEL_BUILDER_PARALLELISM = "maven.modelBuilder.parallelism";
456 
457     /**
458      * User property for enabling/disabling the consumer POM feature.
459      *
460      * @since 4.0.0
461      */
462     @Config(type = "java.lang.Boolean", defaultValue = "true")
463     public static final String MAVEN_CONSUMER_POM = "maven.consumer.pom";
464 
465     /**
466      * User property for controlling "maven personality". If activated Maven will behave
467      * as previous major version, Maven 3.
468      *
469      * @since 4.0.0
470      */
471     @Config(type = "java.lang.Boolean", defaultValue = "false")
472     public static final String MAVEN_MAVEN3_PERSONALITY = "maven.maven3Personality";
473 
474     /**
475      * User property for disabling version resolver cache.
476      *
477      * @since 3.0.0
478      */
479     @Config(type = "java.lang.Boolean", defaultValue = "false")
480     public static final String MAVEN_VERSION_RESOLVER_NO_CACHE = "maven.versionResolver.noCache";
481 
482     /**
483      * User property for overriding calculated "build number" for snapshot deploys. Caution: this property should
484      * be RARELY used (if used at all). It may help in special cases like "aligning" a reactor build subprojects
485      * build numbers to perform a "snapshot lock down". Value given here must be <code>maxRemoteBuildNumber + 1</code>
486      * or greater, otherwise build will fail. How the number to be obtained is left to user (ie by inspecting
487      * snapshot repository metadata or alike).
488      *
489      * Note: this feature is present in Maven 3.9.7 but with different key: <code>maven.buildNumber</code>. In Maven 4
490      * as part of cleanup effort this key was renamed to properly reflect its purpose.
491      *
492      * @since 4.0.0
493      */
494     @Config(type = "java.lang.Integer")
495     public static final String MAVEN_DEPLOY_SNAPSHOT_BUILD_NUMBER = "maven.deploy.snapshot.buildNumber";
496 
497     /**
498      * User property used to store the build timestamp.
499      *
500      * @since 4.0.0
501      */
502     @Config(type = "java.time.Instant")
503     public static final String MAVEN_START_INSTANT = "maven.startInstant";
504 
505     /**
506      * Max number of problems for each severity level retained by the model builder.
507      *
508      * @since 4.0.0
509      */
510     @Config(type = "java.lang.Integer", defaultValue = "100")
511     public static final String MAVEN_BUILDER_MAX_PROBLEMS = "maven.builder.maxProblems";
512 
513     /**
514      * All system properties used by Maven Logger start with this prefix.
515      *
516      * @since 4.0.0
517      */
518     public static final String MAVEN_LOGGER_PREFIX = "maven.logger.";
519 
520     /**
521      * Default log level for all instances of SimpleLogger. Must be one of ("trace", "debug", "info",
522      * "warn", "error" or "off"). If not specified, defaults to "info".
523      *
524      * @since 4.0.0
525      */
526     @Config
527     public static final String MAVEN_LOGGER_DEFAULT_LOG_LEVEL = MAVEN_LOGGER_PREFIX + "defaultLogLevel";
528 
529     /**
530      * Set to true if you want the current date and time to be included in output messages. Default is false.
531      *
532      * @since 4.0.0
533      */
534     @Config(type = "java.lang.Boolean", defaultValue = "false")
535     public static final String MAVEN_LOGGER_SHOW_DATE_TIME = MAVEN_LOGGER_PREFIX + "showDateTime";
536 
537     /**
538      * The date and time format to be used in the output messages. The pattern describing the date and
539      * time format is defined by SimpleDateFormat. If the format is not specified or is invalid, the
540      * number of milliseconds since start up will be output.
541      *
542      * @since 4.0.0
543      */
544     @Config
545     public static final String MAVEN_LOGGER_DATE_TIME_FORMAT = MAVEN_LOGGER_PREFIX + "dateTimeFormat";
546 
547     /**
548      * If you would like to output the current thread id, then set to true. Defaults to false.
549      *
550      * @since 4.0.0
551      */
552     @Config(type = "java.lang.Boolean", defaultValue = "false")
553     public static final String MAVEN_LOGGER_SHOW_THREAD_ID = MAVEN_LOGGER_PREFIX + "showThreadId";
554 
555     /**
556      * Set to true if you want to output the current thread name. Defaults to true.
557      *
558      * @since 4.0.0
559      */
560     @Config(type = "java.lang.Boolean", defaultValue = "true")
561     public static final String MAVEN_LOGGER_SHOW_THREAD_NAME = MAVEN_LOGGER_PREFIX + "showThreadName";
562 
563     /**
564      * Set to true if you want the Logger instance name to be included in output messages. Defaults to true.
565      *
566      * @since 4.0.0
567      */
568     @Config(type = "java.lang.Boolean", defaultValue = "true")
569     public static final String MAVEN_LOGGER_SHOW_LOG_NAME = MAVEN_LOGGER_PREFIX + "showLogName";
570 
571     /**
572      * Set to true if you want the last component of the name to be included in output messages. Defaults to false.
573      *
574      * @since 4.0.0
575      */
576     @Config(type = "java.lang.Boolean", defaultValue = "false")
577     public static final String MAVEN_LOGGER_SHOW_SHORT_LOG_NAME = MAVEN_LOGGER_PREFIX + "showShortLogName";
578 
579     /**
580      * The output target which can be the path to a file, or the special values "System.out" and "System.err".
581      * Default is "System.err".
582      *
583      * @since 4.0.0
584      */
585     @Config
586     public static final String MAVEN_LOGGER_LOG_FILE = MAVEN_LOGGER_PREFIX + "logFile";
587 
588     /**
589      * Should the level string be output in brackets? Defaults to false.
590      *
591      * @since 4.0.0
592      */
593     @Config(type = "java.lang.Boolean", defaultValue = "false")
594     public static final String MAVEN_LOGGER_LEVEL_IN_BRACKETS = MAVEN_LOGGER_PREFIX + "levelInBrackets";
595 
596     /**
597      * The string value output for the warn level. Defaults to WARN.
598      *
599      * @since 4.0.0
600      */
601     @Config(defaultValue = "WARN")
602     public static final String MAVEN_LOGGER_WARN_LEVEL = MAVEN_LOGGER_PREFIX + "warnLevelString";
603 
604     /**
605      * If the output target is set to "System.out" or "System.err" (see preceding entry), by default, logs will
606      * be output to the latest value referenced by System.out/err variables. By setting this parameter to true,
607      * the output stream will be cached, i.e. assigned once at initialization time and re-used independently of
608      * the current value referenced by System.out/err.
609      *
610      * @since 4.0.0
611      */
612     @Config(type = "java.lang.Boolean", defaultValue = "false")
613     public static final String MAVEN_LOGGER_CACHE_OUTPUT_STREAM = MAVEN_LOGGER_PREFIX + "cacheOutputStream";
614 
615     /**
616      * maven.logger.log.a.b.c - Logging detail level for a SimpleLogger instance named "a.b.c". Right-side value
617      * must be one of "trace", "debug", "info", "warn", "error" or "off". When a logger named "a.b.c" is initialized,
618      * its level is assigned from this property. If unspecified, the level of nearest parent logger will be used,
619      * and if none is set, then the value specified by {@code maven.logger.defaultLogLevel} will be used.
620      *
621      * @since 4.0.0
622      */
623     public static final String MAVEN_LOGGER_LOG_PREFIX = MAVEN_LOGGER_PREFIX + "log.";
624 
625     private Constants() {}
626 }