Azure Gradle Plugin

com.arcmutate.azure.cloud

The com.arcmutate.azure.cloud plugin integrates with Azure DevOps cloud and provides two tasks

• pitest-azure
• pitest-azure-upload

The pitest-azure task runs pitest against all modules for which it has been configured, then updates the current PR.

The pitest-azure-upload task updates the PR based on previously generated gitci json files.

Parameters can be configured via a pitestAzure extension block

pitestAzure {
  mutantEmoji = ':vomiting_face:'
  trailingText = 'Happy mutant hunting'
}

Extension Parameters

When running in Azure Pipelines, most required parameters will be autoset from environment variables. These parameters must be explicitly set in other environments.

azure.token

Required

A token with write access to PRs in the repository. If present, this property will be automatically populated from an environment variable named SYSTEM_ACCESSTOKEN.

Although a token is automatically supplied by azure Pipelines, it is not automatically made available as an environment variable and must be explicitly exported.

azure.collectionURI

Required

Autoset

The root URI of the project, e.g. https://dev.azure.com/fabrikamfiber/

If present, this property will be automatically populated from an environment variable named SYSTEM_COLLECTIONURI.

This environment variable is automatically supplied by azure Pipelines.

azure.repo

Required

Autoset

The repository to update. If present, this property will be automatically populated from an environment variable named BUILD_REPOSITORY_ID.

This environment variable is automatically set by azure Pipelines.

azure.pr

Required

Autoset

The pull request to update. If present, this property will be automatically populated from an environment variable named SYSTEM_PULLREQUEST_PULLREQUESTID.

This environment variable is automatically set by azure Pipelines.

azure.workspace

Required (azure-cloud)

Autoset

The workspace the repository belongs to. If present, this property will be automatically populated from an environment variable named SYSTEM_TEAMPROJECTID.

This environment variable is automatically set by azure Pipelines.

pitestReportPaths

Optional

By default, the plugin will examine the output directories of tasks named pitest when looking for json files to process. If this behaviour is incorrect for your build, it can be overridden by setting this parameter.

When set, only files within the explicitly supplied directories will be examined.

This parameter is intended for use with the pitest-azure-upload task when files have already been generated by a pitest run.

azure.deleteOldSummaries

Optional

Determines if pitest summary comments from previous runs should be deleted. Defaults to true.

mutantEmoji

Optional

Character string to use in summary table for surviving mutants.

killedEmoji

Optional

Character string to use in summary table when no surviving mutants.

trailingText

Optional

Custom text to place at end of summary.

includeLinks

Optional

When set, arcmutate will include links to information about the mutator in the mutant.

Defaults to true.