hunterMakesPy 0.3.1__py3-none-any.whl → 0.3.2__py3-none-any.whl

hunterMakesPy/__init__.py

@@ -9,7 +9,7 @@ This package provides:
 """
 
 # isort: split
-from hunterMakesPy.theTypes import identifierDotAttribute as identifierDotAttribute
+from hunterMakesPy.theTypes import identifierDotAttribute as identifierDotAttribute, Ordinals as Ordinals
 
 # isort: split
 from hunterMakesPy.coping import PackageSettings as PackageSettings, raiseIfNone as raiseIfNone
@@ -26,10 +26,8 @@ from hunterMakesPy.filesystemToolkit import (
 
 # isort: split
 from hunterMakesPy.dataStructures import (
-	stringItUp as stringItUp, updateExtendPolishDictionaryLists as updateExtendPolishDictionaryLists)
-
-# isort: split
-from hunterMakesPy.dataStructures import autoDecodingRLE as autoDecodingRLE
+	autoDecodingRLE as autoDecodingRLE, stringItUp as stringItUp,
+	updateExtendPolishDictionaryLists as updateExtendPolishDictionaryLists)
 
 # isort: split
 from hunterMakesPy._theSSOT import settingsPackage  # pyright: ignore[reportUnusedImport]

hunterMakesPy/dataStructures.py

@@ -1,11 +1,14 @@
 """Provides utilities for string extraction from nested data structures and merges multiple dictionaries containing lists into one dictionary."""
-
+from charset_normalizer import CharsetMatch
 from collections.abc import Mapping
+from hunterMakesPy import Ordinals
 from numpy import integer
 from numpy.typing import NDArray
-from typing import Any, Protocol, TYPE_CHECKING, TypeVar
+from typing import Any, cast, TYPE_CHECKING, TypeVar
+import charset_normalizer
 import more_itertools
 import re as regex
+import sys
 
 if TYPE_CHECKING:
 	from collections.abc import Iterator
@@ -187,33 +190,37 @@ def stringItUp(*scrapPile: Any) -> list[str]:
 	listStrungUp: list[str] = []
 
 	def drill(KitKat: Any) -> None:
-		match KitKat:
-			case str():
-				listStrungUp.append(KitKat)
-			case bool() | bytearray() | bytes() | complex() | float() | int() | memoryview() | None:
-				listStrungUp.append(str(KitKat))
-			case dict():
-				for broken, piece in KitKat.items():
-					drill(broken)
-					drill(piece)
-			case list() | tuple() | set() | frozenset() | range():
-				for kit in KitKat:
-					drill(kit)
-			case _:
-				if hasattr(KitKat, '__iter__'):  # Unpack other iterables
-					for kat in KitKat:
-						drill(kat)
-				else:
-					try:
-						sharingIsCaring = KitKat.__str__()
-						listStrungUp.append(sharingIsCaring)
-					except AttributeError:
-						pass
-					except TypeError:  # "The error traceback provided indicates that there is an issue when calling the __str__ method on an object that does not have this method properly defined, leading to a TypeError."
-						pass
-					except:
-						print(f"\nWoah! I received '{repr(KitKat)}'.\nTheir report card says, 'Plays well with others: Needs improvement.'\n")  # noqa: T201
-						raise
+		if isinstance(KitKat, str):
+			listStrungUp.append(KitKat)
+		elif (KitKat is None) or (isinstance(KitKat, (bool, bytearray, bytes, complex, float, int))):
+			listStrungUp.append(str(KitKat))
+		elif isinstance(KitKat, memoryview):
+			decodedString: CharsetMatch | None = charset_normalizer.from_bytes(KitKat.tobytes()).best()
+			if decodedString:
+				listStrungUp.append(str(decodedString))
+		elif isinstance(KitKat, dict):
+			DictDact: dict[Any, Any] = cast(dict[Any, Any], KitKat)
+			for broken, piece in DictDact.items():
+				drill(broken)
+				drill(piece)
+		elif isinstance(KitKat, (list, tuple, set, frozenset, range)):
+			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__()
+				listStrungUp.append(sharingIsCaring)
+			except AttributeError:
+				pass
+			except TypeError:  # "The error traceback provided indicates that there is an issue when calling the __str__ method on an object that does not have this method properly defined, leading to a TypeError."
+				pass
+			except:
+				message: str = (f"\nWoah! I received '{repr(KitKat)}'.\nTheir report card says, 'Plays well with others: Needs improvement.'\n")
+				sys.stderr.write(message)
+				raise
 	try:
 		for scrap in scrapPile:
 			drill(scrap)
@@ -221,16 +228,6 @@ def stringItUp(*scrapPile: Any) -> list[str]:
 		listStrungUp.append(repr(scrap))
 	return listStrungUp
 
-class Ordinals(Protocol):
-	"""Protocol for types that support ordering comparisons."""
-
-	def __le__(self, other: "Ordinals", /) -> bool:
-		"""Less than or equal to comparison."""
-		...
-	def __ge__(self, other: "Ordinals", /) -> bool:
-		"""Greater than or equal to comparison."""
-		...
-
 小于 = TypeVar('小于', bound=Ordinals)
 
 def updateExtendPolishDictionaryLists(*dictionaryLists: Mapping[str, list[小于] | set[小于] | tuple[小于, ...]], destroyDuplicates: bool = False, reorderLists: bool = False, killErroneousDataTypes: bool = False) -> dict[str, list[小于]]:

hunterMakesPy/tests/test_dataStructures.py

@@ -5,7 +5,7 @@ from fractions import Fraction
 from hunterMakesPy import autoDecodingRLE, stringItUp, updateExtendPolishDictionaryLists
 from hunterMakesPy.tests.conftest import standardizedEqualTo
 from numpy.typing import NDArray
-from typing import Any, Literal
+from typing import Any
 import datetime
 import numpy
 import pytest
@@ -35,6 +35,7 @@ class CustomIterable:
 	# Binary data - accepting either representation
 	("Prime bytes", [b'\x0B', b'\x0D', b'\x11'], [repr(b'\x0b'), repr(b'\x0d'), repr(b'\x11')]),  # Let Python choose representation
 	("Custom bytearray", [bytearray(b"DEADBEEF")], ["bytearray(b'DEADBEEF')"]),
+	("Memory view decoded", memoryview(b"DEADBEEF"), ["DEADBEEF"]),
 	# Nested structures with unique values
 	("Nested dictionary", {'phi': 1.618, 'euler': 2.718}, ['phi', '1.618', 'euler', '2.718']),
 	("Mixed nesting", [{'NE': 37}, {'SW': 41}], ['NE', '37', 'SW', '41']),
@@ -59,14 +60,6 @@ def testStringItUp(description: str, value_scrapPile: list[Any], expected: list[
 	"""Test stringItUp with various inputs."""
 	standardizedEqualTo(expected, stringItUp, value_scrapPile)
 
-@pytest.mark.parametrize("description,value_scrapPile,expected", [
-	("Memory view", memoryview(b"DEADBEEF"), ["<memory at 0x"]),  # Special handling for memoryview
-], ids=lambda x: x if isinstance(x, str) else "")
-def testStringItUpErrorCases(description: Literal['Memory view'], value_scrapPile: memoryview, expected: list[str]) -> None:
-	result = stringItUp(value_scrapPile)
-	assert len(result) == 1
-	assert result[0].startswith(expected[0])
-
 @pytest.mark.parametrize("description,value_dictionaryLists,keywordArguments,expected", [
 	("Mixed value types", ({'ne': [11, 'prime'], 'sw': [True, None]}, {'ne': [3.141, 'golden'], 'sw': [False, 'void']}), {'destroyDuplicates': False, 'reorderLists': False}, {'ne': [11, 'prime', 3.141, 'golden'], 'sw': [True, None, False, 'void']}),
 	("Empty dictionaries", (dict[str, list[Any]](), dict[str, list[Any]]()), dict[str, Any](), dict[str, list[Any]]()),

hunterMakesPy/theTypes.py

@@ -1,5 +1,5 @@
 """I type, you type, we all `type` for `theTypes`."""
-from typing import TypeAlias
+from typing import Protocol, Self, TypeAlias
 
 identifierDotAttribute: TypeAlias = str
 """`str` (***str***ing) representing a dotted attribute identifier.
