stdl 0.5.0__tar.gz → 0.5.2__tar.gz

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

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: stdl
-Version: 0.5.0
+Version: 0.5.2
 Summary: Extended Python Standard Library
 Author-email: Žiga Ivanšek <ziga.ivansek@gmail.com>
 Project-URL: Repository, https://github.com/zigai/stdl
-Keywords: python utilites,filesystem,string manipulation,logging configuration,list utils,standard library
+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
 Classifier: Operating System :: OS Independent
@@ -19,23 +19,46 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: PyYAML>=6.0
 Requires-Dist: tqdm
-Requires-Dist: python-dateutil==2.8.2
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: toml>=0.10.2
 Provides-Extra: test
 Requires-Dist: pytest; extra == "test"
 Provides-Extra: dev
 Requires-Dist: black; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
+Requires-Dist: mkdocs; extra == "dev"
+Requires-Dist: mkdocs-material; extra == "dev"
+Requires-Dist: mkdocs-autorefs; extra == "dev"
+Requires-Dist: mkdocstrings[python]; extra == "dev"
 
 # stdl
 [![Tests](https://github.com/zigai/stdl/actions/workflows/tests.yml/badge.svg)](https://github.com/zigai/stdl/actions/workflows/tests.yml)
+[![Documentation Status](https://readthedocs.org/projects/stdl/badge/?version=latest)](https://stdl.readthedocs.io/en/latest/?badge=latest)
 [![PyPI version](https://badge.fury.io/py/stdl.svg)](https://badge.fury.io/py/stdl)
 ![Supported versions](https://img.shields.io/badge/python-3.10+-blue.svg)
 [![Downloads](https://static.pepy.tech/badge/stdl)](https://pepy.tech/project/stdl)
 [![license](https://img.shields.io/github/license/zigai/stdl.svg)](https://github.com/zigai/stdl/blob/master/LICENSE)
 
-Extended Python standard library.
-# Installation
+`stdl` is a collection of Python utilities that complement the standard library. It provides common functions and tools that developers frequently need, with minimal external dependencies.
+
+## Features
+- File and directory operations
+- String manipulation
+- ANSI color support for terminal output
+- Date and time formatting
+- List processing
+- Function decorators
+- Logging configuration for `logging` and `loguru`
+- [See docs](https://stdl.readthedocs.io/en/latest/?badge=latest)
+
+## Dependencies
+- PyYAML
+- python-dateutil
+- toml
+- tqdm
+
+## Installation
 
 #### Using pip
 ```
@@ -45,5 +68,5 @@ pip install stdl
 ```
 pip install git+https://github.com/zigai/stdl
 ```
-# License
+## License
 [MIT License](https://github.com/zigai/stdl/blob/master/LICENSE)

stdl-0.5.2/README.md

@@ -0,0 +1,38 @@
+# stdl
+[![Tests](https://github.com/zigai/stdl/actions/workflows/tests.yml/badge.svg)](https://github.com/zigai/stdl/actions/workflows/tests.yml)
+[![Documentation Status](https://readthedocs.org/projects/stdl/badge/?version=latest)](https://stdl.readthedocs.io/en/latest/?badge=latest)
+[![PyPI version](https://badge.fury.io/py/stdl.svg)](https://badge.fury.io/py/stdl)
+![Supported versions](https://img.shields.io/badge/python-3.10+-blue.svg)
+[![Downloads](https://static.pepy.tech/badge/stdl)](https://pepy.tech/project/stdl)
+[![license](https://img.shields.io/github/license/zigai/stdl.svg)](https://github.com/zigai/stdl/blob/master/LICENSE)
+
+`stdl` is a collection of Python utilities that complement the standard library. It provides common functions and tools that developers frequently need, with minimal external dependencies.
+
+## Features
+- File and directory operations
+- String manipulation
+- ANSI color support for terminal output
+- Date and time formatting
+- List processing
+- Function decorators
+- Logging configuration for `logging` and `loguru`
+- [See docs](https://stdl.readthedocs.io/en/latest/?badge=latest)
+
+## Dependencies
+- PyYAML
+- python-dateutil
+- toml
+- tqdm
+
+## Installation
+
+#### Using pip
+```
+pip install stdl
+```
+#### From source
+```
+pip install git+https://github.com/zigai/stdl
+```
+## License
+[MIT License](https://github.com/zigai/stdl/blob/master/LICENSE)

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

@@ -1,12 +1,18 @@
 [project]
 name = "stdl"
-version = "0.5.0"
+version = "0.5.2"
 description = "Extended Python Standard Library"
 authors = [{ name = "Žiga Ivanšek", email = "ziga.ivansek@gmail.com" }]
 license = { file = "LICENSE.txt" }
 readme = "README.md"
 requires-python = ">=3.10"
-dependencies = ["PyYAML>=6.0", "tqdm", "python-dateutil==2.8.2"]
+
+dependencies = [
+    "PyYAML>=6.0",
+    "tqdm",
+    "python-dateutil>=2.8.2",
+    "toml>=0.10.2 ",
+]
 
 classifiers = [
     "Intended Audience :: Developers",
@@ -27,12 +33,22 @@ keywords = [
     "logging configuration",
     "list utils",
     "standard library",
+    "ANSI colors",
+    "terminal output",
 ]
 
 
 [project.optional-dependencies]
 test = ["pytest"]
-dev = ["black", "pytest", "ruff"]
+dev = [
+    "black",
+    "pytest",
+    "ruff",
+    "mkdocs",
+    "mkdocs-material",
+    "mkdocs-autorefs",
+    "mkdocstrings[python]",
+]
 
 [project.urls]
 Repository = "https://github.com/zigai/stdl"

stdl-0.5.2/stdl/__init__.py

@@ -0,0 +1 @@
+from stdl import dt, fs, log, lst, net, st

{stdl-0.5.0 → stdl-0.5.2}/stdl/decorators.py

@@ -2,13 +2,13 @@ import inspect
 import json
 import sys
 import time
+import typing as T
 from functools import wraps
-from typing import Callable
 
 
 def timer(
     r: int | None = 2,
-    sink: Callable = sys.stdout.write,
+    sink: T.Callable = sys.stdout.write,
     show_args: bool = False,
     serialize: bool = False,
     sep=" | ",
@@ -24,7 +24,7 @@ def timer(
         sep (str, optional): Separator between the function/method name and the arguments. Defaults to " | ".
     """
 
-    def decorator(func: Callable):
+    def decorator(func: T.Callable):
         @wraps(func)
         def wrapper(*args, **kwargs):
             time_start = time.perf_counter()
@@ -84,3 +84,6 @@ def retry(attempts: int, delay: float = 0):
         return wrapper
 
     return decorator
+
+
+__all__ = ["timer", "retry"]

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

@@ -1,8 +1,8 @@
 import random
 import time
+import typing as T
 from dataclasses import dataclass
 from datetime import date, datetime, timedelta, timezone
-from typing import Generator
 
 from dateutil.parser import parse as parse_datetime_str
 
@@ -40,7 +40,7 @@ class Timer:
         Stop the timer.
 
         Args:
-            label (str | None, optional): Label for the stop. Defaults to None.
+            label (str | None, optional): Label for the stop.
 
         Returns:
             TimerStop: The stop data
@@ -88,10 +88,6 @@ class Timer:
             )
         ]
 
-    def print_stops(self) -> None:
-        for stop in self.stops:
-            print(stop)
-
 
 def datetime_fmt(
     d: str | float | int | None | datetime = None,
@@ -105,12 +101,12 @@ def datetime_fmt(
     """Format date and time
 
     Args:
-        d (str | float | None | datetime, optional): Input datetime. Defaults to None.
-        fmt (str, optional): Date format. Defaults to "Ymd".
-        dsep (str, optional): Date values separator. Defaults to "-".
-        tsep (str, optional): Time values separator. Defaults to ":".
-        ms (bool, optional): include miliseconds. Defaults to False.
-        utc (bool, optional):  Use the UTC timezone when building a datetime object from a timestamp. Defaults to True.
+        d (str | float | None | datetime, optional): Input datetime. Defaults to current date and time.
+        fmt (str, optional): Date format.
+        dsep (str, optional): Date values separator.
+        tsep (str, optional): Time values separator.
+        ms (bool, optional): include miliseconds.
+        utc (bool, optional):  Use the UTC timezone when building a datetime object from a timestamp.
 
     Raises:
         TypeError: Raises TypeError if the type of ``d`` is not one of the following: float, str, None, datetime, int
@@ -153,10 +149,10 @@ def time_fmt(
     Format time
 
     Args:
-        t (float | datetime | int | None, optional): Input time. Defaults to current time if it's not provided.
-        sep (str, optional): Character(s) that separates hours, minutes, seconds... Defaults to ":".
-        ms (bool, optional): include miliseconds. Defaults to False.
-        utc (bool, optional): Use the UTC timezone when building a time object from a timestamp. Defaults to True.
+        t (float | datetime | int | None, optional): Input time. Defaults to current time.
+        sep (str, optional): Character(s) that separates hours, minutes, seconds...
+        ms (bool, optional): include miliseconds.
+        utc (bool, optional): Use the UTC timezone when building a time object from a timestamp.
 
     Raises:
         TypeError: Raises TypeError if the type of ``t`` is not one of the following: float, None, datetime, int
@@ -188,9 +184,9 @@ def date_fmt(
     Format date
 
     Args:
-        d (float | date | datetime | int | None ): Input date. Defaults to current date if it's not provided.
-        fmt (str, optional): Date format. Defaults to "Ymd".
-        sep (str, optional): Character(s) that separates days, months and years. Defaults to "-".
+        d (float | date | datetime | int | None ): Input date. Defaults to current date.
+        fmt (str, optional): Date format.
+        sep (str, optional): Character(s) that separates days, months and years.
 
     Raises:
         TypeError: Raises TypeError if the type of ``d`` is not one of the following: float, None, date, datetime, int
@@ -222,7 +218,7 @@ def date_fmt(
     return d.strftime(f"%{fmt[0]}{sep}%{fmt[1]}{sep}%{fmt[2]}")
 
 
-def date_range(start: date, end: date) -> Generator[date, None, None]:
+def date_range(start: date, end: date) -> T.Generator[date, None, None]:
     """
     Returns a generator for dates between ``start`` and ``end``