basetenlabs/changed-files

basetenlabs/changed-files

Description: :octocat: Github action to retrieve all (added, copied, modified, deleted, renamed, type changed, unmerged, unknown) files and directories.

License: MIT

Stars: 1

Forks: 0

Open issues: 5

Created: 2025-03-17T14:27:19Z

Pushed: 2026-04-08T16:55:01Z

Default branch: main

Fork: yes

Parent repository: tj-actions/changed-files

Archived: no

README:

  

changed-files

Effortlessly track all changed files and directories relative to a target branch, the current branch (preceding commit or the last remote commit), multiple branches, or custom commits returning relative paths from the project root using this GitHub action.

> \[!WARNING]\ > Security Alert: A critical security issue was identified in this action due to a compromised commit. > > This commit has been removed from all tags and branches, and necessary measures have been implemented to prevent similar issues in the future. > > #### Action Required: > > * Review your workflows executed between March 14 and March 15. If you notice unexpected output under the changed-files section, decode it using the following command: echo 'xxx' | base64 -d | base64 -d\ > If the output contains sensitive information (e.g., tokens or secrets), revoke and rotate those secrets immediately. > * If your workflows reference this commit directly by its SHA, you must update them immediately to avoid using the compromised version. > * If you are using tagged versions (e.g., v35, v44.5.1), no action is required as these tags have been updated and are now safe to use. > > Additionally, as a precaution, we recommend rotating any secrets that may have been exposed during this timeframe to ensure the continued security of your workflows.

> \[!NOTE] > > * This action solely identifies files that have changed for events such as [pull_request*, push, merge_group, release, and many more](#other-supported-events-electron). However, it doesn't detect pending uncommitted changes created during the workflow execution. > > See: https://github.com/tj-actions/verify-changed-files instead.

Table of contents

• [Features 🚀](#features-)
• [Usage 💻](#usage-)
• [On pull_request 🔀](#on-pull_request-)
• [Using local .git directory 📁](#using-local-git-directory-)
• [Using Github's API :octocat:](#using-githubs-api-octocat)
• [On push ⬆️](#on-push-️)
• [Other supported events :electron:](#other-supported-events-electron)
• [Inputs ⚙️](#inputs-️)
• [Useful Acronyms 🧮](#useful-acronyms-)
• [Outputs 📤](#outputs-)
• [Versioning 🏷️](#versioning-️)
• [Examples 📄](#examples-)
• [Real-world usage 🌐](#real-world-usage-)
• [Open source projects 📦](#open-source-projects-)
• [Scalability Example 📈](#scalability-example-)
• [Important Notice ⚠️](#important-notice-️)
• [Migration guide 🔄](#migration-guide-)
• [Credits 👏](#credits-)
• [Report Bugs 🐛](#report-bugs-)
• [Contributors ✨](#contributors-)

Features 🚀

• Fast execution, averaging 0-10 seconds.
• Leverages either Github's REST API or Git's native diff command to determine changed files.
• Facilitates easy debugging.
• Scales to handle large/mono repositories.
• Supports Git submodules.
• Supports merge queues for pull requests.
• Generates escaped JSON output for running matrix jobs based on changed files.
• Lists changed directories.
• Limits matching changed directories to a specified maximum depth.
• Optionally excludes the current directory.
• Writes outputs to a designated .txt or .json file for further processing.
• Restores deleted files to their previous location or a newly specified location.
• Supports fetching a fixed number of commits, which improves performance.
• Compatible with all platforms (Linux, MacOS, Windows).
• Supports GitHub-hosted runners.
• Supports GitHub Enterprise Server.
• Supports self-hosted runners.
• Lists all files and directories that have changed:
• Between the current pull request branch and the last commit on the target branch.
• Between the last commit and the current pushed change.
• Between the last remote branch commit and the current HEAD.
• Restricts change detection to a subset of files and directories:
• Provides boolean output indicating changes in specific files.
• Uses Glob pattern matching.
• Supports Globstar.
• Supports brace expansion.
• Supports negation.
• Uses YAML syntax for specifying patterns.
• Supports YAML anchors & aliases.
• Supports YAML multi-line strings.

And many more...

Usage 💻

> \[!IMPORTANT] > > * Push Events: When configuring `actions/checkout`, make sure to set `fetch-depth` to either 0 or 2, depending on your use case. > * Mono Repositories: To avoid pulling the entire branch history, you can utilize the default `actions/checkout`'s…