pythonwrench 0.4.9__tar.gz → 0.5.0__tar.gz

{pythonwrench-0.4.9/src/pythonwrench.egg-info → pythonwrench-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pythonwrench
-Version: 0.4.9
+Version: 0.5.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,8 +50,10 @@ 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
+Dynamic: license-file
 
 # pythonwrench
 

{pythonwrench-0.4.9 → pythonwrench-0.5.0}/pyproject.toml

@@ -31,6 +31,7 @@ maintainers = [
 ]
 dynamic = ["version"]
 dependencies = [
+    "lazy-loader>=0.4",
     "typing-extensions>=4.10.0",
 ]
 
@@ -67,7 +68,7 @@ version = {attr = "pythonwrench.__version__"}
 
 [tool.pyright]
 include = ["src"]
-exclude = ["**/__pycache__"]
+exclude = ["**/__pycache__", '**/node_modules', '**/.*', '.venv']
 pythonVersion = "3.8"
 
 [tool.pytest.ini_options]

pythonwrench-0.5.0/src/pythonwrench/__init__.py

@@ -0,0 +1,434 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+"""Python library with tools for typing, manipulating collections, and more!"""
+
+__name__ = "pythonwrench"
+__author__ = "Étienne Labbé (Labbeti)"
+__author_email__ = "labbeti.pub@gmail.com"
+__license__ = "MIT"
+__maintainer__ = "Étienne Labbé (Labbeti)"
+__status__ = "Development"
+__version__ = "0.5.0"
+
+
+from typing import TYPE_CHECKING
+
+try:
+    import lazy_loader as lazy  # type: ignore
+except ImportError:
+    lazy = None
+
+
+if TYPE_CHECKING or lazy is None:
+    # Re-import for language servers
+    from . import abc as abc
+    from . import argparse as argparse
+    from . import cast as cast
+    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 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 warnings as warnings
+
+    # Global library imports
+    from .abc import Singleton
+    from .argparse import (
+        parse_to,
+        str_to_bool,
+        str_to_none,
+        str_to_optional_bool,
+        str_to_optional_float,
+        str_to_optional_int,
+        str_to_optional_str,
+        str_to_type,
+    )
+    from .cast import as_builtin, register_as_builtin_fn
+    from .checksum import checksum_any, checksum_object, register_checksum_fn
+    from .collections import (
+        all_eq,
+        all_ne,
+        contained,
+        dict_list_to_list_dict,
+        dump_dict,
+        duplicate_list,
+        filter_iterable,
+        find,
+        flat_dict_of_dict,
+        flat_list_of_list,
+        flatten,
+        intersect,
+        intersect_lists,
+        is_full,
+        is_sorted,
+        is_unique,
+        list_dict_to_dict_list,
+        prod,
+        recursive_generator,
+        reduce_add,
+        reduce_and,
+        reduce_mul,
+        reduce_or,
+        shuffled,
+        sorted_dict,
+        sum,
+        unflat_dict_of_dict,
+        unflat_list_of_list,
+        union,
+        union_dicts,
+        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
+    from .disk_cache import disk_cache_call, disk_cache_decorator
+    from .enum import StrEnum
+    from .functools import (
+        Compose,
+        compose,
+        filter_and_call,
+        function_alias,
+        identity,
+        repeat_fn,
+    )
+    from .hashlib import hash_file
+    from .importlib import (
+        is_available_package,
+        is_editable_package,
+        reload_editable_packages,
+        reload_submodules,
+        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,
+        VERBOSE_INFO,
+        VERBOSE_WARNING,
+        MkdirFileHandler,
+        get_current_file_logger,
+        get_ipython_name,
+        get_null_logger,
+        log_once,
+        running_on_interpreter,
+        running_on_notebook,
+        running_on_terminal,
+        setup_logging_level,
+        setup_logging_verbose,
+    )
+    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,
+        PatternListLike,
+        compile_patterns,
+        filter_with_patterns,
+        find_patterns,
+        get_key_fn,
+        match_patterns,
+        sort_with_patterns,
+    )
+    from .semver import Version
+    from .typing import (
+        BuiltinCollection,
+        BuiltinNumber,
+        BuiltinScalar,
+        DataclassInstance,
+        EllipsisType,
+        ListOrTuple,
+        NamedTupleInstance,
+        NoneType,
+        SupportsAdd,
+        SupportsAnd,
+        SupportsBool,
+        SupportsDiv,
+        SupportsGetitem,
+        SupportsGetitem2,
+        SupportsGetitemIterLen,
+        SupportsGetitemIterLen2,
+        SupportsGetitemLen,
+        SupportsGetitemLen2,
+        SupportsIterLen,
+        SupportsLen,
+        SupportsMatmul,
+        SupportsMul,
+        SupportsOr,
+        T_BuiltinNumber,
+        T_BuiltinScalar,
+        check_args_types,
+        is_builtin_collection,
+        is_builtin_number,
+        is_builtin_obj,
+        is_builtin_scalar,
+        is_dataclass_instance,
+        is_iterable_bool,
+        is_iterable_bytes_or_list,
+        is_iterable_float,
+        is_iterable_int,
+        is_iterable_integral,
+        is_iterable_str,
+        is_namedtuple_instance,
+        is_sequence_str,
+        is_typed_dict,
+        isinstance_generic,
+    )
+    from .warnings import deprecated_alias, deprecated_function, warn_once
+
+else:
+    __getattr__, __dir__, __all__ = lazy.attach(
+        __name__,
+        submodules=[
+            "abc",
+            "argparse",
+            "cast",
+            "checksum",
+            "collections",
+            "concurrent",
+            "csv",
+            "dataclasses",
+            "datetime",
+            "difflib",
+            "disk_cache",
+            "entries",
+            "enum",
+            "functools",
+            "hashlib",
+            "importlib",
+            "inspect",
+            "json",
+            "jsonl",
+            "logging",
+            "math",
+            "os",
+            "pickle",
+            "random",
+            "re",
+            "semver",
+            "typing",
+            "warnings",
+        ],
+        submod_attrs={
+            "argparse": [
+                "parse_to",
+                "str_to_bool",
+                "str_to_none",
+                "str_to_optional_bool",
+                "str_to_optional_float",
+                "str_to_optional_int",
+                "str_to_optional_str",
+                "str_to_type",
+            ],
+            "abc": ["Singleton"],
+            "cast": ["as_builtin", "register_as_builtin_fn"],
+            "checksum": ["checksum_any", "checksum_object", "register_checksum_fn"],
+            "collections": [
+                "all_eq",
+                "all_ne",
+                "contained",
+                "dict_list_to_list_dict",
+                "dump_dict",
+                "duplicate_list",
+                "filter_iterable",
+                "find",
+                "flat_dict_of_dict",
+                "flat_list_of_list",
+                "flatten",
+                "intersect",
+                "intersect_lists",
+                "is_full",
+                "is_sorted",
+                "is_unique",
+                "list_dict_to_dict_list",
+                "prod",
+                "recursive_generator",
+                "reduce_add",
+                "reduce_and",
+                "reduce_mul",
+                "reduce_or",
+                "shuffled",
+                "sorted_dict",
+                "sum",
+                "unflat_dict_of_dict",
+                "unflat_list_of_list",
+                "union",
+                "union_dicts",
+                "union_lists",
+                "unzip",
+            ],
+            "csv": [
+                "dump_csv",
+                "dumps_csv",
+                "load_csv",
+                "loads_csv",
+                "read_csv",
+                "save_csv",
+            ],
+            "dataclasses": ["get_defaults_values"],
+            "datetime": ["get_now", "get_now_iso8601"],
+            "difflib": ["find_closest_in_list", "sequence_matcher_ratio"],
+            "disk_cache": ["disk_cache_call", "disk_cache_decorator"],
+            "enum": ["StrEnum"],
+            "functools": [
+                "Compose",
+                "compose",
+                "filter_and_call",
+                "function_alias",
+                "identity",
+                "repeat_fn",
+            ],
+            "hashlib": ["hash_file"],
+            "importlib": [
+                "is_available_package",
+                "is_editable_package",
+                "reload_editable_packages",
+                "reload_submodules",
+                "search_submodules",
+            ],
+            "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",
+                "VERBOSE_INFO",
+                "VERBOSE_WARNING",
+                "MkdirFileHandler",
+                "get_current_file_logger",
+                "get_ipython_name",
+                "get_null_logger",
+                "log_once",
+                "running_on_interpreter",
+                "running_on_notebook",
+                "running_on_terminal",
+                "setup_logging_level",
+                "setup_logging_verbose",
+            ],
+            "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",
+                "PatternListLike",
+                "compile_patterns",
+                "filter_with_patterns",
+                "find_patterns",
+                "get_key_fn",
+                "match_patterns",
+                "sort_with_patterns",
+            ],
+            "semver": ["Version"],
+            "typing": [
+                "BuiltinCollection",
+                "BuiltinNumber",
+                "BuiltinScalar",
+                "DataclassInstance",
+                "EllipsisType",
+                "ListOrTuple",
+                "NamedTupleInstance",
+                "NoneType",
+                "SupportsAdd",
+                "SupportsAnd",
+                "SupportsBool",
+                "SupportsDiv",
+                "SupportsGetitem",
+                "SupportsGetitem2",
+                "SupportsGetitemIterLen",
+                "SupportsGetitemIterLen2",
+                "SupportsGetitemLen",
+                "SupportsGetitemLen2",
+                "SupportsIterLen",
+                "SupportsLen",
+                "SupportsMatmul",
+                "SupportsMul",
+                "SupportsOr",
+                "T_BuiltinNumber",
+                "T_BuiltinScalar",
+                "check_args_types",
+                "is_builtin_collection",
+                "is_builtin_number",
+                "is_builtin_obj",
+                "is_builtin_scalar",
+                "is_dataclass_instance",
+                "is_iterable_bool",
+                "is_iterable_bytes_or_list",
+                "is_iterable_float",
+                "is_iterable_int",
+                "is_iterable_integral",
+                "is_iterable_str",
+                "is_namedtuple_instance",
+                "is_sequence_str",
+                "is_typed_dict",
+                "isinstance_generic",
+            ],
+            "warnings": ["deprecated_alias", "deprecated_function", "warn_once"],
+        },
+    )
+
+    Version = __getattr__("Version")
+
+
+version = __version__
+version_info = Version(__version__)
+
+del Version, TYPE_CHECKING

