properties:write-project-properties

Full name:

org.kuali.maven.plugins:properties-maven-plugin:1.5.3:write-project-properties

Description:

Write project properties to a file.

Attributes:

  • Requires a Maven project to be executed.

Required Parameters

Name Type Since Description
outputFile File - The file that properties will be written to
Default value is: ${project.build.directory}/properties/project.properties.
outputStyle OutputStyle - Either NORMAL or ENVIRONMENT_VARIABLE. When set to ENVIRONMENT_VARIABLE the keys in the properties file will all be upper case with periods replaced by underscores.
Default value is: NORMAL.

Optional Parameters

Name Type Since Description
comment String - Anything provided here is added as a comment at the top of the properties file.
encoding String - The encoding to use when storing the properties
Default value is: ${project.build.sourceEncoding}.
exclude String - CSV list of properties to exclude. A single wildcard character * is supported.
excludes List - List of properties to exclude. A single wildcard character * is supported.
include String - CSV list of properties to include. A single wildcard character * is supported.
includeEnvironmentVariables boolean - If true, the plugin will include environment variables when writing the properties file. Environment variables are prefixed with "env". Environment variables override project properties.
Default value is: false.
includeStandardMavenProperties boolean - If true, these Maven properties are added to the properties file: 
  project.groupId
  project.artifactId
  project.version
  project.basedir
  project.build.directory

Default value is: false.
includeSystemProperties boolean - If true, the plugin will include system properties when writing the properties file. System properties override both environment variables and project properties.
Default value is: false.
includes List - List of properties to include. A single wildcard character * is supported.
prefix String - If supplied property keys are prefixed with this value before being stored.
resolvePlaceholders boolean - If true placeholders are resolved before writing properties to the file
Default value is: false.

Parameter Details

comment:

Anything provided here is added as a comment at the top of the properties file.
  • Type: java.lang.String
  • Required: No
  • Expression: ${properties.comment}

encoding:

The encoding to use when storing the properties
  • Type: java.lang.String
  • Required: No
  • Expression: ${properties.encoding}
  • Default: ${project.build.sourceEncoding}

exclude:

CSV list of properties to exclude. A single wildcard character * is supported.
  • Type: java.lang.String
  • Required: No
  • Expression: ${properties.exclude}

excludes:

List of properties to exclude. A single wildcard character * is supported.
  • Type: java.util.List
  • Required: No

include:

CSV list of properties to include. A single wildcard character * is supported.
  • Type: java.lang.String
  • Required: No
  • Expression: ${properties.include}

includeEnvironmentVariables:

If true, the plugin will include environment variables when writing the properties file. Environment variables are prefixed with "env". Environment variables override project properties.
  • Type: boolean
  • Required: No
  • Expression: ${properties.includeEnvironmentVariables}
  • Default: false

includeStandardMavenProperties:

If true, these Maven properties are added to the properties file: 
  project.groupId
  project.artifactId
  project.version
  project.basedir
  project.build.directory
  • Type: boolean
  • Required: No
  • Expression: ${properties.includeStandardMavenProperties}
  • Default: false

includeSystemProperties:

If true, the plugin will include system properties when writing the properties file. System properties override both environment variables and project properties.
  • Type: boolean
  • Required: No
  • Expression: ${properties.includeSystemProperties}
  • Default: false

includes:

List of properties to include. A single wildcard character * is supported.
  • Type: java.util.List
  • Required: No

outputFile:

The file that properties will be written to
  • Type: java.io.File
  • Required: Yes
  • Expression: ${properties.outputFile}
  • Default: ${project.build.directory}/properties/project.properties

outputStyle:

Either NORMAL or ENVIRONMENT_VARIABLE. When set to ENVIRONMENT_VARIABLE the keys in the properties file will all be upper case with periods replaced by underscores.
  • Type: org.codehaus.mojo.properties.OutputStyle
  • Required: Yes
  • Expression: ${properties.outputStyle}
  • Default: NORMAL

prefix:

If supplied property keys are prefixed with this value before being stored.
  • Type: java.lang.String
  • Required: No
  • Expression: ${properties.prefix}

resolvePlaceholders:

If true placeholders are resolved before writing properties to the file
  • Type: boolean
  • Required: No
  • Expression: ${properties.resolvePlaceholders}
  • Default: false