assets_guardian.utils.dates

Functions

add_date_to_filename(path[, date_format])	Replaces the 'DATE' placeholder in the filename with today's date, if present.
format_datetime(value)	Formats a date into a string for display.
parse_datetime(value)	Parses a value into a datetime.

assets_guardian.utils.dates.add_date_to_filename(path: str | Path, date_format: str = '%Y_%m_%d') → str

Replaces the ‘DATE’ placeholder in the filename with today’s date, if present.

Parameters:

• path – Original file path (e.g. ‘outputs/audit_report_DATE.pdf’).

• date_format – strftime format used for the date.

Returns:

The path with ‘DATE’ replaced by today’s date (e.g.

’outputs/audit_report_2026_07_08.pdf’), or unchanged if the filename has no ‘DATE’ placeholder (e.g. ‘outputs/audit_report.pdf’).

Return type:

str

assets_guardian.utils.dates.format_datetime(value: datetime | str | None) → str

Formats a date into a string for display.

Returns ‘Never’ if the date is None or invalid. If a string is passed, tries to parse it first.

Parameters:

value – The date to format (datetime, str, or None).

Returns:

The formatted date or ‘Never’.

Return type:

str

assets_guardian.utils.dates.parse_datetime(value: str | int | float | datetime | None) → datetime | None

Parses a value into a datetime.

Parameters:

value – The value to parse.

Returns:

The parsed datetime if successful, None otherwise.

Return type:

datetime | None