frontengine 1.0.12__tar.gz → 1.0.14__tar.gz

{frontengine-1.0.12 → frontengine-1.0.14}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.12
+Version: 1.0.14
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.12 → frontengine-1.0.14}/frontengine/show/pet/desktop_pet.py

@@ -1,6 +1,6 @@
 import random as _random_module
 import sys
-from datetime import datetime
+from datetime import datetime, timedelta
 from pathlib import Path
 from typing import Optional, Tuple
 
@@ -144,6 +144,49 @@ def windows_platforms(exclude_hwnds=()) -> list:
         return []
 
 
+def pop_due_reminders(now, reminders):
+    """
+    依 now 分出已到期與未到期的提醒。reminders 為 (due_datetime, text) 清單。
+    Split reminders into (due, remaining) at `now`. Each reminder is a
+    (due_datetime, text) tuple.
+    """
+    due = [item for item in reminders if item[0] <= now]
+    remaining = [item for item in reminders if item[0] > now]
+    return due, remaining
+
+
+def read_battery():
+    """
+    回傳 (電量百分比, 是否充電中)；無法取得時回傳 None。僅 Windows 實作。
+    Return (percent, charging) or None when unavailable. Windows only.
+    """
+    if sys.platform != "win32":
+        return None
+    try:
+        import ctypes
+
+        class _SPS(ctypes.Structure):
+            _fields_ = [
+                ("ACLineStatus", ctypes.c_byte),
+                ("BatteryFlag", ctypes.c_byte),
+                ("BatteryLifePercent", ctypes.c_byte),
+                ("SystemStatusFlag", ctypes.c_byte),
+                ("BatteryLifeTime", ctypes.c_ulong),
+                ("BatteryFullLifeTime", ctypes.c_ulong),
+            ]
+
+        status = _SPS()
+        if not ctypes.windll.kernel32.GetSystemPowerStatus(ctypes.byref(status)):
+            return None
+        percent = status.BatteryLifePercent & 0xFF
+        if percent == 255:  # unknown / no battery
+            return None
+        return (int(percent), status.ACLineStatus == 1)
+    except Exception as error:  # pragma: no cover - Win32 boundary
+        front_engine_logger.warning(f"[read_battery] error: {error!r}")
+        return None
+
+
 def nearest_peer(center, peers):
     """
     回傳離 center 最近的同伴座標與距離；無同伴回傳 (None, inf)。
@@ -668,6 +711,14 @@ class DesktopPetWidget(BaseWidget):
         self._peers_provider = None
         self._peer_greeted = False
         self._peer_tick = 0
+        # 電量提醒 / Low-battery reaction
+        self._battery_provider = read_battery
+        self._battery_warned = False
+        # 提醒事項 / Reminders
+        self._now_provider = datetime.now
+        self._reminders: list = []
+        self._reminder_timer = QTimer(self)
+        self._reminder_timer.timeout.connect(self._check_reminders)
         self._bubble = SpeechBubble()
         self._chatter_timer = QTimer(self)
         self._chatter_timer.setSingleShot(True)
@@ -677,6 +728,10 @@ class DesktopPetWidget(BaseWidget):
         self.clone_action = QAction(language_wrapper.language_word_dict.get("pet_clone", "Clone"), self)
         self.clone_action.triggered.connect(self.clone_requested.emit)
         self.menu.addAction(self.clone_action)
+        self.reminder_action = QAction(
+            language_wrapper.language_word_dict.get("pet_set_reminder", "Set reminder..."), self)
+        self.reminder_action.triggered.connect(self._prompt_reminder)
+        self.menu.addAction(self.reminder_action)
         self.close_action = QAction(language_wrapper.language_word_dict.get("control_center_close_all", "Close"), self)
         self.close_action.triggered.connect(self.close)
         self.menu.addAction(self.close_action)
@@ -794,6 +849,7 @@ class DesktopPetWidget(BaseWidget):
         self.move(int(self.motion.x), int(self.motion.y))
         self._timer.start(max(10, int(interval_ms)))
         self._schedule_chatter()
+        self._reminder_timer.start(10000)
 
     def _load_messages(self) -> dict:
         d = language_wrapper.language_word_dict
@@ -809,12 +865,44 @@ class DesktopPetWidget(BaseWidget):
             "happy": lines("pet_chatter_happy", "I'm so happy!|You're the best!|(^o^)"),
             "sad": lines("pet_chatter_sad", "Feeling a bit lonely...|Pet me?|(._.)"),
             "meet": lines("pet_chatter_meet", "Hi friend!|Hello!|Let's play!"),
+            "battery": lines("pet_chatter_battery", "Battery's low - plug me in?|Low power!|Find a charger?"),
             "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
         }
 
     def _persist_mood(self) -> None:
         user_setting_dict["pet_mood"] = self._mood.value
 
+    def add_reminder(self, text: str, minutes: int) -> None:
+        """在 minutes 分鐘後提醒 text / Remind `text` in `minutes` minutes."""
+        due = self._now_provider() + timedelta(minutes=max(1, int(minutes)))
+        self._reminders.append((due, str(text)))
+        front_engine_logger.info(f"[DesktopPetWidget] reminder set | due={due}, text={text}")
+
+    def _check_reminders(self) -> None:
+        if not self._reminders:
+            return
+        due, remaining = pop_due_reminders(self._now_provider(), self._reminders)
+        self._reminders = remaining
+        if due:
+            # Reminders are explicit user requests: deliver even if chatter is off.
+            self._bubble.show_message(due[-1][1], self, duration_ms=12000)
+            self._play_sound()
+
+    def _prompt_reminder(self) -> None:
+        from PySide6.QtWidgets import QInputDialog
+
+        title = language_wrapper.language_word_dict.get("pet_set_reminder", "Set reminder...")
+        text, ok = QInputDialog.getText(
+            self, title, language_wrapper.language_word_dict.get("pet_reminder_prompt", "Remind me to:"))
+        if not ok or not text.strip():
+            return
+        minutes, ok_minutes = QInputDialog.getInt(
+            self, title, language_wrapper.language_word_dict.get("pet_reminder_minutes", "In how many minutes?"),
+            5, 1, 1440)
+        if not ok_minutes:
+            return
+        self.add_reminder(text.strip(), minutes)
+
     def _init_sound(self, sound_path: Optional[str]) -> None:
         if not sound_path:
             return
@@ -843,9 +931,31 @@ class DesktopPetWidget(BaseWidget):
     def _on_chatter(self) -> None:
         self._mood.decay()  # a little neglect over time
         self._persist_mood()
-        self.say()
+        if not self._warn_battery():   # a low-battery warning takes priority
+            self.say()
         self._schedule_chatter()
 
+    BATTERY_THRESHOLD = 20
+
+    def _warn_battery(self) -> bool:
+        """低電量時提醒一次；充電或回升後重置。回傳是否有發出提醒。"""
+        if not self._talk:
+            return False
+        status = self._battery_provider()
+        if status is None:
+            return False
+        percent, charging = status
+        if not charging and percent <= self.BATTERY_THRESHOLD:
+            if not self._battery_warned:
+                self._battery_warned = True
+                pool = self._messages.get("battery") or []
+                if pool:
+                    self.say(pool[self._chatter_rng.randrange(len(pool))])
+                    return True
+        elif charging or percent > self.BATTERY_THRESHOLD + 10:
+            self._battery_warned = False
+        return False
+
     def say(self, text: Optional[str] = None) -> None:
         """顯示一句台詞（text 為 None 時依心情/時段隨機挑）。"""
         if not self._talk:
@@ -923,6 +1033,8 @@ class DesktopPetWidget(BaseWidget):
             self._timer.stop()
         if self._chatter_timer.isActive():
             self._chatter_timer.stop()
+        if self._reminder_timer.isActive():
+            self._reminder_timer.stop()
         self._bubble.close()
         for kind, obj in self._sprites.values():
             if kind == "movie":

{frontengine-1.0.12 → frontengine-1.0.14}/frontengine/utils/multi_language/english.py

@@ -225,6 +225,9 @@ english_word_dict = {
     "pet_behaviour_chase": "Chase cursor",
     "pet_climb_label": "Climb walls",
     "pet_clone": "Clone",
+    "pet_set_reminder": "Set reminder...",
+    "pet_reminder_prompt": "Remind me to:",
+    "pet_reminder_minutes": "In how many minutes?",
     "pet_choose_pack": "Choose pet pack...",
     "pet_choose_sound": "Choose sound (optional)",
     "pet_pack_empty": "No sprites (walk/idle/sleep/climb/fall/drag) found in that folder.",
@@ -238,6 +241,7 @@ english_word_dict = {
     "pet_chatter_happy": "I'm so happy!|You're the best!|(^o^)/|Best day ever!",
     "pet_chatter_sad": "Feeling a bit lonely...|Pet me?|(._.)|Don't forget about me~",
     "pet_chatter_meet": "Hi friend!|Hello there!|Let's play!|Fancy meeting you here!",
+    "pet_chatter_battery": "Battery's low - plug me in?|Low power, careful!|Find a charger soon?|Running on fumes here~",
     "pet_start": "Spawn pet",
     "pet_message_box_text": "Pet image not found",
 }

{frontengine-1.0.12 → frontengine-1.0.14}/frontengine/utils/multi_language/traditional_chinese.py

@@ -226,6 +226,9 @@ traditional_chinese_word_dict = {
     "pet_behaviour_chase": "追逐游標",
     "pet_climb_label": "攀爬牆壁",
     "pet_clone": "複製",
+    "pet_set_reminder": "設定提醒...",
+    "pet_reminder_prompt": "提醒我：",
+    "pet_reminder_minutes": "幾分鐘後？",
     "pet_choose_pack": "選擇動作包資料夾...",
     "pet_choose_sound": "選擇音效（選填）",
     "pet_pack_empty": "該資料夾找不到精靈檔（walk/idle/sleep/climb/fall/drag）。",
@@ -239,6 +242,7 @@ traditional_chinese_word_dict = {
     "pet_chatter_happy": "我好開心！|你最棒了！|(^o^)/|今天真美好！",
     "pet_chatter_sad": "有點寂寞…|摸摸我好嗎？|(._.)|別忘了我～",
     "pet_chatter_meet": "嗨朋友！|你好呀！|一起玩吧！|在這遇到你真巧！",
+    "pet_chatter_battery": "電量很低，幫我插電好嗎？|快沒電了，小心！|該找充電器囉？|我快撐不住了～",
     "pet_start": "召喚寵物",
     "pet_message_box_text": "找不到寵物圖片",
 }

{frontengine-1.0.12 → frontengine-1.0.14}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.12
+Version: 1.0.14
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.12 → frontengine-1.0.14}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.12"
+version = "1.0.14"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]