Skip to main content

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

Project description

Build status


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*;

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for p4clean, version 0.3.3
Filename, size File type Python version Upload date Hashes
Filename, size (12.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page