PyPI - nano-dev-utils - Versions diffs - 1.4.2__tar.gz → 1.4.4__tar.gz - Mend

nano-dev-utils 1.4.2tar.gz → 1.4.4tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (36) hide show

{nano_dev_utils-1.4.2 → nano_dev_utils-1.4.4}/.idea/workspace.xml RENAMED Viewed

@@ -4,11 +4,10 @@
     <option name="autoReloadType" value="SELECTIVE" />
   </component>
   <component name="ChangeListManager">
-    <list default="true" id="1859e23b-7665-4b92-98cc-65e07a208923" name="Changes" comment="Allow an optional printout to console in addition to logger.&#10;README updates in this regard.&#10;&#10;Bumped minor to v1.4.1">
+    <list default="true" id="1859e23b-7665-4b92-98cc-65e07a208923" name="Changes" comment="minor update v1.4.3">
+      <change beforePath="$PROJECT_DIR$/README.md" beforeDir="false" afterPath="$PROJECT_DIR$/README.md" afterDir="false" />
+      <change beforePath="$PROJECT_DIR$/benchmark/benchtest.py" beforeDir="false" afterPath="$PROJECT_DIR$/benchmark/benchtest.py" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/pyproject.toml" beforeDir="false" afterPath="$PROJECT_DIR$/pyproject.toml" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/src/nano_dev_utils/timers.py" beforeDir="false" afterPath="$PROJECT_DIR$/src/nano_dev_utils/timers.py" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/tests/test_timers/test_duration_formatter.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/test_timers/test_duration_formatter.py" afterDir="false" />
-      <change beforePath="$PROJECT_DIR$/tests/test_timers/test_timer.py" beforeDir="false" afterPath="$PROJECT_DIR$/tests/test_timers/test_timer.py" afterDir="false" />
       <change beforePath="$PROJECT_DIR$/uv.lock" beforeDir="false" afterPath="$PROJECT_DIR$/uv.lock" afterDir="false" />
     </list>
     <option name="SHOW_DIALOG" value="false" />
@@ -27,7 +26,7 @@
     <option name="PUSH_AUTO_UPDATE" value="true" />
     <option name="RECENT_BRANCH_BY_REPOSITORY">
       <map>
-        <entry key="$PROJECT_DIR$" value="master" />
+        <entry key="$PROJECT_DIR$" value="YD_Benchmarks" />
       </map>
     </option>
     <option name="RECENT_GIT_ROOT_PATH" value="$PROJECT_DIR$" />
@@ -43,45 +42,46 @@
     <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.ftd_main.executor&quot;: &quot;Run&quot;,
-    &quot;Python.test_timer.executor&quot;: &quot;Run&quot;,
-    &quot;RunOnceActivity.ShowReadmeOnStart&quot;: &quot;true&quot;,
-    &quot;git-widget-placeholder&quot;: &quot;FI-Timer&quot;,
-    &quot;ignore.virus.scanning.warn.message&quot;: &quot;true&quot;,
-    &quot;last_opened_file_path&quot;: &quot;C:/Workspaces/review1&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.benchtest.executor": "Run",
+    "Python.ftd_main.executor": "Run",
+    "Python.test_timer.executor": "Run",
+    "RunOnceActivity.ShowReadmeOnStart": "true",
+    "git-widget-placeholder": "master",
+    "ignore.virus.scanning.warn.message": "true",
+    "last_opened_file_path": "C:/GitHubWS/nano_dev_utils/benchmark",
+    "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\benchmark" />
       <recent name="C:\GitHubWS\nano_dev_utils\src\nano_dev_utils" />
       <recent name="C:\GitHubWS\nano_dev_utils\tests\test_timers" />
       <recent name="C:\GitHubWS\nano_dev_utils\tests\test_timer" />
       <recent name="C:\GitHubWS\nano_dev_utils\tests" />
-      <recent name="C:\GitHubWS\nano_dev_utils" />
     </key>
     <key name="MoveFile.RECENT_KEYS">