pythonwrench-0.5.0/src/pythonwrench/collections/__init__.py

@@ -0,0 +1,104 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+
+from typing import TYPE_CHECKING
+
+try:
+    import lazy_loader as lazy  # type: ignore
+except ImportError:
+    lazy = None
+
+
+if TYPE_CHECKING or lazy is None:
+    from .collections import (
+        SizedGenerator,
+        contained,
+        dict_list_to_list_dict,
+        dump_dict,
+        duplicate_list,
+        filter_iterable,
+        find,
+        flat_dict_of_dict,
+        flat_list_of_list,
+        flatten,
+        intersect_lists,
+        list_dict_to_dict_list,
+        recursive_generator,
+        shuffled,
+        sorted_dict,
+        unflat_dict_of_dict,
+        unflat_list_of_list,
+        union_dicts,
+        union_lists,
+        unzip,
+    )
+    from .prop import (
+        all_eq,
+        all_ne,
+        is_full,
+        is_sorted,
+        is_unique,
+    )
+    from .reducers import (
+        intersect,
+        prod,
+        reduce_add,
+        reduce_and,
+        reduce_matmul,
+        reduce_mul,
+        reduce_or,
+        sum,
+        union,
+    )
+
+else:
+    __getattr__, __dir__, __all__ = lazy.attach(
+        __name__,
+        submodules=[
+            "collections",
+            "prop",
+            "reducers",
+        ],
+        submod_attrs={
+            "collections": [
+                "SizedGenerator",
+                "contained",
+                "dict_list_to_list_dict",
+                "dump_dict",
+                "duplicate_list",
+                "filter_iterable",
+                "find",
+                "flat_dict_of_dict",
+                "flat_list_of_list",
+                "flatten",
+                "intersect_lists",
+                "list_dict_to_dict_list",
+                "recursive_generator",
+                "shuffled",
+                "sorted_dict",
+                "unflat_dict_of_dict",
+                "unflat_list_of_list",
+                "union_dicts",
+                "union_lists",
+                "unzip",
+            ],
+            "prop": [
+                "all_eq",
+                "all_ne",
+                "is_full",
+                "is_sorted",
+                "is_unique",
+            ],
+            "reducers": [
+                "intersect",
+                "prod",
+                "reduce_add",
+                "reduce_and",
+                "reduce_matmul",
+                "reduce_mul",
+                "reduce_or",
+                "sum",
+                "union",
+            ],
+        },
+    )

