pythonwrench 0.5.2__tar.gz → 0.6.1__tar.gz

{pythonwrench-0.5.2/src/pythonwrench.egg-info → pythonwrench-0.6.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pythonwrench
-Version: 0.5.2
+Version: 0.6.1
 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>
@@ -52,8 +52,20 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 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

{pythonwrench-0.5.2 → pythonwrench-0.6.1}/pyproject.toml

@@ -42,17 +42,33 @@ 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"
+pw-info = "pythonwrench.entrypoints.info:main_info"
+pw-tree = "pythonwrench.entrypoints.tree:main_tree"
+pw-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]
@@ -80,23 +96,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.2 → pythonwrench-0.6.1}/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.2"
+__version__ = "0.6.1"
 
 
 from typing import TYPE_CHECKING
@@ -28,31 +28,32 @@ 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 (
+        add_dataclass_fields_to_parser,
+        new_parser_from_dataclass,
+        parse_args_using_dataclass,
         parse_to,
         str_to_bool,
         str_to_none,
@@ -65,6 +66,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 +88,7 @@ if TYPE_CHECKING or lazy is None:
         recursive_generator,
         reduce_add,
         reduce_and,
+        reduce_matmul,
         reduce_mul,
         reduce_or,
         shuffled,
@@ -98,7 +101,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,7 +116,9 @@ if TYPE_CHECKING or lazy is None:
     )
     from .hashlib import hash_file
     from .importlib import (
+        ModulePlaceholder,
         Placeholder,
+        import_if_available,
         is_available_package,
         is_editable_package,
         reload_editable_packages,
@@ -123,15 +127,6 @@ if TYPE_CHECKING or lazy is None:
         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,
@@ -150,14 +145,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,
@@ -170,10 +157,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,
@@ -229,31 +244,32 @@ 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": [
+                "add_dataclass_fields_to_parser",
+                "new_parser_from_dataclass",
+                "parse_args_using_dataclass",
                 "parse_to",
                 "str_to_bool",
                 "str_to_none",
@@ -267,6 +283,7 @@ else:
             "cast": ["as_builtin", "register_as_builtin_fn"],
             "checksum": ["checksum_any", "checksum_object", "register_checksum_fn"],
             "collections": [
+                "SizedGenerator",
                 "all_eq",
                 "all_ne",
                 "contained",
@@ -288,6 +305,7 @@ else:
                 "recursive_generator",
                 "reduce_add",
                 "reduce_and",
+                "reduce_matmul",
                 "reduce_mul",
                 "reduce_or",
                 "shuffled",
@@ -300,13 +318,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"],
@@ -323,6 +359,8 @@ else:
             ],
             "hashlib": ["hash_file"],
             "importlib": [
+                "import_if_available",
+                "ModulePlaceholder",
                 "is_available_package",
                 "is_editable_package",
                 "reload_editable_packages",
@@ -332,22 +370,6 @@ else:
                 "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",
@@ -366,14 +388,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",
@@ -386,10 +400,12 @@ else:
                 "sort_with_patterns",
             ],
             "semver": ["Version"],
+            "time": ["Ticker"],
             "typing": [
                 "BuiltinCollection",
                 "BuiltinNumber",
                 "BuiltinScalar",
+                "Dataclass",
                 "DataclassInstance",
                 "EllipsisType",
                 "ListOrTuple",
@@ -443,4 +459,4 @@ else:
 version = __version__
 version_info = Version(__version__)
 
-del Version, TYPE_CHECKING
+del TYPE_CHECKING, lazy

{pythonwrench-0.5.2 → pythonwrench-0.6.1}/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.2 → pythonwrench-0.6.1}/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
@@ -43,10 +39,14 @@ def return_none(*args, **kwargs) -> None:
 def _decorator_factory(
     inner_fn: Optional[Callable[P, U]],
     *,
-    pre_fn: Callable[..., Any] = return_none,
-    post_fn: Callable[..., Any] = return_none,
+    pre_fn: Optional[Callable[..., Any]] = None,
+    post_fn: Optional[Callable[..., Any]] = None,
 ) -> Callable[[Callable[P, U]], Callable[P, U]]:
     """Deprecated decorator for function aliases."""
+    if pre_fn is None:
+        pre_fn = return_none
+    if post_fn is None:
+        post_fn = return_none
 
     def wrapper_factory(fn: Callable[P, U]) -> Callable[P, U]:
         if inner_fn is None:
@@ -169,53 +169,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