hunterMakesPy 0.3.1__tar.gz → 0.3.2__tar.gz

{huntermakespy-0.3.1 → huntermakespy-0.3.2}/PKG-INFO

@@ -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 → huntermakespy-0.3.2}/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-0.3.1 → huntermakespy-0.3.2}/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-0.3.1 → huntermakespy-0.3.2}/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-0.3.2/hunterMakesPy/theTypes.py

@@ -0,0 +1,17 @@
+"""I type, you type, we all `type` for `theTypes`."""
+from typing import Protocol, Self, TypeAlias
+
+identifierDotAttribute: TypeAlias = str
+"""`str` (***str***ing) representing a dotted attribute identifier.
+
+`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 → huntermakespy-0.3.2}/hunterMakesPy.egg-info/PKG-INFO

@@ -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 → huntermakespy-0.3.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hunterMakesPy"
-version = "0.3.1"
+version = "0.3.2"
 description = "Easy Python functions making making functional Python functions easier."
 readme = "README.md"
 requires-python = ">=3.11"

huntermakespy-0.3.1/hunterMakesPy/theTypes.py

@@ -1,9 +0,0 @@
-"""I type, you type, we all `type` for `theTypes`."""
-from typing import TypeAlias
-
-identifierDotAttribute: TypeAlias = str
-"""`str` (***str***ing) representing a dotted attribute identifier.
-
-`TypeAlias` for a `str` `object` using dot notation to access an attribute, such as 'scipy.signal.windows'.
-
-"""