stdl 0.7.0__tar.gz → 0.8.0__tar.gz

stdl-0.8.0/PKG-INFO

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: stdl
+Version: 0.8.0
+Summary: Extended Python Standard Library
+Keywords: stdl,standard-library,python-utilities,filesystem,list-utils,ansi-colors,color-formats,terminal-links,lazy-import,text-processing
+Author: Žiga Ivanšek
+Author-email: Žiga Ivanšek <ziga.ivansek@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Typing :: Typed
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Classifier: Topic :: System :: Filesystems
+Classifier: Topic :: Text Processing :: General
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Requires-Dist: python-dateutil>=2.8.2
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: toml>=0.10.2
+Requires-Dist: anyio>=4.0.0 ; extra == 'async'
+Requires-Dist: anyio>=4.0.0 ; extra == 'dev'
+Requires-Dist: pytest>=9.0.3 ; extra == 'dev'
+Requires-Dist: coverage>=7.14.1 ; extra == 'dev'
+Requires-Dist: ruff==0.16.10 ; extra == 'dev'
+Requires-Dist: pre-commit>=4.6.0 ; extra == 'dev'
+Requires-Dist: pyrefly>=1.0.0 ; extra == 'dev'
+Requires-Dist: codespell>=2.4.2 ; extra == 'dev'
+Requires-Dist: pydantic>=2 ; extra == 'dev'
+Requires-Dist: rattle-lint>=3.0.0 ; extra == 'dev'
+Requires-Dist: tqdm>=4.67.1 ; extra == 'full'
+Requires-Dist: anyio>=4.0.0 ; extra == 'test'
+Requires-Dist: pytest>=9.0.3 ; extra == 'test'
+Requires-Dist: coverage>=7.14.1 ; extra == 'test'
+Requires-Dist: pydantic>=2 ; extra == 'test'
+Requires-Python: >=3.11
+Project-URL: Repository, https://github.com/zigai/stdl
+Project-URL: Issues, https://github.com/zigai/stdl/issues
+Project-URL: Homepage, https://github.com/zigai/stdl
+Provides-Extra: async
+Provides-Extra: dev
+Provides-Extra: full
+Provides-Extra: test
+Description-Content-Type: text/markdown
+
+# stdl
+
+[![Tests](https://github.com/zigai/stdl/actions/workflows/test.yml/badge.svg)](https://github.com/zigai/stdl/actions/workflows/test.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.11+-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.
+
+## Features
+
+- File and directory operations
+- String manipulation
+- ANSI color support for terminal output
+- Date and time formatting
+- List utils
+- Lazy imports
+- Logging configuration for `logging` and `loguru`
+- [See docs](https://stdl.readthedocs.io/en/latest/?badge=latest)
+
+## Installation
+
+### Using pip
+
+```sh
+pip install stdl
+pip install 'stdl[async]'
+```
+
+### Using uv
+
+```sh
+uv add stdl
+uv add 'stdl[async]'
+```
+
+### From source
+
+```sh
+pip install git+https://github.com/zigai/stdl.git
+# or
+uv add git+https://github.com/zigai/stdl.git
+```
+
+## License
+
+[MIT License](https://github.com/zigai/stdl/blob/master/LICENSE)

{stdl-0.7.0 → stdl-0.8.0}/README.md

@@ -3,7 +3,7 @@
 [![Tests](https://github.com/zigai/stdl/actions/workflows/test.yml/badge.svg)](https://github.com/zigai/stdl/actions/workflows/test.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)
+![Supported versions](https://img.shields.io/badge/python-3.11+-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)
 
@@ -26,12 +26,14 @@
 
 ```sh
 pip install stdl
+pip install 'stdl[async]'
 ```
 
 ### Using uv
 
 ```sh
 uv add stdl
+uv add 'stdl[async]'
 ```
 
 ### From source
@@ -42,35 +44,6 @@ pip install git+https://github.com/zigai/stdl.git
 uv add git+https://github.com/zigai/stdl.git
 ```
 
-## Examples
-
-### Lazy imports
-
-```python
-from typing import TYPE_CHECKING
-from stdl.import_lazy import import_lazy
-
-if TYPE_CHECKING:
-    from os.path import abspath, join
-    import numpy as np
-    import torch
-else:
-    import_lazy("os.path", ["join", "abspath"], verbose=True)
-    import_lazy("numpy", alias="np", verbose=True)
-    import_lazy("torch", verbose=True)
-
-print(np.zeros(4))
-# importing "numpy" took 0.060s
-# [0. 0. 0. 0.]
-print(torch)
-# <LazyImport: torch>
-print(torch.randn(8))
-# importing "torch" took 1.118s
-# tensor([0., 0., 0., 0., 0., 0., 0., 0.])
-print(torch)
-# <module 'torch' from .../torch/__init__.py'
-```
-
 ## License
 
 [MIT License](https://github.com/zigai/stdl/blob/master/LICENSE)

stdl-0.8.0/pyproject.toml

@@ -0,0 +1,300 @@
+[project]
+name = "stdl"
+version = "0.8.0"
+description = "Extended Python Standard Library"
+license = "MIT"
+license-files = ["LICENSE"]
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "python-dateutil>=2.8.2",
+    "pyyaml>=6.0.2",
+    "toml>=0.10.2",
+]
+classifiers = [
+    "Typing :: Typed",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+    "Topic :: System :: Filesystems",
+    "Topic :: Text Processing :: General",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
+]
+keywords = [
+    "stdl",
+    "standard-library",
+    "python-utilities",
+    "filesystem",
+    "list-utils",
+    "ansi-colors",
+    "color-formats",
+    "terminal-links",
+    "lazy-import",
+    "text-processing",
+]
+
+[[project.authors]]
+name = "Žiga Ivanšek"
+email = "ziga.ivansek@gmail.com"
+
+[project.optional-dependencies]
+async = ["anyio>=4.0.0"]
+full = ["tqdm>=4.67.1"]
+dev = [
+    "anyio>=4.0.0",
+    "pytest>=9.0.3",
+    "coverage>=7.14.1",
+    "ruff==0.16.10",
+    "pre-commit>=4.6.0",
+    "pyrefly>=1.0.0",
+    "codespell>=2.4.2",
+    "pydantic>=2",
+    "rattle-lint>=3.0.0",
+]
+test = [
+    "anyio>=4.0.0",
+    "pytest>=9.0.3",
+    "coverage>=7.14.1",
+    "pydantic>=2",
+]
+
+[project.urls]
+Repository = "https://github.com/zigai/stdl"
+Issues = "https://github.com/zigai/stdl/issues"
+Homepage = "https://github.com/zigai/stdl"
+
+[build-system]
+requires = ["uv_build>=0.11.25,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.codespell]
+skip = ".git,uv.lock"
+
+[tool.coverage.run]
+source = ["stdl"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "if typing.TYPE_CHECKING:",
+]
+omit = [
+    "tests/*",
+    "tests/**",
+]
+
+[tool.pyrefly]
+project-includes = ["stdl"]
+project-excludes = ["tests/**"]
+disable-project-excludes-heuristics = true
+search-path = ["."]
+disable-search-path-heuristics = true
+python-version = "3.11"
+enabled-ignores = [
+    "type",
+    "pyrefly",
+]
+use-ignore-files = false
+check-unannotated-defs = true
+infer-return-types = "checked"
+infer-with-first-use = true
+strict-callable-subtyping = false
+spec-compliant-overloads = false
+
+[tool.rattle]
+root = true
+enable = [
+    "blank-line-after-control-block",
+    "blank-line-after-terminal-control-block",
+    "blank-line-before-branch",
+    "blank-line-before-unrelated-block",
+    "no-suite-leading-trailing-blank-lines",
+    "module-all-at-bottom",
+    "no-underscore-all-exports",
+    "forbidden-call",
+    "no-relative-imports",
+    "no-underscore-import-aliases",
+    "no-unsafe-tempfile-factories",
+    "no-annotated-self",
+    "no-exception-message-variables",
+    "no-str-exception-translation",
+    "no-underscore-class",
+    "public-method-order",
+    "no-bare-object-annotations",
+    "no-named-tuple",
+    "no-static-if-condition",
+    "sorted-attributes",
+    "use-callable-ellipsis",
+]
+
+[tool.rattle.options.forbidden-call]
+forbidden_calls = ["typing.cast"]
+
+[tool.ruff]
+line-length = 100
+
+[tool.ruff.lint]
+select = ["ALL"]
+ignore = [
+    "ERA",
+    "FBT002",
+    "COM",
+    "CPY",
+    "DJ",
+    "ANN003",
+    "FIX",
+    "D100",
+    "D101",
+    "D102",
+    "D103",
+    "D104",
+    "D105",
+    "D106",
+    "D107",
+    "D205",
+    "D203",
+    "D212",
+    "E501",
+    "PIE804",
+    "S101",
+    "EM101",
+    "PYI041",
+    "PYI051",
+    "PYI046",
+    "PYI047",
+    "PYI049",
+    "PYI053",
+    "PYI054",
+    "RET501",
+    "SIM910",
+    "N812",
+    "PLC0415",
+    "PLR0904",
+    "PLR0913",
+    "PLR0917",
+    "PLR2004",
+    "PLR1711",
+    "TRY003",
+    "T20",
+    "SIM105",
+    "RET504",
+    "PLR0912",
+    "PLR0915",
+    "SIM105",
+    "TD",
+    "TC001",
+    "TC002",
+    "TC003",
+    "TC006",
+    "PLW0603",
+    "EM102",
+    "PLW2901",
+    "RSE102",
+    "PGH004",
+    "N806",
+    "FBT001",
+    "PTH",
+    "S310",
+]
+exclude = ["build"]
+
+[tool.ruff.lint.per-file-ignores]
+"__init__.py" = [
+    "F401",
+    "E402",
+]
+"**/tests/**/*.py" = [
+    "S104",
+    "S105",
+    "S106",
+    "TRY004",
+    "RUF003",
+    "RUF012",
+    "UP031",
+    "SLF001",
+    "ARG",
+    "N806",
+    "ANN001",
+    "ANN201",
+    "ANN202",
+    "ANN204",
+    "ANN401",
+    "S",
+    "SLF001",
+    "INP001",
+    "PLW0108",
+    "EM102",
+    "FBT001",
+    "SIM300",
+    "DTZ001",
+]
+"examples/*.py" = ["INP001"]
+
+[tool.ruff.lint.pep8-naming]
+classmethod-decorators = [
+    "pydantic.validator",
+    "declared_attr",
+    "expression",
+    "comparator",
+]
+
+[tool.ruff.lint.flake8-builtins]
+ignorelist = [
+    "id",
+    "input",
+]
+
+[tool.ruff.lint.flake8-type-checking]
+runtime-evaluated-base-classes = [
+    "pydantic.BaseModel",
+    "sqlalchemy.orm.DeclarativeBase",
+]
+
+[tool.ruff.lint.isort]
+known-first-party = [
+    "stdl",
+    "tests",
+]
+
+[tool.ruff.lint.pydocstyle]
+convention = "google"
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+skip-magic-trailing-comma = false
+line-ending = "lf"
+
+[tool.uv]
+default-groups = ["test"]
+
+[tool.uv.build-backend]
+module-name = "stdl"
+module-root = ""
+
+[dependency-groups]
+test = [
+    "anyio>=4.0.0",
+    "pytest>=9.0.3",
+    "coverage>=7.14.1",
+    "pydantic>=2",
+]
+dev = [
+    { include-group = "test" },
+    "ruff==0.16.10",
+    "pre-commit>=4.6.0",
+    "pyrefly>=1.0.0",
+    "codespell>=2.4.2",
+    "rattle-lint>=3.0.0",
+]

stdl-0.7.0/pyproject.toml → stdl-0.8.0/pyproject.toml.orig

@@ -1,20 +1,19 @@
 [project]
 name = "stdl"
-version = "0.7.0"
+version = "0.8.0"
 description = "Extended Python Standard Library"
 authors = [{ name = "Žiga Ivanšek", email = "ziga.ivansek@gmail.com" }]
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 readme = "README.md"
-requires-python = ">=3.10"
+requires-python = ">=3.11"
 dependencies = [
     "python-dateutil>=2.8.2",
     "pyyaml>=6.0.2",
     "toml>=0.10.2",
-    "typing_extensions>=4.0; python_version < '3.11'",
 ]
 
 classifiers = [
-    "License :: OSI Approved :: MIT License",
     "Typing :: Typed",
     "Operating System :: OS Independent",
     "Intended Audience :: Developers",
@@ -25,11 +24,11 @@ classifiers = [
     "Programming Language :: Python",
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3 :: Only",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3.15",
 ]
 
 keywords = [
@@ -46,44 +45,37 @@ keywords = [
 ]
 
 [project.optional-dependencies]
+async = ["anyio>=4.0.0"]
 full = ["tqdm>=4.67.1"]
 dev = [
-    "pytest",
-    "coverage",
-    "ruff",
-    "pre-commit",
-    "mypy",
-    "codespell",
+    "anyio>=4.0.0",
+    "pytest>=9.0.3",
+    "coverage>=7.14.1",
+    "ruff==0.16.10",
+    "pre-commit>=4.6.0",
+    "pyrefly>=1.0.0",
+    "codespell>=2.4.2",
     "pydantic>=2",
+    "rattle-lint>=3.0.0",
 ]
 
-test = ["pytest", "coverage", "pydantic>=2"]
+test = ["anyio>=4.0.0", "pytest>=9.0.3", "coverage>=7.14.1", "pydantic>=2"]
 [project.urls]
 Repository = "https://github.com/zigai/stdl"
 Issues = "https://github.com/zigai/stdl/issues"
 Homepage = "https://github.com/zigai/stdl"
 
 [build-system]
-requires = ["hatchling"]
-build-backend = "hatchling.build"
+requires = ["uv_build>=0.11.25,<0.12.0"]
+build-backend = "uv_build"
 
-[tool.hatch.build.targets.wheel]
-packages = ["stdl"]
+[tool.uv.build-backend]
+module-name = "stdl"
+module-root = ""
 
 [tool.codespell]
 skip = '.git,uv.lock'
 
-[tool.hatch.envs.test]
-features = ["test"]
-installer = "uv"
-
-[[tool.hatch.envs.test.matrix]]
-python = ["3.10", "3.11", "3.12", "3.13", "3.14"]
-
-[tool.hatch.envs.test.scripts]
-test = "pytest {args}"
-cov = "coverage run -m pytest {args}"
-
 [tool.coverage.run]
 source = ["stdl"]
 branch = true
@@ -97,21 +89,49 @@ exclude_lines = [
 ]
 omit = ["tests/*", "tests/**"]
 
-[tool.mypy]
-python_version = "3.10"
-files = ["stdl"]
-exclude = ["^tests/"]
-
-disallow_untyped_defs = true
-disallow_untyped_calls = true
-disallow_any_generics = true
-no_implicit_optional = true
-warn_unused_ignores = true
-warn_redundant_casts = true
-warn_return_any = true
-warn_unused_configs = true
-strict_equality = true
-ignore_missing_imports = true
+[tool.pyrefly]
+project-includes = ["stdl"]
+project-excludes = ["tests/**"]
+disable-project-excludes-heuristics = true
+search-path = ["."]
+disable-search-path-heuristics = true
+python-version = "3.11"
+enabled-ignores = ["type", "pyrefly"]
+use-ignore-files = false
+check-unannotated-defs = true
+infer-return-types = "checked"
+infer-with-first-use = true
+strict-callable-subtyping = false
+spec-compliant-overloads = false
+
+[tool.rattle]
+root = true
+enable = [
+    "blank-line-after-control-block",
+    "blank-line-after-terminal-control-block",
+    "blank-line-before-branch",
+    "blank-line-before-unrelated-block",
+    "no-suite-leading-trailing-blank-lines",
+    "module-all-at-bottom",
+    "no-underscore-all-exports",
+    "forbidden-call",
+    "no-relative-imports",
+    "no-underscore-import-aliases",
+    "no-unsafe-tempfile-factories",
+    "no-annotated-self",
+    "no-exception-message-variables",
+    "no-str-exception-translation",
+    "no-underscore-class",
+    "public-method-order",
+    "no-bare-object-annotations",
+    "no-named-tuple",
+    "no-static-if-condition",
+    "sorted-attributes",
+    "use-callable-ellipsis",
+]
+
+[tool.rattle.options."forbidden-call"]
+forbidden_calls = ["typing.cast"]
 
 [tool.ruff]
 line-length = 100
@@ -154,6 +174,7 @@ ignore = [
     "PLC0415",
     "PLR0904",
     "PLR0913",
+    "PLR0917",
     "PLR2004",
     "PLR1711",
     "TRY003",
@@ -240,3 +261,10 @@ known-first-party = ["stdl", "tests"]
 
 [tool.ruff.lint.pydocstyle]
 convention = "google"
+
+[tool.uv]
+default-groups = ["test"]
+
+[dependency-groups]
+test = ["anyio>=4.0.0", "pytest>=9.0.3", "coverage>=7.14.1", "pydantic>=2"]
+dev = [{include-group = "test"}, "ruff==0.16.10", "pre-commit>=4.6.0", "pyrefly>=1.0.0", "codespell>=2.4.2", "rattle-lint>=3.0.0"]

stdl-0.8.0/stdl/__init__.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+from types import ModuleType
+from typing import TYPE_CHECKING, TypeAlias
+
+if TYPE_CHECKING:
+    from stdl.fs import AsyncFileHandle, Directory, File
+
+LazyExport: TypeAlias = "ModuleType | type[AsyncFileHandle[str] | Directory | File]"
+
+
+def __getattr__(name: str) -> LazyExport:
+    """Lazily resolve public package exports."""
+    if name in {"AsyncFileHandle", "Directory", "File"}:
+        from stdl import fs
+
+        return getattr(fs, name)
+    if name in {"color", "decorators", "dt", "fs", "import_lazy", "log", "lst", "net", "st"}:
+        import importlib
+
+        return importlib.import_module(f"stdl.{name}")
+
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+__all__ = [
+    "AsyncFileHandle",
+    "Directory",
+    "File",
+    "color",
+    "decorators",
+    "dt",
+    "fs",
+    "import_lazy",
+    "log",
+    "lst",
+    "net",
+    "st",
+]

stdl-0.8.0/stdl/__init__.pyi

@@ -0,0 +1,27 @@
+from stdl import color as color
+from stdl import decorators as decorators
+from stdl import dt as dt
+from stdl import fs as fs
+from stdl import import_lazy as import_lazy
+from stdl import log as log
+from stdl import lst as lst
+from stdl import net as net
+from stdl import st as st
+from stdl.fs import AsyncFileHandle as AsyncFileHandle
+from stdl.fs import Directory as Directory
+from stdl.fs import File as File
+
+__all__ = [
+    "AsyncFileHandle",
+    "Directory",
+    "File",
+    "color",
+    "decorators",
+    "dt",
+    "fs",
+    "import_lazy",
+    "log",
+    "lst",
+    "net",
+    "st",
+]