+      <recent name="C:\GitHubWS\nano_dev_utils" />
       <recent name="C:\GitHubWS\nano_dev_utils\src\nano_dev_utils" />
       <recent name="C:\GitHubWS\nano_dev_utils\tests\test_timers" />
       <recent name="C:\GitHubWS\nano_dev_utils\tests" />
-      <recent name="C:\GitHubWS\nano_dev_utils" />
     </key>
   </component>
-  <component name="RunManager" selected="Python tests.Python tests in tests">
-    <configuration name="ftd_bench" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
+  <component name="RunManager" selected="Python.benchtest">
+    <configuration name="benchtest" type="PythonConfigurationType" factoryName="Python" temporary="true" nameIsGenerated="true">
       <module name="nano_dev_utils" />
       <option name="ENV_FILES" value="" />
       <option name="INTERPRETER_OPTIONS" value="" />
@@ -90,11 +90,11 @@
         <env name="PYTHONUNBUFFERED" value="1" />
       </envs>
       <option name="SDK_HOME" value="" />
-      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/src/nano_dev_utils" />
+      <option name="WORKING_DIRECTORY" value="$PROJECT_DIR$/benchmark" />
       <option name="IS_MODULE_SDK" value="true" />
       <option name="ADD_CONTENT_ROOTS" value="true" />
       <option name="ADD_SOURCE_ROOTS" value="true" />
-      <option name="SCRIPT_NAME" value="C:\GitHubWS\nano_dev_utils\src\nano_dev_utils\ftd_bench.py" />
+      <option name="SCRIPT_NAME" value="$PROJECT_DIR$/benchmark/benchtest.py" />
       <option name="PARAMETERS" value="" />
       <option name="SHOW_COMMAND_LINE" value="false" />
       <option name="EMULATE_TERMINAL" value="false" />
@@ -164,7 +164,7 @@
       <method v="2" />
     </configuration>
     <list>
-      <item itemvalue="Python.ftd_bench" />
+      <item itemvalue="Python.benchtest" />
       <item itemvalue="Python tests.Python tests in test_dynamic_importer.py" />
       <item itemvalue="Python tests.Python tests in test_file_tree_display.py" />
       <item itemvalue="Python tests.Python tests in test_timers" />
@@ -172,11 +172,11 @@
     </list>
     <recent_temporary>
       <list>
+        <item itemvalue="Python.benchtest" />
         <item itemvalue="Python tests.Python tests in tests" />
-        <item itemvalue="Python tests.Python tests in test_timers" />
         <item itemvalue="Python tests.Python tests in test_file_tree_display.py" />
+        <item itemvalue="Python tests.Python tests in test_timers" />
         <item itemvalue="Python tests.Python tests in test_dynamic_importer.py" />
-        <item itemvalue="Python.ftd_bench" />
       </list>
     </recent_temporary>
   </component>
@@ -196,134 +196,6 @@
       <option name="presentableId" value="Default" />
       <updated>1746126505743</updated>
     </task>
