stdl 0.5.2__tar.gz → 0.5.3__tar.gz

{stdl-0.5.2/stdl.egg-info → stdl-0.5.3}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.1
 Name: stdl
-Version: 0.5.2
+Version: 0.5.3
 Summary: Extended Python Standard Library
 Author-email: Žiga Ivanšek <ziga.ivansek@gmail.com>
 Project-URL: Repository, https://github.com/zigai/stdl
+Project-URL: Documentation, https://stdl.readthedocs.io
 Keywords: python utilites,filesystem,string manipulation,logging configuration,list utils,standard library,ANSI colors,terminal output
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License

{stdl-0.5.2 → stdl-0.5.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "stdl"
-version = "0.5.2"
+version = "0.5.3"
 description = "Extended Python Standard Library"
 authors = [{ name = "Žiga Ivanšek", email = "ziga.ivansek@gmail.com" }]
 license = { file = "LICENSE.txt" }
@@ -52,6 +52,7 @@ dev = [
 
 [project.urls]
 Repository = "https://github.com/zigai/stdl"
+Documentation = "https://stdl.readthedocs.io"
 
 [tool.black]
 line-length = 100

{stdl-0.5.2 → stdl-0.5.3}/stdl/dt.py

@@ -45,7 +45,7 @@ class Timer:
         Returns:
             TimerStop: The stop data
         """
-        t = time.time()
+        t = time.perf_counter()
         elapsed_total = t - self.start
         since_last = t - self.stops[-1].at if self.stops else 0
         if not self.ms:
@@ -78,7 +78,7 @@ class Timer:
 
     def reset(self) -> None:
         """Reset the timer."""
-        self.start = time.time()
+        self.start = time.perf_counter()
         self.stops: list[TimerStop] = [
             TimerStop(
                 total=timedelta(seconds=0),
@@ -114,17 +114,18 @@ def datetime_fmt(
     Returns:
         str: Formated date and time.
 
-    Examples:
-    --------
-    >>> fmt_datetime()
-    '2022-11-22 22:40:04' # current date and time
-    >>> fmt_datetime(0)
-    "1970-01-01 00:00:00"
-    >>> fmt_datetime(0, fmt="dmY", dsep="/")
-    "01/01/1970 00:00:00"
+    Example:
+        ```python
+        >>> fmt_datetime()
+        '2022-11-22 22:40:04' # current date and time
+        >>> fmt_datetime(0)
+        "1970-01-01 00:00:00"
+        >>> fmt_datetime(0, fmt="dmY", dsep="/")
+        "01/01/1970 00:00:00"
+        ```
     """
     if d is None:
-        d = datetime.fromtimestamp(time.time(), **{"tz": timezone.utc} if utc else {})
+        d = datetime.fromtimestamp(time.perf_counter(), **{"tz": timezone.utc} if utc else {})
 
     elif isinstance(d, str):
         d = parse_datetime_str(d)
@@ -161,7 +162,7 @@ def time_fmt(
         str: Formated time.
     """
     if t is None:
-        tm = datetime.fromtimestamp(time.time(), **{"tz": timezone.utc} if utc else {})
+        tm = datetime.fromtimestamp(time.perf_counter(), **{"tz": timezone.utc} if utc else {})
     elif isinstance(t, datetime):
         tm = t.time()
     elif isinstance(t, (int, float)):
@@ -194,19 +195,20 @@ def date_fmt(
     Returns:
         str: Formated date.
 
-    Examples
-    --------
-    >>> fmt_date(date(2022,11,22))
-    '2022-11-22'
-    >>> fmt_date(date(2022,11,22), sep="/")
-    '2022/11/22'
-    >>> fmt_date(date(2022,11,22), sep="/", fmt="dmY")
-    '22/11/2022'
-    >>> fmt_date()
-    '2022-11-22'
+    Example:
+        ```python
+        >>> fmt_date(date(2022,11,22))
+        '2022-11-22'
+        >>> fmt_date(date(2022,11,22), sep="/")
+        '2022/11/22'
+        >>> fmt_date(date(2022,11,22), sep="/", fmt="dmY")
+        '22/11/2022'
+        >>> fmt_date()
+        '2022-11-22'
+        ```
     """
     if d is None:
-        d = date.fromtimestamp(time.time())
+        d = date.fromtimestamp(time.perf_counter())
     elif isinstance(d, (float, int)):
         d = date.fromtimestamp(d)
     elif isinstance(d, datetime):
@@ -222,12 +224,13 @@ def date_range(start: date, end: date) -> T.Generator[date, None, None]:
     """
     Returns a generator for dates between ``start`` and ``end``
 
-    Examples
-    --------
-    >>> for i in date_range(date(2022,11,19), date(2022,11,22)): print(i)
-    2022-11-19
-    2022-11-20
-    2022-11-21
+    Example:
+        ```python
+        >>> for i in date_range(date(2022,11,19), date(2022,11,22)): print(i)
+        2022-11-19
+        2022-11-20
+        2022-11-21
+        ```
     """
     for n in range(int((end - start).days)):
         yield start + timedelta(n)

{stdl-0.5.2 → stdl-0.5.3}/stdl/fs.py

@@ -873,6 +873,29 @@ def ensure_paths_exist(*args: str | PathLike | Iterable[str | PathLike]) -> None
                 check_path(i)
 
 
+def ensure_paths_dont_exist(*args: str | PathLike | Iterable[str | PathLike]) -> None:
+    """
+    Ensures that the specified paths don't exist.
+
+    Args:
+        *args : one or more strings representing the paths to check. Can also include an Iterable of paths.
+
+    Raises:
+        FileNotFoundError : if one of the provided paths exists.
+    """
+
+    def check_path(path: str | PathLike):
+        if os.path.exists(os.fspath(path)):
+            raise FileExistsError(f"Path already exists: {path}")
+
+    for path in args:
+        if isinstance(path, (str, bytes, PathLike)):
+            check_path(path)
+        elif isinstance(path, Iterable):
+            for i in path:
+                check_path(i)
+
+
 class CompletedCommand(subprocess.CompletedProcess):
     def __init__(
         self,

{stdl-0.5.2 → stdl-0.5.3}/stdl/log.py

@@ -22,13 +22,13 @@ class LoguruFormatter:
 
     def format(self, record: dict) -> str:
         """
-        Example usage:
-        ```python
-        >>> import sys
-        >>> from loguru import logger
-        >>> logger.remove()
-        >>> logger.add(sys.stdout, level="DEBUG", format=loguru_formater)
-        ```
+        Example:
+            ```python
+            >>> import sys
+            >>> from loguru import logger
+            >>> logger.remove()
+            >>> logger.add(sys.stdout, level="DEBUG", format=loguru_formater)
+            ```
         """
         extras = ""
         if len(record["extra"]):

{stdl-0.5.2 → stdl-0.5.3}/stdl/st.py

@@ -203,8 +203,10 @@ def terminal_link(
     Returns a hyperlink that can be used in terminals.
 
     NOTE:
-        Hyperlinks are not supported in all terminals. For more information visit
-        <https://github.com/Alhadis/OSC8-Adoption/> and
+        Hyperlinks are not supported in all terminals.
+        For more information visit
+        <https://github.com/Alhadis/OSC8-Adoption/>
+        and
         <https://gist.github.com/egmontkob/eb114294efbcd5adb1944c9f3cb5feda>
 
     Args:
@@ -234,7 +236,7 @@ def remove(s: str, chars: str | set, replace_with: str = "") -> str:
 
     Args:
         s (str): Input string.
-        chrs (str | set): Characters to remove
+        chars (str | set): Characters to remove
         replace_with (str, optional): If provided, replace the characters with this value.
 
     """
@@ -255,7 +257,7 @@ def keep(s: str, chars: str | set, replace_with: str = "") -> str:
 
     Args:
         s (str): Input string
-        chrs (str | set): Characters to keep
+        chars (str | set): Characters to keep
         replace_with (str, optional): If provided, replace other characters with this value.
 
     """

{stdl-0.5.2 → stdl-0.5.3/stdl.egg-info}/PKG-INFO

@@ -1,9 +1,10 @@
 Metadata-Version: 2.1
 Name: stdl
-Version: 0.5.2
+Version: 0.5.3
 Summary: Extended Python Standard Library
 Author-email: Žiga Ivanšek <ziga.ivansek@gmail.com>
 Project-URL: Repository, https://github.com/zigai/stdl
+Project-URL: Documentation, https://stdl.readthedocs.io
 Keywords: python utilites,filesystem,string manipulation,logging configuration,list utils,standard library,ANSI colors,terminal output
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License