A tool to reset perforce local workspace to its initial state.
P4clean returns a folder tree inside a local Perfoce workspace to its original state by deleting untracked files and removing all empty folders. An exclusion list can be set so untracked development files are not deleted.
Warning: This tool is to be used only if you are confident untracked files can be deleted. Otherwise ‘p4 reconcile’ (Perforce 2012.1 and later) may be a better choice.
Perforce server and command line tools must be installed.
$ pip install --upgrade p4clean
$ easy_install -ZU p4clean
To clean current folder hiearchy
Usage: p4clean [options] Clean Perfoce local workspace. Options: -n, --dry-run Print names of files and folders that would be deleted -q, --quiet Do not print names of deleted files and folders -e, --exclude Semicolon separated list of file and folder patterns to be ignored from the clean-up. -v, --version Show program's version number and exit -h, --help Show this help message and exit
An optional p4clean config file can be used. Add a file named ‘.p4clean’ anywhere inside the local workspace (Suggested location for .p4clean config file is workspace root). At launch, p4clean looks recursively up to the workspace root for this file. If found, matching pattern files and directories are excluded from the clean-up.
p4clean config file example:
[p4clean] exclude = *.log;*/.git*;