Scroll to navigation

datalad check-dates(1) datalad datalad check-dates(1)

NAME

datalad check-dates - find repository dates that are more recent than a reference date.

SYNOPSIS

datalad check-dates [-h] [-D DATE] [--rev REVISION] [--annex all|tree|none] [--no-tags] [--older] [PATH [PATH ...]]

DESCRIPTION

The main purpose of this tool is to find "leaked" real dates in repositories that are configured to use fake dates. It checks dates from three sources: (1) commit timestamps (author and committer dates), (2) timestamps within files of the "git-annex" branch, and (3) the timestamps of annotated tags.

OPTIONS

PATH
Root directory in which to search for Git repositories. The current working directory will be used by default. Constraints: value must be a string

-h, --help, --help-np
show this help message. --help-np forcefully disables the use of a pager for displaying the help message
-D DATE, --reference-date DATE
Compare dates to this date. If dateutil is installed, this value can be any format that its parser recognizes. Otherwise, it should be a unix timestamp that starts with a "@". The default value corresponds to 01 Jan, 2018 00:00:00 -0000. Constraints: value must be a string [Default: '@1514764800']
--rev REVISION
Search timestamps from commits that are reachable from REVISION. Any revision specification supported by git log, including flags like --all and --tags, can be used. This option can be given multiple times. [Default: None]
--annex all|tree|none
Mode for "git-annex" branch search. If 'all', all blobs within the branch are searched. 'tree' limits the search to blobs that are referenced by the tree at the tip of the branch. 'none' disables search of "git-annex" blobs. Constraints: value must be one of ('all', 'tree', 'none') [Default: 'all']
--no-tags
Don't check the dates of annotated tags. [Default: False]
--older
Find dates which are older than the reference date rather than newer. [Default: False]

AUTHORS

datalad is developed by The DataLad Team and Contributors <team@datalad.org>.
2019-02-08