{pythonwrench-0.4.9 → pythonwrench-0.5.0}/src/pythonwrench/csv.py

@@ -189,20 +189,27 @@ def _serialize_csv(
     if to_builtins:
         data = as_builtin(data)
 
+    is_mapping_iterable = isinstance_generic(data, Mapping[str, Iterable])
+    if is_mapping_iterable:
+        is_iterable_mapping = False
+    else:
+        is_iterable_mapping = isinstance_generic(data, Iterable[Mapping[str, Any]])
+
     if header == "auto":
-        header = isinstance_generic(
-            data, (Mapping[str, Iterable], Iterable[Mapping[str, Any]])
-        )
+        header = is_mapping_iterable or is_iterable_mapping
 
-    if isinstance_generic(data, Mapping[str, Iterable]):
-        data_lst = dict_list_to_list_dict(data, "same")  # type: ignore
-    elif isinstance_generic(data, Iterable[Mapping[str, Any]]):
+    if is_mapping_iterable:
+        data_lst = dict_list_to_list_dict(data, "same")
+    elif is_iterable_mapping:
         data_lst = [dict(data_i.items()) for data_i in data]
+    elif isinstance(data, str):
+        msg = f"Invalid argument type {type(data)}."
+        raise TypeError(msg)
     elif not header and isinstance_generic(data, Iterable[str]):
         data_lst = [{"0": data_i} for data_i in data]
     elif not header and isinstance_generic(data, Iterable[Iterable]):
         data_lst = [dict(zip(map(str, range(len(data_i))), data)) for data_i in data]
-    elif not header and isinstance_generic(data, Iterable):
+    elif not header and isinstance(data, Iterable):
         data_lst = [{"0": data_i} for data_i in data]
     else:
         msg = f"Invalid argument type {type(data)} with {header=}."