wechatbridge-cli 1.3.0__py3-none-any.whl

wechatbridge/update_check.py

@@ -0,0 +1,175 @@
+"""
+wechatbridge Update Check Module
+Periodically check PyPI for new versions and notify admin users via WeChat.
+"""
+
+import asyncio
+import logging
+import re
+
+import httpx
+
+from . import __version__
+from .config import config
+
+logger = logging.getLogger(__name__)
+
+PYPI_URL = "https://pypi.org/pypi/wechatbridge-cli/json"
+RELEASES_URL = "https://github.com/dorokuma/wechatbridge/releases"
+
+
+# ---------------------------------------------------------------------------
+# Version comparison helpers
+# ---------------------------------------------------------------------------
+
+def _parse_version(v: str) -> tuple:
+    """Parse a semver string into a numeric tuple for comparison.
+
+    Each dot-segment is parsed by taking the leading digits; non-digit
+    suffixes (e.g. ``-beta``) are ignored. Missing segments default to 0.
+    """
+    parts = v.split(".")
+    result = []
+    for seg in parts:
+        m = re.match(r"\d+", seg)
+        result.append(int(m.group()) if m else 0)
+    return tuple(result)
+
+
+def is_newer(latest: str, current: str = __version__) -> bool:
+    """Return True if ``latest`` is a higher version than ``current``."""
+    return _parse_version(latest) > _parse_version(current)
+
+
+# ---------------------------------------------------------------------------
+# Module-level state
+# ---------------------------------------------------------------------------
+
+latest_version: str | None = None
+_notified_admins: set = set()
+
+
+# ---------------------------------------------------------------------------
+# Network operations
+# ---------------------------------------------------------------------------
+
+async def fetch_latest_version() -> str | None:
+    """Query PyPI JSON API for the latest published version.
+
+    Returns version string on success, ``None`` on any failure.
+    """
+    try:
+        async with httpx.AsyncClient(timeout=5.0) as client:
+            resp = await client.get(PYPI_URL)
+            resp.raise_for_status()
+            data = resp.json()
+            version: str = data["info"]["version"]
+            logger.debug("PyPI latest version: %s", version)
+            return version
+    except Exception as e:
+        logger.debug("Failed to fetch latest version from PyPI: %s", e)
+        return None
+
+
+# ---------------------------------------------------------------------------
+# Background loop
+# ---------------------------------------------------------------------------
+
+async def update_check_loop() -> None:
+    """Background task: check PyPI immediately, then every ``update_check_interval`` seconds.
+
+    Never raises; all exceptions are caught and logged.
+    """
+    global latest_version
+
+    while True:
+        try:
+            version = await fetch_latest_version()
+            if version is not None:
+                if latest_version is None or is_newer(version, latest_version):
+                    latest_version = version
+                    if is_newer(version):
+                        logger.warning(
+                            "发现新版本: 当前 %s → 最新 %s。"
+                            "更新: `pipx upgrade wechatbridge-cli` | %s",
+                            __version__, version, RELEASES_URL,
+                        )
+                elif version == latest_version:
+                    pass  # same version, no action
+            # else: fetch failed, will retry next cycle
+        except Exception as e:
+            logger.exception("update_check_loop 未知异常: %s", e)
+
+        await asyncio.sleep(config.update_check_interval)
+
+
+# ---------------------------------------------------------------------------
+# Query helpers (used by /version)
+# ---------------------------------------------------------------------------
+
+def update_available() -> bool:
+    """Return True if a newer version has been detected."""
+    if latest_version is None:
+        return False
+    return is_newer(latest_version)
+
+
+def format_update_hint() -> str:
+    """Return a formatted update hint string, or empty string if no update.
+
+    Designed to be appended to ``/version`` replies.
+    """
+    if not update_available():
+        return ""
+    return (
+        f"\n\n🆕 发现新版本 `{latest_version}`，更新：`pipx upgrade wechatbridge-cli`"
+    )
+
+
+# ---------------------------------------------------------------------------
+# Admin notification
+# ---------------------------------------------------------------------------
+
+async def maybe_notify_admin(client, from_user: str, context_token: str) -> None:
+    """If an update is available and ``from_user`` is an admin, send a WeChat notification.
+
+    Each admin is only notified once per process lifetime (tracked in
+    ``_notified_admins``). On send failure, the admin is removed from the set
+    so the next message from them will retry.
+
+    All network/send exceptions are caught and logged.
+    """
+    if not update_available():
+        return
+    if from_user not in config.admin_users:
+        return
+    if from_user in _notified_admins:
+        return
+
+    # Mark as notified immediately to prevent concurrent duplicates
+    _notified_admins.add(from_user)
+
+    text = (
+        f"🆕 **wechatbridge 有新版本** 🆕\n\n"
+        f"当前 `{__version__}` → 最新 `{latest_version}`\n\n"
+        f"更新方法：\n"
+        f"`pipx upgrade wechatbridge-cli && sudo systemctl restart wechatbridge`\n\n"
+        f"更新内容：{RELEASES_URL}"
+    )
+
+    try:
+        success = await client.send_message(
+            to_user_id=from_user,
+            text=text,
+            context_token=context_token,
+            baseurl=client.state.baseurl,
+            bot_token=client.state.bot_token,
+        )
+        if success:
+            logger.info("已向管理员 %s 发送版本更新通知", from_user)
+        else:
+            logger.warning("向管理员 %s 发送版本更新通知失败", from_user)
+            _notified_admins.discard(from_user)
+    except Exception as e:
+        logger.warning("向管理员 %s 发送版本更新通知异常: %s", from_user, e)
+        _notified_admins.discard(from_user)

