nano-dev-utils 0.2.1__py3-none-any.whl → 0.3.3__py3-none-any.whl

nano_dev_utils/__init__.py

@@ -1,6 +1,7 @@
-"""Nano-Utils-Yaronday - A collection of small Python utilities for developers.
+"""nano-dev-utils - A collection of small Python utilities for developers.
 Copyright (c) 2025 Yaron Dayan
 """
+
 from .dynamic_importer import Importer
 from .timers import Timer
 from .release_ports import PortsRelease, PROXY_SERVER, INSPECTOR_CLIENT

nano_dev_utils/release_ports.py

@@ -1,7 +1,6 @@
 import platform
 import subprocess
 import logging
-from typing import Optional
 
 
 logging.basicConfig(filename='port release.log',
@@ -15,7 +14,7 @@ INSPECTOR_CLIENT = 6274
 
 
 class PortsRelease:
-    def __init__(self, default_ports: Optional[list[int]] = None):
+    def __init__(self, default_ports: list[int] | None = None):
         self.default_ports: list[int] = default_ports \
             if default_ports is not None else [PROXY_SERVER, INSPECTOR_CLIENT]
 
@@ -36,8 +35,8 @@ class PortsRelease:
         return f'Invalid port number: {port}. Skipping.'
 
     @staticmethod
-    def _log_terminate_failed(pid: int, port: Optional[int] = None,
-                              error: Optional[str] = None) -> str:
+    def _log_terminate_failed(pid: int, port: int | None = None,
+                              error: str | None = None) -> str:
         base_msg = f'Failed to terminate process {pid}'
         if port:
             base_msg += f' (on port {port})'
@@ -61,14 +60,15 @@ class PortsRelease:
     def _log_unsupported_os() -> str:
         return f'Unsupported OS: {platform.system()}'
 
-    def get_pid_by_port(self, port: int) -> Optional[int]:
+    def get_pid_by_port(self, port: int) -> int | None:
         """Gets the process ID (PID) listening on the specified port."""
+        system = platform.system()
         try:
-            cmd: Optional[str] = {
+            cmd: str = {
                 "Windows": f"netstat -ano | findstr :{port}",
                 "Linux": f"ss -lntp | grep :{port}",
                 "Darwin": f"lsof -i :{port}",
-            }.get(platform.system())
+            }.get(system, "")
             if not cmd:
                 lgr.error(self._log_unsupported_os())
                 return None
@@ -85,13 +85,13 @@ class PortsRelease:
             for line in lines:
                 if str(port) in line:
                     parts: list[str] = line.split()
-                    if platform.system() == "Windows" and len(parts) > 4:
+                    if system == "Windows" and len(parts) > 4:
                         try:
                             return int(parts[4])
                         except ValueError:
                             lgr.error(self._log_line_parse_failed(line))
                             return None
-                    elif platform.system() == "Linux":
+                    elif system == "Linux":
                         for part in parts:
                             if "pid=" in part:
                                 try:
@@ -99,7 +99,7 @@ class PortsRelease:
                                 except ValueError:
                                     lgr.error(self._log_line_parse_failed(line))
                                     return None
-                    elif platform.system() == "Darwin" and len(parts) > 1:
+                    elif system == "Darwin" and len(parts) > 1:
                         try:
                             return int(parts[1])
                         except ValueError:
@@ -113,11 +113,11 @@ class PortsRelease:
     def kill_process(self, pid: int) -> bool:
         """Kills the process with the specified PID."""
         try:
-            cmd: Optional[str] = {
+            cmd: str = {
                 'Windows': f'taskkill /F /PID {pid}',
                 'Linux': f'kill -9 {pid}',
                 'Darwin': f'kill -9 {pid}',
-            }.get(platform.system())
+            }.get(platform.system(), "")  # fallback to empty string
             if not cmd:
                 lgr.error(self._log_unsupported_os())
                 return False
@@ -132,7 +132,7 @@ class PortsRelease:
             lgr.error(self._log_unexpected_error(e))
             return False
 
-    def release_all(self, ports: Optional[list[int]] = None) -> None:
+    def release_all(self, ports: list[int] | None = None) -> None:
         try:
             ports_to_release: list[int] = self.default_ports if ports is None else ports
 
@@ -141,7 +141,7 @@ class PortsRelease:
                     lgr.error(self._log_invalid_port(port))
                     continue
 
-                pid: Optional[int] = self.get_pid_by_port(port)
+                pid: int | None = self.get_pid_by_port(port)
                 if pid is None:
                     lgr.info(self._log_no_process(port))
                     continue

nano_dev_utils/timers.py

@@ -10,15 +10,26 @@ class Timer:
     def timeit(self, func):
         @wraps(func)
         def timeit_wrapper(*args, **kwargs):
-            start_time = time.perf_counter()
+            start_time = time.perf_counter_ns()
             result = func(*args, **kwargs)
-            end_time = time.perf_counter()
-            total_time = end_time - start_time
-            extra_info = f'{args} {kwargs} ' if self.verbose else ''
-            print(f'{func.__name__} {extra_info}took {total_time:.{self.precision}f} [s]')
-            return result
-        return timeit_wrapper
-
+            end_time = time.perf_counter_ns()
+            total_ns = end_time - start_time
 
+            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"
 
+            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

{nano_dev_utils-0.2.1.dist-info → nano_dev_utils-0.3.3.dist-info}/METADATA

@@ -1,11 +1,11 @@
 Metadata-Version: 2.4
 Name: nano_dev_utils
-Version: 0.2.1
+Version: 0.3.3
 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
 Author-email: Yaron Dayan <yaronday77@gmail.com>
-License-Expression: MIT
+License: MIT
 License-File: LICENSE.md
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
@@ -29,7 +29,6 @@ This module provides a `Timer` class for measuring the execution time of code bl
     * display time durations. Defaults to 4.
     * `verbose` (bool, optional): If `True`, the function's arguments and keyword
     * arguments will be included in the printed timing output. Defaults to `False`.
-    * `timing_records` (list): A list to store the recorded timing durations as formatted strings.
 
 * **`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,

nano_dev_utils-0.3.3.dist-info/RECORD

@@ -0,0 +1,8 @@
+nano_dev_utils/__init__.py,sha256=NFw7FWw1oJnOmRLe8btPbLJX7e5O78Keaw5fow29tOQ,371
+nano_dev_utils/dynamic_importer.py,sha256=sW09aj3_6tzm6mOQbBuqZjp6O2PnpG0_2Ol4Zs_nXe4,902
+nano_dev_utils/release_ports.py,sha256=lw4pNCvkVG36UIMlibpPzKUlNPlvwuYQ3klAd7XLSug,6042
+nano_dev_utils/timers.py,sha256=niQhXzMuwUh7cdOPi8trKySbv8pFkP4XO5cLBqOxlng,1142
+nano_dev_utils-0.3.3.dist-info/METADATA,sha256=CsZ-gMgfclYXXmRyKJz7XaDoQJTQqa29AJuvIm1sJEM,5049
+nano_dev_utils-0.3.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+nano_dev_utils-0.3.3.dist-info/licenses/LICENSE.md,sha256=Muenl7Bw_LdtHZtlOMAP7Kt97gDCq8WWp2605eDWhHU,1089
+nano_dev_utils-0.3.3.dist-info/RECORD,,

nano_dev_utils-0.2.1.dist-info/RECORD

@@ -1,8 +0,0 @@
-nano_dev_utils/__init__.py,sha256=qcbhac5zx27mAgmNvwwHzNxyYsMRK-WElB8n4e8c81A,374
-nano_dev_utils/dynamic_importer.py,sha256=sW09aj3_6tzm6mOQbBuqZjp6O2PnpG0_2Ol4Zs_nXe4,902
-nano_dev_utils/release_ports.py,sha256=HpKL7kawNrLE5RPLByoX_nflaLkQfTnlZKyEIZqSG8g,6081
-nano_dev_utils/timers.py,sha256=_WBY0EQLTn3m-41hw0bzpZ2jR9jn2pmbhfAOWmQkKho,690
-nano_dev_utils-0.2.1.dist-info/METADATA,sha256=561_a1OX9cNMOcu_0cabbp86RfgjjWUHpSAMNGkdqtU,5159
-nano_dev_utils-0.2.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-nano_dev_utils-0.2.1.dist-info/licenses/LICENSE.md,sha256=Muenl7Bw_LdtHZtlOMAP7Kt97gDCq8WWp2605eDWhHU,1089
-nano_dev_utils-0.2.1.dist-info/RECORD,,