Skip to content

A format check task for Azure Devops Pull Requests, based on dotnet format. It can scan all files or just the ones in a PR and add comments for each error found to the PR. When errors are found optionally fail the task or set a status check.

Notifications You must be signed in to change notification settings

ajeckmans/format-check-task

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Custom Azure DevOps PR task for code formatting check

This project contains a custom Azure DevOps Pull Request (PR) task constructed for the specific need of validating code formatting rules using dotnet. It is designed to add value to your workflows by automatically detecting and highlighting any code violations, injecting these as comments directly into your PR.

Features

  • Automated code formatting check using dotnet.
  • Direct injection of any identified errors as comments into your PR.

How to use

  1. Integrate this task into your Azure pipeline. To include it without failing the build, but set a PR status check, use:

    - task: FormatCheck@1
      inputs:
        SolutionPath: '$(Build.SourcesDirectory)'
        failOnFormattingErrors: false
        statusCheck: true
        statusCheckName: format check
        statusCheckGenre: formatting
      env:
        SYSTEM_ACCESSTOKEN: $(System.AccessToken)

    To make it fail the PR build:

    - task: FormatCheck@1
      inputs:
        SolutionPath: '$(Build.SourcesDirectory)'
      env:
        SYSTEM_ACCESSTOKEN: $(System.AccessToken)

    In either case it will add comments to the pull request for any issues found by dotnet format.

    To scope the task to only files included in the PR set ScopeToPullRequest to true (default: false).

    NOTE: Make sure the job running the task has rights to use the OAuth token and that the user running the build has the 'Contribute to Pull Requests' rights.

  2. During the operation of the pipeline, the task will examine your code and highlight formatting issues using dotnet.

  3. Any errors identified will be automatically pushed as comments to your PR, highlighting the exact locations and nature of the issues.

By improving your workflow with this custom PR task, we hope to save time, improve code quality, increase team efficiency, and ensure code consistency across your projects. Happy coding!

About

A format check task for Azure Devops Pull Requests, based on dotnet format. It can scan all files or just the ones in a PR and add comments for each error found to the PR. When errors are found optionally fail the task or set a status check.

Resources

Stars

Watchers

Forks

Packages