Code Transform

GIT repository

You can specify various git repositories by specifying the type git:

vcs:
  - type: git
    baseUrl: git@github.com:myorg
    suffix: ".git"
    checkoutBranch: test
    checkinBranch: test-transformed
    repositories:
      - repo1
      - repo2

This assumes that you have the git executable in your path, and you have authentication already setup to checkout the projects.

It will automatically checkout the specified checkoutBranch branch, perform the transformations.

If the maven command is executed with the push parameter set to true, it will then push the changes to the checkinBranch branch.

Matchers

- matcher:
  type: path
  paths:
  - test.txt

- matcher:
  type: "path-regex"
  regex: "src/main/mule/.*?\\.xml"

File: Set content

The file-set-content action will set the content of a file.

Parameters:

• content: Content to set (if the content type is binary, it must be base64 encoded)
• content-type: Content type of the file (either text or binary, file and defaults to text if not specified)

If the content type is file, the content will be read from the specified file, relative to the configuration file. If the content type is binary, it should be base64 encoded binary content.

Example:

- type: file-set-content
  content: "Hello World!"

Filename: Change case

The filename-change-case action can be used to change the case of a file name.

Parameters:

• case: The case to convert to (either upper or lower)
• regex: Regex to match against (defaults to .*) of what needs to be changed in the filename

Example:

- type: filename-change-case
  case: lower

JSON: add json

The add-json action can be used to add content to a JSON file.

Supported elements to add to are:

• Array elements

Parameters:

• point: A JSON pointer to the location where the content should be added
• json: JSON content to be added

Example:

- type: add-json
  pointer: /mylist
  json: |
    {
      "foo": "bar"
    }

this would modify the file from this:

{
  "mylist": [
    {
      "test": "value"
    }
  ]
}

to

{
  "mylist": [
    {
      "test": "value"
    },
    {
      "foo": "bar"
    }
  ]
}

Maven: Set parent pom

The maven-set-parent-pom action can be used to set the parent pom for a maven project.

Parameters:

• groupId: groupId of the parent
• artifactId: artifactId of the parent
• version: version of the parent

Example:

- type: maven-set-parent-pom
  groupId: "com.mycompany"
  artifactId: "my-parent"
  version: "1.0.5"

XML: Add

The add-xml action can be used to add content to an XML file. This currently only supports adding XML content to an element.

Parameters:

• namespace: Enable namespace support (defaults to false)
• prettyPrint: If the XML should be pretty printed (defaults to true)
• xmlDeclaration: If the XML should have an XML declaration (defaults to true)
• condition: XPath condition (must resolve to a boolean) to check if content should be added (defaults to true)
• xpath: XPath to the location where the content should be added
• value: XML content to add

Example:

- type: add-xml
  condition: not(boolean(//dependencies/dependency[artifactId='splunk-library-javalogging']))
  xpath: "//dependencies"
  value: |-
    <dependency>
      <groupId>com.splunk.logging</groupId>
      <artifactId>splunk-library-javalogging</artifactId>
      <version>1.11.8</version>
    </dependency>

XML: Delete

The delete-xml action can be used to delete a node from XML file.

Parameters:

• namespace: Enable namespace support (defaults to false)
• prettyPrint: If the XML should be pretty printed (defaults to true)
• xmlDeclaration: If the XML should have an XML declaration (defaults to true)
• condition: XPath condition (must resolve to a boolean) to check if content should be deleted (defaults to true)
• xpath: XPath to the location where the content should be added
• value: XML content to add

Example:

- type: delete-xml
  xpath: "//dependencies/dependency[artifactId='mule-splunk-plugin']"

XML: Update

The delete-xml action can be used to delete a node from XML file.

Parameters:

• namespace: Enable namespace support (defaults to false)
• prettyPrint: If the XML should be pretty printed (defaults to true)
• xmlDeclaration: If the XML should have an XML declaration (defaults to true)
• xpath: XPath to the location where the content should be added
• value: XML content to add

Example: Updating an attribute value

- type: update-xml
  xpath: /mule/request-config/request-connection[starts-with(@host,'\{secure::domain.https.req.host}')]/@host
  value: "www.mydomain.com"

Example: Updating an element's text content

- type: update-xml
  xpath: "/project/properties/java.version"
  value: "17"