-    <task id="LOCAL-00055" summary="README updates related to exposed instances">
-      <option name="closed" value="true" />
-      <created>1761700369016</created>
-      <option name="number" value="00055" />
-      <option name="presentableId" value="LOCAL-00055" />
-      <option name="project" value="LOCAL" />
-      <updated>1761700369016</updated>
-    </task>
-    <task id="LOCAL-00056" summary="v1.1.2&#10;dynamic_importer.py:&#10;adding update method&#10;&#10;release_ports.py&#10;+flexible init">
-      <option name="closed" value="true" />
-      <created>1761700719843</created>
-      <option name="number" value="00056" />
-      <option name="presentableId" value="LOCAL-00056" />
-      <option name="project" value="LOCAL" />
-      <updated>1761700719843</updated>
-    </task>
-    <task id="LOCAL-00057" summary="v1.1.2: all object instances exposed&#10;additional methods (update and init wrapper) for importer and ports_release">
-      <option name="closed" value="true" />
-      <created>1761701044755</created>
-      <option name="number" value="00057" />
-      <option name="presentableId" value="LOCAL-00057" />
-      <option name="project" value="LOCAL" />
-      <updated>1761701044755</updated>
-    </task>
-    <task id="LOCAL-00058" summary="Addint imports file_tree_display">
-      <option name="closed" value="true" />
-      <created>1761702026964</created>
-      <option name="number" value="00058" />
-      <option name="presentableId" value="LOCAL-00058" />
-      <option name="project" value="LOCAL" />
-      <updated>1761702026964</updated>
-    </task>
-    <task id="LOCAL-00059" summary="improving file_tree_display.py implementation&#10;&#10;removing old consts file">
-      <option name="closed" value="true" />
-      <created>1761702129430</created>
-      <option name="number" value="00059" />
-      <option name="presentableId" value="LOCAL-00059" />
-      <option name="project" value="LOCAL" />
-      <updated>1761702129430</updated>
-    </task>
-    <task id="LOCAL-00060" summary="file_tree_display.py:&#10;+init(self, *args, **kwargs)&#10;unit tests code refactor and improvements.">
-      <option name="closed" value="true" />
-      <created>1761702755192</created>
-      <option name="number" value="00060" />
-      <option name="presentableId" value="LOCAL-00060" />
-      <option name="project" value="LOCAL" />
-      <updated>1761702755192</updated>
-    </task>
-    <task id="LOCAL-00061" summary="ongoing refactor">
-      <option name="closed" value="true" />
-      <created>1761736405549</created>
-      <option name="number" value="00061" />
-      <option name="presentableId" value="LOCAL-00061" />
-      <option name="project" value="LOCAL" />
-      <updated>1761736405549</updated>
-    </task>
-    <task id="LOCAL-00062" summary="ongoing refactor">
-      <option name="closed" value="true" />
-      <created>1761737723282</created>
-      <option name="number" value="00062" />
-      <option name="presentableId" value="LOCAL-00062" />
-      <option name="project" value="LOCAL" />
-      <updated>1761737723282</updated>
-    </task>
-    <task id="LOCAL-00063" summary="eliminated the warning raised by async test due to a coroutine leakage">
-      <option name="closed" value="true" />
-      <created>1761738281462</created>
-      <option name="number" value="00063" />
-      <option name="presentableId" value="LOCAL-00063" />
-      <option name="project" value="LOCAL" />
-      <updated>1761738281462</updated>
-    </task>
-    <task id="LOCAL-00064" summary="timeit: +docstring&#10;update: minor typing polish">
-      <option name="closed" value="true" />
-      <created>1761738809870</created>
-      <option name="number" value="00064" />
-      <option name="presentableId" value="LOCAL-00064" />
-      <option name="project" value="LOCAL" />
-      <updated>1761738809870</updated>
-    </task>
-    <task id="LOCAL-00065" summary=".">
-      <option name="closed" value="true" />
-      <created>1761739346814</created>
-      <option name="number" value="00065" />
-      <option name="presentableId" value="LOCAL-00065" />
-      <option name="project" value="LOCAL" />
-      <updated>1761739346814</updated>
-    </task>
-    <task id="LOCAL-00066" summary=".">
-      <option name="closed" value="true" />
-      <created>1761742788639</created>
-      <option name="number" value="00066" />
-      <option name="presentableId" value="LOCAL-00066" />
-      <option name="project" value="LOCAL" />
-      <updated>1761742788639</updated>
-    </task>
-    <task id="LOCAL-00067" summary="improving time unites handler (faster)">
-      <option name="closed" value="true" />
-      <created>1761746130529</created>
-      <option name="number" value="00067" />
-      <option name="presentableId" value="LOCAL-00067" />
-      <option name="project" value="LOCAL" />
-      <updated>1761746130529</updated>
-    </task>
-    <task id="LOCAL-00068" summary="ruff linter update">
-      <option name="closed" value="true" />
-      <created>1761746187138</created>
-      <option name="number" value="00068" />
-      <option name="presentableId" value="LOCAL-00068" />
-      <option name="project" value="LOCAL" />
-      <updated>1761746187138</updated>
-    </task>
-    <task id="LOCAL-00069" summary="+fast multi-unit time duration converter and formatter">
-      <option name="closed" value="true" />
-      <created>1761748339362</created>
-      <option name="number" value="00069" />
-      <option name="presentableId" value="LOCAL-00069" />
-      <option name="project" value="LOCAL" />
-      <updated>1761748339362</updated>
-    </task>
-    <task id="LOCAL-00070" summary="message formatter: using local verbose and changing to static method">
-      <option name="closed" value="true" />
-      <created>1761748675961</created>
-      <option name="number" value="00070" />
-      <option name="presentableId" value="LOCAL-00070" />
-      <option name="project" value="LOCAL" />
-      <updated>1761748675961</updated>
-    </task>
     <task id="LOCAL-00071" summary="ongoing updates">
       <option name="closed" value="true" />
       <created>1761749373855</created>
