Skip to main content

Delete registry keys, registry value/ value_names, path entries, and often used installation directories based on a string search.

Reason this release was yanked:

Subparser names can't start with --

Project description

Win_purge

It is a very bad idea to run Python code from the internet that modifies the Windows Registry. Minor bugs in Win_purge can be critical - any could inadvertantly cripple your system. Win_purge can delete important registry keys if you let it - I do not know the purpose of every Registry key, and there is no special treatment of any Windows edition or setups (the code can quickly become out of date - the frequency of automatic Windows updates in the modern age, means Win_purge could have become inadvertantly unsafe at any point in time).

I draw your attention to the last paragraph of the MIT license:

"THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE."

That said, if you accept the risk, then win_purge has been designed to take the following steps to protect your system, based on a simple text search:

  • Refuses to run if a matching registered uninstaller is found (as this should be run instead).

  • Uses exactly the same search code for a safe dry run, as for a run that deletes matching keys - no surprising results.

  • Requires a special force switch on the CLI to delete and modify keys.

  • Prompts for confirmation, skip or quit (y/n/quit respectively) before each change.

  • Tries to identify system path keys. In recognised path keys, win_purge modifies the path name/data in the value instead (removing matching paths from the system wide path and from the user's path).

  • Backs up each key before modification or deletion (with reg export[^0]), and consolidates the backups after each session.

  • Uses send2trash to send the temporary key back up files to the Recycle Bin (does not permanently delete them).

  • Win_purge can also delete matching application files from common installation directories.

Project details


Download files

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

Source Distribution

win_purge-0.0.0.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

win_purge-0.0.0-py3-none-any.whl (14.3 kB view details)

Uploaded Python 3

File details

Details for the file win_purge-0.0.0.tar.gz.

File metadata

  • Download URL: win_purge-0.0.0.tar.gz
  • Upload date:
  • Size: 11.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.4.20

File hashes

Hashes for win_purge-0.0.0.tar.gz
Algorithm Hash digest
SHA256 8dc72f6e6f2d7d27880a52e9aa29aa31d19d3437f0436ff05b7d493ad463d7d9
MD5 6a58552b9b07237fda7dd8dd569bffdd
BLAKE2b-256 d0d3c7a42630c4fb8832a23635655f5b349596c631038ad43acf42dcc7cd5db5

See more details on using hashes here.

File details

Details for the file win_purge-0.0.0-py3-none-any.whl.

File metadata

  • Download URL: win_purge-0.0.0-py3-none-any.whl
  • Upload date:
  • Size: 14.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.4.20

File hashes

Hashes for win_purge-0.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 6936b9fc93fcbcc0e52f334a6fca0781727ef525711fef6d1245fc7d8fb2ed85
MD5 f8a5075a57488843acb9d853c1424291
BLAKE2b-256 a2cc8acc7dd3b05211c4de7d71fe919a160a16450495be31fe821b5e2fce0228

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page