pyselfupdate 0.5.1__tar.gz → 0.5.2__tar.gz

{pyselfupdate-0.5.1 → pyselfupdate-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pyselfupdate
-Version: 0.5.1
+Version: 0.5.2
 Summary: Self-update and update notification for Python CLIs installed with uv tool
 Project-URL: Repository, https://github.com/datapointchris/pyselfupdate
 Project-URL: Issues, https://github.com/datapointchris/pyselfupdate/issues

{pyselfupdate-0.5.1 → pyselfupdate-0.5.2}/src/pyselfupdate/github.py

@@ -88,10 +88,9 @@ DEFAULT_TOKEN_COMMAND = 'gh auth token'  # nosec B105
 
 Authenticating is the default because the alternative is not "no credential" but
 "sixty requests an hour, charged per IP address and shared by every host behind
-one egress". Measured 2026-08-21 across one household: two machines checking on a
-timer held that pool at zero for whole hours, and every tool on the network that
-asked anonymously was refused. A default that has to be opted into is a default
-nobody sets, and eleven of fourteen tools here had not.
+one egress". Two machines checking on a timer can hold that pool at zero for
+whole hours, and every tool behind the same address that asks anonymously is
+then refused. A default that has to be opted into is a default nobody sets.
 """
 
 

{pyselfupdate-0.5.1 → pyselfupdate-0.5.2}/src/pyselfupdate/install.py

@@ -83,9 +83,6 @@ class Installation:
     # raises NotInstalledError on them instead of dropping them.
     _unrebuildable: tuple[str, ...] = field(default=(), repr=False)
 
-    def is_updatable(self) -> bool:
-        return self.kind is not InstallKind.LOCAL
-
 
 def tool_dir() -> Path:
     """uv's tool directory.

{pyselfupdate-0.5.1 → pyselfupdate-0.5.2}/src/pyselfupdate/notifier.py

@@ -28,11 +28,12 @@ from pyselfupdate.updater import installed_from_release
 
 DEFAULT_INTERVAL = dt.timedelta(hours=24)
 
-# Environment variables. Presence-only, any value including empty -- the
+# The environment variables every tool honors, beside its own `<TOOL>_` forms.
+# The disable switch is presence-only, any value including empty -- the
 # NO_COLOR convention -- so that NO_AUTO_UPDATE=0 cannot mean "on". The interval
 # gets its own name precisely so presence and value never share one variable.
-FLEET_DISABLE = 'NO_AUTO_UPDATE'
-FLEET_INTERVAL = 'AUTO_UPDATE_INTERVAL'
+_SHARED_DISABLE_VARIABLE = 'NO_AUTO_UPDATE'
+_SHARED_INTERVAL_VARIABLE = 'AUTO_UPDATE_INTERVAL'
 
 CI_VARIABLES = ('CI', 'BUILD_NUMBER', 'RUN_ID', 'GITHUB_ACTIONS', 'CODESPACES')
 
@@ -97,9 +98,10 @@ def notify(
 def enabled(config: Config, *, interactive: bool | None = None) -> tuple[bool, Skip | None]:
     """Whether a check would run, without touching the network or the clock.
 
-    Backs a fleet dashboard and a `<tool> update --why`. The interval is
-    deliberately not consulted: this answers "is this tool opted in", not "is it
-    due".
+    For a caller that reports why a tool does or does not check, such as a
+    dashboard listing installed tools or a `<tool> update --why`. The interval
+    is deliberately not consulted: this answers "is this tool opted in", not "is
+    it due".
     """
     if _disabled_by_env(config.tool):
         return False, Skip.DISABLED
@@ -122,9 +124,9 @@ def _asking_for_help() -> bool:
     screen. Nothing a notice is for happens on a help screen, and the check
     costs a releases-API call and a state write every time.
 
-    It lands hardest on a reader that walks a tool's help. Measured 2026-08-22:
-    reading doit's twenty commands meant twenty-one invocations, each one
-    reaching this.
+    It lands hardest on a reader that walks a tool's help. Reading every
+    command's help is one invocation per command plus one for the root, and
+    each of them reaches this.
 
     A `--` ends the scan, because everything after it is the command's own
     argument. Skipping when it should not have costs a missed notice, which is
@@ -201,7 +203,7 @@ def _emit(message: str, *, out: TextIO | None, defer: bool) -> None:
 
 
 def _disabled_by_env(tool: str) -> bool:
-    return FLEET_DISABLE in os.environ or _tool_variable(tool, 'NO_AUTO_UPDATE') in os.environ
+    return _SHARED_DISABLE_VARIABLE in os.environ or _tool_variable(tool, 'NO_AUTO_UPDATE') in os.environ
 
 
 def _in_ci() -> bool:
@@ -250,7 +252,7 @@ def _is_local_install(config: Config) -> bool:
 def _interval(tool: str, override: dt.timedelta | None) -> dt.timedelta:
     if override is not None:
         return override
-    for name in (_tool_variable(tool, 'AUTO_UPDATE_INTERVAL'), FLEET_INTERVAL):
+    for name in (_tool_variable(tool, 'AUTO_UPDATE_INTERVAL'), _SHARED_INTERVAL_VARIABLE):
         raw = os.environ.get(name)
         if raw:
             parsed = parse_interval(raw)