@@ -588,7 +460,135 @@
       <option name="project" value="LOCAL" />
       <updated>1762093698362</updated>
     </task>
-    <option name="localTasksCounter" value="104" />
+    <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>
+    </task>
+    <task id="LOCAL-00107" summary="timers refactor">
+      <option name="closed" value="true" />
+      <created>1762138590329</created>
+      <option name="number" value="00107" />
+      <option name="presentableId" value="LOCAL-00107" />
+      <option name="project" value="LOCAL" />
+      <updated>1762138590329</updated>
+    </task>
+    <task id="LOCAL-00108" summary="renaming + docstring updates">
+      <option name="closed" value="true" />
+      <created>1762162557303</created>
+      <option name="number" value="00108" />
+      <option name="presentableId" value="LOCAL-00108" />
+      <option name="project" value="LOCAL" />
+      <updated>1762162557303</updated>
+    </task>
+    <task id="LOCAL-00109" summary="docstring rephrase; code linting &amp; formatting">
+      <option name="closed" value="true" />
+      <created>1762162961435</created>
+      <option name="number" value="00109" />
+      <option name="presentableId" value="LOCAL-00109" />
+      <option name="project" value="LOCAL" />
+      <updated>1762162961435</updated>
+    </task>
+    <task id="LOCAL-00110" summary="removed methods that are now obsolete">
+      <option name="closed" value="true" />
+      <created>1762163648421</created>
+      <option name="number" value="00110" />
+      <option name="presentableId" value="LOCAL-00110" />
+      <option name="project" value="LOCAL" />
+      <updated>1762163648421</updated>
+    </task>
+    <task id="LOCAL-00111" summary="_check_timeout changed to static;&#10;improved formatting">
+      <option name="closed" value="true" />
+      <created>1762165957757</created>
+      <option name="number" value="00111" />
+      <option name="presentableId" value="LOCAL-00111" />
+      <option name="project" value="LOCAL" />
+      <updated>1762165957757</updated>
+    </task>
+    <task id="LOCAL-00112" summary="duration formatter: improved unit tests">
+      <option name="closed" value="true" />
+      <created>1762169854461</created>
+      <option name="number" value="00112" />
+      <option name="presentableId" value="LOCAL-00112" />
+      <option name="project" value="LOCAL" />
+      <updated>1762169854461</updated>
+    </task>
+    <task id="LOCAL-00113" summary="reformat">
+      <option name="closed" value="true" />
+      <created>1762170443081</created>
+      <option name="number" value="00113" />
+      <option name="presentableId" value="LOCAL-00113" />
+      <option name="project" value="LOCAL" />
+      <updated>1762170443081</updated>
+    </task>
+    <task id="LOCAL-00114" summary="+ wrapper for Tree (MS Windows utility that visualizes folder structure)">
+      <option name="closed" value="true" />
+      <created>1762172657234</created>
+      <option name="number" value="00114" />
+      <option name="presentableId" value="LOCAL-00114" />
+      <option name="project" value="LOCAL" />
+      <updated>1762172657234</updated>
+    </task>
+    <task id="LOCAL-00115" summary="bugfix str2file (create parent if doesn't exist)">
+      <option name="closed" value="true" />
+      <created>1762176931574</created>
+      <option name="number" value="00115" />
+      <option name="presentableId" value="LOCAL-00115" />
+      <option name="project" value="LOCAL" />
+      <updated>1762176931574</updated>
+    </task>
+    <task id="LOCAL-00116" summary="FTD unit tests refactor,&#10;completing coverage for file_tree_display method">
+      <option name="closed" value="true" />
+      <created>1762180145497</created>
+      <option name="number" value="00116" />
+      <option name="presentableId" value="LOCAL-00116" />
+      <option name="project" value="LOCAL" />
+      <updated>1762180145497</updated>
+    </task>
+    <task id="LOCAL-00117" summary="tiny reformatting and renaming">
+      <option name="closed" value="true" />
+      <created>1762180180185</created>
+      <option name="number" value="00117" />
+      <option name="presentableId" value="LOCAL-00117" />
+      <option name="project" value="LOCAL" />
+      <updated>1762180180185</updated>
+    </task>
+    <task id="LOCAL-00118" summary="+improved error handling for win_tree_wrapper&#10;+benchtest code, comparing my FTD module to MS-Windows Tree (focusing on running time)">
+      <option name="closed" value="true" />
+      <created>1762180401037</created>
+      <option name="number" value="00118" />
+      <option name="presentableId" value="LOCAL-00118" />
+      <option name="project" value="LOCAL" />
+      <updated>1762180401037</updated>
+    </task>
+    <task id="LOCAL-00119" summary="minor update v1.4.3">
+      <option name="closed" value="true" />
+      <created>1762181821368</created>
+      <option name="number" value="00119" />
+      <option name="presentableId" value="LOCAL-00119" />
+      <option name="project" value="LOCAL" />
+      <updated>1762181821368</updated>
+    </task>
+    <option name="localTasksCounter" value="120" />
     <servers />
   </component>
   <component name="Vcs.Log.Tabs.Properties">