wechatbridge_cli-1.3.0.dist-info/METADATA

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: wechatbridge-cli
+Version: 1.3.0
+Summary: Bridge WeChat messages to agy or Grok Build CLIs — text/image/file/voice in, CLI replies and generated files back.
+Author: WeChatBridge contributors
+License: MIT
+Project-URL: Homepage, https://github.com/dorokuma/wechatbridge
+Project-URL: Repository, https://github.com/dorokuma/wechatbridge
+Project-URL: Issues, https://github.com/dorokuma/wechatbridge/issues
+Project-URL: Changelog, https://github.com/dorokuma/wechatbridge/blob/main/CHANGELOG.md
+Keywords: wechat,bot,bridge,agy,grok
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Requires-Python: >=3.10
+License-File: LICENSE
+Requires-Dist: httpx
+Requires-Dist: qrcode
+Requires-Dist: Pillow
+Requires-Dist: cryptography
+Dynamic: license-file

wechatbridge_cli-1.3.0.dist-info/RECORD

@@ -0,0 +1,15 @@
+wechatbridge/__init__.py,sha256=RXm_TLO0Has6_lQKHEWEw2SQzvvt3K3Gt0n-8VVEalI,95
+wechatbridge/__main__.py,sha256=siqkkOqvVtcsjpQnK5noeax5zAgB9M2xfPB7VBm39VI,74
+wechatbridge/agy.py,sha256=hqZNXv2Kwmql594llk8G8aTxe7fxTKNF3AGcMNSD0qQ,24587
+wechatbridge/config.py,sha256=S0nQCykibpYJ3sgkf-l6YgD9ynv8h-mAOHoyF0Y-a7s,10090
+wechatbridge/grok.py,sha256=FO7vyj9oRqYg-WKNbrHfKyfg0lxucJ8xlszfYk5vmJE,25501
+wechatbridge/ilink.py,sha256=qQYIxvkILQ2yEdLVckcTn7DyNMVgy-O8w3Hig0PFoyc,31309
+wechatbridge/main.py,sha256=f4UwMyCBRzNAxyQL4O5Oq7WlWyFgEWtWSLA6o1TSkIk,29748
+wechatbridge/runner_common.py,sha256=KVNF6ctpwrNea5mC4AknYPwwULAod8d5ILCA91i7Urk,35856
+wechatbridge/update_check.py,sha256=CKBHR8QbXoEvuBlQYMop234UwnNm2N60SP5uv5vBmOI,6086
+wechatbridge_cli-1.3.0.dist-info/licenses/LICENSE,sha256=N0uJ1olAtTpsi_pq08gi0sDDG18VxpF6ae0V-a7N3Rc,1082
+wechatbridge_cli-1.3.0.dist-info/METADATA,sha256=Ek5oJnDC5xtjZ8MsQuOW2H3Og-aJIcjbVsvnaF_6GNI,1236
+wechatbridge_cli-1.3.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+wechatbridge_cli-1.3.0.dist-info/entry_points.txt,sha256=NgIGRaOGDzV0QZH8-NgLMyW_WdiKpPiHpaNQeqLrupw,56
+wechatbridge_cli-1.3.0.dist-info/top_level.txt,sha256=Ph3fc1evjcKb_Mdz_RsukQbviBX3Yeh8n-BNMlPpCgw,13
+wechatbridge_cli-1.3.0.dist-info/RECORD,,

wechatbridge_cli-1.3.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

wechatbridge_cli-1.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+wechatbridge = wechatbridge.main:main

wechatbridge_cli-1.3.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 WeChatBridge contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

wechatbridge_cli-1.3.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+wechatbridge