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

hunterMakesPy/__init__.py

@@ -8,28 +8,15 @@ 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
 
-# isort: split
-from hunterMakesPy.parseParameters import (
-	defineConcurrencyLimit as defineConcurrencyLimit, intInnit as intInnit, oopsieKwargsie as oopsieKwargsie)
+from hunterMakesPy.parseParameters import defineConcurrencyLimit, intInnit, oopsieKwargsie
 
-# isort: split
 from hunterMakesPy.filesystemToolkit import (
-	importLogicalPath2Identifier as importLogicalPath2Identifier,
-	importPathFilename2Identifier as importPathFilename2Identifier, makeDirsSafely as makeDirsSafely,
-	writePython as writePython, writeStringToHere as writeStringToHere)
+	importLogicalPath2Identifier, importPathFilename2Identifier, makeDirsSafely, writePython, writeStringToHere)
 
-# isort: split
-from hunterMakesPy.dataStructures import (
-	stringItUp as stringItUp, updateExtendPolishDictionaryLists as updateExtendPolishDictionaryLists)
+from hunterMakesPy.dataStructures import autoDecodingRLE, stringItUp, updateExtendPolishDictionaryLists
 
-# isort: split
-from hunterMakesPy.dataStructures import autoDecodingRLE as autoDecodingRLE
-
-# 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[小于]]:
@@ -270,7 +267,7 @@ def updateExtendPolishDictionaryLists(*dictionaryLists: Mapping[str, list[小于
 		for keyName, keyValue in dictionaryListTarget.items():
 			try:
 				ImaStr = str(keyName)
-				ImaList = list(keyValue)
+				ImaList: list[小于] = list(keyValue)
 				ePluribusUnum.setdefault(ImaStr, []).extend(ImaList)
 			except TypeError:
 				if killErroneousDataTypes:

hunterMakesPy/filesystemToolkit.py

@@ -118,7 +118,6 @@ settings_isortDEFAULT: dict[str, bool | int | str | list[str]] = {
 	"lines_between_types": 0,
 	"multi_line_output": 4,
 	"no_sections": True,
-	"skip": ["__init__.py"], # TODO think
 	"use_parentheses": True,
 }
 

hunterMakesPy/parseParameters.py

@@ -148,21 +148,18 @@ def defineConcurrencyLimit(*, limit: bool | float | int | None, cpuTotal: int =
 			limit = limitFromString
 	if isinstance(limit, float) and abs(limit) >= 1:
 		limit = round(limit)
-	match limit:
-		case None | False | 0:
-			pass
-		case True:
-			concurrencyLimit = 1
-		case _ if limit >= 1:
-			concurrencyLimit = int(limit)
-		case _ if 0 < limit < 1:
-			concurrencyLimit = round(limit * cpuTotal)
-		case _ if -1 < limit < 0:
-			concurrencyLimit = cpuTotal - abs(round(limit * cpuTotal))
-		case _ if limit <= -1:
-			concurrencyLimit = cpuTotal - abs(int(limit))
-		case _:
-			pass
+	if limit is None or limit is False or limit == 0:
+		pass
+	elif limit is True:
+		concurrencyLimit = 1
+	elif limit >= 1:
+		concurrencyLimit = int(limit)
+	elif 0 < limit < 1:
+		concurrencyLimit = round(limit * cpuTotal)
+	elif -1 < limit < 0:
+		concurrencyLimit = cpuTotal - abs(round(limit * cpuTotal))
+	elif limit <= -1:
+		concurrencyLimit = cpuTotal - abs(int(limit))
 
 	return max(int(concurrencyLimit), 1)
 
@@ -208,7 +205,7 @@ def intInnit(listInt_Allegedly: Iterable[Any], parameterName: str | None = None,
 	parameterType = parameterType or list
 
 	if not listInt_Allegedly:
-		message = f"I did not receive a value for {parameterName}, but it is required."
+		message: str = f"I did not receive a value for {parameterName}, but it is required."
 		raise ValueError(message)
 
 	# Be nice, and assume the input container is valid and every element is valid.
@@ -319,11 +316,3 @@ def oopsieKwargsie(huh: Any) -> bool | None | str:
 	if formatted == str(None):
 		return None
 	return huh
-
-if __name__ == '__main__':
-	# Frankly, I cannot remember the precise reason I put this in some modules. It solved a concurrency problem I was having at the time,
-	# but it felt like a hack at the time and it feels even more like a hack now. I suspect I will eventually learn enough so that I can
-	# come full circle: know why I added it, know how I already fixed the real issue, and know that I can safely remove this.  # noqa: ERA001
-	multiprocessing.set_start_method('spawn')
-
-	# Well, actually, I don't want to be programming for so long that I learn that much. I want to heal and do things in my areas of competency.

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,15 @@ 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` by comparison operators."""
+
+	def __le__(self, not_self_selfButSelfSelf_youKnow: Self, /) -> bool:
+		"""Comparison by "***l***ess than or ***e***qual to"."""
+		...
+
+	def __lt__(self, not_self_selfButSelfSelf_youKnow: Self, /) -> bool:
+		"""Comparison by "***l***ess ***t***han"."""
+		...
+

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterMakesPy
-Version: 0.3.1
+Version: 0.3.3
 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.3.dist-info}/RECORD

@@ -1,20 +1,20 @@
-hunterMakesPy/__init__.py,sha256=N2Bvmacvs9z8ITWWjQr6-5LQHZ1FG5KL6v-pR1m6fCY,1547
+hunterMakesPy/__init__.py,sha256=bydhevjZG6_JT2q_v9rfozvjhXVqyyUGCovL6EwxlBk,1168
 hunterMakesPy/_theSSOT.py,sha256=x9Rdmw0qeAqgmlMFyFYRTRV5kEDYXcN4aBZ4KjlnKEU,170
 hunterMakesPy/coping.py,sha256=42a_1kB6zHeRpfbpPnjmhrgWTPvUtqE5W9z3tqu-K8w,6068
-hunterMakesPy/dataStructures.py,sha256=0-BRFriADFKX9pvjYj03ukj021ZII61wet2Wq2yAEdM,11776
-hunterMakesPy/filesystemToolkit.py,sha256=8Yx8SH56w7g9wxpLjsdCaC1RvsW8Ur_cDrxhHaY9cLM,6848
-hunterMakesPy/parseParameters.py,sha256=uQXoD89BfWAmRVT2yabyHtW7qITwAuCC9eh0sQFIV5Q,11966
+hunterMakesPy/dataStructures.py,sha256=GbFk5uJskkjL5WNCSJbgn7BKQVh0f792gZ4zgSod9H8,11934
+hunterMakesPy/filesystemToolkit.py,sha256=4zgXrDELBnS2UJ4sGPJVFyyrjDwfF0evnGIWssm--Jk,6809
+hunterMakesPy/parseParameters.py,sha256=k5sGBoCeVRK02lNze59xPb99UiXm2l-HXI5HQPcKHnY,11321
 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=Ce2hGCsBgd_DaUVoWZ6Iq-Lp4qf6053orHq0o52ssgM,734
 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.3.dist-info/licenses/LICENSE,sha256=NxH5Y8BdC-gNU-WSMwim3uMbID2iNDXJz7fHtuTdXhk,19346
+huntermakespy-0.3.3.dist-info/METADATA,sha256=VNrznpDWhCCoxUM0nAufsjImFAiVagnHgFbCPPXxnzQ,6319
+huntermakespy-0.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+huntermakespy-0.3.3.dist-info/top_level.txt,sha256=Uh4bj8EDTdsRpqY1VlK_his_B4HDfZ6Tqrwhoj75P_w,14
+huntermakespy-0.3.3.dist-info/RECORD,,