@@ -599,7 +599,7 @@
             <list>
               <RecentGroup>
                 <option name="FILTER_VALUES">
-                  <option value="origin/FI" />
+                  <option value="origin/YD_Benchmarks" />
                 </option>
               </RecentGroup>
               <RecentGroup>
@@ -607,6 +607,11 @@
                   <option value="origin/master" />
                 </option>
               </RecentGroup>
+              <RecentGroup>
+                <option name="FILTER_VALUES">
+                  <option value="origin/FI" />
+                </option>
+              </RecentGroup>
             </list>
           </value>
         </entry>
@@ -616,30 +621,25 @@
       <map>
         <entry key="MAIN">
           <value>
-            <State />
+            <State>
+              <option name="FILTERS">
+                <map>
+                  <entry key="branch">
+                    <value>
+                      <list>
+                        <option value="origin/YD_Benchmarks" />
+                      </list>
+                    </value>
+                  </entry>
+                </map>
+              </option>
+            </State>
           </value>
         </entry>
       </map>
     </option>
   </component>
   <component name="VcsManagerConfiguration">
-    <MESSAGE value="timer -&gt; timer_mock" />
-    <MESSAGE value="ruff." />
-    <MESSAGE value="test_timer unit tests complete" />
-    <MESSAGE value="bumped version to 1.2.0" />
-    <MESSAGE value="+uv.lock" />
-    <MESSAGE value="aysnc_sleep_mocker -&gt; moved to conftest; &#10;uv lock sync with v1.2.1" />
-    <MESSAGE value="async_sleep_mocker -&gt; moved to conftest;&#10;uv lock sync with v1.2.1" />
-    <MESSAGE value="async_sleep_mocker -&gt; moved to conftest;&#10;uv lock sync with v1.2.1" />
-    <MESSAGE value="async_sleep_mocker -&gt; conftest;&#10;uv lock sync with v1.2.1" />
-    <MESSAGE value="+str2file function (instead of buffer2file method) + unit tests." />
-    <MESSAGE value="minor update" />
-    <MESSAGE value="test_common refactor;&#10;minor update" />
-    <MESSAGE value="file_tree_display.py additional features: &#10;Style control&#10;Flexible sorting &#10;Improved recursive DFS method build_tree" />
-    <MESSAGE value="bumped to v1.3.0; synced uv.lock" />
-    <MESSAGE value="typo correction" />
-    <MESSAGE value="+PredicateBuilder: creates predicate functions" />
-    <MESSAGE value="README updates IAW recends mods" />
     <MESSAGE value="bumped to v1.4.0" />
     <MESSAGE value="+build" />
     <MESSAGE value="Readme updates" />
