hunterMakesPy 0.5.5__tar.gz → 0.7.0__tar.gz

{huntermakespy-0.5.5/hunterMakesPy.egg-info → huntermakespy-0.7.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterMakesPy
-Version: 0.5.5
+Version: 0.7.0
 Summary: Easy Python functions making making functional Python functions easier.
 Author-email: Hunter Hogan <HunterHogan@pm.me>
 License-Expression: CC-BY-NC-4.0
@@ -9,7 +9,7 @@ Project-URL: Donate, https://www.patreon.com/integrated
 Project-URL: Homepage, https://github.com/hunterhogan/hunterMakesPy
 Project-URL: Issues, https://github.com/hunterhogan/hunterMakesPy/issues
 Project-URL: Repository, https://github.com/hunterhogan/hunterMakesPy
-Keywords: attribute loading,concurrency limit,configuration,cytoolz,defensive programming,dictionary merging,directory creation,dynamic import,error propagation,file system utilities,input validation,integer parsing,module loading,nested data structures,package settings,parameter validation,pytest,string extraction,test utilities,toolz
+Keywords: attribute loading,configuration,defensive programming,dictionary merging,dynamic import,file system utilities,input validation,module loading,package settings,parameter validation
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
 Classifier: Framework :: Pytest
@@ -19,15 +19,12 @@ Classifier: Intended Audience :: Other Audience
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.14
-Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.12
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: autoflake
@@ -35,21 +32,18 @@ Requires-Dist: charset_normalizer
 Requires-Dist: isort
 Requires-Dist: more_itertools
 Requires-Dist: numpy
+Requires-Dist: tomli
 Requires-Dist: typing_extensions>=4.10.0
 Provides-Extra: development
-Requires-Dist: astToolkit; extra == "development"
-Requires-Dist: setuptools>=62.3; extra == "development"
 Requires-Dist: pytest-cov; extra == "development"
 Provides-Extra: testing
-Requires-Dist: cython; extra == "testing"
 Requires-Dist: librosa; extra == "testing"
 Requires-Dist: pytest; extra == "testing"
-Requires-Dist: pytest-xdist; extra == "testing"
 Dynamic: license-file
 
 # hunterMakesPy
 
-Utilities for converting mixed input to integers, calculating CPU limits, handling None values, importing code dynamically, and manipulating nested data. Also includes `humpy_toolz`, `humpy_cytoolz`, and `humpy_tlz`: typed forks of `toolz` and `cytoolz` with curried namespaces and a sandbox.
+Utilities for converting mixed input to integers, calculating CPU limits, handling None values, importing code dynamically, and manipulating nested data.
 
 [![pip install hunterMakesPy](https://img.shields.io/badge/pip%20install-hunterMakesPy-gray.svg?colorB=3b434b)](https://pypi.org/project/hunterMakesPy/)
 
@@ -128,7 +122,7 @@ Write to `"deep/nested/path/file.txt"` and parent directories are created automa
 from hunterMakesPy.filesystemToolkit import writeStringToHere, writePython
 
 writeStringToHere("content", "nested/dirs/file.txt")  # Creates dirs
-writePython(sourceCode, "output/module.py")            # Formats, then writes
+writePython(sourceCode, "output/module.py")           # Formats, then writes
 ```
 
 ## Extract Strings from Arbitrarily Nested Data
@@ -189,100 +183,6 @@ def test_my_integer_validator(test_name, test_func):
     test_func()
 ```
 
----
-
-## `humpy_toolz`: Typed Pure-Python Functional Utilities
-
-`humpy_toolz` is a typed fork of [`toolz`](https://github.com/pytoolz/toolz). It provides composable functions for iterators, dictionaries, and function composition with full type stubs and docstrings.
-
-### Dictionary Transformations without Mutation
-
-Create new mappings by associating, dissociating, filtering, and mapping over keys or values. Nested access is supported through key-path sequences.
-
-```python
-from humpy_toolz import merge, valmap, keyfilter, assoc
-
-merged = merge({"a": 1}, {"b": 2})             # {"a": 1, "b": 2}
-doubled = valmap(lambda x: x * 2, {"a": 1})    # {"a": 2}
-evens = keyfilter(lambda k: k > 1, {1: "a", 2: "b"})  # {2: "b"}
-updated = assoc({"x": 10}, "y", 20)            # {"x": 10, "y": 20}
-```
-
-### Compose, Curry, and Thread Functions
-
-Build transformation sequences from left or right, partially apply arguments with `curry`, and thread a value through a series of functions.
-
-```python
-from humpy_toolz import compose_left, curry, pipe
-
-increment = lambda x: x + 1
-double = lambda x: x * 2
-transform = compose_left(increment, double)
-transform(3)  # 8
-
-pipe(3, increment, double)  # 8
-```
-
-### Slice, Group, and Deduplicate Iterators
-
-Lazy operations over iterables: `take`, `drop`, `partition`, `sliding_window`, `unique`, `interleave`, `groupby`, `frequencies`, and more.
-
-```python
-from humpy_toolz import take, frequencies, groupby, unique
-
-list(take(3, range(100)))              # [0, 1, 2]
-frequencies(["a", "b", "a", "c"])      # {"a": 2, "b": 1, "c": 1}
-groupby(len, ["cat", "mouse", "dog"])  # {3: ["cat", "dog"], 5: ["mouse"]}
-list(unique([1, 2, 1, 3]))            # [1, 2, 3]
-```
-
-### Curried Namespace for Partial Application
-
-Every function in `humpy_toolz.curried` accepts partial arguments and returns a new callable waiting for the rest.
-
-```python
-from humpy_toolz.curried import map, filter, get
-
-list(map(str.upper, ["hello", "world"]))  # ["HELLO", "WORLD"]
-list(filter(lambda x: x > 2, [1, 2, 3, 4]))  # [3, 4]
-list(map(get(0), [(1, 2), (3, 4)]))       # [1, 3]
-```
-
-### Sandbox: Parallel Fold and Equality-Based Hashing
-
-`humpy_toolz.sandbox` provides `fold` for unordered parallel reductions and `EqualityHashKey` for hashing otherwise-unhashable types.
-
-```python
-from humpy_toolz.sandbox import fold, EqualityHashKey
-from operator import add
-
-fold(add, range(100), default=0)  # 4950
-```
-
----
-
-## `humpy_cytoolz`: Cython-Accelerated Functional Utilities
-
-`humpy_cytoolz` is a typed fork of [`cytoolz`](https://github.com/pytoolz/cytoolz). It exposes the same API as `humpy_toolz` but the core modules (`dicttoolz`, `functoolz`, `itertoolz`, `recipes`, `utils`) are compiled as Cython extension modules for lower overhead on hot paths.
-
-```python
-from humpy_cytoolz import groupby, curry, merge
-```
-
-Install with the `cython` build dependency to compile the extensions. If compilation is unavailable, use `humpy_toolz` directly.
-
----
-
-## `humpy_tlz`: Automatic Cython-or-Pure Dispatch
-
-`humpy_tlz` mirrors the `humpy_toolz` API and imports from `humpy_cytoolz` when available, falling back to `humpy_toolz` otherwise. Use `humpy_tlz` in library code so callers benefit from Cython acceleration without requiring it.
-
-```python
-from humpy_tlz import pipe, curry, groupby
-```
-
----
-
 ## My recovery
 
 [![Static Badge](https://img.shields.io/badge/2011_August-Homeless_since-blue?style=flat)](https://HunterThinks.com/support)

{huntermakespy-0.5.5 → huntermakespy-0.7.0}/README.md

@@ -1,6 +1,6 @@
 # hunterMakesPy
 
-Utilities for converting mixed input to integers, calculating CPU limits, handling None values, importing code dynamically, and manipulating nested data. Also includes `humpy_toolz`, `humpy_cytoolz`, and `humpy_tlz`: typed forks of `toolz` and `cytoolz` with curried namespaces and a sandbox.
+Utilities for converting mixed input to integers, calculating CPU limits, handling None values, importing code dynamically, and manipulating nested data.
 
 [![pip install hunterMakesPy](https://img.shields.io/badge/pip%20install-hunterMakesPy-gray.svg?colorB=3b434b)](https://pypi.org/project/hunterMakesPy/)
 
@@ -79,7 +79,7 @@ Write to `"deep/nested/path/file.txt"` and parent directories are created automa
 from hunterMakesPy.filesystemToolkit import writeStringToHere, writePython
 
 writeStringToHere("content", "nested/dirs/file.txt")  # Creates dirs
-writePython(sourceCode, "output/module.py")            # Formats, then writes
+writePython(sourceCode, "output/module.py")           # Formats, then writes
 ```
 
 ## Extract Strings from Arbitrarily Nested Data
@@ -140,100 +140,6 @@ def test_my_integer_validator(test_name, test_func):
     test_func()
 ```
 
----
-
-## `humpy_toolz`: Typed Pure-Python Functional Utilities
-
-`humpy_toolz` is a typed fork of [`toolz`](https://github.com/pytoolz/toolz). It provides composable functions for iterators, dictionaries, and function composition with full type stubs and docstrings.
-
-### Dictionary Transformations without Mutation
-
-Create new mappings by associating, dissociating, filtering, and mapping over keys or values. Nested access is supported through key-path sequences.
-
-```python
-from humpy_toolz import merge, valmap, keyfilter, assoc
-
-merged = merge({"a": 1}, {"b": 2})             # {"a": 1, "b": 2}
-doubled = valmap(lambda x: x * 2, {"a": 1})    # {"a": 2}
-evens = keyfilter(lambda k: k > 1, {1: "a", 2: "b"})  # {2: "b"}
-updated = assoc({"x": 10}, "y", 20)            # {"x": 10, "y": 20}
-```
-
-### Compose, Curry, and Thread Functions
-
-Build transformation sequences from left or right, partially apply arguments with `curry`, and thread a value through a series of functions.
-
-```python
-from humpy_toolz import compose_left, curry, pipe
-
-increment = lambda x: x + 1
-double = lambda x: x * 2
-transform = compose_left(increment, double)
-transform(3)  # 8
-
-pipe(3, increment, double)  # 8
-```
-
-### Slice, Group, and Deduplicate Iterators
-
-Lazy operations over iterables: `take`, `drop`, `partition`, `sliding_window`, `unique`, `interleave`, `groupby`, `frequencies`, and more.
-
-```python
-from humpy_toolz import take, frequencies, groupby, unique
-
-list(take(3, range(100)))              # [0, 1, 2]
-frequencies(["a", "b", "a", "c"])      # {"a": 2, "b": 1, "c": 1}
-groupby(len, ["cat", "mouse", "dog"])  # {3: ["cat", "dog"], 5: ["mouse"]}
-list(unique([1, 2, 1, 3]))            # [1, 2, 3]
-```
-
-### Curried Namespace for Partial Application
-
-Every function in `humpy_toolz.curried` accepts partial arguments and returns a new callable waiting for the rest.
-
-```python
-from humpy_toolz.curried import map, filter, get
-
-list(map(str.upper, ["hello", "world"]))  # ["HELLO", "WORLD"]
-list(filter(lambda x: x > 2, [1, 2, 3, 4]))  # [3, 4]
-list(map(get(0), [(1, 2), (3, 4)]))       # [1, 3]
-```
-
-### Sandbox: Parallel Fold and Equality-Based Hashing
-
-`humpy_toolz.sandbox` provides `fold` for unordered parallel reductions and `EqualityHashKey` for hashing otherwise-unhashable types.
-
-```python
-from humpy_toolz.sandbox import fold, EqualityHashKey
-from operator import add
-
-fold(add, range(100), default=0)  # 4950
-```
-
----
-
-## `humpy_cytoolz`: Cython-Accelerated Functional Utilities
-
-`humpy_cytoolz` is a typed fork of [`cytoolz`](https://github.com/pytoolz/cytoolz). It exposes the same API as `humpy_toolz` but the core modules (`dicttoolz`, `functoolz`, `itertoolz`, `recipes`, `utils`) are compiled as Cython extension modules for lower overhead on hot paths.
-
-```python
-from humpy_cytoolz import groupby, curry, merge
-```
-
-Install with the `cython` build dependency to compile the extensions. If compilation is unavailable, use `humpy_toolz` directly.
-
----
-
-## `humpy_tlz`: Automatic Cython-or-Pure Dispatch
-
-`humpy_tlz` mirrors the `humpy_toolz` API and imports from `humpy_cytoolz` when available, falling back to `humpy_toolz` otherwise. Use `humpy_tlz` in library code so callers benefit from Cython acceleration without requiring it.
-
-```python
-from humpy_tlz import pipe, curry, groupby
-```
-
----
-
 ## My recovery
 
 [![Static Badge](https://img.shields.io/badge/2011_August-Homeless_since-blue?style=flat)](https://HunterThinks.com/support)

{huntermakespy-0.5.5 → huntermakespy-0.7.0}/hunterMakesPy/__init__.py

@@ -72,7 +72,7 @@ from hunterMakesPy.semiotics import decreasing as decreasing, errorL33T as error
 
 # isort: split
 from hunterMakesPy.theTypes import (
-	CallableFunction as CallableFunction, identifierDotAttribute as identifierDotAttribute, Ordinals as Ordinals)
+	CallableFunction as CallableFunction, identifierDotAttribute as identifierDotAttribute, Ordinals as Ordinals, 小于 as 小于)
 
 # isort: split
 from hunterMakesPy.coping import PackageSettings as PackageSettings, raiseIfNone as raiseIfNone

{huntermakespy-0.5.5 → huntermakespy-0.7.0}/hunterMakesPy/coping.py

@@ -3,22 +3,23 @@ from __future__ import annotations
 
 from importlib.util import find_spec
 from pathlib import Path
-from tomllib import loads as tomllib_loads
+from tomli import loads as tomli_loads
 from typing import TYPE_CHECKING
+from typing_extensions import TypeVar
 import dataclasses
 
 if TYPE_CHECKING:
 	from importlib.machinery import ModuleSpec
 
 def getIdentifierPackagePACKAGING(identifierPackageFALLBACK: str) -> str:
-	"""Get package name from pyproject.toml or fallback to provided value."""
+	"""Get package name from pyproject.toml or fallback to provided value."""  # noqa: DOC201
 	try:
-		return tomllib_loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['name']
+		return tomli_loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['name']
 	except Exception:  # noqa: BLE001
 		return identifierPackageFALLBACK
 
 def getPathPackageINSTALLING(identifierPackage: str) -> Path:
-	"""Return the root directory of the installed package."""
+	"""Return the root directory of the installed package."""  # noqa: DOC201
 	try:
 		moduleSpecification: ModuleSpec | None = find_spec(identifierPackage)
 		if moduleSpecification and moduleSpecification.origin:
@@ -85,7 +86,9 @@ class PackageSettings:
 		if self.pathPackage == Path() and self.identifierPackage:
 			self.pathPackage = getPathPackageINSTALLING(self.identifierPackage)
 
-def raiseIfNone[TypeSansNone](expression: TypeSansNone | None, errorMessage: str | None = None) -> TypeSansNone:
+TypeSansNone = TypeVar('TypeSansNone')
+
+def raiseIfNone(expression: TypeSansNone | None, errorMessage: str | None = None) -> TypeSansNone:
 	"""Convert the `expression` return annotation from '`cerPytainty | None`' to '`cerPytainty`' because `expression` cannot be `None`; `raise` an `Exception` if you're wrong.
 
 	The Python interpreter evaluates `expression` to a value: think of a function call or an attribute access. You can use

{huntermakespy-0.5.5 → huntermakespy-0.7.0}/hunterMakesPy/dataStructures.py

@@ -31,7 +31,6 @@ References
 from __future__ import annotations
 
 from charset_normalizer import CharsetMatch
-from hunterMakesPy import Ordinals
 from types import FunctionType
 from typing import Any, cast, TYPE_CHECKING
 import charset_normalizer
@@ -41,11 +40,12 @@ import sys
 
 if TYPE_CHECKING:
 	from collections.abc import Iterator, Mapping
+	from hunterMakesPy import 小于
 	from numpy import integer
 	from numpy.typing import NDArray
 
 def removeExtraWhitespace(string: str) -> str:
-	"""Remove extra whitespace from string representation of Python data structures."""
+	"""Remove extra whitespace from string representation of Python data structures."""  # noqa: DOC201
 	commas: str = regex.sub(r',\s+', ',', string)
 	bracketsOpening: str = regex.sub(r'([\[\(])\s+', r'\1', commas)
 	# Remove spaces before closing brackets/parentheses.
@@ -83,7 +83,7 @@ def autoDecodingRLE(arrayTarget: NDArray[integer[Any]], *, assumeAddSpaces: bool
 	"""
 	def sliceNDArrayToNestedLists(arraySlice: NDArray[integer[Any]]) -> Any:
 		def getLengthOption(optionAsStr: str) -> int:
-			"""`assumeAddSpaces` characters: `,` 1 space; `]*` 2 spaces."""
+			"""`assumeAddSpaces` characters: `,` 1 space; `]*` 2 spaces."""  # noqa: DOC201
 			return assumeAddSpaces * (optionAsStr.count(',') + optionAsStr.count(']*') * 2) + len(optionAsStr)
 
 		if 1 < arraySlice.ndim:
@@ -160,20 +160,20 @@ def autoDecodingRLE(arrayTarget: NDArray[integer[Any]], *, assumeAddSpaces: bool
 	arrayAsStr: str = removeExtraWhitespace(str(arrayAsNestedLists))
 
 	patternRegex: regex.Pattern[str] = regex.compile(
-		"(?<!rang)(?:"
-		# Pattern 1: Comma ahead, bracket behind  # noqa: ERA001
-		"(?P<joinAhead>,)\\((?P<malkovich>\\d+),(?P<multiply>\\d+)\\)(?P<bracketBehind>])|"
-		# Pattern 2: Bracket or start ahead, comma behind  # noqa: ERA001
-		"(?P<bracketOrStartAhead>\\[|^.)\\((?P<malkovichMalkovich>\\d+),(?P<multiplyIDK>\\d+)\\)(?P<joinBehind>,)|"
-		# Pattern 3: Bracket ahead, bracket behind  # noqa: ERA001
-		"(?P<bracketAhead>\\[)\\((?P<malkovichMalkovichMalkovich>\\d+),(?P<multiply_whatever>\\d+)\\)(?P<bracketBehindBracketBehind>])|"
-		# Pattern 4: Comma ahead, comma behind  # noqa: ERA001
-		"(?P<joinAheadJoinAhead>,)\\((?P<malkovichMalkovichMalkovichMalkovich>\\d+),(?P<multiplyOrSomething>\\d+)\\)(?P<joinBehindJoinBehind>,)"
-		")"
+		r"(?<!rang)(?:"
+		# Pattern 1: Comma ahead, bracket behind
+		r"(?P<joinAhead>,)\((?P<malkovich>\d+),(?P<multiply>\d+)\)(?P<bracketBehind>])|"
+		# Pattern 2: Bracket or start ahead, comma behind
+		r"(?P<bracketOrStartAhead>\[|^.)\((?P<malkovichMalkovich>\d+),(?P<multiplyIDK>\d+)\)(?P<joinBehind>,)|"
+		# Pattern 3: Bracket ahead, bracket behind
+		r"(?P<bracketAhead>\[)\((?P<malkovichMalkovichMalkovich>\d+),(?P<multiply_whatever>\d+)\)(?P<bracketBehindBracketBehind>])|"
+		# Pattern 4: Comma ahead, comma behind
+		r"(?P<joinAheadJoinAhead>,)\((?P<malkovichMalkovichMalkovichMalkovich>\d+),(?P<multiplyOrSomething>\d+)\)(?P<joinBehindJoinBehind>,)"
+		r")"
 	)
 
 	def replacementByContext(match: regex.Match[str]) -> str:
-		"""Generate replacement string based on context patterns."""
+		"""Generate replacement string based on context patterns."""  # noqa: DOC201
 		elephino: dict[str, str | None] = match.groupdict()
 		joinAhead: str | None = elephino.get('joinAhead') or elephino.get('joinAheadJoinAhead')
 		malkovich: str | None = elephino.get('malkovich') or elephino.get('malkovichMalkovich') or elephino.get('malkovichMalkovichMalkovich') or elephino.get('malkovichMalkovichMalkovichMalkovich')
@@ -189,7 +189,7 @@ def autoDecodingRLE(arrayTarget: NDArray[integer[Any]], *, assumeAddSpaces: bool
 	arrayAsStr = patternRegex.sub(replacementByContext, arrayAsStr)
 	arrayAsStr = patternRegex.sub(replacementByContext, arrayAsStr)
 
-	# Replace `range(0,stop)` syntax with `range(stop)` syntax.  # noqa: ERA001
+	# Replace `range(0,stop)` syntax with `range(stop)` syntax.
 	# Add unpack operator `*` for automatic decoding when evaluated.
 	return arrayAsStr.replace('range(0,', 'range(').replace('range', '*range')
 
@@ -232,14 +232,14 @@ def stringItUp(*scrapPile: Any) -> list[str]:
 				drill(broken)
 				drill(piece)
 		elif isinstance(KitKat, (list, tuple, set, frozenset, range)):
-			for kit in KitKat: # pyright: ignore[reportUnknownVariableType]
+			for kit in KitKat:  # pyright: ignore[reportUnknownVariableType]
 				drill(kit)
 		elif hasattr(KitKat, '__iter__'):  # Unpack other iterables
 			for kat in KitKat:
 				drill(kat)
 		else:
 			try:
-				sharingIsCaring: str = KitKat.__str__()
+				sharingIsCaring: str = KitKat.__str__()  # noqa: PLC2801
 				listStrungUp.append(sharingIsCaring)
 			except AttributeError:
 				pass
@@ -256,7 +256,7 @@ def stringItUp(*scrapPile: Any) -> list[str]:
 		listStrungUp.append(repr(scrap))
 	return listStrungUp
 
-def updateExtendPolishDictionaryLists[小于: Ordinals](*dictionaryLists: Mapping[str, list[小于] | set[小于] | tuple[小于, ...]], destroyDuplicates: bool = False, reorderLists: bool = False, killErroneousDataTypes: bool = False) -> dict[str, list[小于]]:
+def updateExtendPolishDictionaryLists(*dictionaryLists: Mapping[str, list[小于] | set[小于] | tuple[小于, ...]], destroyDuplicates: bool = False, reorderLists: bool = False, killErroneousDataTypes: bool = False) -> dict[str, list[小于]]:
 	"""Merge multiple dictionaries with `list` values into a single dictionary with the `list` values merged.
 
 	Plus options to destroy duplicates, sort `list` values, and handle erroneous data types.
@@ -288,7 +288,7 @@ def updateExtendPolishDictionaryLists[小于: Ordinals](*dictionaryLists: Mappin
 	types will not be preserved. That could have unexpected consequences. Conversion from the
 	original data type to a `list`, for example, may not preserve the order even if you want the
 	order to be preserved.
-	"""
+	"""  # noqa: DOC501
 	ePluribusUnum: dict[str, list[小于]] = {}
 
 	for dictionaryListTarget in dictionaryLists:
@@ -297,7 +297,7 @@ def updateExtendPolishDictionaryLists[小于: Ordinals](*dictionaryLists: Mappin
 				ImaStr = str(keyName)
 				ImaList: list[小于] = list(keyValue)
 				ePluribusUnum.setdefault(ImaStr, []).extend(ImaList)
-			except TypeError:
+			except TypeError:  # noqa: PERF203
 				if killErroneousDataTypes:
 					continue
 				else: