utilitz 0.3.2__tar.gz → 0.4.1__tar.gz

{utilitz-0.3.2 → utilitz-0.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: utilitz
-Version: 0.3.2
+Version: 0.4.1
 Summary: Simple Python utility functions to save and load data
 Project-URL: Homepage, https://github.com/artitzco/utilitz
 Project-URL: Issues, https://github.com/artitzco/utilitz/issues

{utilitz-0.3.2 → utilitz-0.4.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "utilitz"
-version = "0.3.2"
+version = "0.4.1"
 authors = [
   { name = "Artitzco", email = "artitzco@proton.me" },
 ]

{utilitz-0.3.2 → utilitz-0.4.1}/src/utilitz/path.py

@@ -1,8 +1,10 @@
 from pathlib import Path
 import os
 
+import sys
 
-def locate_project(level=None, forced=False):
+
+def locate_project(level=None, forced=False, source=None):
     """
     Change the current working directory to a project root based on a search pattern or parent level.
 
@@ -19,7 +21,7 @@ def locate_project(level=None, forced=False):
         - Raises FileNotFoundError if the search fails.
     """
     global_vars = globals()
-    varname = '__locate__project__'
+    varname = 'utilitz__locate__project__'
     cwd = Path.cwd()
     if varname in global_vars:
         if level is None or forced:
@@ -28,6 +30,7 @@ def locate_project(level=None, forced=False):
             del global_vars[varname]
             print(f'[INFO] Working directory restored: {cwd}')
         if not forced:
+            set_soruce(source)
             return
 
     if level is not None:
@@ -52,3 +55,32 @@ def locate_project(level=None, forced=False):
                 raise FileNotFoundError(
                     f"Could not find a directory matching level '{level}' from {cwd}"
                 )
+    set_soruce(source)
+
+
+def set_soruce(source):
+    if source is None:
+        source = []
+    if isinstance(source, str):
+        source = [source]
+
+    varname = 'utilitz__set_source__'
+    path_list = globals().get(varname, [])
+    new_path_list = [str(Path().resolve() / x) for x in source]
+
+    # agregar nuevos paths
+    for x in new_path_list:
+        if x not in path_list:
+            sys.path.append(x)
+            print(f"[INFO] Path added to sys.path: {x}")
+
+    # quitar paths que ya no están
+    for x in path_list:
+        if x not in new_path_list:
+            if x in sys.path:
+                sys.path.remove(x)
+                print(f"[INFO] Path removed from sys.path: {x}")
+
+    # actualizar globals si hubo cambios
+    if new_path_list != path_list:
+        globals()[varname] = new_path_list

utilitz-0.4.1/src/utilitz/sys.py

@@ -0,0 +1,66 @@
+from pynput import keyboard, mouse
+from datetime import datetime
+import pyautogui
+import time
+
+
+class MonitorActivity:
+    
+    def __init__(self):
+        self.last_activity_time = time.monotonic()
+        self._keyboard_listener = keyboard.Listener(
+            on_press=self._on_keyboard_event,
+            on_release=self._on_keyboard_event,
+        )
+        self._mouse_listener = mouse.Listener(
+            on_move=self._on_mouse_event,
+            on_click=self._on_mouse_event,
+            on_scroll=self._on_mouse_event,
+        )
+
+    def _on_keyboard_event(self, *args, **kwargs):
+        self.last_activity_time = time.monotonic()
+
+    def _on_mouse_event(self, *args, **kwargs):
+        self.last_activity_time = time.monotonic()
+
+    def start(self):
+        self._keyboard_listener.start()
+        self._mouse_listener.start()
+
+    def stop(self):
+        self._keyboard_listener.stop()
+        self._mouse_listener.stop()
+
+def monitor_keep_alive(seconds, key='ctrl', verbose=1, tolerance = 0.1):
+    def time_format(ts):
+        return datetime.fromtimestamp(ts).strftime("%Y-%m-%d %H:%M:%S")
+
+    monitor = MonitorActivity()
+    monitor.start()
+    status = '==START=='
+    if verbose:
+        print(time_format(time.time()), status)
+    time.sleep(seconds)
+    while True:
+        sleep_end_time = time.monotonic()
+        last_activity_time = monitor.last_activity_time
+
+        inactive_time = sleep_end_time - last_activity_time
+        is_active = inactive_time < seconds
+
+        if is_active:
+            last_status = status
+            status = '==ACTIVE=='
+            sleep_time = max(tolerance, seconds - inactive_time - tolerance)
+        else:
+            last_status = status
+            status = '==INACTIVE=='
+            sleep_time = max(tolerance, seconds - tolerance)
+            pyautogui.press(key)
+        if verbose == 1 and status != last_status:
+            print(time_format(time.time()), status)
+        elif verbose == 2:
+            print(time_format(time.time()), status,
+                  '\n\tinactive_time:',  f'{inactive_time:.03f}', 'sleep_time:', f'{sleep_time:.03f}')
+        time.sleep(sleep_time)

utilitz-0.3.2/src/utilitz/sys.py

@@ -1,141 +0,0 @@
-
-from pynput import keyboard, mouse
-from datetime import datetime
-import pyautogui
-import time
-
-
-class MonitorActivity:
-    """
-    MonitorActivity
-    ----------------
-    Class responsible for listening to keyboard and mouse events via pynput.
-
-    Attributes
-    ----------
-    last_activity_time : float
-        Timestamp of the last detected user activity.
-
-    Methods
-    -------
-    start():
-        Starts the keyboard and mouse listeners.
-    stop():
-        Stops the listeners.
-
-    Internal Use
-    ------------
-    This class is used by monitor_keep_alive to determine the amount of time
-    that has passed without any user interaction.
-    """
-
-    def __init__(self):
-        self.last_activity_time = time.time()
-        self._keyboard_listener = keyboard.Listener(
-            on_press=self._on_keyboard_event,
-            on_release=self._on_keyboard_event,
-        )
-        self._mouse_listener = mouse.Listener(
-            on_move=self._on_mouse_event,
-            on_click=self._on_mouse_event,
-            on_scroll=self._on_mouse_event,
-        )
-
-    def _on_keyboard_event(self, *args, **kwargs):
-        self.last_activity_time = time.time()
-
-    def _on_mouse_event(self, *args, **kwargs):
-        self.last_activity_time = time.time()
-
-    def start(self):
-        self._keyboard_listener.start()
-        self._mouse_listener.start()
-
-    def stop(self):
-        self._keyboard_listener.stop()
-        self._mouse_listener.stop()
-
-
-def monitor_keep_alive(seconds, key='ctrl', verbose=1):
-    """
-    monitor_keep_alive
-    -------------------
-    Continuously monitors user activity and triggers an automatic key press
-    when no keyboard or mouse events occur within the specified interval.
-
-    Parameters
-    ----------
-    seconds : int or float
-        Base interval in seconds to evaluate user activity.
-    key : str, optional
-        The key to press when inactivity is detected.
-        Examples: 'ctrl', 'shift', 'space', 'enter', 'f15', etc.
-    verbose : int, optional
-        Controls console logging:
-            0 → silent
-            1 → prints only when the user status changes (Active/Inactive)
-            2 → prints extended debug information (timings, cycle details)
-
-    Behavior
-    --------
-    - Starts a real-time activity monitor (keyboard + mouse).
-    - Every `seconds` seconds, checks whether activity occurred.
-    - If activity occurred → does nothing.
-    - If NO activity occurred → presses the configured key.
-    - Dynamically adjusts sleep intervals based on the last activity time.
-
-    Examples
-    --------
-    # Keep session alive by pressing CTRL every 3 seconds of inactivity
-    monitor_keep_alive(3)
-
-    # Use SHIFT instead of CTRL
-    monitor_keep_alive(5, key='shift')
-
-    # Verbose debug mode
-    monitor_keep_alive(10, verbose=2)
-
-    Notes
-    -----
-    - The function runs indefinitely; stop it manually when needed.
-    - pyautogui may require accessibility permissions on macOS.
-    - pynput listeners run on background threads.
-
-    Warning
-    -------
-    This script simulates human activity. It may violate rules in certain
-    applications, organizations, or platforms. Use at your own risk.
-    """
-
-    monitor = MonitorActivity()
-    monitor.start()
-    status = '==START=='
-    sleep_start_time = time.time()
-    time.sleep(seconds)
-    if verbose:
-        print(datetime.fromtimestamp(sleep_end_time).strftime("%Y-%m-%d %H:%M:%S"), status)
-    while True:
-        sleep_end_time = time.time()
-        ####
-        last_activity_time = monitor.last_activity_time
-        is_active = (last_activity_time - 0.001 > sleep_start_time
-                     and last_activity_time < sleep_end_time)
-        inactive_time = sleep_end_time-last_activity_time
-        if is_active:
-            last_status = status
-            status = '==ACTIVE=='
-            sleep_time = seconds - inactive_time
-        else:
-            last_status = status
-            status = '==INACTIVE=='
-            sleep_time = seconds
-            pyautogui.press(key)
-        if verbose == 1 and status != last_status:
-            print(datetime.fromtimestamp(sleep_end_time).strftime(
-                "%Y-%m-%d %H:%M:%S"), status)
-        elif verbose == 2:
-            print(datetime.fromtimestamp(sleep_end_time).strftime("%Y-%m-%d %H:%M:%S"), status,
-                  '\n\tInactive Time:',  f'{inactive_time:.03f}', 'Sleep Time:', f'{sleep_time:.03f}')
-
-        sleep_start_time = time.time()
-        time.sleep(sleep_time)