Configuration

This page lists configuration properties which can be used to define the functionality and behavior of Cake.Issues recipes.

Git repository information¶

Cake.Issues recipes require some information about current Git repository.

To define the Git provider in Cake.Issues.Recipe set the global variable RepositoryInfoProvider. To define the Git provider in Cake.Frosting.Issues.Recipe pass the value to the constructor of IssueContext.

The following providers are supported:

Provider	Description
`RepositoryInfoProviderType.CakeGit`	Read repository information using Cake.Git addin. Requires system to be compatible with Cake.Git addin.
`RepositoryInfoProviderType.Cli`	Read repository information using Git CLI. Requires Git CLI to be available in path.

By default Cake.Git addin will be used.

General¶

Cake.Issues.Recipe Property	Cake.Frosting.Issues.Recipe Property	Default Value	Description
`IssuesParameters.` `OutputDirectory`	`IssuesContext.Parameters.` `OutputDirectory`	`BuildArtifacts`	Path to the output directory. A relative path will be relative to the current working directory.
`IssuesParameters.` `BuildIdentifier`	`IssuesContext.Parameters.` `BuildIdentifier`	`string.Empty`	Identifier for the build run. If set this identifier will be used to identify to artifacts provided by the build if building on multiple configurations.

Input files¶

Report creation¶

Cake.Issues.Recipe Property	Cake.Frosting.Issues.Recipe Property	Default Value	Description
`IssuesParameters.Reporting.` `ShouldCreateFullIssuesReport`	`IssuesContext.Parameters.Reporting.` `ShouldCreateFullIssuesReport`	`true`	Indicates whether full issues report should be created.
`IssuesParameters.Reporting.` `FullIssuesReportSettings`	`IssuesContext.Parameters.Reporting.` `FullIssuesReportSettings`	`GenericIssueReportTemplate.HtmlDxDataGrid` template with `DevExtremeTheme.MaterialBlueLight` theme.	Settings for creating the full issues report. See Template Gallery for possible options.
`IssuesParameters.Reporting.` `ShouldCreateSarifReport`	`IssuesContext.Parameters.Reporting.` `ShouldCreateSarifReport`	`true`	Indicates whether a report in SARIF format should be created.
`IssuesParameters.Reporting.` `ShouldReportIssuesToConsole`	`IssuesContext.Parameters.Reporting.` `ShouldReportIssuesToConsole`	`false`	Indicates whether issues should be reported to the console.
`IssuesParameters.Reporting.` `ReportToConsoleSettings`	`IssuesContext.Parameters.Reporting.` `ReportToConsoleSettings`		Settings for reporting issues to the console.

Build server integration¶

Cake.Issues.Recipe Property	Cake.Frosting.Issues.Recipe Property	Default Value	Description
`IssuesParameters.BuildServer.` `ShouldReportIssuesToBuildServer`	`IssuesContext.Parameters.BuildServer.` `ShouldReportIssuesToBuildServer`	`true`	Indicates whether issues should be reported to the build server.
`IssuesParameters.BuildServer.` `ShouldPublishFullIssuesReport`	`IssuesContext.Parameters.BuildServer.` `ShouldPublishFullIssuesReport`	`true`	Indicates whether full issues report should be published as artifact to the build system.
`IssuesParameters.BuildServer.` `ShouldPublishSarifReport`	`IssuesContext.Parameters.BuildServer.` `ShouldPublishSarifReport`	`true`	Indicates whether report int SARIF format shoudl be published as artifact to the build system.
`IssuesParameters.BuildServer.` `ShouldCreateSummaryIssuesReport`	`IssuesContext.Parameters.BuildServer.` `ShouldCreateSummaryIssuesReport`	`true`	Indicates whether summary issues report should be created.

Pull request integration¶