@@ -648,6 +648,23 @@
     <MESSAGE value="+printout testing (WIP)" />
     <MESSAGE value="Pyright corrections;&#10;Timer unit tests - improved code" />
     <MESSAGE value="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="LAST_COMMIT_MESSAGE" value="Allow an optional printout to console in addition to logger.&#10;README updates in this regard.&#10;&#10;Bumped minor to v1.4.1" />
+    <MESSAGE value="+blank space before time unit&#10;&#10;Bumped minor to v1.4.2" />
+    <MESSAGE value="+link to PYPI package&#10;Benchmark data, Tree(a built-in windows utility) vs my FTD" />
+    <MESSAGE value="applying precision upon request" />
+    <MESSAGE value="timers refactor" />
+    <MESSAGE value="renaming + docstring updates" />
+    <MESSAGE value="docstring rephrase; code linting &amp; formatting" />
+    <MESSAGE value="removed methods that are now obsolete" />
+    <MESSAGE value="_check_timeout changed to static;&#10;improved formatting" />
+    <MESSAGE value="duration formatter: improved unit tests" />
+    <MESSAGE value="reformat" />
+    <MESSAGE value="+ wrapper for Tree (MS Windows utility that visualizes folder structure)" />
+    <MESSAGE value="bugfix str2file (create parent if doesn't exist)" />
+    <MESSAGE value="FTD unit tests refactor,&#10;completing coverage for file_tree_display method" />
+    <MESSAGE value="tiny reformatting and renaming" />
+    <MESSAGE value="+improved error handling for win_tree_wrapper&#10;+benchtest code, comparing my FTD module to MS-Windows Tree (focusing on running time)&#10;+updating bench results (FTD is very stable twice as fast)" />
+    <MESSAGE value="+improved error handling for win_tree_wrapper&#10;+benchtest code, comparing my FTD module to MS-Windows Tree (focusing on running time)" />
+    <MESSAGE value="minor update v1.4.3" />
+    <option name="LAST_COMMIT_MESSAGE" value="minor update v1.4.3" />
   </component>
 </project>

{nano_dev_utils-1.4.2 → nano_dev_utils-1.4.4}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nano_dev_utils
-Version: 1.4.2
+Version: 1.4.4
 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
@@ -17,6 +17,7 @@ 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
@@ -58,7 +59,7 @@ import time
 import logging
 from nano_dev_utils import timer
-# This timer version uses a logger but also allows printing (if enabled), so it has to be configured in your app, for instance:
+# 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',
@@ -156,8 +157,7 @@ It supports Windows, Linux, and macOS.
 import logging
 from nano_dev_utils import ports_release, PortsRelease
