nano-dev-utils 0.3.5__py3-none-any.whl → 0.4.2__py3-none-any.whl

nano_dev_utils/release_ports.py

@@ -2,12 +2,8 @@ import platform
 import subprocess
 import logging
 
-
-logging.basicConfig(filename='port release.log',
-                    level=logging.INFO,
-                    format='%(asctime)s - %(levelname)s: %(message)s',
-                    datefmt='%d-%m-%Y %H:%M:%S')
 lgr = logging.getLogger(__name__)
+"""Module-level logger. Configure using logging.basicConfig() in your application."""
 
 PROXY_SERVER = 6277
 INSPECTOR_CLIENT = 6274
@@ -152,5 +148,4 @@ class PortsRelease:
                 else:
                     lgr.error(self._log_terminate_failed(pid=pid, port=port))
         except Exception as e:
-            lgr.error(self._log_unexpected_error(e))
-
+            lgr.error(self._log_unexpected_error(e))

nano_dev_utils/timers.py

@@ -1,35 +1,39 @@
 from functools import wraps
 import time
+from typing import Callable, ParamSpec, TypeVar
+P = ParamSpec('P')
+R = TypeVar('R')
 
 
 class Timer:
     def __init__(self, precision=4, verbose=False):
         self.precision = precision
         self.verbose = verbose
+        self.units = [
+            (1e9, 's'),
+            (1e6, 'ms'),
+            (1e3, 'μs'),
+            (1.0, 'ns')
+        ]
 
-    def timeit(self, func):
+    def timeit(self, func: Callable[P, R]) -> Callable[P, R]:
+        """Decorator that times function execution with automatic unit scaling."""
         @wraps(func)
-        def timeit_wrapper(*args, **kwargs):
-            start_time = time.perf_counter_ns()
+        def wrapper(*args: P.args, **kwargs: P.kwargs) -> R:
+            start = time.perf_counter_ns()
             result = func(*args, **kwargs)
-            end_time = time.perf_counter_ns()
-            total_ns = end_time - start_time
+            elapsed = time.perf_counter_ns() - start
 
-            if total_ns < 1_000:  # 1μs
-                value = total_ns
-                unit = "ns"
-            elif total_ns < 1_000_000:  # < 1ms
-                value = total_ns / 1_000
-                unit = "μs"
-            elif total_ns < 1_000_000_000:  # < 1s
-                value = total_ns / 1_000_000
-                unit = "ms"
-            else:
-                value = total_ns / 1_000_000_000
-                unit = "s"
+            value = elapsed
+            unit = 'ns'
+
+            for divisor, unit in self.units:
+                if elapsed >= divisor or unit == 'ns':
+                    value = elapsed / divisor
+                    break
 
             extra_info = f'{args} {kwargs} ' if self.verbose else ''
             print(f'{func.__name__} {extra_info}took {value:.{self.precision}f} [{unit}]')
             return result
 
-        return timeit_wrapper
+        return wrapper

