pyloid 0.10.2__py3-none-any.whl → 0.11.0__py3-none-any.whl

pyloid/__init__.py

@@ -2,5 +2,6 @@ from .pyloid import Pyloid
 from .api import PyloidAPI, Bridge
 from .utils import get_production_path, is_production
 from .tray import TrayEvent
+from .timer import PyloidTimer
 
-__all__ = ['Pyloid', 'PyloidAPI', 'Bridge', 'get_production_path', 'is_production', 'TrayEvent']
+__all__ = ['Pyloid', 'PyloidAPI', 'Bridge', 'get_production_path', 'is_production', 'TrayEvent', 'PyloidTimer']

pyloid/timer.py

@@ -0,0 +1,123 @@
+from PySide6.QtCore import QTimer, QObject
+
+class PyloidTimer(QObject):
+    def __init__(self):
+        super().__init__()
+        self.timers = {}
+
+    def start_periodic_timer(self, interval, callback):
+        """
+        주기적으로 실행되는 타이머를 시작합니다.
+        
+        :param interval: 밀리초 단위의 간격
+        :param callback: 실행할 콜백 함수
+        :param auto_remove: 타이머 중지 시 자동 삭제 여부
+        :return: 타이머 ID
+        """
+        return self._create_timer(interval, callback, single_shot=False, auto_remove=False)
+
+    def start_single_shot_timer(self, delay, callback):
+        """
+        한 번만 실행되는 타이머를 시작합니다.
+        
+        :param delay: 밀리초 단위의 지연 시간
+        :param callback: 실행할 콜백 함수
+        :return: 타이머 ID
+        """
+        return self._create_timer(delay, callback, single_shot=True, auto_remove=True)
+
+    def _create_timer(self, interval, callback, single_shot=False, auto_remove=False):
+        timer = QTimer(self)
+        timer.setInterval(interval)
+        timer.setSingleShot(single_shot)
+        
+        if auto_remove or single_shot:
+            timer.timeout.connect(lambda: self._timer_finished(callback, id(timer)))
+        else:
+            timer.timeout.connect(callback)
+        
+        timer.start()
+        
+        timer_id = id(timer)
+        self.timers[timer_id] = timer
+        return timer_id
+
+    def _timer_finished(self, callback, timer_id):
+        callback()
+        self.stop_timer(timer_id)
+
+    def stop_timer(self, timer_id):
+        """
+        지정된 ID의 타이머를 중지합니다.
+        
+        :param timer_id: 중지할 타이머의 ID
+        """
+        if timer_id in self.timers:
+            self.timers[timer_id].stop()
+            del self.timers[timer_id]
+
+    def is_timer_active(self, timer_id):
+        """
+        지정된 ID의 타이머가 활성 상태인지 확인합니다.
+        
+        :param timer_id: 확인할 타이머의 ID
+        :return: 타이머가 활성 상태이면 True, 그렇지 않으면 False
+        """
+        return timer_id in self.timers and self.timers[timer_id].isActive()
+
+    def get_remaining_time(self, timer_id):
+        """
+        지정된 ID의 타이머의 남은 시간을 반환합니다.
+        
+        :param timer_id: 확인할 타이머의 ID
+        :return: 남은 시간 (밀리초), 타이머가 없으면 None
+        """
+        if timer_id in self.timers:
+            return self.timers[timer_id].remainingTime()
+        return None
+
+    def set_interval(self, timer_id, interval):
+        """
+        지정된 ID의 타이머의 간격을 설정합니다.
+        
+        :param timer_id: 설정할 타이머의 ID
+        :param interval: 새로운 간격 (밀리초)
+        """
+        if timer_id in self.timers:
+            self.timers[timer_id].setInterval(interval)
+
+    def start_precise_periodic_timer(self, interval, callback):
+        """
+        정밀한 주기적 타이머를 시작합니다.
+        
+        :param interval: 밀리초 단위의 간격
+        :param callback: 실행할 콜백 함수
+        :return: 타이머 ID
+        """
+        return self._create_timer_with_type(interval, callback, QTimer.TimerType.PreciseTimer)
+
+    def start_coarse_periodic_timer(self, interval, callback):
+        """
+        덜 정밀한 주기적 타이머를 시작합니다.
+        
+        :param interval: 밀리초 단위의 간격
+        :param callback: 실행할 콜백 함수
+        :return: 타이머 ID
+        """
+        return self._create_timer_with_type(interval, callback, QTimer.TimerType.CoarseTimer)
+
+    def _create_timer_with_type(self, interval, callback, timer_type, auto_remove=False):
+        timer = QTimer(self)
+        timer.setInterval(interval)
+        timer.setTimerType(timer_type)
+        
+        if auto_remove:
+            timer.timeout.connect(lambda: self._timer_finished(callback, id(timer)))
+        else:
+            timer.timeout.connect(callback)
+        
+        timer.start()
+        
+        timer_id = id(timer)
+        self.timers[timer_id] = timer
+        return timer_id

{pyloid-0.10.2.dist-info → pyloid-0.11.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pyloid
-Version: 0.10.2
+Version: 0.11.0
 Summary: 
 Author: aesthetics-of-record
 Author-email: 111675679+aesthetics-of-record@users.noreply.github.com

{pyloid-0.10.2.dist-info → pyloid-0.11.0.dist-info}/RECORD

@@ -1,12 +1,13 @@
-pyloid/__init__.py,sha256=98jn3uaX1hB0aZCmFFLYBIswGmauIBHNYX2ZXQC4KjA,246
+pyloid/__init__.py,sha256=OOPhOKNQVmAM8hnfTeE7lHzxb8LsFNcgegBAvDrA-vY,293
 pyloid/api.py,sha256=whgfvPr1A6iwZ1Ewo-0FnOUNnt1K58c-P7YjzuQHcUM,194
 pyloid/autostart.py,sha256=K7DQYl4LHItvPp0bt1V9WwaaZmVSTeGvadkcwG-KKrI,3899
 pyloid/filewatcher.py,sha256=n8N56D65le5TpsgxXb7z-FO_0lqv4UYD4yGq_UuMrAs,1285
 pyloid/monitor.py,sha256=fqDnZ_7dpxVZLVJ5gCluDRY2USrQ5YL_fw1AnYivhsk,12741
 pyloid/pyloid.py,sha256=s3oES8HVgW53mYxizUzcVIYDNOhMADuEkYKuv5IlBtQ,40459
+pyloid/timer.py,sha256=1bYhqte3rV77vaeMUkcTgmx2ux7FtCqLCx9lIC2-COg,4360
 pyloid/tray.py,sha256=rXgdkvzGxtie_EIcTSA7fjuta4nJk5THhNkGFcfv5Ew,634
 pyloid/utils.py,sha256=DQerZWU_0o8dHcJ5y3yXf9i5OXn7KQZqU-hVBq3uPUA,711
-pyloid-0.10.2.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
-pyloid-0.10.2.dist-info/METADATA,sha256=wnzUpr44CzzouCGHgoVKsDVHWnbE1QY1E1tHZ4TpK9Y,6068
-pyloid-0.10.2.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-pyloid-0.10.2.dist-info/RECORD,,
+pyloid-0.11.0.dist-info/LICENSE,sha256=F96EzotgWhhpnQTW2TcdoqrMDir1jyEo6H915tGQ-QE,11524
+pyloid-0.11.0.dist-info/METADATA,sha256=jb38fxpq61DXAil2tQwTRVXtl5300UAMImmNOCi9jmU,6068
+pyloid-0.11.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+pyloid-0.11.0.dist-info/RECORD,,