hunterMakesPy 0.8.1__tar.gz → 0.9.0__tar.gz

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterMakesPy
-Version: 0.8.1
+Version: 0.9.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
@@ -17,15 +17,15 @@ Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Z0Z_tools>=2.2.1
+Requires-Dist: Z0Z_tools>=4.0.0
 Requires-Dist: autoflake
 Requires-Dist: charset_normalizer
 Requires-Dist: isort
@@ -185,6 +185,11 @@ def test_my_integer_validator(test_name, test_func):
 ## My recovery
 
 [![Static Badge](https://img.shields.io/badge/2011_August-Homeless_since-blue?style=flat)](https://HunterThinks.com/support)
-[![YouTube Channel Subscribers](https://img.shields.io/youtube/channel/subscribers/UC3Gx7kz61009NbhpRtPP7tw)](https://www.youtube.com/@HunterHogan)
 
 [![CC-BY-NC-4.0](https://raw.githubusercontent.com/hunterhogan/hunterMakesPy/refs/heads/main/.github/CC-BY-NC-4.0.png)](https://creativecommons.org/licenses/by-nc/4.0/)
+
+By law, authors retain their copyrights unless they grant exceptions. The [Attribution-NonCommercial 4.0 International Deed](https://github.com/hunterhogan/hunterMakesPy#License-1-ov-file) outlines how you may use this work.
+
+The restriction on commercial use (without a license) limits advantage-taking, unjust enrichment, and exploitation. You would be morally wrong if you were to enrich yourself by using this work while I am denied healthcare, housing, security of property, and the safety of my person.
+
+To obtain and retain the right to use this work, you incur the cost of attributing the work to me. Your nominal cost might accrue as a benefit that mitigates my suffering or saves my life.

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/README.md

@@ -143,6 +143,11 @@ def test_my_integer_validator(test_name, test_func):
 ## My recovery
 
 [![Static Badge](https://img.shields.io/badge/2011_August-Homeless_since-blue?style=flat)](https://HunterThinks.com/support)
-[![YouTube Channel Subscribers](https://img.shields.io/youtube/channel/subscribers/UC3Gx7kz61009NbhpRtPP7tw)](https://www.youtube.com/@HunterHogan)
 
 [![CC-BY-NC-4.0](https://raw.githubusercontent.com/hunterhogan/hunterMakesPy/refs/heads/main/.github/CC-BY-NC-4.0.png)](https://creativecommons.org/licenses/by-nc/4.0/)
+
+By law, authors retain their copyrights unless they grant exceptions. The [Attribution-NonCommercial 4.0 International Deed](https://github.com/hunterhogan/hunterMakesPy#License-1-ov-file) outlines how you may use this work.
+
+The restriction on commercial use (without a license) limits advantage-taking, unjust enrichment, and exploitation. You would be morally wrong if you were to enrich yourself by using this work while I am denied healthcare, housing, security of property, and the safety of my person.
+
+To obtain and retain the right to use this work, you incur the cost of attributing the work to me. Your nominal cost might accrue as a benefit that mitigates my suffering or saves my life.

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy/coping.py

@@ -12,7 +12,6 @@ if TYPE_CHECKING:
 	from importlib.machinery import ModuleSpec
 
 def getIdentifierPackagePACKAGING(identifierPackageFALLBACK: str) -> str:
-	#ruff: ignore[docstring-missing-returns]
 	"""Get package name from pyproject.toml or fallback to provided value."""
 	try:
 		return tomli_loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['name']
@@ -21,7 +20,6 @@ def getIdentifierPackagePACKAGING(identifierPackageFALLBACK: str) -> str:
 		return identifierPackageFALLBACK
 
 def getPathPackageINSTALLING(identifierPackage: str) -> Path:
-	#ruff: ignore[docstring-missing-returns]
 	"""Return the root directory of the installed package."""
 	try:
 		moduleSpecification: ModuleSpec | None = find_spec(identifierPackage)
@@ -68,7 +66,6 @@ class PackageSettings:
 		fileExtension='.pyx'
 	)
 	```
-
 	"""
 
 	identifierPackageFALLBACK: dataclasses.InitVar[str] = ''
@@ -142,7 +139,6 @@ def raiseIfNone(expression: TypeSansNone | None, errorMessage: str | None = None
 	Thanks
 	------
 	sobolevn, https://github.com/sobolevn, for the seed of this function. https://github.com/python/typing/discussions/1997#discussioncomment-13108399
-
 	"""
 	if expression is None:
 		message: str = errorMessage or 'A function unexpectedly returned `None`. Hint: look at the traceback immediately before `raiseIfNone`.'

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy/dataStructures.py

@@ -36,7 +36,6 @@ if TYPE_CHECKING:
 	from typing import Any, Literal
 
 def removeExtraWhitespace(string: str) -> str:
-	#ruff: ignore[docstring-missing-returns]
 	"""Remove extra whitespace from string representation of Python data structures."""
 	commas: str = regex.sub(r',\s+', ',', string)
 	bracketsOpening: str = regex.sub(r'([\[\(])\s+', r'\1', commas)
@@ -72,7 +71,6 @@ def autoDecodingRLE(arrayTarget: NDArray[integer[Any]], *, assumeAddSpaces: bool
 	"""
 	def sliceNDArrayToNestedLists(arraySlice: NDArray[integer[Any]]) -> Any:
 		def getLengthOption(optionAsStr: str) -> int:
-			#ruff: ignore[docstring-missing-returns]
 			"""`assumeAddSpaces` characters: `,` 1 space; `]*` 2 spaces."""
 			return assumeAddSpaces * (optionAsStr.count(',') + optionAsStr.count(']*') * 2) + len(optionAsStr)
 
@@ -161,7 +159,6 @@ def autoDecodingRLE(arrayTarget: NDArray[integer[Any]], *, assumeAddSpaces: bool
 	)
 
 	def replacementByContext(match: regex.Match[str]) -> str:
-		#ruff: ignore[docstring-missing-returns]
 		"""Generate replacement string based on context patterns."""
 		elephino: dict[str, str | None] = match.groupdict()
 		joinAhead: str | None = elephino.get('joinAhead') or elephino.get('joinAheadJoinAhead')
@@ -268,7 +265,7 @@ def updateExtendPolishDictionaryLists(*dictionaryLists: Mapping[文件, Iterable
 	the list follows the iterable's order, which may be unpredictable for sets. Strings contribute
 	individual characters, and mapping values contribute their keys.
 
-	Deduplication uses `dict.fromkeys` [1] to preserve first occurrences. Sorting uses `sorted` [2]
+	Deduplication uses `dict.fromkeys` [1] to preserve first occurrences. Sorting uses `sorted`
 	and runs after deduplication. Every retained value becomes a list regardless of the input type.
 
 	Parameters
@@ -319,8 +316,6 @@ def updateExtendPolishDictionaryLists(*dictionaryLists: Mapping[文件, Iterable
 	----------
 	[1] Python dictionaries and `dict.fromkeys`.
 		https://docs.python.org/3/library/stdtypes.html#dict.fromkeys
-	[2] Python `sorted`.
-		https://docs.python.org/3/library/functions.html#sorted
 	"""
 	ePluribusUnum: dict[文件, list[文义]] = {}
 

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy/filesystemToolkit.py

@@ -85,23 +85,14 @@ def appendStringToHere(this: str, pathFilename: PathLike[Any] | PurePath) -> Pat
 
 	File Writing
 	------------
-	This function prepares parent directories with `makeDirectorySafely` [1], then opens the file in
-	append mode with UTF-8 encoding and `newline=''` [2]. Newline characters in `this` are written
-	without translation. This function writes and flushes the text with `writeStringToHere` [3].
+	This function prepares parent directories with `makeDirectorySafely`, then opens the file in
+	append mode with UTF-8 encoding and `newline=''`. Newline characters in `this` are written
+	without translation. This function writes and flushes the text with `writeStringToHere`.
 	Directory creation suppresses `OSError`, but errors from opening or writing the file propagate.
 
 	Examples
 	--------
 	No invocation of this function exists elsewhere in the codebase.
-
-	References
-	----------
-	[1] `makeDirectorySafely`
-
-	[2] Python `open` modes, encoding, and newline handling.
-		https://docs.python.org/3/library/functions.html#open
-	[3] `writeStringToHere`
-
 	"""
 	pathFilename = Path(pathFilename)
 	makeDirectorySafely(pathFilename)
@@ -141,8 +132,8 @@ def importPathFilename2Identifier(pathFilename: PathLike[Any] | PurePath, identi
 
 	You can use this function to load a Python source file as a module and retrieve a named attribute
 	from that module. This function builds a module specification with
-	`importlib.util.spec_from_file_location` [1], executes the loaded module with
-	`importlib.util.module_from_spec` [2], and returns the attribute selected by `identifier`.
+	`importlib.util.spec_from_file_location`, executes the loaded module with
+	`importlib.util.module_from_spec`, and returns the attribute selected by `identifier`.
 
 	Parameters
 	----------
@@ -166,13 +157,6 @@ def importPathFilename2Identifier(pathFilename: PathLike[Any] | PurePath, identi
 		Raised when the loader cannot read `pathFilename`.
 	AttributeError
 		Raised when the loaded module does not define `identifier`.
-
-	References
-	----------
-	[1] `importlib.util.spec_from_file_location`
-		https://docs.python.org/3/library/importlib.html#importlib.util.spec_from_file_location
-	[2] `importlib.util.module_from_spec`
-		https://docs.python.org/3/library/importlib.html#importlib.util.module_from_spec
 	"""
 	pathFilename = Path(pathFilename)
 
@@ -189,21 +173,14 @@ def makeDirectorySafely(pathFilename: Any) -> None:
 	"""Create parent directories for `pathFilename` when `pathFilename` is a filesystem path.
 
 	You can use this function to prepare an output location before a later write operation. This
-	function ignores `OSError` from `Path.mkdir` [1] and does nothing when `pathFilename` is an
-	`IOBase` [2] stream.
+	function ignores `OSError` from `Path.mkdir` and does nothing when `pathFilename` is an
+	`IOBase` stream.
 
 	Parameters
 	----------
 	pathFilename : Any
 		The target path or open stream. When `pathFilename` is not an `IOBase` instance, the
 		function creates the parent directory of `pathFilename`.
-
-	References
-	----------
-	[1] `pathlib.Path.mkdir`
-		https://docs.python.org/3/library/pathlib.html#pathlib.Path.mkdir
-	[2] `IOBase`
-		https://docs.python.org/3/library/io.html#io.IOBase
 	"""
 	if not isinstance(pathFilename, IOBase):
 		with contextlib.suppress(OSError):
@@ -296,7 +273,7 @@ def writeStringToHere(this: str, pathFilename: PathLike[Any] | PurePath | TextIO
 
 	You can use this function to send text to a filesystem path or an open text stream. This function
 	creates the parent directory when `pathFilename` is path-like, writes UTF-8 text with
-	`Path.write_text` [1], or writes and flushes a `TextIOBase` [2] stream.
+	`Path.write_text`, or writes and flushes a `TextIOBase` stream.
 
 	Parameters
 	----------
@@ -326,13 +303,6 @@ def writeStringToHere(this: str, pathFilename: PathLike[Any] | PurePath | TextIO
 		pathFilename.relative_to(pathTransformee)
 	)
 	```
-
-	References
-	----------
-	[1] `pathlib.Path.write_text`
-		https://docs.python.org/3/library/pathlib.html#pathlib.Path.write_text
-	[2] `TextIOBase`
-		https://docs.python.org/3/library/io.html#io.TextIOBase
 	"""
 	if isinstance(pathFilename, TextIOBase):
 		pathFilename.write(str(this))

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy/parseParameters.py

@@ -6,8 +6,8 @@
 You can use this module to convert integer-compatible inputs into lists of integers, calculate
 worker counts from absolute or fractional limits, and interpret strings as `True`, `False`, or
 `None`. Integer validation reports incompatible values with context about the caller's parameter.
-Worker-count calculation uses the system CPU count from `multiprocessing` [1] by default and also
-accepts numeric strings. Binary integer inputs use `charset_normalizer` [2] for text decoding.
+Worker-count calculation uses the system CPU count from `multiprocessing` by default and also
+accepts numeric strings. Binary integer inputs use `charset_normalizer` for text decoding.
 
 Contents
 --------
@@ -22,14 +22,6 @@ Functions
 Classes
 	ErrorMessageContext
 		Store value, type, and container information for integer-validation error messages.
-
-References
-----------
-[1] Python `multiprocessing`.
-	https://docs.python.org/3/library/multiprocessing.html
-[2] charset-normalizer.
-	https://github.com/Ousret/charset_normalizer
-
 """
 from __future__ import annotations
 
@@ -78,14 +70,14 @@ def defineConcurrencyLimit(*, limit: ConcurrencyLimit, cpuTotal: int = multiproc
 
 	String Parsing
 	--------------
-	This function first uses `oopsieKwargsie` [1] to interpret strings representing `True`, `False`,
+	This function first uses `oopsieKwargsie` to interpret strings representing `True`, `False`,
 	or `None`, ignoring capitalization and surrounding whitespace. Other strings are converted
 	with `float`. An invalid numeric string raises `ValueError` with the conversion error as the cause.
 
 	Processor Counts
 	----------------
 	This function rounds floating-point counts whose absolute value is at least one before applying
-	the count rules. Rounding uses Python `round` [2], including rounding ties to the nearest even
+	the count rules. Rounding uses Python `round`, including rounding ties to the nearest even
 	integer. This function applies the following rules before enforcing the platform bounds.
 
 	- `None`, `False`, or zero select `cpuTotal`.
@@ -96,7 +88,7 @@ def defineConcurrencyLimit(*, limit: ConcurrencyLimit, cpuTotal: int = multiproc
 	- A negative count of at most negative one reserves `abs(int(limit))` CPUs.
 
 	This function caps the result at 61 on Windows, matching the restriction for
-	`concurrent.futures.ProcessPoolExecutor` [3]. This function then enforces the minimum of one.
+	`concurrent.futures.ProcessPoolExecutor`. This function then enforces the minimum of one.
 
 	Parameters
 	----------
@@ -107,7 +99,7 @@ def defineConcurrencyLimit(*, limit: ConcurrencyLimit, cpuTotal: int = multiproc
 		Strings are also accepted at runtime, although the type annotation excludes strings.
 	cpuTotal : int = multiprocessing.cpu_count()
 		The CPU count used for fractional limits and reserved-CPU calculations. The default is the
-		value of `multiprocessing.cpu_count` [4] evaluated when this module is imported.
+		value of `multiprocessing.cpu_count` evaluated when this module is imported.
 
 	Returns
 	-------
@@ -129,17 +121,6 @@ def defineConcurrencyLimit(*, limit: ConcurrencyLimit, cpuTotal: int = multiproc
 
 		workers = defineConcurrencyLimit(limit=0.75)
 		```
-
-	References
-	----------
-	[1] `oopsieKwargsie`
-
-	[2] Python `round`.
-		https://docs.python.org/3/library/functions.html#round
-	[3] Python `concurrent.futures.ProcessPoolExecutor`.
-		https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.ProcessPoolExecutor
-	[4] Python `multiprocessing.cpu_count`.
-		https://docs.python.org/3/library/multiprocessing.html#multiprocessing.cpu_count
 	"""
 	if isinstance(limit, str):
 		limitFromString: bool | str | None = oopsieKwargsie(limit)
@@ -196,7 +177,6 @@ def _constructErrorMessage(context: ErrorMessageContext, parameterName: str, par
 	-------
 	errorMessage : str
 		The constructed error message string.
-
 	"""
 	messageParts: list[str] = ["I received "]
 

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy/semiotics.py

@@ -117,7 +117,7 @@ expects negative error indicators. The leetspeak encoding makes `errorL33T` imme
 in debugger output, log files, or printed state, reducing the risk of overlooking error conditions
 that might be missed with generic values like `-1`.
 
-In rare cases when code execution does not raise `Exception` [2] but produces incorrect output,
+In rare cases when code execution does not raise `Exception` but produces incorrect output,
 seeing `31212012` or `-31212012` in the output provides a stronger diagnostic signal than `-1` or
 other conventional error values. The distinctive value helps identify which variables hold error
 states without requiring careful inspection of every numeric field.
@@ -150,9 +150,6 @@ References
 ----------
 [1] Leet - Wikipedia
 	https://en.wikipedia.org/wiki/Leet
-[2] Built-in Exceptions - `Exception` (Python documentation)
-	https://docs.python.org/3/library/exceptions.html#Exception
-
 """
 
 inclusive: Final[int] = 1
@@ -323,6 +320,7 @@ References
 
 """
 
+# TODO Can I use Python's color system? It is shockingly similar in structure and even identifiers.
 #======== Some colors for printing text to the terminal. ========
 # Many values and options at https://gist.github.com/JBlond/2fea43a3049b38287e5e9cefc87b2124
 # Many, many, many options at https://stackoverflow.com/a/33206814/4403878

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hunterMakesPy
-Version: 0.8.1
+Version: 0.9.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
@@ -17,15 +17,15 @@ Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: Utilities
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: Z0Z_tools>=2.2.1
+Requires-Dist: Z0Z_tools>=4.0.0
 Requires-Dist: autoflake
 Requires-Dist: charset_normalizer
 Requires-Dist: isort
@@ -185,6 +185,11 @@ def test_my_integer_validator(test_name, test_func):
 ## My recovery
 
 [![Static Badge](https://img.shields.io/badge/2011_August-Homeless_since-blue?style=flat)](https://HunterThinks.com/support)
-[![YouTube Channel Subscribers](https://img.shields.io/youtube/channel/subscribers/UC3Gx7kz61009NbhpRtPP7tw)](https://www.youtube.com/@HunterHogan)
 
 [![CC-BY-NC-4.0](https://raw.githubusercontent.com/hunterhogan/hunterMakesPy/refs/heads/main/.github/CC-BY-NC-4.0.png)](https://creativecommons.org/licenses/by-nc/4.0/)
+
+By law, authors retain their copyrights unless they grant exceptions. The [Attribution-NonCommercial 4.0 International Deed](https://github.com/hunterhogan/hunterMakesPy#License-1-ov-file) outlines how you may use this work.
+
+The restriction on commercial use (without a license) limits advantage-taking, unjust enrichment, and exploitation. You would be morally wrong if you were to enrich yourself by using this work while I am denied healthcare, housing, security of property, and the safety of my person.
+
+To obtain and retain the right to use this work, you incur the cost of attributing the work to me. Your nominal cost might accrue as a benefit that mitigates my suffering or saves my life.

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/hunterMakesPy.egg-info/requires.txt

@@ -1,4 +1,4 @@
-Z0Z_tools>=2.2.1
+Z0Z_tools>=4.0.0
 autoflake
 charset_normalizer
 isort

{huntermakespy-0.8.1 → huntermakespy-0.9.0}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "hunterMakesPy"
-version = "0.8.1"
+version = "0.9.0"
 description = "Easy Python functions making making functional Python functions easier."
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 license = "CC-BY-NC-4.0"
 authors = [{ name = "Hunter Hogan", email = "HunterHogan@pm.me" }]
 keywords = [
@@ -20,14 +20,14 @@ classifiers = [
   "Natural Language :: English",
   "Operating System :: OS Independent",
   "Programming Language :: Python",
-  "Programming Language :: Python :: 3.11",
-  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.15",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: Utilities",
   "Typing :: Typed",
 ]
 dependencies = [
-  "Z0Z_tools>=2.2.1",
+  "Z0Z_tools>=4.0.0",
   "autoflake",
   "charset_normalizer",
   "isort",