Cake.Issues.Recipe Property	Cake.Frosting.Issues.Recipe Property	Default Value	Description
`IssuesParameters.PullRequestSystem.` `ShouldReportIssuesToPullRequest`	`IssuesContext.Parameters.PullRequestSystem.` `ShouldReportIssuesToPullRequest`	`true`	Indicates whether issues should be reported to the pull request system.
`IssuesParameters.PullRequestSystem.` `MaxIssuesToPost`	`IssuesContext.Parameters.PullRequestSystem.` `MaxIssuesToPost`	`null`	Global number of issues which should be posted at maximum over all issue provider. Issues are filtered by priority and issues with a file path are prioritized. `null` won't set a global limit.
`IssuesParameters.PullRequestSystem.` `MaxIssuesToPostAcrossRuns`	`IssuesContext.Parameters.PullRequestSystem.` `MaxIssuesToPostAcrossRuns`	`null`	Global number of issues which should be posted at maximum over all issue providers and across multiple runs. Issues are filtered by priority and issues with a file path are prioritized. `null` won't set a limit across multiple runs.
`IssuesParameters.PullRequestSystem.` `MaxIssuesToPostForEachIssueProvider`	`IssuesContext.Parameters.PullRequestSystem.` `MaxIssuesToPostForEachIssueProvider`	`100`	Number of issues which should be posted at maximum for each issue provider. Issues are filtered by priority and issues with a file path are prioritized. `null` won't limit issues per issue provider.
`IssuesParameters.PullRequestSystem.` `ProviderIssueLimits`	`IssuesContext.Parameters.PullRequestSystem.` `ProviderIssueLimits`	Empty	Issue limits for individual issue provider. The key must be the `IIssue.ProviderType` of a specific provider to which the limits should be applied to.
`IssuesParameters.PullRequestSystem.` `IssueFilters`	`IssuesContext.Parameters.PullRequestSystem.` `IssueFilters`	Empty	List of filter functions which should be applied before posting issues to pull requests.
`IssuesParameters.PullRequestSystem.` `ShouldSetPullRequestStatus`	`IssuesContext.Parameters.PullRequestSystem.` `ShouldSetPullRequestStatus`	`true`	Indicates whether a status on the pull request should be set if there are any issues found.
`IssuesParameters.PullRequestSystem.` `ShouldSetSeparatePullRequestStatusForEachIssueProviderAndRun`	`IssuesContext.Parameters.PullRequestSystem.` `ShouldSetSeparatePullRequestStatusForEachIssueProviderAndRun`	`true`	Indicates whether a separate status should be set for issues of every issue provider and run.

Cake.Issues.Recipe Methods	Cake.Frosting.Issues.Recipe Methods	Description
`IssuesParameters.InputFiles.` `AddMsBuildXmlFileLoggerLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddMsBuildXmlFileLoggerLogFilePath()`	Adds a path to a MSBuild log file created by XmlFileLogger.
`IssuesParameters.InputFiles.` `AddMsBuildXmlFileLoggerLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddMsBuildXmlFileLoggerLogFileContent()`	Adds content of a MSBuild log file created by XmlFileLogger.
`IssuesParameters.InputFiles.` `AddMsBuildBinaryLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddMsBuildBinaryLogFilePath()`	Adds a path to a MSBuild binary log file.
`IssuesParameters.InputFiles.` `AddMsBuildBinaryLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddMsBuildBinaryLogFileContent()`	Adds content of a MSBuild binary log file.
`IssuesParameters.InputFiles.` `AddInspectCodeLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddInspectCodeLogFilePath()`	Adds a path to a JetBrains InspectCode log file.
`IssuesParameters.InputFiles.` `AddInspectCodeLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddInspectCodeLogFileContent()`	Adds content of a JetBrains InspectCode log file.
`IssuesParameters.InputFiles.` `AddMarkdownlintCliLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintCliLogFilePath()`	Adds a path to a markdownlint-cli log file.
`IssuesParameters.InputFiles.` `AddMarkdownlintCliLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintCliLogFileContent()`	Adds content of a markdownlint-cli log file.
`IssuesParameters.InputFiles.` `AddMarkdownlintCliJsonLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintCliJsonLogFilePath()`	Adds a path to a markdownlint-cli log file writting with `--json`.
`IssuesParameters.InputFiles.` `AddMarkdownlintCliJsonLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintCliJsonLogFileContent()`	Adds content of a markdownlint-cli log file writting with `--json`.
`IssuesParameters.InputFiles.` `AddMarkdownlintV1LogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintV1LogFilePath()`	Adds a path to a markdownlint log file in version 1.
`IssuesParameters.InputFiles.` `AddMarkdownlintV1LogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddMarkdownlintV1LogFileContent()`	Adds content of a markdownlint log file in version 1.
`IssuesParameters.InputFiles.` `AddEsLintJsonLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddEsLintJsonLogFilePath()`	Adds a path to a ESLint log file generated by the ESLint json formatter.
`IssuesParameters.InputFiles.` `AddEsLintJsonLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddEsLintJsonLogFileContent()`	Adds content of a ESLint log file generated by the ESLint json formatter.
`IssuesParameters.InputFiles.` `AddSarifLogFilePath()`	`IssuesContext.Parameters.InputFiles.` `AddSarifLogFilePath()`	Adds a path to a SARIF log file.
`IssuesParameters.InputFiles.` `AddSarifLogFileContent()`	`IssuesContext.Parameters.InputFiles.` `AddSarifLogFileContent()`	Adds content of a SARIF log file.