INPUT | TYPE | REQUIRED | DEFAULT | DESCRIPTION |
---|---|---|---|---|
base_sha | string | false | Specify a different base commit SHA used for comparing changes |
|
diff_relative | string | false | Exclude changes outside the current directory and show path names relative to it. NOTE: This requires you to specify the top level directory via the path input. |
|
dir_names | string | false | "false" |
Output unique changed directories instead of filenames. NOTE: This returns . forchanged files located in the root of the project. |
dir_names_max_depth | string | false | Maximum depth of directories to output. e.g test/test1/test2 with max depth of2 returns test/test1 . |
|
fetch_depth | string | false | "50" |
Depth of additional branch history fetched. NOTE: This can be adjusted to resolve errors with insufficient history. |
files | string | false | File and directory patterns to detect changes using only these list of file(s) (Defaults to the entire repo) NOTE: Multiline file/directory patterns should not include quotes. |
|
files_from_source_file | string | false | Source file(s) used to populate thefiles input. |
|
files_ignore | string | false | Ignore changes to these file(s) NOTE: Multiline file/directory patterns should not include quotes. |
|
files_ignore_from_source_file | string | false | Source file(s) used to populate thefiles_ignore input |
|
files_ignore_separator | string | false | "\n" |
Separator used to split the files_ignore input |
files_separator | string | false | "\n" |
Separator used to split the files input |
include_all_old_new_renamed_files | string | false | "false" |
Include all_old_new_renamed_files output. Note this cangenerate a large output See: #501. |
json | string | false | "false" |
Output list of changed files in a JSON formatted string which can be used for matrix jobs. |
json_raw_format | string | false | "false" |
Output list of changed files in a raw format which means that the output will not be surrounded by quotes and special characters will not be escaped. |
match_directories | string | false | "true" |
Indicates whether to include match directories |
old_new_files_separator | string | false | " " |
Split character for old and new renamed filename pairs. |
old_new_separator | string | false | "," |
Split character for old and new filename pairs. |
output_dir | string | false | ".github/outputs" |
Directory to store output files. |
path | string | false | "." |
Specify a relative path under $GITHUB_WORKSPACE to locate the repository. |
quotepath | string | false | "true" |
Use non ascii characters to match files and output the filenames completely verbatim by setting this to false |
separator | string | false | " " |
Split character for output strings |
sha | string | false | Specify a different commit SHA used for comparing changes |
|
since | string | false | Get changed files for commits whose timestamp is older than the given time. |
|
since_last_remote_commit | string | true | "false" |
Use the last commit on the remote branch as the base_sha . Defaultsto the last non merge commit on the target branch for pull request events and the previous remote commit of the current branch for push events. |
until | string | false | Get changed files for commits whose timestamp is earlier than the given time. |
|
write_output_files | string | false | "false" |
Write outputs to files in the.github/outputs folder by default. |
OUTPUT | TYPE |
---|---|
added_files | string |
all_changed_and_modified_files | string |
all_changed_files | string |
all_modified_files | string |
all_old_new_renamed_files | string |
any_changed | string |
any_deleted | string |
any_modified | string |
copied_files | string |
deleted_files | string |
modified_files | string |
only_changed | string |
only_deleted | string |
only_modified | string |
other_changed_files | string |
other_deleted_files | string |
other_modified_files | string |
renamed_files | string |
type_changed_files | string |
unknown_files | string |
unmerged_files | string |