Skip to content

armgit / peel

Public Imported from GitHub
0

Uninstall Mac apps with every file they leave behind, and see why each belongs. Free up space, fine-tune macOS, and set up Terminal.

Name the folders Put Back takes back among what Peel deletes outright

Țugui Dragoșbcecc685c712
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index ad4f14f2..674fd1ec 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -186,18 +186,19 @@ A handful of ideas carry most of the weight. Each is enforced in one place and t
- **The Trash, never deletion.** Nothing in Peel deletes anything of the user's. What it deletes outright holds
nothing of theirs: the empty placeholder `TrashMover` makes to hold a name on a disk that cannot rename without
replacing (exFAT), when the move it was made for fails; the folder `PreferenceBackup` makes for a reset's saved
- settings, when saving fails while it is still empty; and the empty file cfprefsd writes back where a moved
- settings file was when `PreferenceCleanup` forgets a domain it still holds, which would keep History from putting
- that file back. Peel's list of refusals goes to the Trash when `peel history --refused --clear` asks. Four
- actions can't be undone by History, and each says so where it is confirmed: Homebrew's own uninstall and
- cleanups, resetting an app's privacy permissions, and Force Quit for an app that is still open 10 seconds after
- Peel asked it to quit (`QuitBeforeRemoving`). Moving Mullvad VPN, Citrix Workspace, or TeamViewer starts that
- app's own uninstaller, which deletes what History can't bring back, and Peel says so before it moves them
- (`UninstallsItself`). Forgetting a preference domain happens only once its file is in the Trash, so putting the
- file back undoes it, or, when saved settings are put back, once the settings in use are saved as a copy of their
- own (`PreferenceBackup`). Every `brew` call runs without Homebrew's automatic cleanup
- (`HOMEBREW_NO_INSTALL_CLEANUP`), so an upgrade never deletes on its own; when a `brew.env` file of the user's
- turns that back on (`Homebrew.overrides()`, from `brew config`), the Homebrew page says so and leaves upgrades to
+ settings, when saving fails while it is still empty; the folders Put Back makes on the way back
+ (`DirectoryHandle.child(_:makingIfMissing:)`), when the item then stays in the Trash and each is still the empty
+ folder it made; and the empty file cfprefsd writes back where a moved settings file was when `PreferenceCleanup`
+ forgets a domain it still holds, which would keep History from putting that file back. Peel's list of refusals goes
+ to the Trash when `peel history --refused --clear` asks. Four actions can't be undone by History, and each says so
+ where it is confirmed: Homebrew's own uninstall and cleanups, resetting an app's privacy permissions, and Force Quit
+ for an app that is still open 10 seconds after Peel asked it to quit (`QuitBeforeRemoving`). Moving Mullvad VPN,
+ Citrix Workspace, or TeamViewer starts that app's own uninstaller, which deletes what History can't bring back, and
+ Peel says so before it moves them (`UninstallsItself`). Forgetting a preference domain happens only once its file is
+ in the Trash, so putting the file back undoes it, or, when saved settings are put back, once the settings in use are
+ saved as a copy of their own (`PreferenceBackup`). Every `brew` call runs without Homebrew's automatic cleanup
+ (`HOMEBREW_NO_INSTALL_CLEANUP`), so an upgrade never deletes on its own; when a `brew.env` file of the user's turns
+ that back on (`Homebrew.overrides()`, from `brew config`), the Homebrew page says so and leaves upgrades to
Terminal.
- **One guard.** `RemovalGuard` decides, for the app and the `peel` tool alike, whether an item may move. Its
list of what nothing can bring back lives in `ProtectedData`, in PeelPrivileged, so the helper applies the
diff --git a/SAFETY.md b/SAFETY.md
index 6fc3f653..3288c5af 100644
--- a/SAFETY.md
+++ b/SAFETY.md
@@ -185,9 +185,10 @@ themselves; on one that cannot, such as exFAT, Peel first takes the name with an
free name allows, and the move then replaces the placeholder.
What Peel deletes outright holds nothing of yours: such a placeholder, when the move it was made for fails; the folder
-it makes to save an app's settings before a reset, when saving fails before anything is written in it; and the empty
-settings file macOS writes back when Peel forgets a preference domain, as described below. Its list of refusals goes
-to the Trash when `peel history --refused --clear` is asked to forget it, after a question.
+it makes to save an app's settings before a reset, when saving fails before anything is written in it; the folders it
+makes again on the way back for a Put Back, when the item then stays in the Trash and each is still the empty folder it
+made; and the empty settings file macOS writes back when Peel forgets a preference domain, as described below. Its list
+of refusals goes to the Trash when `peel history --refused --clear` is asked to forget it, after a question.
Four things Peel starts can't be undone by History, and Peel says so before you confirm each of them: