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

hunterMakesPy/__init__.py

@@ -8,26 +8,15 @@ This package provides:
 
 """
 
-# isort: split
 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 (
-	autoDecodingRLE as autoDecodingRLE, stringItUp as stringItUp,
-	updateExtendPolishDictionaryLists as updateExtendPolishDictionaryLists)
+from hunterMakesPy.dataStructures import autoDecodingRLE, stringItUp, updateExtendPolishDictionaryLists
 
-# isort: split
 from hunterMakesPy._theSSOT import settingsPackage  # pyright: ignore[reportUnusedImport]

hunterMakesPy/dataStructures.py

@@ -267,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/pytestForYourUse.py

@@ -6,5 +6,4 @@ Note: These test functions are now in `hunterMakesPy.tests` with all other tests
 """
 
 from hunterMakesPy.tests.test_parseParameters import (
-	PytestFor_defineConcurrencyLimit as PytestFor_defineConcurrencyLimit, PytestFor_intInnit as PytestFor_intInnit,
-	PytestFor_oopsieKwargsie as PytestFor_oopsieKwargsie)
+	PytestFor_defineConcurrencyLimit, PytestFor_intInnit, PytestFor_oopsieKwargsie)

hunterMakesPy/tests/conftest.py

@@ -1,3 +1,11 @@
+"""Configuration and fixtures for pytest.
+
+(AI generated docstring)
+
+This module provides shared fixtures and utility functions for the test suite,
+including data paths, source code samples, and standardized assertion helpers.
+
+"""
 # pyright: standard
 from collections.abc import Callable
 from typing import Any
@@ -6,11 +14,26 @@ import pathlib
 import pytest
 
 # SSOT for test data paths and filenames
-pathDataSamples = pathlib.Path("hunterMakesPy/tests/dataSamples")
+pathDataSamples: pathlib.Path = pathlib.Path("hunterMakesPy/tests/dataSamples")
 
 # Fixture to provide a temporary directory for filesystem tests
 @pytest.fixture
 def pathTmpTesting(tmp_path: pathlib.Path) -> pathlib.Path:
+	"""Provide a temporary directory for filesystem tests.
+
+	(AI generated docstring)
+
+	Parameters
+	----------
+	tmp_path : pathlib.Path
+		The pytest built-in temporary path fixture.
+
+	Returns
+	-------
+	pathTmpTesting : pathlib.Path
+		The path to the temporary directory.
+
+	"""
 	return tmp_path
 
 # Fixture for predictable Python source code samples
@@ -44,7 +67,27 @@ def listFileContentsFibonacci() -> list[str]:
 	return ['fibonacci8', 'fibonacci13', 'fibonacci21', 'fibonacci34']
 
 def uniformTestFailureMessage(expected: Any, actual: Any, functionName: str, *arguments: Any, **keywordArguments: Any) -> str:
-	"""Format assertion message for any test comparison."""
+	"""Format assertion message for any test comparison.
+
+	Parameters
+	----------
+	expected : Any
+		The expected value or outcome.
+	actual : Any
+		The actual value or outcome received.
+	functionName : str
+		The name of the function or test case being executed.
+	*arguments : Any
+		Positional arguments passed to the function having its return value checked.
+	**keywordArguments : Any
+		Keyword arguments passed to the function having its return value checked.
+
+	Returns
+	-------
+	message : str
+		A formatted failure message detailing the expectation vs reality.
+
+	"""
 	listArgumentComponents: list[str] = [str(parameter) for parameter in arguments]
 	listKeywordComponents: list[str] = [f"{key}={value}" for key, value in keywordArguments.items()]
 	joinedArguments: str = ', '.join(listArgumentComponents + listKeywordComponents)
@@ -54,7 +97,22 @@ def uniformTestFailureMessage(expected: Any, actual: Any, functionName: str, *ar
 			f"Got: {actual}")
 
 def standardizedEqualTo(expected: Any, functionTarget: Callable[..., Any], *arguments: Any, **keywordArguments: Any) -> None:
-	"""Template for most tests to compare the actual outcome with the expected outcome, including expected errors."""
+	"""Template for most tests to compare actual outcome with expected outcome.
+
+	Includes handling for expected errors/exceptions.
+
+	Parameters
+	----------
+	expected : Any
+		The expected return value, or an Exception type if an error is expected.
+	functionTarget : Callable[..., Any]
+		The function to call and test.
+	*arguments : Any
+		Positional arguments to pass to `functionTarget`.
+	**keywordArguments : Any
+		Keyword arguments to pass to `functionTarget`.
+
+	"""
 	if type(expected) == type[Exception]:  # noqa: E721
 		messageExpected: str = expected.__name__
 	else:
@@ -63,7 +121,23 @@ def standardizedEqualTo(expected: Any, functionTarget: Callable[..., Any], *argu
 	try:
 		messageActual = actual = functionTarget(*arguments, **keywordArguments)
 	except Exception as actualError:
-		messageActual: str = type(actualError).__name__
+		messageActual = type(actualError).__name__
 		actual = type(actualError)
 
-	assert actual == expected, uniformTestFailureMessage(messageExpected, messageActual, functionTarget.__name__, *arguments, **keywordArguments)
+	functionName: str = getattr(functionTarget, "__name__", functionTarget.__class__.__name__)
+	assert actual == expected, uniformTestFailureMessage(messageExpected, messageActual, functionName, *arguments, **keywordArguments)
+
+# Why I wish I could figure out how to implement standardized* test functions.
+# ruff: noqa: ERA001
+	# standardizedEqualTo(expected, updateExtendPolishDictionaryLists, *value_dictionaryLists, **keywordArguments)
+# NOTE one line of code with `standardizedEqualTo` (above) replaced the following ten lines of code. Use `standardizedEqualTo`.
+	# if isinstance(expected, type) and issubclass(expected, Exception):
+	#	 with pytest.raises(expected):
+	#		 updateExtendPolishDictionaryLists(*value_dictionaryLists, **keywordArguments)
+	# else:
+	#	 result = updateExtendPolishDictionaryLists(*value_dictionaryLists, **keywordArguments)
+	#	 if description == "Set values":  # Special handling for unordered sets
+	#		 for key in result:
+	#			 assert sorted(result[key]) == sorted(expected[key])
+	#	 else:
+	#		 assert result == expected