fab.steps.cleanup_prebuilds#

Pruning of old files from the incremental/prebuild folder.

Functions

`by_age`(older_than, prebuilds_ts, current_files)
`by_version_age`(n_versions, prebuilds_ts, ...)
`cleanup_prebuilds`(config[, older_than, ...])	A step to delete old files from the local incremental/prebuild folder.
`get_access_time`(fpath)	Return the access time of the given file.
`remove_all_unused`(found_files, current_files)

fab.steps.cleanup_prebuilds.cleanup_prebuilds(config, older_than=None, n_versions=0, all_unused=None)#

A step to delete old files from the local incremental/prebuild folder.

Assumes prebuild filenames follow the pattern: <stem>.<hash>.<suffix>.

Parameters:

config – The fab.build_config.BuildConfig object where we can read settings such as the project workspace folder or the multiprocessing flag.
older_than (timedelta | None) – Delete prebuild artefacts which are n seconds older than the last prebuild access time. (default: None)
n_versions (int) – Only keep the most recent n versions of each artefact <stem>.*.<suffix> (default: 0)
all_unused (bool | None) – Delete everything which was not part of the current build. (default: None)

If no parameters are specified then all_unused will default to True.

fab.steps.cleanup_prebuilds.get_access_time(fpath)#

Return the access time of the given file.

Depends on the file system’s ability to report a file’s last access time via the os.stat_result.st_atime returned by Path.stat.