{nano_dev_utils-0.3.5.dist-info → nano_dev_utils-0.4.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nano_dev_utils
-Version: 0.3.5
+Version: 0.4.2
 Summary: A collection of small Python utilities for developers.
 Project-URL: Homepage, https://github.com/yaronday/nano_utils
 Project-URL: Issues, https://github.com/yaronday/nano_utils/issues
@@ -24,22 +24,23 @@ This module provides a `Timer` class for measuring the execution time of code bl
 
 #### `Timer` Class
 
-* **`__init__(self, precision=4, verbose=False)`**: Initializes a `Timer` instance.
-    * `precision` (int, optional): The number of decimal places to record and 
+* **`__init__(self, precision: int = 4, verbose: bool = False)`**: Initializes a `Timer` instance.
+    * `precision`: The number of decimal places to record and    
        display time durations. Defaults to 4.
-    * `verbose` (bool, optional): If `True`, the function's arguments (args) and keyword arguments (kwargs) 
-       will be included in the printed timing output. Defaults to `False`.
+    * `verbose`: Optionally displays the function's positional arguments (args) and keyword arguments (kwargs).       
+       Defaults to `False`.
 
-* **`timeit(self, func)`**: A decorator that measures the execution time of the decorated function.
-    * When the decorated function is called, this decorator records the start and end times,
-    * calculates the total execution time, prints the function name and execution time. 
-    * (optionally including arguments if `verbose` is `True`), and returns the result of the original function.
+* **`timeit(self, func: Callable[P, R]) -> Callable[P, R]`**:   
+      Decorator that times function execution with automatic unit scaling.   
+    * When the decorated function is called, this decorator records the start and end times,   
+      calculates the total execution time, prints the function name and execution    
+      time (optionally including arguments), and returns the result of the original function.
 
 #### Example Usage:
 
 ```python
 import time
-from src.nano_dev_utils.timers import Timer
+from nano_dev_utils.timers import Timer
 
 timer = Timer(precision=6, verbose=True)
 
@@ -66,13 +67,13 @@ This module provides an `Importer` class for lazy loading and caching module imp
 * **`import_mod_from_lib(self, library: str, module_name: str) -> ModuleType | Any`**: Lazily imports a module from a specified library and caches it.
     * `library` (str): The name of the library (e.g., "os", "requests").
     * `module_name` (str): The name of the module to import within the library (e.g., "path", "get").
-    * Returns the imported module. If the module has already been imported, it returns the cached instance.
+    * Returns the imported module. If the module has already been imported, it returns a cached instance.
     * Raises `ImportError` if the module cannot be found.
 
 #### Example Usage:
 
 ```python
-from src.nano_dev_utils.dynamic_importer import Importer
+from nano_dev_utils.dynamic_importer import Importer
 
 importer = Importer()
 
@@ -90,34 +91,42 @@ print(f"Imported os.path again (cached): {os_path_again}")
 ### `release_ports.py`
 
 This module provides a `PortsRelease` class to identify and release processes 
-listening on specified TCP ports. It supports Windows, Linux, and macOS.
+listening on specified TCP ports.    
+It supports Windows, Linux, and macOS.
 
 #### `PortsRelease` Class
 
-* **`__init__(self, default_ports: Optional[list[int]] = None)`**: 
+* **`__init__(self, default_ports: list[int] | None = None)`**: 
 * Initializes a `PortsRelease` instance.
-    * `default_ports` (`list[int]`, *optional*): A list of default ports to manage. 
-    * If not provided, it defaults to `[6277, 6274]`.
+    * `default_ports`: A list of default ports to manage. If not provided, it defaults to `[6277, 6274]`.
 
-* **`get_pid_by_port(port: int) -> Optional[int]`**: A static method that attempts to 
-* find the process ID (PID) listening on the given `port`. It uses platform-specific 
-  commands (`netstat`, `ss`, `lsof`). Returns the PID if found, otherwise `None`. 
+* **`get_pid_by_port(self, port: int) -> int | None`**: A static method that attempts to find   
+     a process ID (PID) listening on a given `port`.       
+*    It uses platform-specific commands (`netstat`, `ss`, `lsof`).       
+*    Returns the PID if found, otherwise `None`.    
 
-* **`kill_process(pid: int) -> bool`**: A static method that attempts to kill the process 
-  with the given `pid`. It uses platform-specific commands (`taskkill`, `kill -9`). 
+* **`kill_process(self, pid: int) -> bool`**: A static method that attempts to kill the process 
+  with the given `pid`.   
+* It uses platform-specific commands (`taskkill`, `kill -9`). 
 * Returns `True` if the process was successfully killed, `False` otherwise. 
 
-* **`release_all(self, ports: Optional[list[int]] = None) -> None`**: Releases all processes
-* listening on the specified `ports`.
-    * `ports` (`list[int]`, *optional*): A list of ports to release. If `None`, it uses the
-      `default_ports` defined during initialization.
-    * For each port, it first tries to get the PID and then attempts to kill the process. 
+* **`release_all(self, ports: list[int] | None = None) -> None`**: Releases all processes listening on the specified `ports`.   
+    * `ports`: A list of ports to release.   
+    * If `None`, it uses the `default_ports` defined during initialization.   
+    * For each port, it first tries to get the PID and then attempts to kill the process.       
     * It logs the actions and any errors encountered. Invalid port numbers in the provided list are skipped.
 
 #### Example Usage:
 
 ```python
-from src.nano_dev_utils.release_ports import PortsRelease
+import logging
+from nano_dev_utils import PortsRelease
+
+# in case you're interested in logging 
+logging.basicConfig(filename='port release.log',
+                    level=logging.INFO,  # specify here desire level, e.g. DEBUG etc.
+                    format='%(asctime)s - %(levelname)s: %(message)s',
+                    datefmt='%d-%m-%Y %H:%M:%S')
 
 # Create an instance with default ports
 port_releaser = PortsRelease()

nano_dev_utils-0.4.2.dist-info/RECORD

@@ -0,0 +1,8 @@
+nano_dev_utils/__init__.py,sha256=NFw7FWw1oJnOmRLe8btPbLJX7e5O78Keaw5fow29tOQ,371
+nano_dev_utils/dynamic_importer.py,sha256=ufMEQKhtlDIYorjWVv58CKm-GWCwwgzp2pSSMznzlkc,917
+nano_dev_utils/release_ports.py,sha256=9tScRYGWrzCaiK8UkiRV8vfflSEYyueokyn0mspivek,5910
+nano_dev_utils/timers.py,sha256=gDIsJekCz8VmlakTs5ttQY-K05J1e0kOtNpyTtCuav0,1232
+nano_dev_utils-0.4.2.dist-info/METADATA,sha256=CGzGDb4SjgAHJ_mWudrcWH64vXm14ELlgC2TQUL5tzE,5333
+nano_dev_utils-0.4.2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nano_dev_utils-0.4.2.dist-info/licenses/LICENSE.md,sha256=Muenl7Bw_LdtHZtlOMAP7Kt97gDCq8WWp2605eDWhHU,1089
+nano_dev_utils-0.4.2.dist-info/RECORD,,

nano_dev_utils-0.3.5.dist-info/RECORD

@@ -1,8 +0,0 @@
-nano_dev_utils/__init__.py,sha256=NFw7FWw1oJnOmRLe8btPbLJX7e5O78Keaw5fow29tOQ,371
-nano_dev_utils/dynamic_importer.py,sha256=ufMEQKhtlDIYorjWVv58CKm-GWCwwgzp2pSSMznzlkc,917
-nano_dev_utils/release_ports.py,sha256=lw4pNCvkVG36UIMlibpPzKUlNPlvwuYQ3klAd7XLSug,6042
-nano_dev_utils/timers.py,sha256=niQhXzMuwUh7cdOPi8trKySbv8pFkP4XO5cLBqOxlng,1142
-nano_dev_utils-0.3.5.dist-info/METADATA,sha256=AZDVeHhP4MN7Gn7I-LBvz51R7uuBcMky4YOyZTy0B6Q,5069
-nano_dev_utils-0.3.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nano_dev_utils-0.3.5.dist-info/licenses/LICENSE.md,sha256=Muenl7Bw_LdtHZtlOMAP7Kt97gDCq8WWp2605eDWhHU,1089
-nano_dev_utils-0.3.5.dist-info/RECORD,,