frontengine 1.0.15__tar.gz → 1.0.16__tar.gz

{frontengine-1.0.15 → frontengine-1.0.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.15
+Version: 1.0.16
 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.15 → frontengine-1.0.16}/frontengine/show/pet/desktop_pet.py

@@ -144,6 +144,30 @@ def windows_platforms(exclude_hwnds=()) -> list:
         return []
 
 
+def idle_seconds():
+    """
+    回傳使用者未操作的秒數；無法取得時回傳 None。僅 Windows 實作。
+    Seconds since the last user input, or None when unavailable (Windows only).
+    """
+    if sys.platform != "win32":
+        return None
+    try:
+        import ctypes
+
+        class _LASTINPUTINFO(ctypes.Structure):
+            _fields_ = [("cbSize", ctypes.c_uint), ("dwTime", ctypes.c_uint)]
+
+        info = _LASTINPUTINFO()
+        info.cbSize = ctypes.sizeof(info)
+        if not ctypes.windll.user32.GetLastInputInfo(ctypes.byref(info)):
+            return None
+        elapsed_ms = ctypes.windll.kernel32.GetTickCount() - info.dwTime
+        return max(0.0, elapsed_ms / 1000.0)
+    except Exception as error:  # pragma: no cover - Win32 boundary
+        front_engine_logger.warning(f"[idle_seconds] error: {error!r}")
+        return None
+
+
 def pop_due_reminders(now, reminders):
     """
     依 now 分出已到期與未到期的提醒。reminders 為 (due_datetime, text) 清單。
@@ -646,6 +670,12 @@ class PetMotion:
         self._idle_count = 0
         self._new_state(force_walk=True)
 
+    def sleep(self) -> None:
+        """讓寵物進入睡眠（使用者閒置時呼叫）/ Put the pet to sleep."""
+        self.state = STATE_SLEEP
+        self._state_ticks = self._rng.randint(300, 600)
+        self.follow_target_x = None
+
     # --- free wander ---
     def _step_wander(self, left, top, right, bottom) -> Tuple[int, int]:
         if abs(self.vy) < 1e-9:
@@ -750,6 +780,9 @@ class DesktopPetWidget(BaseWidget):
         # 電量提醒 / Low-battery reaction
         self._battery_provider = read_battery
         self._battery_warned = False
+        # 閒置反應 / Idle reaction
+        self._idle_provider = idle_seconds
+        self._idle_reacted = False
         # 提醒事項 / Reminders
         self._now_provider = datetime.now
         self._reminders: list = []
@@ -907,6 +940,7 @@ class DesktopPetWidget(BaseWidget):
             "battery": lines("pet_chatter_battery", "Battery's low - plug me in?|Low power!|Find a charger?"),
             "hungry": lines("pet_chatter_hungry", "I'm hungry...|Got a snack?|Feed me?"),
             "fed": lines("pet_chatter_fed", "Yum!|Thank you!|Delicious!"),
+            "away": lines("pet_chatter_away", "Still there?|I'll nap till you're back~|Zzz..."),
             "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
         }
 
@@ -973,11 +1007,33 @@ class DesktopPetWidget(BaseWidget):
         self._mood.decay()  # a little neglect over time
         self._hunger.decay()
         self._persist_mood()
-        # priority: low battery, then hunger, otherwise normal chatter
-        if not self._warn_battery() and not self._warn_hungry():
+        # priority: user idle (nap), low battery, hunger, otherwise normal chatter
+        if not self._check_idle() and not self._warn_battery() and not self._warn_hungry():
             self.say()
         self._schedule_chatter()
 
+    IDLE_THRESHOLD = 120.0
+
+    def _check_idle(self) -> bool:
+        """使用者閒置久了打盹並說一句；回來後醒。回傳是否有反應（抑制一般閒聊）。"""
+        seconds = self._idle_provider()
+        if seconds is None:
+            return False
+        if seconds >= self.IDLE_THRESHOLD:
+            if not self._idle_reacted:
+                self._idle_reacted = True
+                self.motion.sleep()
+                if self._talk:
+                    pool = self._messages.get("away") or []
+                    if pool:
+                        self.say(pool[self._chatter_rng.randrange(len(pool))])
+                        return True
+            return False
+        if seconds < 5.0 and self._idle_reacted:
+            self._idle_reacted = False
+            self.motion.wake()
+        return False
+
     def _persist_hunger(self) -> None:
         user_setting_dict["pet_hunger"] = self._hunger.value
 

{frontengine-1.0.15 → frontengine-1.0.16}/frontengine/utils/multi_language/english.py

@@ -228,6 +228,7 @@ english_word_dict = {
     "pet_feed": "Feed",
     "pet_chatter_hungry": "I'm hungry...|Got a snack?|Feed me, please?|My tummy's rumbling~",
     "pet_chatter_fed": "Yum!|Thank you!|Delicious!|Nom nom (^o^)",
+    "pet_chatter_away": "Still there?|I'll nap till you're back~|Zzz...|Take your time!",
     "pet_set_reminder": "Set reminder...",
     "pet_reminder_prompt": "Remind me to:",
     "pet_reminder_minutes": "In how many minutes?",

{frontengine-1.0.15 → frontengine-1.0.16}/frontengine/utils/multi_language/traditional_chinese.py

@@ -229,6 +229,7 @@ traditional_chinese_word_dict = {
     "pet_feed": "餵食",
     "pet_chatter_hungry": "我餓了…|有點心嗎？|餵餵我好嗎？|肚子咕咕叫～",
     "pet_chatter_fed": "好吃！|謝謝你！|真美味！|嗯嗯 (^o^)",
+    "pet_chatter_away": "還在嗎？|我先打個盹等你回來～|Zzz…|慢慢來沒關係！",
     "pet_set_reminder": "設定提醒...",
     "pet_reminder_prompt": "提醒我：",
     "pet_reminder_minutes": "幾分鐘後？",

{frontengine-1.0.15 → frontengine-1.0.16}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.15
+Version: 1.0.16
 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.15 → frontengine-1.0.16}/pyproject.toml

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