diffCommits

List modified files between two commits

Since R2025a

Syntax

files = diffCommits(repo,firstCommit,secondCommit)

files = diffCommits(repo,firstCommit,secondCommit,MergeBase=tf)

Description

files = diffCommits(repo,firstCommit,secondCommit) returns the list of files that changed between the specified commits in the Git™ repository repo.

files = diffCommits(repo,firstCommit,secondCommit,MergeBase=tf), if tf is true, finds the merge base of firstCommit and secondCommit and returns the list of files that changed between the merge base and secondCommit.

Examples

List Modified Files Between Branches

Navigate to your repository folder and create a repository object.

repo = gitrepo;

List all files that changed between the branches main and featureBranch.

files = diffCommits(repo,"main","featureBranch")

files = 

  3×1 table

                                                                  Status  
                                                                 __________

    "C:\myWorkSpace\example\repo\data.txt"                        Modified
    "C:\myWorkSpace\example\repo\README.md"                       Modified
    "C:\myWorkSpace\example\repo\model.slx"                       Added

List only the files that have the status Modified.

modifiedFiles = files(files.Status == "Modified",:).File

modifiedFiles =

  2×1 cell array

    {'C:\myWorkSpace\example\repo\data.txt' }
    {'C:\myWorkSpace\example\repo\README.md'}
  

List Modified Files Between Commits Using Their Merge Base

Navigate to your repository folder and create a repository object.

repo = gitrepo;

Find the common ancestor of commit 40eba76 and commit d834e90 and list all files that changed between the common ancestor and d834e90.

files = diffCommits(repo,"40eba76","d834e90",MergeBase=true)

files = 

  3×1 table

                                                                  Status  
                                                                 __________

    "C:\myWorkSpace\example\repo\newData.txt"                     Added
    "C:\myWorkSpace\example\repo\README.md"                       Modified
    "C:\myWorkSpace\example\repo\mymodel.slx"                     Deleted

Input Arguments

repo — Git repository

matlab.git.GitRepository object

Git repository, specified as a matlab.git.GitRepository object.

firstCommit — Revision specifier

string scalar | character vector | matlab.git.GitBranch object

Revision specifier (ID), specified as a string scalar, character vector, or matlab.git.GitBranch object.

Commit IDs support short, full, and relative commits.

Example: "08a4c49", "08a4c49d249a4dc3d998b473cdda186f1c05dfd0", "origin/Dev"

secondCommit — Revision specifier

string scalar | character vector | matlab.git.GitBranch object

Revision specifier (ID), specified as a string scalar, character vector, or matlab.git.GitBranch object.

Commit IDs support short, full, and relative commits.

Example: "08a4c49", "08a4c49d249a4dc3d998b473cdda186f1c05dfd0", "origin/Dev"

Data Types: char | string

tf — Option to find merge base

false or 0 (default) | true or 1

Option to find the merge base of two Git commits, specified as a numeric or logical 1 (true) or 0 (false).

Data Types: logical

Output Arguments

files — Modified files between commits

table

Modified files and their status between the specified commits in the Git repository, returned as a table.

The status of the file can only be Added, Deleted, or Modified.

Version History

Introduced in R2025a