-# configure the logger
 logging.basicConfig(filename='port release.log',
                     level=logging.INFO,  # DEBUG, WARNING, ERROR, CRITICAL
                     format='%(asctime)s - %(levelname)s: %(message)s',
@@ -196,20 +196,29 @@ Output can be displayed in the console or saved to a file.
 ## Benchmarks
-As measured on a dataset of 10553 files, 1235 folders (ca. 16 GB) using Python 3.10 on SSD.
-Avg. time was measured over 10 runs per configuration.
+A measurement on an unfiltered, high-depth dataset of 10553 files, 1235 folders (ca. 16 GB) using Python 3.10 on SSD.
+Avg. time was measured over 20 runs per configuration, using `timeit` decorator I've implemented in this package.
+Comparing FileTreeDisplay (FTD) with
+[win_tree_wrapper](https://github.com/yaronday/nano_dev_utils/blob/master/benchmark/win_tree_wrapper.py)
+(Windows [Tree](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/tree)
+wrapper which I've implemented for this purpose):
+03-11-2025 17:10:06 - INFO: ftd_run took 182.155 ms (avg. over 20 runs)
+03-11-2025 17:10:14 - INFO: win_tree_cmd took 406.849 ms (avg. over 20 runs)
-| Tool            | Time (s) |
-|-----------------|----------|
-| FileTreeDisplay | 0.198    |
-| Seedir          | 4.378    |
+| Tool   | Time (s) |
+|--------|----------|
+| FTD    | 0.182    |
+| Tree   | 0.407    |
+[Benchtest code](https://github.com/yaronday/nano_dev_utils/blob/master/benchmark/benchtest.py)
 #### Class Overview
 **`FileTreeDisplay`**
-Constructs and manages the visual representation of a directory structure.
+Constructs and manages the visual representation of a folder structure of a path or of a disk drive.
 **Initialization Parameters**

{nano_dev_utils-1.4.2 → nano_dev_utils-1.4.4}/README.md RENAMED Viewed

@@ -1,6 +1,7 @@
 # nano_dev_utils
 A collection of small Python utilities for developers.
+[PYPI package: nano-dev-utils](https://pypi.org/project/nano-dev-utils)
 ## Modules
@@ -42,7 +43,7 @@ import time
 import logging
 from nano_dev_utils import timer
-# This timer version uses a logger but also allows printing (if enabled), so it has to be configured in your app, for instance:
+# 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',
@@ -140,8 +141,7 @@ It supports Windows, Linux, and macOS.
 import logging
 from nano_dev_utils import ports_release, PortsRelease
-# configure the logger
 logging.basicConfig(filename='port release.log',
                     level=logging.INFO,  # DEBUG, WARNING, ERROR, CRITICAL
                     format='%(asctime)s - %(levelname)s: %(message)s',
@@ -180,20 +180,29 @@ Output can be displayed in the console or saved to a file.
 ## Benchmarks
-As measured on a dataset of 10553 files, 1235 folders (ca. 16 GB) using Python 3.10 on SSD.
-Avg. time was measured over 10 runs per configuration.
+A measurement on an unfiltered, high-depth dataset of 10553 files, 1235 folders (ca. 16 GB) using Python 3.10 on SSD.
+Avg. time was measured over 20 runs per configuration, using `timeit` decorator I've implemented in this package.
+Comparing FileTreeDisplay (FTD) with
+[win_tree_wrapper](https://github.com/yaronday/nano_dev_utils/blob/master/benchmark/win_tree_wrapper.py)
+(Windows [Tree](https://learn.microsoft.com/en-us/windows-server/administration/windows-commands/tree)
+wrapper which I've implemented for this purpose):
+03-11-2025 17:10:06 - INFO: ftd_run took 182.155 ms (avg. over 20 runs)
+03-11-2025 17:10:14 - INFO: win_tree_cmd took 406.849 ms (avg. over 20 runs)
-| Tool            | Time (s) |
-|-----------------|----------|
-| FileTreeDisplay | 0.198    |
-| Seedir          | 4.378    |
+| Tool   | Time (s) |
+|--------|----------|
+| FTD    | 0.182    |
+| Tree   | 0.407    |
+[Benchtest code](https://github.com/yaronday/nano_dev_utils/blob/master/benchmark/benchtest.py)
 #### Class Overview
 **`FileTreeDisplay`**
-Constructs and manages the visual representation of a directory structure.
+Constructs and manages the visual representation of a folder structure of a path or of a disk drive.
 **Initialization Parameters**

nano-dev-utils 1.4.2__tar.gz → 1.4.4__tar.gz

nano-dev-utils 1.4.2tar.gz → 1.4.4tar.gz