android-localisation 1.1.1__tar.gz → 1.1.2__tar.gz

{android_localisation-1.1.1/android_localisation.egg-info → android_localisation-1.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-localisation
-Version: 1.1.1
+Version: 1.1.2
 Summary: Zero-dependency Android strings.xml translation and verification using LLMs (Gemini, OpenAI, Anthropic, Ollama).
 License: MIT
 Project-URL: Homepage, https://github.com/BharathKmalviya/android-llm-localization
@@ -56,6 +56,24 @@ Requires Python 3.8+. No other dependencies.
 
 CLI output uses UTF-8, including when redirected to a file or pipe on Windows.
 
+### Update notices
+
+Interactive `android-localise` commands check PyPI for a newer stable release in
+the background, at most once every 24 hours. When available, a note on stderr
+shows `pip install --upgrade android-localisation`. The CLI never waits for the
+lookup or installs an update automatically. A first short command may finish
+before the lookup completes; a notice appears when a check completes during a
+command or a later invocation can use its cached result.
+
+Checks are skipped for help/version output, CI (`CI` set), redirected output and
+pipes. Set `ANDROID_LOCALISE_NO_UPDATE_CHECK=1` to disable them, including when
+using a local model offline. Lookup or cache failures stay silent and do not
+change command exit codes. The small cache lives under
+`%LOCALAPPDATA%/android-localisation` on Windows, or
+`${XDG_CACHE_HOME:-~/.cache}/android-localisation` elsewhere. Only the package's
+public release metadata is requested; API keys and Android resources are never
+included.
+
 ---
 
 ## Quick start
@@ -289,6 +307,8 @@ android-localise translate
 | `OPENAI_API_KEY` | `--provider openai` and `--provider custom` |
 | `ANTHROPIC_API_KEY` | `--provider anthropic` |
 | `API_KEY` | fallback for any provider if the provider-specific var is not set |
+| `ANDROID_LOCALISE_NO_UPDATE_CHECK` | Set to `1` to disable update checks/notices |
+| `CI` | When nonempty, skips update checks/notices |
 
 ---
 

{android_localisation-1.1.1 → android_localisation-1.1.2}/README.md

@@ -28,6 +28,24 @@ Requires Python 3.8+. No other dependencies.
 
 CLI output uses UTF-8, including when redirected to a file or pipe on Windows.
 
+### Update notices
+
+Interactive `android-localise` commands check PyPI for a newer stable release in
+the background, at most once every 24 hours. When available, a note on stderr
+shows `pip install --upgrade android-localisation`. The CLI never waits for the
+lookup or installs an update automatically. A first short command may finish
+before the lookup completes; a notice appears when a check completes during a
+command or a later invocation can use its cached result.
+
+Checks are skipped for help/version output, CI (`CI` set), redirected output and
+pipes. Set `ANDROID_LOCALISE_NO_UPDATE_CHECK=1` to disable them, including when
+using a local model offline. Lookup or cache failures stay silent and do not
+change command exit codes. The small cache lives under
+`%LOCALAPPDATA%/android-localisation` on Windows, or
+`${XDG_CACHE_HOME:-~/.cache}/android-localisation` elsewhere. Only the package's
+public release metadata is requested; API keys and Android resources are never
+included.
+
 ---
 
 ## Quick start
@@ -261,6 +279,8 @@ android-localise translate
 | `OPENAI_API_KEY` | `--provider openai` and `--provider custom` |
 | `ANTHROPIC_API_KEY` | `--provider anthropic` |
 | `API_KEY` | fallback for any provider if the provider-specific var is not set |
+| `ANDROID_LOCALISE_NO_UPDATE_CHECK` | Set to `1` to disable update checks/notices |
+| `CI` | When nonempty, skips update checks/notices |
 
 ---
 

{android_localisation-1.1.1 → android_localisation-1.1.2}/android_localisation/__init__.py

@@ -2,4 +2,4 @@
 android-localisation: Zero-dependency Android strings.xml translation using LLMs.
 """
 
-__version__ = "1.1.1"
+__version__ = "1.1.2"

{android_localisation-1.1.1 → android_localisation-1.1.2}/android_localisation/cli.py

@@ -13,7 +13,7 @@ import sys
 from android_localisation import __version__
 
 
-def main():
+def main(args=None):
     for stream in (sys.stdout, sys.stderr):
         if hasattr(stream, "reconfigure"):
             stream.reconfigure(encoding="utf-8", errors="replace")
@@ -57,8 +57,18 @@ def main():
     models_parser.add_argument("--provider", choices=["gemini", "openai", "anthropic"], default=None,
                                help="Filter by provider (shows all if not set)")
 
-    args = parser.parse_args()
+    if args is None or isinstance(args, list):
+        args = parser.parse_args(args)
 
+    from android_localisation.updates import start_update_check, show_update_notice
+    update_state = start_update_check()
+    try:
+        return _run_command(args)
+    finally:
+        show_update_notice(update_state)
+
+
+def _run_command(args):
     if args.command == "translate":
         from android_localisation.translate import main as run
         return run(args)

android_localisation-1.1.2/android_localisation/updates.py

@@ -0,0 +1,95 @@
+"""Best-effort release notices for interactive CLI sessions."""
+
+import json
+import os
+from pathlib import Path
+import re
+import sys
+import threading
+import time
+import urllib.request
+
+from android_localisation import __version__
+from android_localisation.resources import atomic_write
+
+CHECK_INTERVAL = 24 * 60 * 60
+PYPI_URL = "https://pypi.org/pypi/android-localisation/json"
+
+
+def _stable_version(value):
+    # This package releases semantic versions; never advertise prereleases.
+    if not isinstance(value, str) or not re.fullmatch(r"[0-9]{1,6}\.[0-9]{1,6}\.[0-9]{1,6}", value):
+        return None
+    return tuple(int(part) for part in value.split("."))
+
+
+def _cache_path():
+    if os.name == "nt":
+        base = os.environ.get("LOCALAPPDATA") or str(Path.home() / "AppData" / "Local")
+    else:
+        base = os.environ.get("XDG_CACHE_HOME") or str(Path.home() / ".cache")
+    return Path(base) / "android-localisation" / "update.json"
+
+
+def start_update_check():
+    """Return notice state; refresh in a daemon thread without waiting for network."""
+    try:
+        if os.environ.get("ANDROID_LOCALISE_NO_UPDATE_CHECK") or os.environ.get("CI"):
+            return None
+        if not sys.stdout.isatty() or not sys.stderr.isatty():
+            return None
+        if _stable_version(__version__) is None:
+            return None
+        path = _cache_path()
+        now = time.time()
+        state = {"latest": None}
+        try:
+            cached = json.loads(path.read_text(encoding="utf-8"))
+            if _stable_version(cached.get("latest")):
+                state["latest"] = cached["latest"]
+            checked = cached.get("checked_at")
+            if isinstance(checked, (int, float)) and 0 <= now - checked < CHECK_INTERVAL:
+                return state
+        except (OSError, ValueError, TypeError, AttributeError):
+            pass
+
+        def refresh():
+            try:
+                request = urllib.request.Request(
+                    PYPI_URL,
+                    headers={"User-Agent": "android-localisation/{}".format(__version__)},
+                )
+                with urllib.request.urlopen(request, timeout=1) as response:
+                    payload = json.loads(response.read(512 * 1024).decode("utf-8"))
+                latest = payload["info"]["version"]
+                if _stable_version(latest):
+                    state["latest"] = latest
+            except Exception:
+                # Offline, malformed replies and lookup failures never affect commands.
+                pass
+            try:
+                path.parent.mkdir(parents=True, exist_ok=True)
+                atomic_write(str(path), json.dumps({"checked_at": now, "latest": state["latest"]}))
+            except Exception:
+                pass
+
+        threading.Thread(target=refresh, name="release-check", daemon=True).start()
+        return state
+    except Exception:
+        return None
+
+
+def show_update_notice(state):
+    """Print only a completed/cached check, preserving stdout and exit status."""
+    try:
+        latest = state.get("latest") if state else None
+        available = _stable_version(latest)
+        installed = _stable_version(__version__)
+        if available and installed and available > installed:
+            print(
+                "\nUpdate available: android-localisation {} (installed {}).\n"
+                "Upgrade: pip install --upgrade android-localisation".format(latest, __version__),
+                file=sys.stderr,
+            )
+    except Exception:
+        pass

{android_localisation-1.1.1 → android_localisation-1.1.2/android_localisation.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: android-localisation
-Version: 1.1.1
+Version: 1.1.2
 Summary: Zero-dependency Android strings.xml translation and verification using LLMs (Gemini, OpenAI, Anthropic, Ollama).
 License: MIT
 Project-URL: Homepage, https://github.com/BharathKmalviya/android-llm-localization
@@ -56,6 +56,24 @@ Requires Python 3.8+. No other dependencies.
 
 CLI output uses UTF-8, including when redirected to a file or pipe on Windows.
 
+### Update notices
+
+Interactive `android-localise` commands check PyPI for a newer stable release in
+the background, at most once every 24 hours. When available, a note on stderr
+shows `pip install --upgrade android-localisation`. The CLI never waits for the
+lookup or installs an update automatically. A first short command may finish
+before the lookup completes; a notice appears when a check completes during a
+command or a later invocation can use its cached result.
+
+Checks are skipped for help/version output, CI (`CI` set), redirected output and
+pipes. Set `ANDROID_LOCALISE_NO_UPDATE_CHECK=1` to disable them, including when
+using a local model offline. Lookup or cache failures stay silent and do not
+change command exit codes. The small cache lives under
+`%LOCALAPPDATA%/android-localisation` on Windows, or
+`${XDG_CACHE_HOME:-~/.cache}/android-localisation` elsewhere. Only the package's
+public release metadata is requested; API keys and Android resources are never
+included.
+
 ---
 
 ## Quick start
@@ -289,6 +307,8 @@ android-localise translate
 | `OPENAI_API_KEY` | `--provider openai` and `--provider custom` |
 | `ANTHROPIC_API_KEY` | `--provider anthropic` |
 | `API_KEY` | fallback for any provider if the provider-specific var is not set |
+| `ANDROID_LOCALISE_NO_UPDATE_CHECK` | Set to `1` to disable update checks/notices |
+| `CI` | When nonempty, skips update checks/notices |
 
 ---
 

{android_localisation-1.1.1 → android_localisation-1.1.2}/android_localisation.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ android_localisation/cli.py
 android_localisation/fix.py
 android_localisation/resources.py
 android_localisation/translate.py
+android_localisation/updates.py
 android_localisation/verify.py
 android_localisation.egg-info/PKG-INFO
 android_localisation.egg-info/SOURCES.txt

{android_localisation-1.1.1 → android_localisation-1.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "android-localisation"
-version = "1.1.1"
+version = "1.1.2"
 description = "Zero-dependency Android strings.xml translation and verification using LLMs (Gemini, OpenAI, Anthropic, Ollama)."
 readme = "README.md"
 license = { text = "MIT" }