Skip to content
file

GitHub Action

Retrieve All Changed Files

v3.0.0 Latest version

Retrieve All Changed Files

file

Retrieve All Changed Files

Retrieve all of the files changed/modified in a pull request or push's commits

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Retrieve All Changed Files

uses: masesgroup/[email protected]

Learn more about this action in masesgroup/retrieve-changed-files

Choose a version

masesgroup/retrieve-changed-files status

Retrieve All Changed Files

Retrieve all of the files changed/modified in a pull request or push's commits. You can choose to retrieve all changed files, only added files, only modified files, only removed files, only renamed files, or all added and modified files. These outputs are available via the steps output context. The steps output context exposes the output names all, added, modified, removed, renamed, and added_modified.

Usage

See action.yml

- uses: masesgroup/retrieve-changed-files@v3
  with:
    # Format of the steps output context.
    # Can be 'space-delimited', 'csv', or 'json'.
    # Default: 'space-delimited'
    format: ''

Scenarios

Retrieve all changed files as space-delimited

If there are any files with spaces in them, then this method won't work and the step will fail. Consider using one of the other formats if that's the case.

- id: files
  uses: masesgroup/retrieve-changed-files@v3
- run: |
    for changed_file in ${{ steps.files.outputs.all }}; do
      echo "Do something with this ${changed_file}."
    done

Retrieve all added and modified files as CSV

- id: files
  uses: masesgroup/retrieve-changed-files@v3
  with:
    format: 'csv'
- run: |
    mapfile -d ',' -t added_modified_files < <(printf '%s,' '${{ steps.files.outputs.added_modified }}')
    for added_modified_file in "${added_modified_files[@]}"; do
      echo "Do something with this ${added_modified_file}."
    done

Retrieve all removed files as JSON

- id: files
  uses: masesgroup/retrieve-changed-files@v3
  with:
    format: 'json'
- run: |
    readarray -t removed_files <<<"$(jq -r '.[]' <<<'${{ steps.files.outputs.removed }}')"
    for removed_file in ${removed_files[@]}; do
      echo "Do something with this ${removed_file}."
    done

Install, Build, Lint, Test, and Package

Make sure to do the following before checking in any code changes.

$ yarn
$ yarn all

License

The scripts and documentation in this project are released under the MIT License