frontengine 1.0.13__tar.gz → 1.0.15__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.13
+Version: 1.0.15
 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.13 → frontengine-1.0.15}/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,17 @@ 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 實作。
@@ -255,6 +266,40 @@ class PetMood:
         return self.CONTENT
 
 
+class PetHunger:
+    """
+    寵物飽足值 0~100：餵食上升、隨時間下降；level() 回傳 full/ok/hungry。
+    Pet fullness 0..100: feeding raises it, time lowers it; level() buckets it.
+    """
+
+    FULL = "full"
+    OK = "ok"
+    HUNGRY = "hungry"
+
+    def __init__(self, value: int = 70) -> None:
+        self.value = self._clamp(value)
+
+    @staticmethod
+    def _clamp(value) -> int:
+        try:
+            return max(0, min(100, int(value)))
+        except (TypeError, ValueError):
+            return 70
+
+    def feed(self, amount: int = 30) -> None:
+        self.value = self._clamp(self.value + amount)
+
+    def decay(self, amount: int = 1) -> None:
+        self.value = self._clamp(self.value - amount)
+
+    def level(self) -> str:
+        if self.value >= 60:
+            return self.FULL
+        if self.value <= 25:
+            return self.HUNGRY
+        return self.OK
+
+
 class SpeechBubble(QWidget):
     """寵物頭上的小對話泡泡，數秒後自動消失 / A small speech bubble that auto-hides."""
 
@@ -691,6 +736,8 @@ class DesktopPetWidget(BaseWidget):
         self._moved = False
         self._chatter_rng = _random_module.SystemRandom()
         self._mood = PetMood(user_setting_dict.get("pet_mood", 60))
+        self._hunger = PetHunger(user_setting_dict.get("pet_hunger", 70))
+        self._hunger_warned = False
         self._messages = self._load_messages()
         self._sound: Optional[QSoundEffect] = None
         self._init_sound(sound_path)
@@ -703,6 +750,11 @@ class DesktopPetWidget(BaseWidget):
         # 電量提醒 / 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)
@@ -712,6 +764,13 @@ 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.feed_action = QAction(language_wrapper.language_word_dict.get("pet_feed", "Feed"), self)
+        self.feed_action.triggered.connect(self.feed)
+        self.menu.addAction(self.feed_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)
@@ -829,6 +888,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
@@ -845,12 +905,45 @@ class DesktopPetWidget(BaseWidget):
             "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?"),
+            "hungry": lines("pet_chatter_hungry", "I'm hungry...|Got a snack?|Feed me?"),
+            "fed": lines("pet_chatter_fed", "Yum!|Thank you!|Delicious!"),
             "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
@@ -878,11 +971,42 @@ class DesktopPetWidget(BaseWidget):
 
     def _on_chatter(self) -> None:
         self._mood.decay()  # a little neglect over time
+        self._hunger.decay()
         self._persist_mood()
-        if not self._warn_battery():   # a low-battery warning takes priority
+        # priority: low battery, then hunger, otherwise normal chatter
+        if not self._warn_battery() and not self._warn_hungry():
             self.say()
         self._schedule_chatter()
 
+    def _persist_hunger(self) -> None:
+        user_setting_dict["pet_hunger"] = self._hunger.value
+
+    def feed(self) -> None:
+        """餵食：補足飽足並讓心情變好，說一句道謝。"""
+        self._hunger.feed()
+        self._mood.pet()
+        self._persist_hunger()
+        self._persist_mood()
+        pool = self._messages.get("fed") or []
+        if pool:
+            self.say(pool[self._chatter_rng.randrange(len(pool))])
+
+    def _warn_hungry(self) -> bool:
+        """飢餓時討食一次；吃飽後重置。回傳是否有討食。"""
+        self._persist_hunger()
+        if not self._talk:
+            return False
+        if self._hunger.level() == PetHunger.HUNGRY:
+            if not self._hunger_warned:
+                self._hunger_warned = True
+                pool = self._messages.get("hungry") or []
+                if pool:
+                    self.say(pool[self._chatter_rng.randrange(len(pool))])
+                    return True
+        elif self._hunger.level() == PetHunger.FULL:
+            self._hunger_warned = False
+        return False
+
     BATTERY_THRESHOLD = 20
 
     def _warn_battery(self) -> bool:
@@ -981,6 +1105,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.13 → frontengine-1.0.15}/frontengine/user_setting/user_setting_file.py

@@ -36,6 +36,9 @@ user_setting_dict: Dict[str, Any] = {
     # 桌面寵物心情值（0~100），跨工作階段保存
     # Desktop pet mood (0..100), persisted across sessions
     "pet_mood": 60,
+    # 桌面寵物飽足值（0~100）
+    # Desktop pet fullness (0..100)
+    "pet_hunger": 70,
 }
 
 

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

@@ -225,6 +225,12 @@ english_word_dict = {
     "pet_behaviour_chase": "Chase cursor",
     "pet_climb_label": "Climb walls",
     "pet_clone": "Clone",
+    "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_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.",

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

@@ -226,6 +226,12 @@ traditional_chinese_word_dict = {
     "pet_behaviour_chase": "追逐游標",
     "pet_climb_label": "攀爬牆壁",
     "pet_clone": "複製",
+    "pet_feed": "餵食",
+    "pet_chatter_hungry": "我餓了…|有點心嗎？|餵餵我好嗎？|肚子咕咕叫～",
+    "pet_chatter_fed": "好吃！|謝謝你！|真美味！|嗯嗯 (^o^)",
+    "pet_set_reminder": "設定提醒...",
+    "pet_reminder_prompt": "提醒我：",
+    "pet_reminder_minutes": "幾分鐘後？",
     "pet_choose_pack": "選擇動作包資料夾...",
     "pet_choose_sound": "選擇音效（選填）",
     "pet_pack_empty": "該資料夾找不到精靈檔（walk/idle/sleep/climb/fall/drag）。",

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

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

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