datalad.api.diff(path=None, dataset=None, revision=None, staged=False, ignore_subdatasets='none', report_untracked='normal', recursive=False, recursion_limit=None)

Report changes of dataset components.

Reports can be generated for changes between recorded revisions, or between a revision and the state of a dataset’s work tree.

Unlike ‘git diff’, this command also reports untracked content when comparing a revision to the state of the work tree. Such content is marked with the property state=’untracked’ in the command results.

The following types of changes are distinguished and reported via the state result property: