nano-dev-utils 1.6.2__tar.gz → 1.7.1__tar.gz

{nano_dev_utils-1.6.2 → nano_dev_utils-1.7.1}/.gitignore

@@ -174,4 +174,6 @@ cython_debug/
 .pypirc
 
 /src/*/debug.py
-/src/*/*.log
+/src/*/*.log
+
+update_package.py

nano_dev_utils-1.7.1/.idea/nano_dev_utils.iml

@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module external.system.id="pyproject.toml" type="PYTHON_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/src" />
+      <excludeFolder url="file://$MODULE_DIR$/.venv" />
+    </content>
+    <orderEntry type="jdk" jdkName="C:\GitHubWS\nano_dev_utils\.venv" jdkType="Python SDK" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

{nano_dev_utils-1.6.2 → nano_dev_utils-1.7.1}/.idea/workspace.xml

@@ -4,10 +4,7 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="1859e23b-7665-4b92-98cc-65e07a208923" name="Changes" comment="versioning updates;&#10;load_cfg_file minor update;&#10;v1.6.1">
-      <change beforePath="$PROJECT_DIR$/src/nano_dev_utils/__main__.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/nano_dev_utils/__main__.py" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/nano_dev_utils/__version__.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/nano_dev_utils/__version__.py" afterDir="false" />
-    </list>
+    <list default="true" id="1859e23b-7665-4b92-98cc-65e07a208923" name="Changes" comment="bumped minor" />
     <option name="SHOW_DIALOG" value="false" />
     <option name="HIGHLIGHT_CONFLICTS" value="true" />
     <option name="HIGHLIGHT_NON_ACTIVE_CHANGELIST" value="false" />
@@ -24,7 +21,7 @@
     <option name="PUSH_AUTO_UPDATE" value="true" />
     <option name="RECENT_BRANCH_BY_REPOSITORY">
       <map>
-        <entry key="$PROJECT_DIR$" value="FI-CLI" />
+        <entry key="$PROJECT_DIR$" value="master" />
       </map>
     </option>
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
@@ -40,32 +37,36 @@
     <option name="showLibraryContents" value="true" />
     <option name="showMembers" value="true" />
   </component>
-  <component name="PropertiesComponent">{
-  &quot;keyToString&quot;: {
-    &quot;Python tests.Python tests in test_dynamic_importer.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_file_tree_display.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_release_ports.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_timer.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_timers (1).executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_timers.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in test_timers_async.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in testing_duration_formatter.py.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.Python tests in tests.executor&quot;: &quot;Run&quot;,
-    &quot;Python tests.test_timer prev.executor&quot;: &quot;Run&quot;,
-    &quot;Python.__main__.executor&quot;: &quot;Debug&quot;,
-    &quot;Python.benchtest.executor&quot;: &quot;Run&quot;,
-    &quot;Python.benchtest_bkp.executor&quot;: &quot;Run&quot;,
-    &quot;Python.ftd_main.executor&quot;: &quot;Run&quot;,
-    &quot;Python.test_timer.executor&quot;: &quot;Run&quot;,
-    &quot;Python.update_package.executor&quot;: &quot;Run&quot;,
-    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
-    &quot;git-widget-placeholder&quot;: &quot;master&quot;,
-    &quot;ignore.virus.scanning.warn.message&quot;: &quot;true&quot;,
-    &quot;last_opened_file_path&quot;: &quot;C:/GitHubWS/nano_dev_utils/src&quot;,
-    &quot;settings.editor.selected.configurable&quot;: &quot;com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable&quot;,
-    &quot;two.files.diff.last.used.file&quot;: &quot;C:/Workspaces/review1/tools/file_tree_display/tests/test_file_tree_display.py&quot;
+  <component name="PropertiesComponent"><![CDATA[{
+  "keyToString": {
+    "Python tests.Python tests in test_dynamic_importer.py.executor": "Run",
+    "Python tests.Python tests in test_file_tree_display.py.executor": "Run",
+    "Python tests.Python tests in test_release_ports.py.executor": "Run",
+    "Python tests.Python tests in test_timer.py.executor": "Run",
+    "Python tests.Python tests in test_timers (1).executor": "Run",
+    "Python tests.Python tests in test_timers.executor": "Run",
+    "Python tests.Python tests in test_timers_async.py.executor": "Run",
+    "Python tests.Python tests in testing_duration_formatter.py.executor": "Run",
+    "Python tests.Python tests in tests.executor": "Run",
+    "Python tests.test_timer prev.executor": "Run",
+    "Python.__main__.executor": "Debug",
+    "Python.benchtest.executor": "Run",
+    "Python.benchtest_bkp.executor": "Run",
+    "Python.ftd_main.executor": "Run",
+    "Python.test_timer.executor": "Run",
+    "Python.update_package.executor": "Run",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "RunOnceActivity.typescript.service.memoryLimit.init": "true",
+    "codeWithMe.voiceChat.enabledByDefault": "false",
+    "git-widget-placeholder": "yd__caseBugFix",
+    "ignore.virus.scanning.warn.message": "true",
+    "last_opened_file_path": "C:/GitHubWS/nano_dev_utils",
+    "nodejs_package_manager_path": "npm",
+    "python.packages.toolwindow.project.migrated.to.right.top.v2": "true",
+    "settings.editor.selected.configurable": "com.jetbrains.python.configuration.PyActiveSdkModuleConfigurable",
+    "two.files.diff.last.used.file": "C:/Workspaces/review1/tools/file_tree_display/tests/test_file_tree_display.py"
   }
-}</component>
+}]]></component>
   <component name="RecentsManager">
     <key name="CopyFile.RECENT_KEYS">
       <recent name="C:\GitHubWS\nano_dev_utils\src" />
@@ -81,7 +82,7 @@
       <recent name="C:\GitHubWS\nano_dev_utils\tests" />
     </key>
   </component>
-  <component name="RunManager" selected="Python.benchtest_bkp">
+  <component name="RunManager" selected="Python.update_package">
     <configuration name="benchtest_bkp" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="nano_dev_utils" />
       <option name="ENV_FILES" value="" />
@@ -95,6 +96,9 @@
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="RUN_TOOL" value="" />
       <option name="SCRIPT_NAME" value="$PROJECT_DIR$/benchmark/benchtest_bkp.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
@@ -117,6 +121,9 @@
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="RUN_TOOL" value="" />
       <option name="SCRIPT_NAME" value="$PROJECT_DIR$/update_package.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
@@ -126,21 +133,6 @@
       <option name="INPUT_FILE" value="" />
       <method v="2" />
     </configuration>
-    <configuration name="Python tests in test_file_tree_display.py" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
-      <module name="nano_dev_utils" />
-      <option name="ENV_FILES" value="" />
-      <option name="INTERPRETER_OPTIONS" value="" />
-      <option name="PARENT_ENVS" value="true" />
-      <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/tests" />
-      <option name="IS_MODULE_SDK" value="true" />
-      <option name="ADD_CONTENT_ROOTS" value="true" />
-      <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="_new_additionalArguments" value="&quot;&quot;" />
-      <option name="_new_target" value="&quot;$PROJECT_DIR$/tests/test_file_tree_display.py&quot;" />
-      <option name="_new_targetType" value="&quot;PATH&quot;" />
-      <method v="2" />
-    </configuration>
     <configuration name="Python tests in tests" type="tests" factoryName="Autodetect" temporary="true" nameIsGenerated="true">
       <module name="nano_dev_utils" />
       <option name="ENV_FILES" value="" />
@@ -151,6 +143,9 @@
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
+      <option name="DEBUG_JUST_MY_CODE" value="true" />
+      <EXTENSION ID="PythonCoverageRunConfigurationExtension" runner="coverage.py" />
+      <option name="RUN_TOOL" value="true" />
       <option name="_new_additionalArguments" value="&quot;&quot;" />
       <option name="_new_target" value="&quot;$PROJECT_DIR$/tests&quot;" />
       <option name="_new_targetType" value="&quot;PATH&quot;" />
@@ -159,7 +154,6 @@
     <list>
       <item itemvalue="Python.update_package" />
       <item itemvalue="Python.benchtest_bkp" />
-      <item itemvalue="Python tests.Python tests in test_file_tree_display.py" />
       <item itemvalue="Python tests.Python tests in tests" />
     </list>
     <recent_temporary>
@@ -167,14 +161,13 @@
         <item itemvalue="Python.update_package" />
         <item itemvalue="Python tests.Python tests in tests" />
         <item itemvalue="Python.benchtest_bkp" />
-        <item itemvalue="Python tests.Python tests in test_file_tree_display.py" />
       </list>
     </recent_temporary>
   </component>
   <component name="SharedIndexes">
     <attachedChunks>
       <set>
-        <option value="bundled-python-sdk-5b207ade9991-746f403e7f0c-com.jetbrains.pycharm.community.sharedIndexes.bundled-PC-241.17890.14" />
+        <option value="bundled-python-sdk-73a66231627c-5bd6d13a2a75-com.jetbrains.pycharm.pro.sharedIndexes.bundled-PY-262.10968.92" />
       </set>
     </attachedChunks>
   </component>
@@ -186,78 +179,7 @@
       <option name="number" value="Default" />
       <option name="presentableId" value="Default" />
       <updated>1746126505743</updated>
-    </task>
-    <task id="LOCAL-00098" summary="Readme updates">
-      <option name="closed" value="true" />
-      <created>1762078800875</created>
-      <option name="number" value="00098" />
-      <option name="presentableId" value="LOCAL-00098" />
-      <option name="project" value="LOCAL" />
-      <updated>1762078800875</updated>
-    </task>
-    <task id="LOCAL-00099" summary="+res_formatter, a wrapper for the private static _duration_formatter.">
-      <option name="closed" value="true" />
-      <created>1762081915651</created>
-      <option name="number" value="00099" />
-      <option name="presentableId" value="LOCAL-00099" />
-      <option name="project" value="LOCAL" />
-      <updated>1762081915651</updated>
-    </task>
-    <task id="LOCAL-00100" summary="Timer: +printout option">
-      <option name="closed" value="true" />
-      <created>1762081953468</created>
-      <option name="number" value="00100" />
-      <option name="presentableId" value="LOCAL-00100" />
-      <option name="project" value="LOCAL" />
-      <updated>1762081953468</updated>
-    </task>
-    <task id="LOCAL-00101" summary="+printout testing (WIP)">
-      <option name="closed" value="true" />
-      <created>1762084839210</created>
-      <option name="number" value="00101" />
-      <option name="presentableId" value="LOCAL-00101" />
-      <option name="project" value="LOCAL" />
-      <updated>1762084839210</updated>
-    </task>
-    <task id="LOCAL-00102" summary="Pyright corrections;&#10;Timer unit tests - improved code">
-      <option name="closed" value="true" />
-      <created>1762093068383</created>
-      <option name="number" value="00102" />
-      <option name="presentableId" value="LOCAL-00102" />
-      <option name="project" value="LOCAL" />
-      <updated>1762093068383</updated>
-    </task>
-    <task id="LOCAL-00103" summary="Allow an optional printout to console in addition to logger.&#10;README updates in this regard.&#10;&#10;Bumped minor to v1.4.1">
-      <option name="closed" value="true" />
-      <created>1762093698362</created>
-      <option name="number" value="00103" />
-      <option name="presentableId" value="LOCAL-00103" />
-      <option name="project" value="LOCAL" />
-      <updated>1762093698362</updated>
-    </task>
-    <task id="LOCAL-00104" summary="+blank space before time unit&#10;&#10;Bumped minor to v1.4.2">
-      <option name="closed" value="true" />
-      <created>1762096472993</created>
-      <option name="number" value="00104" />
-      <option name="presentableId" value="LOCAL-00104" />
-      <option name="project" value="LOCAL" />
-      <updated>1762096472993</updated>
-    </task>
-    <task id="LOCAL-00105" summary="+link to PYPI package&#10;Benchmark data, Tree(a built-in windows utility) vs my FTD">
-      <option name="closed" value="true" />
-      <created>1762135842965</created>
-      <option name="number" value="00105" />
-      <option name="presentableId" value="LOCAL-00105" />
-      <option name="project" value="LOCAL" />
-      <updated>1762135842965</updated>
-    </task>
-    <task id="LOCAL-00106" summary="applying precision upon request">
-      <option name="closed" value="true" />
-      <created>1762136721863</created>
-      <option name="number" value="00106" />
-      <option name="presentableId" value="LOCAL-00106" />
-      <option name="project" value="LOCAL" />
-      <updated>1762136721863</updated>
+      <workItem from="1792508470918" duration="2158000" />
     </task>
     <task id="LOCAL-00107" summary="timers refactor">
       <option name="closed" value="true" />
@@ -579,9 +501,84 @@
       <option name="project" value="LOCAL" />
       <updated>1762712425856</updated>
     </task>
-    <option name="localTasksCounter" value="147" />
+    <task id="LOCAL-00147" summary="minor bugfix (cfg); &#10;Bumped minor version&#10;v1.6.2">
+      <option name="closed" value="true" />
+      <created>1762716808091</created>
+      <option name="number" value="00147" />
+      <option name="presentableId" value="LOCAL-00147" />
+      <option name="project" value="LOCAL" />
+      <updated>1762716808091</updated>
+    </task>
+    <task id="LOCAL-00148" summary="removing ftd since it has its own package.">
+      <option name="closed" value="true" />
+      <created>1762853900126</created>
+      <option name="number" value="00148" />
+      <option name="presentableId" value="LOCAL-00148" />
+      <option name="project" value="LOCAL" />
+      <updated>1762853900126</updated>
+    </task>
+    <task id="LOCAL-00149" summary="removing benchtest (only related to ftd)">
+      <option name="closed" value="true" />
+      <created>1762853964111</created>
+      <option name="number" value="00149" />
+      <option name="presentableId" value="LOCAL-00149" />
+      <option name="project" value="LOCAL" />
+      <updated>1762853964111</updated>
+    </task>
+    <task id="LOCAL-00150" summary=".">
+      <option name="closed" value="true" />
+      <created>1762854113345</created>
+      <option name="number" value="00150" />
+      <option name="presentableId" value="LOCAL-00150" />
+      <option name="project" value="LOCAL" />
+      <updated>1762854113345</updated>
+    </task>
+    <task id="LOCAL-00151" summary="case sensitivity bugfix">
+      <option name="closed" value="true" />
+      <created>1792509006160</created>
+      <option name="number" value="00151" />
+      <option name="presentableId" value="LOCAL-00151" />
+      <option name="project" value="LOCAL" />
+      <updated>1792509006161</updated>
+    </task>
+    <task id="LOCAL-00152" summary="build_predicate: improve signature matching for type checker; adding an explicit fallback">
+      <option name="closed" value="true" />
+      <created>1792509795158</created>
+      <option name="number" value="00152" />
+      <option name="presentableId" value="LOCAL-00152" />
+      <option name="project" value="LOCAL" />
+      <updated>1792509795158</updated>
+    </task>
+    <task id="LOCAL-00153" summary="update: improved error message">
+      <option name="closed" value="true" />
+      <created>1792509982461</created>
+      <option name="number" value="00153" />
+      <option name="presentableId" value="LOCAL-00153" />
+      <option name="project" value="LOCAL" />
+      <updated>1792509982461</updated>
+    </task>
+    <task id="LOCAL-00154" summary="update: improved error message">
+      <option name="closed" value="true" />
+      <created>1792510231518</created>
+      <option name="number" value="00154" />
+      <option name="presentableId" value="LOCAL-00154" />
+      <option name="project" value="LOCAL" />
+      <updated>1792510231518</updated>
+    </task>
+    <task id="LOCAL-00155" summary="bumped minor">
+      <option name="closed" value="true" />
+      <created>1792510400660</created>
+      <option name="number" value="00155" />
+      <option name="presentableId" value="LOCAL-00155" />
+      <option name="project" value="LOCAL" />
+      <updated>1792510400660</updated>
+    </task>
+    <option name="localTasksCounter" value="156" />
     <servers />
   </component>
+  <component name="TypeScriptGeneratedFilesManager">
+    <option name="version" value="3" />
+  </component>
   <component name="Vcs.Log.Tabs.Properties">
     <option name="RECENT_FILTERS">
       <map>
@@ -617,33 +614,13 @@
       <map>
         <entry key="MAIN">
           <value>
-            <State>
-              <option name="FILTERS">
-                <map>
-                  <entry key="branch">
-                    <value>
-                      <list>
-                        <option value="origin/master" />
-                      </list>
-                    </value>
-                  </entry>
-                </map>
-              </option>
-            </State>
+            <State />
           </value>
         </entry>
       </map>
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="upgrading connector style (WIP)" />
-    <MESSAGE value="optimizing performance:&#10;-reduced alloc &amp; overhead;&#10;-precomputed style dict and sorting outside the recursive _build_tree;&#10;-improved string ops:&#10;used StringIO for better memory efficiency&#10;-improved traversal&#10;&#10;Unit tests updates" />
-    <MESSAGE value="-removing single char old style fallback &#10;+ unit test for custom styles dynamically added by user" />
-    <MESSAGE value="README updates related to FTD" />
-    <MESSAGE value="bugfix! simultaneously enabling printout and save2file is now possible" />
-    <MESSAGE value="README update regarding custom connector style" />
-    <MESSAGE value="reminder" />
-    <MESSAGE value="bumped to v1.5.0" />
     <MESSAGE value="typo (+CRLF)" />
     <MESSAGE value="Ruff &amp; Pyright updates" />
     <MESSAGE value="v1.5.1" />
@@ -655,12 +632,23 @@
     <MESSAGE value="precommit update" />
     <MESSAGE value="minor updates" />
     <MESSAGE value="minor updates:&#10;benchtest-removed old style&#10;FTD: +skip_sorting&#10;README: FTD doc updates" />
-    <MESSAGE value="." />
     <MESSAGE value="+load_cfg_file: loading configuration from a JSON file (e.g. for CLI version)." />
     <MESSAGE value="ftd: +get_num_of_entries (total number of scanned files and folders)" />
     <MESSAGE value="+ftd cli version" />
     <MESSAGE value="pyproject.toml: &#10;dynamic version; &#10;ftd cli shortcut;&#10;hatch.version path according to __version__ &#10;v1.6.0" />
     <MESSAGE value="versioning updates;&#10;load_cfg_file minor update;&#10;v1.6.1" />
-    <option name="LAST_COMMIT_MESSAGE" value="versioning updates;&#10;load_cfg_file minor update;&#10;v1.6.1" />
+    <MESSAGE value="minor bugfix (cfg); &#10;Bumped minor version&#10;v1.6.2" />
+    <MESSAGE value="removing ftd since it has its own package." />
+    <MESSAGE value="removing benchtest (only related to ftd)" />
+    <MESSAGE value="." />
+    <MESSAGE value="case sensitivity bugfix" />
+    <MESSAGE value="build_predicate: improve signature matching for type checker; adding an explicit fallback" />
+    <MESSAGE value="fixed warning" />
+    <MESSAGE value="fixed warning" />
+    <MESSAGE value="bumped minor" />
+    <option name="LAST_COMMIT_MESSAGE" value="bumped minor" />
+  </component>
+  <component name="com.intellij.coverage.CoverageDataManagerImpl">
+    <SUITE FILE_PATH="coverage/nano_dev_utils$.coverage" NAME=" Coverage Results" MODIFIED="1792509575145" SOURCE_PROVIDER="com.intellij.coverage.DefaultCoverageFileProvider" RUNNER="coverage.py" COVERAGE_BY_TEST_ENABLED="false" COVERAGE_TRACING_ENABLED="false" WORKING_DIRECTORY="$PROJECT_DIR$/tests" />
   </component>
 </project>

nano_dev_utils-1.7.1/PKG-INFO

@@ -0,0 +1,180 @@
+Metadata-Version: 2.5
+Name: nano_dev_utils
+Version: 1.7.1
+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
+Project-URL: license, https://github.com/yaronday/nano_dev_utils/blob/master/LICENSE
+Author-email: Yaron Dayan <yaronday77@gmail.com>
+License: MIT
+License-File: LICENSE
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.10
+Requires-Dist: build>=1.3.0
+Description-Content-Type: text/markdown
+
+# nano_dev_utils
+
+A collection of small Python utilities for developers.
+[PYPI package: nano-dev-utils](https://pypi.org/project/nano-dev-utils)
+
+## Modules
+
+### `timers.py`
+
+This module provides a `Timer` class for measuring the execution time of code blocks and functions with additional features like timeout control and multi-iteration averaging.
+
+#### `Timer` Class
+
+* **`__init__(self, precision: int = 4, verbose: bool = False, printout: bool = False)`**: Initializes a `Timer` instance.
+    * `precision`: The number of decimal places to record and display time durations. Defaults to 4.
+    * `verbose`: Optionally displays the function's positional arguments (args) and keyword arguments (kwargs). Defaults to `False`.
+    * `printout`: Allows printing to console.
+
+* **`def timeit(
+        self,
+        iterations: int = 1,
+        timeout: float | None = None,
+        per_iteration: bool = False,
+    ) -> Callable[[Callable[P, Any]], Callable[P, Any]]:`**:   
+      Decorator that times either **sync** or **async** function execution with advanced features:
+    * `iterations`: Number of times to run the function (for averaging). Defaults to 1.
+    * `timeout`: Maximum allowed execution time in seconds. When exceeded:
+        * Raises `TimeoutError` immediately
+        * **Warning:** The function execution will be aborted mid-operation
+        * No return value will be available if timeout occurs
+    * `per_iteration`: If True, applies timeout check to each iteration; otherwise checks total time across all iterations.
+    * Features:
+        * Records execution times
+        * Handles timeout conditions
+        * Calculates average execution time across iterations
+        * Logs the function name and execution time (with optional arguments)
+        * Returns the result of the original function (unless timeout occurs)
+
+#### Example Usage:
+
+```python
+import time
+import logging
+from nano_dev_utils import timer
+
+# if printout is not enabled, a logger must be configured in order to see timing results
+logging.basicConfig(filename='timer example.log',
+                    level=logging.INFO,  # DEBUG, WARNING, ERROR, CRITICAL
+                    format='%(asctime)s - %(levelname)s: %(message)s',
+                    datefmt='%d-%m-%Y %H:%M:%S')
+
+# Basic timing
+@timer.timeit()
+def my_function(a, b=10):
+    """A sample function."""
+    time.sleep(0.1)
+    return a + b
+
+timer.init(precision=6, verbose=True)
+'''Alternative options: 
+timer.update({'precision': 6, 'verbose': True})  # 1. Using update method  
+
+from nano_dev_utils.timers import Timer  # 2. explicit instantiation
+timer = Timer(precision=6, verbose=True)  
+'''
+
+timer.update({'printout': True})  # allow printing to console
+
+# Advanced usage with timeout and iterations
+@timer.timeit(iterations=5, timeout=0.5, per_iteration=True)
+def critical_function(x):
+    """Function with timeout check per iteration."""
+    time.sleep(0.08)
+    return x * 2
+
+result1 = my_function(5, b=20)  # Shows args/kwargs and timing
+result2 = critical_function(10)  # Runs 5 times with per-iteration timeout
+```
+
+### `dynamic_importer.py`
+
+This module provides an `Importer` class for lazy loading and caching module imports.
+
+#### `Importer` Class
+
+* **`__init__(self)`**: Initializes an `Importer` instance with an empty dictionary `imported_modules` to cache imported modules.
+
+* **`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 a cached instance.
+    * Raises `ImportError` if the module cannot be found.
+
+#### Example Usage:
+
+```python
+from nano_dev_utils import importer
+
+os_path = importer.import_mod_from_lib("os", "path")
+print(f"Imported os.path: {os_path}")
+
+requests_get = importer.import_mod_from_lib("requests", "get")
+print(f"Imported requests.get: {requests_get}")
+
+# Subsequent calls will return the cached module
+os_path_again = importer.import_mod_from_lib("os", "path")
+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.
+
+#### `PortsRelease` Class
+
+* **`__init__(self, default_ports: list[int] | None = None)`**: 
+* Initializes a `PortsRelease` instance.
+    * `default_ports`: A list of default ports to manage. If not provided, it defaults to `[6277, 6274]`.
+
+* **`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(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: 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
+import logging
+from nano_dev_utils import ports_release, PortsRelease
+
+ 
+logging.basicConfig(filename='port release.log',
+                    level=logging.INFO,  # DEBUG, WARNING, ERROR, CRITICAL 
+                    format='%(asctime)s - %(levelname)s: %(message)s',
+                    datefmt='%d-%m-%Y %H:%M:%S')
+
+
+ports_release.release_all()
+
+# Create an instance with custom ports
+custom_ports_releaser = PortsRelease(default_ports=[8080, 9000, 6274])
+custom_ports_releaser.release_all(ports=[8080, 9000])
+
+# Release only the default ports
+ports_release.release_all()
+```
+
+
+## License
+This project is licensed under the MIT License. 
+See [LICENSE](https://github.com/yaronday/nano_dev_utils/blob/master/LICENSE) for details.