Profile Activator Extension

Provide flexible Maven profile activation via script

License	Apache-2.0
Categories	Maven Build Tools
GroupId	com.carrotgarden.maven
ArtifactId	profile-activator-extension
Last Version	1.3.20190513180922
Release Date	May 13, 2019
Type	jar
Description	Profile Activator Extension Provide flexible Maven profile activation via script
Project URL	https://github.com/random-maven/profile-activator-extension
Project Organization	CarrotGarden
Source Code Management	https://github.com/random-maven/profile-activator-extension

Download profile-activator-extension

Filename	Size
profile-activator-extension-1.3.20190513180922.pom
profile-activator-extension-1.3.20190513180922.jar	17 KB
profile-activator-extension-1.3.20190513180922-sources.jar	11 KB
profile-activator-extension-1.3.20190513180922-javadoc.jar	91 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/com.carrotgarden.maven/profile-activator-extension/ -->
<dependency>
    <groupId>com.carrotgarden.maven</groupId>
    <artifactId>profile-activator-extension</artifactId>
    <version>1.3.20190513180922</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/com.carrotgarden.maven/profile-activator-extension/
implementation 'com.carrotgarden.maven:profile-activator-extension:1.3.20190513180922'

Gradle Kotlin

// https://jarcasting.com/artifacts/com.carrotgarden.maven/profile-activator-extension/
implementation ("com.carrotgarden.maven:profile-activator-extension:1.3.20190513180922")

Apache Buildr

'com.carrotgarden.maven:profile-activator-extension:jar:1.3.20190513180922'

Apache Ivy

<dependency org="com.carrotgarden.maven" name="profile-activator-extension" rev="1.3.20190513180922">
  <artifact name="profile-activator-extension" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='com.carrotgarden.maven', module='profile-activator-extension', version='1.3.20190513180922')
)

Scala SBT

libraryDependencies += "com.carrotgarden.maven" % "profile-activator-extension" % "1.3.20190513180922"

Leiningen

[com.carrotgarden.maven/profile-activator-extension "1.3.20190513180922"]

Dependencies

compile (4)

Group / Artifact	Type	Version
org.scala-lang : scala-compiler	jar	2.12.8
org.mvel : mvel2	jar	2.4.4.Final
org.codehaus.groovy : groovy-jsr223	jar	2.5.7
cat.inspiracio : rhino-js-engine	jar	1.7.10

provided (2)

Group / Artifact	Type	Version
org.apache.maven : maven-core	jar	3.5.2
org.codehaus.plexus : plexus-component-annotations	jar	1.7.1

Project Modules

There are no modules declared in this project.

Profile Activator Extension

Provide flexible Maven profile activation via script.

Reference feature implementation, vote for MNG-6345.

Install	Production Release	Development Release
Artifact

Similar extensions

• kpiwko/el-profile-activator-extension
• rrialq/jsr223-profile-activator-extension

Extension features

• comprehensive logging
• exposes resolved project pom.xml
• works with Maven 3.5 (activation via AND)
• scripting with Groovy, JavaScript, MVEL Script

Usage Examples:

Profile activator is configured in two steps:

1. Register project extension

${project.basedir}/.mvn/extensions.xml

<extension>
   <groupId>com.carrotgarden.maven</groupId>
   <artifactId>profile-activator-extension</artifactId>
</extension>

2. Provide activation script inside the magic property

<profile>
   <activation>
      <property>
         <name>[ACTIVATOR:MVELSCRIPT]</name>
         <value>
<![CDATA[
   isdef property1 && isdef property2 && property1 == "hello-maven" && project.packaging == "bundle" 
]]>
         </value>
       </property>
   </activation>
</profile>

• example activator in Groovy
• example activator in JavaScript
• example activator in MVEL Script

Script variables

Tip: check examples first.

Activator script has access to

• merged properties, as a map of type java.util.Map<String, String> named value
• resolved project model, as an object of type org.apache.maven.model.Model named project

Merged Properties

Activator script has ordered and merged view of

• project properties: pom.xml/<properties>
• system properties form: System.getProperties()
• user properties from user-provided command line -D options

Merged properties scopes

• properties are injected in the default script variable scope (for scripting engines that have such)
• there is also an extension-provided map value, which contains a copy of the default scope
• use value map to access variables with dot in the name or when there is no default scope

Example default scope access syntax: the following expression extracts the value of pom.xml/<properties>/<property1>

• Groovy syntax: not available, use value["property1"]
• JavaScript syntax: property1 (same result as value["property1"])
• MVEL Script syntax: property1 (same result as value["property1"])

Example value map access syntax: the following expression extracts the value of user.name which originally comes from a system property, and which is considered "invalid name" in the default scope:

• Groovy syntax: value["user.name"]
• JavaScript syntax: value["user.name"]
• MVEL Script syntax: value["user.name"]

Resolved Project Model

Resolved interpolated project descriptor is exposed in the form of project model bean .

Activator script has access to the project model as an object named project.

Example project object access syntax: the following expression extracts the value of pom.xml/<packaging> which is available as public String getPackaging()

• Groovy syntax: project.packaging (same result as project.getPackaging())
• JavaScript syntax: project.packaging (same result as project.getPackaging())
• MVEL Script syntax: project.packaging (same result as project.getPackaging())

Variable existence check

Normally, scripting engine will throw an error when trying to access a variable which is not defined.

Example variable existence check syntax:

• Groovy syntax: not available, use null-test: if ( value["property1"] ) { ... }
• JavaScript syntax: if ( typeof property1 !== 'undefined' ) { ... }
• MVEL Script syntax: if ( isdef property1 ) { ... }

In practice, null-test is sufficient in most cases

• if ( value["property1"] ) { ... }

Project model members are always defined, but can return null.

Build yourself

cd /tmp
git clone [email protected]:random-maven/profile-activator-extension.git
cd profile-activator-extension
./mvnw.sh clean install -B -P skip-test

Versions

Version
1.3.20190513180922 May 13, 2019
1.2.20180119141943 Jan 19, 2018
1.1.20180118221118 Jan 19, 2018