changed-files/README.md

changed-files

Get modified files using git diff --diff-filter to locate all files that have been modified relative to the default branch.

NOTE: ⚠️ This action should only run on the following events ⚠️

• pull_request
• pull_request_review
• pull_request_review_comment
• pull_request_target

Usage

With defaults

name: CI

on:
  pull_request:
    branches:
      - main

jobs:
  test:
    runs-on: ubuntu-latest
    name: Test changed-files
    steps:
      - uses: actions/checkout@v2
      - name: Get changed files
        id: changed-files
        uses: tj-actions/changed-files@v3.1

Example

...
    steps:
      - uses: actions/checkout@v2
      - name: Get changed files using defaults
        id: changed-files
        uses: tj-actions/changed-files@v3.1
      
      - name: Get changed files using a comma separator
        id: changed-files-comma
        uses: tj-actions/changed-files@v3.1
        with:
          separator: ","
       
      - name: List all added files
        run: |
          for file in "${{ steps.changed-files.outputs.added_files }}"; do
            echo $file
          done
                    
      - name: Run step when a file changes in a PR relative to the default branch
        if: contains(steps.changed-files.outputs.modified_files, 'my-file.txt')
        run: |
            echo "Your file my-file.txt has been modified."            

      - name: Run step when a file is deleted in a PR relative to the default branch
        if: contains(steps.changed-files.outputs.deleted_files, 'test.txt')
        run: |
            echo "Your test.txt has been deleted."
                        
        

Inputs

Input	type	required	default	description
separator	string	true	' '	Separator to return outputs

Outputs

Using the default separator.

Output	type	example	description
added_files	string	'new.txt other.png ...'	Select only files that are Added (A)
copied_files	string	'new.txt other.png ...'	Select only files that are Copied (C)
deleted_files	string	'new.txt other.png ...'	Select only files that are Deleted (D)
modified_files	string	'new.txt other.png ...'	Select only files that are Modified (M)
renamed_files	string	'new.txt other.png ...'	Select only files that are Renamed (R)
changed_files	string	'new.txt other.png ...'	Select only files that have their type changed (T)
unmerged_files	string	'new.txt other.png ...'	Select only files that are Unmerged (U)
unknown_files	string	'new.txt other.png ...'	Select only files that are Unknown (X)
all_changed_files	string	'new.txt other.png ...'	Select all paths (*) i.e a combination of all options above.
all_modified_files	string	'new.txt other.png ...'	Select all modified files (*) i.e a combination of all added, copied and modified files (ACM).

Example

• Free software: MIT license

Features

• Added Files
• Copied Files
• Deleted Files
• Modified Files
• Renamed Files
• Changed Files
• Unmerged Files
• Unknown Files
• All Changed Files

Credits

This package was created with Cookiecutter.

Report Bugs

Report bugs at https://github.com/tj-actions/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.