@@ -7,3 +7,11 @@ identifierDotAttribute: TypeAlias = str
 `TypeAlias` for a `str` `object` using dot notation to access an attribute, such as 'scipy.signal.windows'.
 
 """
+
+
+class Ordinals(Protocol):
+	"""Any Python `object` `type` that may be ordered before or after a comparable `object` `type` using a less-than-or-equal-to comparison."""
+
+	def __le__(self, not_self_selfButSelfSelf_youKnow: Self, /) -> bool:
+		"""Comparison by "***l***ess than or ***e***qual to"."""
+		...

{huntermakespy-0.3.1.dist-info → huntermakespy-0.3.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterMakesPy
-Version: 0.3.1
+Version: 0.3.2
 Summary: Easy Python functions making making functional Python functions easier.
 Author-email: Hunter Hogan <HunterHogan@pm.me>
 License: CC-BY-NC-4.0

{huntermakespy-0.3.1.dist-info → huntermakespy-0.3.2.dist-info}/RECORD

@@ -1,20 +1,20 @@
-hunterMakesPy/__init__.py,sha256=N2Bvmacvs9z8ITWWjQr6-5LQHZ1FG5KL6v-pR1m6fCY,1547
+hunterMakesPy/__init__.py,sha256=oKeYKtnf8Y0oLe7UVlOFFx0BXi4GLEgdwEuJ3MOKc-4,1514
 hunterMakesPy/_theSSOT.py,sha256=x9Rdmw0qeAqgmlMFyFYRTRV5kEDYXcN4aBZ4KjlnKEU,170
 hunterMakesPy/coping.py,sha256=42a_1kB6zHeRpfbpPnjmhrgWTPvUtqE5W9z3tqu-K8w,6068
-hunterMakesPy/dataStructures.py,sha256=0-BRFriADFKX9pvjYj03ukj021ZII61wet2Wq2yAEdM,11776
+hunterMakesPy/dataStructures.py,sha256=GMl9AiQPuype67NZD7moLVzxezPVP38Cw3CoN4gRJI4,11920
 hunterMakesPy/filesystemToolkit.py,sha256=8Yx8SH56w7g9wxpLjsdCaC1RvsW8Ur_cDrxhHaY9cLM,6848
 hunterMakesPy/parseParameters.py,sha256=uQXoD89BfWAmRVT2yabyHtW7qITwAuCC9eh0sQFIV5Q,11966
 hunterMakesPy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hunterMakesPy/pytestForYourUse.py,sha256=GiN1C1gTTM0ZunRPEMnrKlLQLMdH0wF_ZGr_RPgRjjA,500
-hunterMakesPy/theTypes.py,sha256=C2d0uLn1VIx6_2CK41it3IP7iplSQqe51tzWc-RT320,306
+hunterMakesPy/theTypes.py,sha256=gqTGyqrLySOKKXG0NNgixqwePPZ2_hBlzKNYS3jpHtk,627
 hunterMakesPy/tests/__init__.py,sha256=C_FzfKDi_VrGVxlenWHyOYtKShAKlt3KW14jeRx1mQI,224
 hunterMakesPy/tests/conftest.py,sha256=NZQPRiwvGhP16hJ6WGGm9eKLxfQArYV8E9X12YzSpP0,2827
 hunterMakesPy/tests/test_coping.py,sha256=mH89TUAL6fJanBLlhdVlCNNQqm5OpdcQMP_p5W2JJwo,9860
-hunterMakesPy/tests/test_dataStructures.py,sha256=OouddHjN-Km26U92jYwnjYeP6_Y2DrJLgq3qD_8GvGw,16393
+hunterMakesPy/tests/test_dataStructures.py,sha256=WQlq98SllAPSUEjvIHZ9Az2pKNWeLNP4dnl3UyP9yuc,16004
 hunterMakesPy/tests/test_filesystemToolkit.py,sha256=_CoSMzstJwWZ_tkNyIqclOIIqTaY2tYfUIgxGFfC0Jk,15335
 hunterMakesPy/tests/test_parseParameters.py,sha256=UKf1hwhLtXYL96VVJNf8NpJOyzRLO204pd-9PdDjufA,13267
-huntermakespy-0.3.1.dist-info/licenses/LICENSE,sha256=NxH5Y8BdC-gNU-WSMwim3uMbID2iNDXJz7fHtuTdXhk,19346
-huntermakespy-0.3.1.dist-info/METADATA,sha256=_rbA9J-buuKyZvp8vkiYMhSipTCPdLFGdjRsRNtK5oU,6319
-huntermakespy-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-huntermakespy-0.3.1.dist-info/top_level.txt,sha256=Uh4bj8EDTdsRpqY1VlK_his_B4HDfZ6Tqrwhoj75P_w,14
-huntermakespy-0.3.1.dist-info/RECORD,,
+huntermakespy-0.3.2.dist-info/licenses/LICENSE,sha256=NxH5Y8BdC-gNU-WSMwim3uMbID2iNDXJz7fHtuTdXhk,19346
+huntermakespy-0.3.2.dist-info/METADATA,sha256=cSkWkEXB8eEXH5StDtTZKsc2x5uTN1IlAC1xJapoHU4,6319
+huntermakespy-0.3.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+huntermakespy-0.3.2.dist-info/top_level.txt,sha256=Uh4bj8EDTdsRpqY1VlK_his_B4HDfZ6Tqrwhoj75P_w,14
+huntermakespy-0.3.2.dist-info/RECORD,,