pythonwrench 0.5.1__tar.gz → 0.6.0__tar.gz

{pythonwrench-0.5.1/src/pythonwrench.egg-info → pythonwrench-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pythonwrench
-Version: 0.5.1
+Version: 0.6.0
 Summary: Python library with tools for typing, manipulating collections, and more!
 Author-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
 Maintainer-email: "Étienne Labbé (Labbeti)" <labbeti.pub@gmail.com>
@@ -50,11 +50,23 @@ Classifier: Operating System :: POSIX
 Requires-Python: <3.15,>=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: lazy-loader>=0.4
 Requires-Dist: typing-extensions>=4.10.0
 Provides-Extra: dev
+Requires-Dist: pandas>=2.0.3; extra == "dev"
+Requires-Dist: coverage[toml]>=7.6.1; extra == "dev"
+Requires-Dist: ruff>=0.12.0; extra == "dev"
+Requires-Dist: sphinx<9.0.0; extra == "dev"
+Requires-Dist: sphinx-immaterial>=0.11.14; extra == "dev"
+Requires-Dist: flake8>=5.0.4; extra == "dev"
+Requires-Dist: ipykernel>=6.29.5; extra == "dev"
+Requires-Dist: ipython>=8.12.3; extra == "dev"
+Requires-Dist: pre-commit>=3.5.0; extra == "dev"
+Requires-Dist: pytest>=8.3.5; extra == "dev"
+Requires-Dist: setuptools>=75.3.2; extra == "dev"
+Requires-Dist: twine>=6.1.0; extra == "dev"
 Provides-Extra: lazy
-Requires-Dist: lazy-loader>=0.4; extra == "lazy"
+Requires-Dist: lazy-loader<0.5,>=0.4; extra == "lazy"
+Dynamic: license-file
 
 # pythonwrench
 
@@ -219,6 +231,9 @@ Easely converts common python structures like list of dicts to dict of lists :
 ... True
 ```
 
+## Lazy loading
+To speed up this package loading, you can install it with `uv add pythonwrench[lazy]`, so `import pythonwrench as pw` will be faster.
+
 ## Contact
 Maintainer:
 - [Étienne Labbé](https://labbeti.github.io/) "Labbeti": labbeti.pub@gmail.com

{pythonwrench-0.5.1 → pythonwrench-0.6.0}/README.md

@@ -161,6 +161,9 @@ Easely converts common python structures like list of dicts to dict of lists :
 ... True
 ```
 
+## Lazy loading
+To speed up this package loading, you can install it with `uv add pythonwrench[lazy]`, so `import pythonwrench as pw` will be faster.
+
 ## Contact
 Maintainer:
 - [Étienne Labbé](https://labbeti.github.io/) "Labbeti": labbeti.pub@gmail.com

{pythonwrench-0.5.1 → pythonwrench-0.6.0}/pyproject.toml

@@ -31,7 +31,6 @@ maintainers = [
 ]
 dynamic = ["version"]
 dependencies = [
-    "lazy-loader>=0.4",
     "typing-extensions>=4.10.0",
 ]
 
@@ -43,17 +42,30 @@ Changelog = "https://github.com/Labbeti/pythonwrench/blob/main/CHANGELOG.md"
 Tracker = "https://github.com/Labbeti/pythonwrench/issues"
 
 [project.scripts]
-pythonwrench-info = "pythonwrench.entries:print_install_info"
-pythonwrench-tree = "pythonwrench.entries:main_tree"
-pythonwrench-safe-rmdir = "pythonwrench.entries:main_safe_rmdir"
-pyw-info = "pythonwrench.entries:print_install_info"
-pyw-tree = "pythonwrench.entries:main_tree"
-pyw-safe-rmdir = "pythonwrench.entries:main_safe_rmdir"
+pythonwrench-info = "pythonwrench.entrypoints.info:main_info"
+pythonwrench-tree = "pythonwrench.entrypoints.tree:main_tree"
+pythonwrench-safe-rmdir = "pythonwrench.entrypoints.safe_rmdir:main_safe_rmdir"
+pyw-info = "pythonwrench.entrypoints.info:main_info"
+pyw-tree = "pythonwrench.entrypoints.tree:main_tree"
+pyw-safe-rmdir = "pythonwrench.entrypoints.safe_rmdir:main_safe_rmdir"
 
 [project.optional-dependencies]
-dev = []
+dev = [
+    "pandas>=2.0.3",
+    "coverage[toml]>=7.6.1",
+    "ruff>=0.12.0",
+    "sphinx<9.0.0",
+    "sphinx-immaterial>=0.11.14",
+    "flake8>=5.0.4",
+    "ipykernel>=6.29.5",
+    "ipython>=8.12.3",
+    "pre-commit>=3.5.0",
+    "pytest>=8.3.5",
+    "setuptools>=75.3.2",
+    "twine>=6.1.0",
+]
 lazy = [
-    "lazy-loader>=0.4",
+    "lazy-loader>=0.4,<0.5",
 ]
 
 [build-system]
@@ -81,23 +93,9 @@ testpaths = ["tests"]
 source = ["src"]
 
 [tool.ruff.lint.extend-per-file-ignores]
+# F401: module imported but unused
+# F403: ‘from module import *’ used; unable to detect undefined names
 "__init__.py" = ["F401", "F403"]
 
 [tool.uv.sources]
 pythonwrench = { workspace = true }
-
-[dependency-groups]
-dev = [
-    "coverage[toml]>=7.6.1",
-    "flake8",
-    "ipykernel",
-    "ipython",
-    "pre-commit",
-    "pytest",
-    "pythonwrench",
-    "ruff>=0.12.0",
-    "setuptools",
-    "sphinx<9.0.0",
-    "sphinx-immaterial>=0.11.14",
-    "twine",
-]

{pythonwrench-0.5.1 → pythonwrench-0.6.0}/src/pythonwrench/__init__.py

@@ -9,7 +9,7 @@ __author_email__ = "labbeti.pub@gmail.com"
 __license__ = "MIT"
 __maintainer__ = "Étienne Labbé (Labbeti)"
 __status__ = "Development"
-__version__ = "0.5.1"
+__version__ = "0.6.0"
 
 
 from typing import TYPE_CHECKING
@@ -28,31 +28,31 @@ if TYPE_CHECKING or lazy is None:
     from . import checksum as checksum
     from . import collections as collections
     from . import concurrent as concurrent
-    from . import csv as csv
     from . import dataclasses as dataclasses
     from . import datetime as datetime
     from . import difflib as difflib
     from . import disk_cache as disk_cache
-    from . import entries as entries
+    from . import entrypoints as entrypoints
     from . import enum as enum
     from . import functools as functools
     from . import hashlib as hashlib
     from . import importlib as importlib
     from . import inspect as inspect
-    from . import json as json
-    from . import jsonl as jsonl
     from . import logging as logging
     from . import math as math
     from . import os as os
-    from . import pickle as pickle
     from . import random as random
     from . import re as re
     from . import semver as semver
+    from . import serialization as serialization
+    from . import time as time
     from . import warnings as warnings
 
     # Global library imports
     from .abc import Singleton
     from .argparse import (
+        new_parser_from_dataclass,
+        parse_args_using_dataclass,
         parse_to,
         str_to_bool,
         str_to_none,
@@ -65,6 +65,7 @@ if TYPE_CHECKING or lazy is None:
     from .cast import as_builtin, register_as_builtin_fn
     from .checksum import checksum_any, checksum_object, register_checksum_fn
     from .collections import (
+        SizedGenerator,
         all_eq,
         all_ne,
         contained,
@@ -86,6 +87,7 @@ if TYPE_CHECKING or lazy is None:
         recursive_generator,
         reduce_add,
         reduce_and,
+        reduce_matmul,
         reduce_mul,
         reduce_or,
         shuffled,
@@ -98,7 +100,6 @@ if TYPE_CHECKING or lazy is None:
         union_lists,
         unzip,
     )
-    from .csv import dump_csv, dumps_csv, load_csv, loads_csv, read_csv, save_csv
     from .dataclasses import get_defaults_values
     from .datetime import get_now, get_now_iso8601
     from .difflib import find_closest_in_list, sequence_matcher_ratio
@@ -114,22 +115,15 @@ if TYPE_CHECKING or lazy is None:
     )
     from .hashlib import hash_file
     from .importlib import (
+        Placeholder,
         is_available_package,
         is_editable_package,
         reload_editable_packages,
         reload_submodules,
+        requires_packages,
         search_submodules,
     )
     from .inspect import get_argnames, get_current_fn_name, get_fullname
-    from .json import dump_json, dumps_json, load_json, loads_json, read_json, save_json
-    from .jsonl import (
-        dump_jsonl,
-        dumps_jsonl,
-        load_jsonl,
-        loads_jsonl,
-        read_jsonl,
-        save_jsonl,
-    )
     from .logging import (
         VERBOSE_DEBUG,
         VERBOSE_ERROR,
@@ -148,14 +142,6 @@ if TYPE_CHECKING or lazy is None:
     )
     from .math import argmax, argmin, argsort, clamp, clip
     from .os import get_num_cpus_available, safe_rmdir, tree_iter
-    from .pickle import (
-        dump_pickle,
-        dumps_pickle,
-        load_pickle,
-        loads_pickle,
-        read_pickle,
-        save_pickle,
-    )
     from .random import randstr
     from .re import (
         PatternLike,
@@ -168,10 +154,38 @@ if TYPE_CHECKING or lazy is None:
         sort_with_patterns,
     )
     from .semver import Version
+    from .serialization import (
+        dump_csv,
+        dump_json,
+        dump_jsonl,
+        dump_pickle,
+        dumps_csv,
+        dumps_json,
+        dumps_jsonl,
+        dumps_pickle,
+        load_csv,
+        load_json,
+        load_jsonl,
+        load_pickle,
+        loads_csv,
+        loads_json,
+        loads_jsonl,
+        loads_pickle,
+        read_csv,
+        read_json,
+        read_jsonl,
+        read_pickle,
+        save_csv,
+        save_json,
+        save_jsonl,
+        save_pickle,
+    )
+    from .time import Ticker
     from .typing import (
         BuiltinCollection,
         BuiltinNumber,
         BuiltinScalar,
+        Dataclass,
         DataclassInstance,
         EllipsisType,
         ListOrTuple,
@@ -227,31 +241,31 @@ else:
             "checksum",
             "collections",
             "concurrent",
-            "csv",
             "dataclasses",
             "datetime",
             "difflib",
             "disk_cache",
-            "entries",
+            "entrypoints",
             "enum",
             "functools",
             "hashlib",
             "importlib",
             "inspect",
-            "json",
-            "jsonl",
             "logging",
             "math",
             "os",
-            "pickle",
             "random",
             "re",
             "semver",
+            "serialization",
+            "time",
             "typing",
             "warnings",
         ],
         submod_attrs={
             "argparse": [
+                "new_parser_from_dataclass",
+                "parse_args_using_dataclass",
                 "parse_to",
                 "str_to_bool",
                 "str_to_none",
@@ -265,6 +279,7 @@ else:
             "cast": ["as_builtin", "register_as_builtin_fn"],
             "checksum": ["checksum_any", "checksum_object", "register_checksum_fn"],
             "collections": [
+                "SizedGenerator",
                 "all_eq",
                 "all_ne",
                 "contained",
@@ -286,6 +301,7 @@ else:
                 "recursive_generator",
                 "reduce_add",
                 "reduce_and",
+                "reduce_matmul",
                 "reduce_mul",
                 "reduce_or",
                 "shuffled",
@@ -298,13 +314,31 @@ else:
                 "union_lists",
                 "unzip",
             ],
-            "csv": [
+            "serialization": [
                 "dump_csv",
+                "dump_json",
+                "dump_jsonl",
+                "dump_pickle",
                 "dumps_csv",
+                "dumps_json",
+                "dumps_jsonl",
+                "dumps_pickle",
                 "load_csv",
+                "load_json",
+                "load_jsonl",
+                "load_pickle",
                 "loads_csv",
+                "loads_json",
+                "loads_jsonl",
+                "loads_pickle",
                 "read_csv",
+                "read_json",
+                "read_jsonl",
+                "read_pickle",
                 "save_csv",
+                "save_json",
+                "save_jsonl",
+                "save_pickle",
             ],
             "dataclasses": ["get_defaults_values"],
             "datetime": ["get_now", "get_now_iso8601"],
@@ -325,25 +359,11 @@ else:
                 "is_editable_package",
                 "reload_editable_packages",
                 "reload_submodules",
+                "requires_packages",
                 "search_submodules",
+                "Placeholder",
             ],
             "inspect": ["get_argnames", "get_current_fn_name", "get_fullname"],
-            "json": [
-                "dump_json",
-                "dumps_json",
-                "load_json",
-                "loads_json",
-                "read_json",
-                "save_json",
-            ],
-            "jsonl": [
-                "dump_jsonl",
-                "dumps_jsonl",
-                "load_jsonl",
-                "loads_jsonl",
-                "read_jsonl",
-                "save_jsonl",
-            ],
             "logging": [
                 "VERBOSE_DEBUG",
                 "VERBOSE_ERROR",
@@ -362,14 +382,6 @@ else:
             ],
             "math": ["argmax", "argmin", "argsort", "clamp", "clip"],
             "os": ["get_num_cpus_available", "safe_rmdir", "tree_iter"],
-            "pickle": [
-                "dump_pickle",
-                "dumps_pickle",
-                "load_pickle",
-                "loads_pickle",
-                "read_pickle",
-                "save_pickle",
-            ],
             "random": ["randstr"],
             "re": [
                 "PatternLike",
@@ -382,10 +394,12 @@ else:
                 "sort_with_patterns",
             ],
             "semver": ["Version"],
+            "time": ["Ticker"],
             "typing": [
                 "BuiltinCollection",
                 "BuiltinNumber",
                 "BuiltinScalar",
+                "Dataclass",
                 "DataclassInstance",
                 "EllipsisType",
                 "ListOrTuple",
@@ -439,4 +453,4 @@ else:
 version = __version__
 version_info = Version(__version__)
 
-del Version, TYPE_CHECKING
+del TYPE_CHECKING, lazy

{pythonwrench-0.5.1 → pythonwrench-0.6.0}/src/pythonwrench/__main__.py

@@ -1,7 +1,7 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-from .entries import print_install_info
+from .entrypoints.info import main_info
 
 if __name__ == "__main__":
-    print_install_info()
+    main_info()

{pythonwrench-0.5.1 → pythonwrench-0.6.0}/src/pythonwrench/_core.py

@@ -1,10 +1,7 @@
 #!/usr/bin/env python
 # -*- coding: utf-8 -*-
 
-import os
 from functools import wraps
-from io import TextIOWrapper
-from pathlib import Path
 from typing import (
     Any,
     Callable,
@@ -16,7 +13,6 @@ from typing import (
     Tuple,
     Union,
     get_args,
-    overload,
 )
 
 from typing_extensions import ParamSpec, TypeVar
@@ -169,53 +165,3 @@ class _FunctionRegistry(Generic[T_Output]):
         else:
             msg = f"Invalid argument {unk_mode=}. (expected one of {get_args(UnkMode)})"
             raise ValueError(msg)
-
-
-@overload
-def _setup_output_fpath(
-    fpath: Union[str, Path, os.PathLike],
-    overwrite: bool,
-    make_parents: bool,
-    absolute: bool = True,
-) -> Path: ...
-
-
-@overload
-def _setup_output_fpath(
-    fpath: TextIOWrapper,
-    overwrite: bool,
-    make_parents: bool,
-    absolute: bool = True,
-) -> TextIOWrapper: ...
-
-
-@overload
-def _setup_output_fpath(
-    fpath: None,
-    overwrite: bool,
-    make_parents: bool,
-    absolute: bool = True,
-) -> None: ...
-
-
-def _setup_output_fpath(
-    fpath: Union[str, Path, os.PathLike, TextIOWrapper, None],
-    overwrite: bool,
-    make_parents: bool,
-    absolute: bool = True,
-) -> Union[Path, None, TextIOWrapper]:
-    """Resolve path, expand path and create intermediate parents."""
-    if not isinstance(fpath, (str, Path, os.PathLike)):
-        return fpath
-
-    fpath = Path(fpath)
-    if absolute:
-        fpath = fpath.resolve().expanduser()
-
-    if not overwrite and fpath.exists():
-        msg = f"File {fpath} already exists."
-        raise FileExistsError(msg)
-    elif make_parents:
-        fpath.parent.mkdir(parents=True, exist_ok=True)
-
-    return fpath