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.

Say in the documents how Homebrew answers in place of an app's source

Țugui Dragoș815423a6b588
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index 74419a3a..9faa5820 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -324,16 +324,20 @@ macOS asks the user to approve it once. It talks to the app over XPC.
`SUVerifyUpdateBeforeExtraction`, and `SUAllowsAutomaticUpdates` off), the one place Sparkle reads its security
settings from. It asks on its own only while Check for app updates is on (`OwnUpdateCheck`), and the update
round of the other apps passes over Peel.
-- **Updates of other apps.** `UpdateChecker` asks each app's own feed, or the App Store about an app from the App
- Store, and uses what Homebrew knows for an app a cask installed, an "up to date" only for a day after Homebrew
- last checked for new versions (`Homebrew.lastUpdateCheck`, the time of `.git/FETCH_HEAD` in its repository, which
- Homebrew itself compares before updating on its own). What Homebrew's casks and the app's own files decide without
- a server (`statusWithoutAsking`) shows as soon as Homebrew is read, and again at every round, and Peel reads
- Homebrew again once it has checked since. From the App Store it reads the listing of the installed bundle
- (`AppStoreListing`): the Mac's, which Apple gives for the desktop, also for an app sold once for iPhone and Mac,
- or the iPhone and iPad one for an app of those devices installed on the Mac. Every answer that changes nothing
- makes the next check of that app wait longer, up to a week (`UpdateSchedule`), and `UpdateMemory` keeps the last
- answer across launches.
+- **Updates of other apps.** `UpdateChecker` asks each app's own feed, or the App Store about an app from the App Store,
+ and uses what Homebrew knows for an app a cask installed: first with Automatic or Homebrew preferred, and under any
+ choice once the app's own source can't answer, an "up to date" only for a day after Homebrew last checked for new
+ versions (`Homebrew.lastUpdateCheck`, the time of `.git/FETCH_HEAD` in its repository, which Homebrew itself compares
+ before updating on its own). An answer Homebrew gives in place of the app's own source carries what that source
+ answered (`UpdateAnswer.standsInFor`, kept in `UpdateMemory`): the source's answer stands again once Homebrew's no
+ longer counts, the next check follows the source's own count, and an update the source found earlier stays. What
+ Homebrew's casks and the app's own files decide without a server, and what Homebrew knows where the app's own source
+ last had no answer (`statusWithoutAsking`), shows as soon as Homebrew is read, and again at every round, an update
+ Homebrew no longer reports is forgotten then, and Peel reads Homebrew again once it has checked since. From the App
+ Store it reads the listing of the installed bundle (`AppStoreListing`): the Mac's, which Apple gives for the desktop,
+ also for an app sold once for iPhone and Mac, or the iPhone and iPad one for an app of those devices installed on the
+ Mac. Every answer that changes nothing makes the next check of that app wait longer, up to a week (`UpdateSchedule`),
+ and `UpdateMemory` keeps the last answer across launches.
- **Orphaned Files.** `OrphanScanner` lists what no installed app claims, under the app Peel saw go when it can
name it (`AppMemory`), and selects nothing for the person.
- **Resetting an app.** `AppReset` selects an app's settings, caches, and window state, which the app makes again
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 96293ccd..e896321c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -65,6 +65,9 @@ its changes the way [Keep a Changelog](https://keepachangelog.com/) suggests.
- Rescan asks about every app's updates again at once, whatever each one's schedule says.
- Peel reads Homebrew again once Homebrew has checked for new versions since Peel last read it, as after `brew update`
in Terminal.
+- With The App Store or The app's own feed preferred, an app its own source can't answer for gets what Homebrew knows,
+ as with Automatic, and `peel updates` says the same as Applications. The note under Prefer updates from in Settings
+ gives the order.
- A folder named like the app without the word of its release channel, as Zed Nightly keeps its settings in `zed`, is
shown for review and never selected, and Orphaned Files counts it as the installed channel's.
@@ -126,6 +129,11 @@ its changes the way [Keep a Changelog](https://keepachangelog.com/) suggests.
days before: what Homebrew says counts for a day after it last checked for new versions, and the app's page then says
when that was and that Update Homebrew lets Peel tell again. `peel updates` says it too.
- An update Homebrew learns of shows at once, also for an app it had called up to date.
+- An app whose own feed couldn't be reached no longer reads "Up to date" on what Homebrew knew more than a day before,
+ or once Homebrew no longer has the app, and its feed is asked again as often as any feed that fails.
+- An update an app's own feed found stays when a later check can't reach the feed, even where Homebrew, not caught up
+ yet, calls the app up to date.
+- An update Homebrew no longer reports leaves the list as soon as Peel reads Homebrew again, rather than a day later.
- A folder named like the app is no longer selected while another app's name holds that name, as Epic Games Launcher
holds Epic: it is listed as also used by that app.
- An app whose identifier a tool wrote for it, such as Electron's `com.electron.<name>`, no longer lists every other
diff --git a/GUIDE.md b/GUIDE.md
index 7729eb68..14fe9c91 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -70,16 +70,15 @@ and how to get it, [SAFETY.md](SAFETY.md) what it protects, [PRIVACY.md](PRIVACY
of these files.
- **What it opens.** An app's page lists the kinds of files and links it opens by default, and what would open
them once it's gone. Peel never changes that itself.
-- **Updates for your apps.** Peel checks your apps for new versions, through the update feed each app names, the
- App Store for apps bought there, iPhone and iPad apps on the Mac included, or Homebrew for apps it installed, as
- Prefer updates from in Settings > General chooses, and shows what is new in the version that waits, as the app's
- own notes say it, even with no connection. What Homebrew says counts for a day after it last checked for new
- versions, the time Homebrew itself waits before it checks again. Past that, an app only Homebrew can answer for
- reads Can't check for updates until Homebrew checks again, with Update Homebrew on the Homebrew page or
- `brew update` in Terminal, and Peel reads Homebrew again once it has. Rescan in Applications asks about every app
- again at once. Skip This Version and Never Check This App keep it quiet about the ones you want left alone, and
- Settings > General lists them under Muted Updates, where Check Again brings their updates back. Turning off Check
- for app updates there stops the checks.
+- **Updates for your apps.** Peel checks your apps for new versions, through the update feed each app names, the App
+ Store for apps bought there, iPhone and iPad apps on the Mac included, or Homebrew for apps it installed, in the order
+ Prefer updates from in Settings > General sets, and shows what is new in the version that waits, as the app's own
+ notes say it, even with no connection. What Homebrew says counts for a day after it last checked for new versions, the
+ time Homebrew itself waits before it checks again. Past that, an app only Homebrew can answer for reads Can't check
+ for updates until Homebrew checks again, with Update Homebrew on the Homebrew page or `brew update` in Terminal, and
+ Peel reads Homebrew again once it has. Rescan in Applications asks about every app again at once. Skip This Version
+ and Never Check This App keep it quiet about the ones you want left alone, and Settings > General lists them under
+ Muted Updates, where Check Again brings their updates back. Turning off Check for app updates there stops the checks.
## Free up disk space