skip to navigation
skip to content

p4clean 0.2.1

A tool to reset perforce local workspace to its initial state.

Latest Version: 0.3.3


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.


From pip:

$ pip install --upgrade p4clean

From easy_install:

$ easy_install -ZU p4clean


To clean current folder hiearchy

$ p4clean


Usage: p4clean [options]

Clean Perfoce local workspace.

  -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

Config file

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:

exclude = *.log;*/.git*;
File Type Py Version Uploaded on Size (md5) Source 2014-03-11 12KB