verify-changed-files

Verify that certain files or directories did or did not change during the workflow execution.

[!NOTE]

This action only detects files that have pending uncommitted changes generated during the workflow execution, for running a specific step when a file changes in a pull request or based on a pushed commit

See: https://github.com/tj-actions/changed-files instead

Features

Fast execution (0-2 seconds on average).
Easy to debug.
Scales to large repositories.
Supports all platforms (Linux, MacOS, Windows).
GitHub-hosted runners support
GitHub Enterprise Server support.
self-hosted runners support.
Boolean output for detecting uncommitted changes.
List all files that changed during the workflow execution.
Detect changes to track and untracked files.
Restrict change detection to a subset of files:
- Using Glob pattern matching.
  - Supports Globstar.
  - Supports brace expansion.
  - Supports negation.

Usage

...
    steps:
      - uses: actions/checkout@v4

      - name: Change text file
        run: |
          echo "Modified" > new.txt

      - name: Change file in directory
        run: |
          echo "Changed" > test_directory/new.txt

      - name: Verify Changed files
        uses: tj-actions/verify-changed-files@v20
        id: verify-changed-files
        with:
          files: |
             *.txt
             test_directory
             action.yml
             **/*.{jpeg,py}
             !*.sql

      - name: Run step only when any of the above files change.
        if: steps.verify-changed-files.outputs.files_changed == 'true'
        env:
          CHANGED_FILES: ${{ steps.verify-changed-files.outputs.changed_files }}
        run: |
          echo "Changed files: $CHANGED_FILES"
        # Outputs: "Changed files: new.txt test_directory/new.txt"

Using the `contains` function.

...
      - name: Verify Changed files
        uses: tj-actions/verify-changed-files@v20
        id: verify-changed-files
        with:
          files: |
             new.txt
             test_directory

      - name: Perform action when test_directory changes
        if: contains(steps.verify-changed-files.outputs.changed_files, 'test_directory')
        run: |
          echo "test_directory has changed."

Get all unstaged (tracked/untracked) files

...
      - name: Verify Changed files
        uses: tj-actions/verify-changed-files@v20
        id: verify-changed-files
      
      - name: List all changed tracked and untracked files
        env:
          CHANGED_FILES: ${{ steps.verify-changed-files.outputs.changed_files }}
        run: |
          echo "Changed files: $CHANGED_FILES"

If you feel generous and want to show some extra appreciation:

Support this project with a :star:

Inputs

- uses: tj-actions/verify-changed-files@v20
  id: verify-changed-files
  with:
    # Indicates whether to fail if 
    # files have changed. 
    # Type: boolean
    # Default: "false"
    fail-if-changed: ''

    # Indicates whether to fail if 
    # no files have changed. 
    # Type: boolean
    # Default: "false"
    fail-if-unchanged: ''

    # Message to display when `fail-if-changed` 
    # or `fail-if-unchanged` is set to 
    # `true`. 
    # Type: string
    fail-message: ''

    # File/Directory names to check for 
    # uncommited changes. 
    # Type: string
    files: ''

    # Separator used to split the 
    # `files` input 
    # Type: string
    # Default: "\n"
    files-separator: ''

    # Indicates whether to match files 
    # in `.gitignore` 
    # Type: boolean
    # Default: "false"
    match-gitignore-files: ''

    # Relative path under GITHUB_WORKSPACE to 
    # the repository 
    # Type: string
    # Default: "."
    path: ''

    # Use non-ASCII characters to match 
    # files and output the filenames 
    # completely verbatim by setting this 
    # to `false` 
    # Type: boolean
    # Default: "true"
    quotepath: ''

    # Indicates whether to read `.gitignore`. 
    # The `.gitignore` file will be 
    # ignored if set to `false`. 
    # Overrides `match-gitignore-files` 
    # Type: boolean
    # Default: "false"
    read-gitignore: ''

    # Apply sanitization to output filenames 
    # before being set as output. 
    # Type: boolean
    # Default: "true"
    safe_output: ''

    # Output string separator.
    # Type: string
    # Default: " "
    separator: ''

Outputs

OUTPUT	TYPE	DESCRIPTION
<a name="output_changed_files"></a>changed_files	string	List of changed files
<a name="output_files_changed"></a>files_changed	string	Boolean indicating that files have <br>changed.

Free software: MIT license

Known Limitation

[!WARNING]

Using characters like \n, %, . and \r as output string separators would be URL encoded

Report Bugs

Report bugs at https://github.com/tj-actions/verify-changed-files/issues.

If you are reporting a bug, please include:

Your operating system name and version.
Any details about your workflow that might be helpful in troubleshooting.
Detailed steps to reproduce the bug.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

<table> <tbody> <tr> <td align="center" valign="top" width="14.28%"><a href="https://github.com/max-kahnt-keylight"><img src="https://avatars.githubusercontent.com/u/79849575?v=4?s=100" width="100px;" alt="Max Kahnt"/> Max Kahnt</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=max-kahnt-keylight" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://wllm.no"><img src="https://avatars.githubusercontent.com/u/1223410?v=4?s=100" width="100px;" alt="William Killerud"/> William Killerud</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=wkillerud" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Minecraftschurli"><img src="https://avatars.githubusercontent.com/u/23388022?v=4?s=100" width="100px;" alt="Minecraftschurli"/> Minecraftschurli</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Minecraftschurli" title="Code">💻</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Minecraftschurli" title="Documentation">📖</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Minecraftschurli" title="Tests">⚠️</a></td> <td align="center" valign="top" width="14.28%"><a href="https://stefanhoth.com"><img src="https://avatars.githubusercontent.com/u/45467?v=4?s=100" width="100px;" alt="Stefan Hoth"/> Stefan Hoth</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=stefanhoth" title="Code">💻</a></td> <td align="center" valign="top" width="14.28%"><a href="https://home.boidol.dev/"><img src="https://avatars.githubusercontent.com/u/652404?v=4?s=100" width="100px;" alt="Raphael Boidol"/> Raphael Boidol</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=boidolr" title="Documentation">📖</a></td> <td align="center" valign="top" width="14.28%"><a href="https://github.com/Larspolo"><img src="https://avatars.githubusercontent.com/u/11822478?v=4?s=100" width="100px;" alt="Lars"/> Lars</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Larspolo" title="Code">💻</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Larspolo" title="Tests">⚠️</a> <a href="https://github.com/tj-actions/verify-changed-files/commits?author=Larspolo" title="Documentation">📖</a></td> </tr> </tbody> </table>

This project follows the all-contributors specification. Contributions of any kind