pyutilkit 0.2.0__tar.gz → 0.3.0__tar.gz

{pyutilkit-0.2.0 → pyutilkit-0.3.0}/PKG-INFO

@@ -1,18 +1,17 @@
 Metadata-Version: 2.1
 Name: pyutilkit
-Version: 0.2.0
+Version: 0.3.0
 Summary: python's missing batteries
 Home-page: https://pyutilkit.readthedocs.io/en/stable/
 License: LGPL-3.0+
 Keywords: utils
 Author: Stephanos Kuma
 Author-email: stephanos@kuma.ai
-Requires-Python: >=3.8,<4.0
+Requires-Python: >=3.9,<4.0
 Classifier: Development Status :: 4 - Beta
 Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
@@ -31,7 +30,11 @@ Description-Content-Type: text/markdown
 [![build automation: yam][yam_badge]][yam_url]
 [![Lint: ruff][ruff_badge]][ruff_url]
 
-Long project description and tldr goes here
+The Python has long maintained the philosophy of "batteries included", giving the user
+a rich standard library, avoiding the need for third party tools for most work. Some packages
+are so common, that the have a similar status to the standard library. Still, some code seems
+to be written time and again, with every project. This small library, with minimal requirements,
+hopes to stop this repetition.
 
 ## Links
 

{pyutilkit-0.2.0 → pyutilkit-0.3.0}/docs/README.md

@@ -8,7 +8,11 @@
 [![build automation: yam][yam_badge]][yam_url]
 [![Lint: ruff][ruff_badge]][ruff_url]
 
-Long project description and tldr goes here
+The Python has long maintained the philosophy of "batteries included", giving the user
+a rich standard library, avoiding the need for third party tools for most work. Some packages
+are so common, that the have a similar status to the standard library. Still, some code seems
+to be written time and again, with every project. This small library, with minimal requirements,
+hopes to stop this repetition.
 
 ## Links
 

{pyutilkit-0.2.0 → pyutilkit-0.3.0}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.black]
 target-version = [
-    "py38",
+    "py39",
 ]
 
 [tool.mypy]
@@ -32,7 +32,7 @@ warn_unused_configs = true
 src = [
     "src",
 ]
-target-version = "py38"
+target-version = "py39"
 
 [tool.ruff.lint]
 select = [
@@ -126,7 +126,7 @@ skip_empty = true
 
 [tool.poetry]
 name = "pyutilkit"
-version = "0.2.0"
+version = "0.3.0"
 description = "python's missing batteries"
 authors = [
     "Stephanos Kuma <stephanos@kuma.ai>",
@@ -149,7 +149,7 @@ classifiers = [
 
 [tool.poetry.dependencies]
 # python version
-python = "^3.8"
+python = "^3.9"
 
 [tool.poetry.group.dev.dependencies]
 ipdb = { version = "^0.13", python = "^3.10" }

{pyutilkit-0.2.0 → pyutilkit-0.3.0}/src/pyutilkit/date_utils.py

@@ -1,7 +1,6 @@
 from __future__ import annotations
 
 from datetime import datetime, tzinfo
-
 from zoneinfo import ZoneInfo, available_timezones
 
 from pyutilkit.data.timezones import UNAVAILABLE_TIMEZONES

{pyutilkit-0.2.0 → pyutilkit-0.3.0}/src/pyutilkit/timing.py

@@ -1,4 +1,12 @@
+from __future__ import annotations  # py3.9: remove this line
+
 from dataclasses import dataclass
+from time import perf_counter_ns
+from types import TracebackType
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from typing_extensions import Self  # py3.10: import Self from typing
 
 
 @dataclass(frozen=True, order=True)
@@ -36,3 +44,25 @@ class Timing:
             return f"{milliseconds:.1f}ms"
         seconds = milliseconds / 1000
         return f"{seconds:,.2f}s"
+
+
+class Stopwatch:
+    _start: int
+    timing: Timing
+
+    def __init__(self) -> None:
+        self._start = 0
+        self.timing = Timing(nanoseconds=0)
+
+    def __enter__(self) -> Self:
+        self._start = perf_counter_ns()
+        return self
+
+    def __exit__(
+        self,
+        exc_type: type[Exception] | None,
+        exc_value: Exception | None,
+        traceback: TracebackType | None,
+    ) -> None:
+        _end = perf_counter_ns()
+        self.timing = Timing(nanoseconds=_end - self._start)

pyutilkit-0.2.0/src/pyutilkit/__init__.py

@@ -1 +0,0 @@
-__version__ = "0.2.0"