mapFolding 0.17.1__py3-none-any.whl → 0.18.0__py3-none-any.whl

mapFolding/_e/pinIt.py

@@ -0,0 +1,436 @@
+"""Generalized pinning functions in the "Elimination" algorithm for any `mapShape`.
+
+Functions for 2^n-dimensional maps must go in other modules.
+
+The development of this generalized module is severely hampered, however. Functions for 2^n-dimensional maps have a "beans and
+cornbread" problem that was difficult for me to "solve"--due to my programming skills. If I were able to decouple the "beans and
+cornbread" solution from the 2^n-dimensional functions, I would generalize more functions and move them here.
+"""
+from collections.abc import Callable, Iterable, Iterator
+from cytoolz.dicttoolz import assoc as associate
+from cytoolz.functoolz import compose, curry as syntacticCurry
+from cytoolz.itertoolz import groupby as toolz_groupby
+from functools import partial
+from gmpy2 import bit_mask
+from hunterMakesPy import raiseIfNone
+from itertools import repeat
+from mapFolding import inclusive
+from mapFolding._e import (
+	DOTgetPileIfLeaf, DOTgetPileIfPileRangeOfLeaves, DOTvalues, Folding, getLeafDomain, getPileRange, Leaf,
+	PermutationSpace, Pile, PileRangeOfLeaves)
+from mapFolding._e.dataBaskets import EliminationState
+from mapFolding._e.filters import (
+	between, extractPinnedLeaves, leafIsInPileRange, leafIsNotPinned, leafIsPinned, leafIsPinnedAtPile, pileIsNotOpen,
+	pileIsOpen, thisIsALeaf)
+from more_itertools import flatten, ilen
+from operator import getitem
+
+#======== Boolean filters =======================
+
+@syntacticCurry
+def atPilePinLeafSafetyFilter(permutationSpace: PermutationSpace, pile: Pile, leaf: Leaf) -> bool:
+	"""Return `True` if it is safe to call `atPilePinLeaf(permutationSpace, pile, leaf)`.
+
+	For performance, you probably can and probably *should* create a set of filters for your circumstances.
+
+	Parameters
+	----------
+	permutationSpace : PermutationSpace
+		A mapping of each `pile` with a pinned `leaf`.
+	pile : int
+		`pile` at which to pin.
+	leaf : int
+		`leaf` to pin.
+
+	Returns
+	-------
+	isSafeToPin : bool
+		True if it is safe to pin `leaf` at `pile` in `permutationSpace`.
+	"""
+	return leafIsPinnedAtPile(permutationSpace, leaf, pile) or (pileIsOpen(permutationSpace, pile) and leafIsNotPinned(permutationSpace, leaf))
+
+@syntacticCurry
+def disqualifyAppendingLeafAtPile(state: EliminationState, leaf: Leaf) -> bool:
+	return any([state.pile not in getLeafDomain(state, leaf), leafIsPinned(state.permutationSpace, leaf), pileIsNotOpen(state.permutationSpace, state.pile)])
+
+#======== Group by =======================
+
+def _segregateLeafPinnedAtPile(listPermutationSpace: list[PermutationSpace], leaf: Leaf, pile: Pile) -> tuple[list[PermutationSpace], list[PermutationSpace]]:
+	"""Partition `listPermutationSpace` into (notPinned, isPinned) groups for `leaf` pinned at `pile`.
+
+	Parameters
+	----------
+	listPermutationSpace : list[PermutationSpace]
+		Collection of partial folding dictionaries.
+	leaf : int
+		`leaf` to test.
+	pile : int
+		`pile` index.
+
+	Returns
+	-------
+	segregatedLists : tuple[list[PermutationSpace], list[PermutationSpace]]
+		First element: dictionaries where `leaf` is NOT pinned at `pile`.
+		Second element: dictionaries where `leaf` IS pinned at `pile`.
+	"""
+	isPinned: Callable[[PermutationSpace], bool] = leafIsPinnedAtPile(leaf=leaf, pile=pile)
+	grouped: dict[bool, list[PermutationSpace]] = toolz_groupby(isPinned, listPermutationSpace)
+	return (grouped.get(False, []), grouped.get(True, []))
+
+def moveFoldingToListFolding(state: EliminationState) -> EliminationState:
+	listPermutationSpace: list[PermutationSpace] = state.listPermutationSpace.copy()
+	state.listPermutationSpace = []
+	for permutationSpace in listPermutationSpace:
+		if any(map(leafIsNotPinned(permutationSpace), range(state.leavesTotal))):
+			state.listPermutationSpace.append(permutationSpace)
+		else:
+			folding: Folding = makeFolding(permutationSpace, ())
+			state.listFolding.append(folding)
+	return state
+
+#======== Pin a `leaf` in a `PermutationSpace` or `Folding` =======================
+# NOTE This section ought to contain all functions based on the "Elimination" algorithm that pin a `leaf` in a `PermutationSpace` or `Folding`.
+
+@syntacticCurry
+def atPilePinLeaf(permutationSpace: PermutationSpace, pile: Pile, leaf: Leaf) -> PermutationSpace:
+	"""Return a new `PermutationSpace` with `leaf` pinned at `pile` without modifying `permutationSpace`.
+
+	Warning
+	-------
+	This function assumes either 1. `leaf` is not pinned and `pile` is open or 2. `leaf` is pinned at `pile`. Overwriting a
+	different `leaf` pinned at `pile` corrupts the permutation space.
+
+	Parameters
+	----------
+	permutationSpace : PermutationSpace
+		Dictionary of `pile` with pinned `leaf` or pile-range of leaves, if a `leaf` is pinned at `pile` or the pile-range of
+		leaves is defined.
+	pile : int
+		`pile` at which to pin `leaf`.
+	leaf : int
+		`leaf` to pin.
+
+	Returns
+	-------
+	dictionaryPermutationSpace : PermutationSpace
+		New dictionary with `pile` mapped to `leaf`.
+
+	See Also
+	--------
+	deconstructPermutationSpaceAtPile
+	"""
+	return associate(permutationSpace, pile, leaf)
+
+# TODO more flexible.
+def makeFolding(permutationSpace: PermutationSpace, leavesToInsert: tuple[Leaf, ...]) -> Folding:
+	if leavesToInsert:
+		permutand: Iterator[Leaf] = iter(leavesToInsert)
+		pilesTotal: int = ilen(filter(thisIsALeaf, DOTvalues(permutationSpace))) + len(leavesToInsert)
+		# pilesTotal: int = len(extractPinnedLeaves(permutationSpace)) + len(leavesToInsert)  # noqa: ERA001
+		folding: Folding = tuple([
+			leafOrLeafRange if (leafOrLeafRange := DOTgetPileIfLeaf(permutationSpace, pile)) else next(permutand)
+			for pile in range(pilesTotal)
+		])
+	else:
+		folding = tuple(DOTvalues(extractPinnedLeaves(permutationSpace)))
+	return folding
+
+#======== Deconstruct a `PermutationSpace` dictionary =======
+def deconstructPermutationSpaceAtPile(permutationSpace: PermutationSpace, pile: Pile, leavesToPin: Iterable[Leaf]) -> dict[Leaf, PermutationSpace]:
+	"""Deconstruct an open `pile` to the `leaf` range of `pile`.
+
+	Return a dictionary of `PermutationSpace` with either `permutationSpace` because it already has a `leaf` pinned at `pile` or one
+	`PermutationSpace` for each `leaf` in `leavesToPin` pinned at `pile`.
+
+	Parameters
+	----------
+	permutationSpace : PermutationSpace
+		Dictionary to divide and replace.
+	pile : int
+		`pile` at which to pin a `leaf`.
+	leavesToPin : list[int]
+		List of `leaves` to pin at `pile`.
+
+	Returns
+	-------
+	deconstructedPermutationSpace : dict[int, PermutationSpace]
+		Dictionary mapping from `leaf` pinned at `pile` to the `PermutationSpace` dictionary with the `leaf` pinned at `pile`.
+	"""
+	if (leaf := DOTgetPileIfLeaf(permutationSpace, pile)):
+		deconstructedPermutationSpace: dict[Leaf, PermutationSpace] = {leaf: permutationSpace}
+	else:
+		pin: Callable[[Leaf], PermutationSpace] = atPilePinLeaf(permutationSpace, pile)
+		leafCanBePinned: Callable[[Leaf], bool] = leafIsNotPinned(permutationSpace)
+		deconstructedPermutationSpace = {leaf: pin(leaf) for leaf in filter(leafCanBePinned, leavesToPin)}
+	return deconstructedPermutationSpace
+
+def deconstructPermutationSpaceByDomainOfLeaf(permutationSpace: PermutationSpace, leaf: Leaf, leafDomain: Iterable[Pile]) -> list[PermutationSpace]:
+	"""Pin `leaf` at each open `pile` in the domain of `leaf`.
+
+	Return a `list` of `PermutationSpace` with either `permutationSpace` because `leaf` is already pinned or one `PermutationSpace` for each
+	open `pile` in `leafDomain` with `leaf` pinned at `pile`.
+
+	Parameters
+	----------
+	permutationSpace : PermutationSpace
+		Dictionary to divide and replace.
+	leaf : int
+		`leaf` to pin.
+	leafDomain : Iterable[int]
+		Domain of `pile` indices for `leaf`.
+
+	Returns
+	-------
+	deconstructedPermutationSpace : list[PermutationSpace]
+		List of `PermutationSpace` dictionaries with `leaf` pinned at each open `pile` in `leafDomain`.
+	"""
+	if leafIsNotPinned(permutationSpace, leaf):
+		pileOpen: Callable[[int], bool] = pileIsOpen(permutationSpace)
+		leafInPileRange: Callable[[int], bool] = compose(leafIsInPileRange(leaf), partial(DOTgetPileIfPileRangeOfLeaves, permutationSpace, default=bit_mask(len(permutationSpace))))
+		pinLeafAt: Callable[[int], PermutationSpace] = atPilePinLeaf(permutationSpace, leaf=leaf)
+		deconstructedPermutationSpace: list[PermutationSpace] = list(map(pinLeafAt, filter(leafInPileRange, filter(pileOpen, leafDomain))))
+	else:
+		deconstructedPermutationSpace = [permutationSpace]
+	return deconstructedPermutationSpace
+
+def deconstructPermutationSpaceByDomainsCombined(permutationSpace: PermutationSpace, leaves: tuple[Leaf, ...], leavesDomain: Iterable[tuple[Pile, ...]]) -> list[PermutationSpace]:
+	"""Prototype."""
+	deconstructedPermutationSpace: list[PermutationSpace] = []
+
+	def pileOpenByIndex(index: int) -> Callable[[tuple[Pile, ...]], bool]:
+		def workhorse(domain: tuple[Pile, ...]) -> bool:
+			return pileIsOpen(permutationSpace, domain[index])
+		return workhorse
+
+	def leafInPileRangeByIndex(index: int) -> Callable[[tuple[Pile, ...]], bool]:
+		def workhorse(domain: tuple[Pile, ...]) -> bool:
+			pileRangeOfLeaves: PileRangeOfLeaves = raiseIfNone(DOTgetPileIfPileRangeOfLeaves(permutationSpace, domain[index], default=bit_mask(len(permutationSpace))))
+			return leafIsInPileRange(leaves[index], pileRangeOfLeaves)
+		return workhorse
+
+	def isPinnedAtPileByIndex(leaf: Leaf, index: int) -> Callable[[tuple[Pile, ...]], bool]:
+		def workhorse(domain: tuple[Pile, ...]) -> bool:
+			return leafIsPinnedAtPile(permutationSpace, leaf, domain[index])
+		return workhorse
+
+	if any(map(leafIsNotPinned(permutationSpace), leaves)):
+		for index in range(len(leaves)):
+			"""Redefine leavesDomain by filtering out domains that are not possible with the current `PermutationSpace`."""
+			if leafIsNotPinned(permutationSpace, leaves[index]):
+				"""`leaves[index]` is not pinned, so it needs a pile.
+				In each iteration of `leavesDomain`, `listOfPiles`, the pile it needs is `listOfPiles[index]`.
+				Therefore, if `listOfPiles[index]` is open, filter in the iteration. If `listOfPiles[index]` is occupied, filter out the iteration."""
+				leavesDomain = filter(pileOpenByIndex(index), leavesDomain)
+				"""`leaves[index]` is not pinned, it wants `listOfPiles[index]`, and `listOfPiles[index]` is open.
+				Is `leaves[index]` in the pile-range of `listOfPiles[index]`?"""
+				leavesDomain = filter(leafInPileRangeByIndex(index), leavesDomain)
+			else:
+				"""`leaves[index]` is pinned.
+				In each iteration of `leavesDomain`, `listOfPiles`, the pile in which `leaves[index]` is pinned must match `listOfPiles[index]`.
+				Therefore, if the pile in which `leaves[index]` is pinned matches `listOfPiles[index]`, filter in the iteration. Otherwise, filter out the iteration."""
+				leavesDomain = filter(isPinnedAtPileByIndex(leaves[index], index), leavesDomain)
+
+		for listOfPiles in leavesDomain:
+			"""Properly and safely deconstruct `permutationSpace` by the combined domain of leaves.
+			The parameter `leavesDomain` is the full domain of the leaves, so deconstructing with `leavesDomain` preserves the permutation space.
+			For each leaf in leaves, I filter out occupied piles, so I will not overwrite any pinned leaves--that would invalidate the permutation space.
+			I apply filters that prevent pinning the same leaf twice.
+			Therefore, for each domain in `leavesDomain`, I can safely pin `leaves[index]` at `listOfPiles[index]` without corrupting the permutation space."""
+			permutationSpaceForListOfPiles: PermutationSpace = permutationSpace.copy()
+			for index in range(len(leaves)):
+				permutationSpaceForListOfPiles = atPilePinLeaf(permutationSpaceForListOfPiles, listOfPiles[index], leaves[index])
+			deconstructedPermutationSpace.append(permutationSpaceForListOfPiles)
+	else:
+		deconstructedPermutationSpace = [permutationSpace]
+
+	return deconstructedPermutationSpace
+
+#======== Bulk modifications =======================
+
+def deconstructListPermutationSpaceAtPile(listPermutationSpace: Iterable[PermutationSpace], pile: Pile, leavesToPin: Iterable[Leaf]) -> Iterator[PermutationSpace]:
+	"""Expand every dictionary in `listPermutationSpace` at `pile` into all pinning variants.
+
+	Applies `deconstructPermutationSpaceAtPile` element-wise, then flattens the nested value collections (each a mapping leaf -> dictionary)
+	into a single list of dictionaries, discarding the intermediate keyed structure.
+
+	Parameters
+	----------
+	listPermutationSpace : Iterable[PermutationSpace]
+		Partial folding dictionaries.
+	pile : int
+		`pile` index to expand.
+	leavesToPin : Iterable[int]
+		`leaf` indices to pin at `pile`.
+
+	Returns
+	-------
+	listPermutationSpace : Iterator[PermutationSpace]
+		Flat iterator of expanded dictionaries covering all possible `leaf` assignments at `pile`.
+
+	See Also
+	--------
+	deconstructPermutationSpaceAtPile
+	"""
+	return  flatten(map(DOTvalues, map(deconstructPermutationSpaceAtPile, listPermutationSpace, repeat(pile), repeat(leavesToPin))))
+
+def excludeLeaf_rBeforeLeaf_kAtPile_k(state: EliminationState, leaf_k: Leaf, leaf_r: Leaf, pile_k: Pile, domain_r: Iterable[Pile] | None = None, rangePile_k: Iterable[Leaf] | None = None) -> EliminationState:
+	"""Exclude `leaf_r` from appearing before `leaf_k` at `pile_k`.
+
+	Parameters
+	----------
+	state : EliminationState
+		Mutable elimination state (provides `leavesTotal`, `pileLast`).
+	leaf_k : int
+		Reference leaf index derived from `productOfDimensions` for a dimension.
+	leaf_r : int
+		Leaf that must not appear before `leaf_k` (also dimension-derived).
+	pile_k : int
+		Pile index currently under consideration for leaf `leaf_k`.
+	domain_r : Iterable[int] | None = None
+		Optional domain of piles for leaf `leaf_r`. If `None`, the full domain from `state` is used.
+	rangePile_k : Iterable[int] | None = None
+		Optional range of leaves for pile `pile_k`. If `None`, the full range from `state` is used.
+
+	Returns
+	-------
+	state : EliminationState
+		Same state instance, mutated with updated `listPermutationSpace`.
+
+	See Also
+	--------
+	excludeLeafRBeforeLeafK, theorem4, theorem2b
+	"""
+	iterator_kPinnedAt_pile_k: Iterable[PermutationSpace] = []
+	iterable_pile_kOccupied: Iterable[PermutationSpace] = []
+	listPermutationSpace: list[PermutationSpace] = []
+	listPermutationSpaceCompleted: list[PermutationSpace] = []
+
+	pile_kIsOpen: Callable[[PermutationSpace], bool] = pileIsOpen(pile=pile_k)
+	kIsNotPinned: Callable[[PermutationSpace], bool] = leafIsNotPinned(leaf=leaf_k)
+	def notLeaf_r(comparand: Leaf, r: Leaf = leaf_r) -> bool:
+		return comparand != r
+
+	listPermutationSpace, iterator_kPinnedAt_pile_k = _segregateLeafPinnedAtPile(state.listPermutationSpace, leaf_k, pile_k)
+	state.listPermutationSpace = []
+
+	grouped: dict[bool, list[PermutationSpace]] = toolz_groupby(kIsNotPinned, listPermutationSpace)
+	listPermutationSpaceCompleted, listPermutationSpace = grouped.get(False, []), grouped.get(True, [])
+	grouped = toolz_groupby(pile_kIsOpen, listPermutationSpace)
+	iterable_pile_kOccupied, listPermutationSpace = grouped.get(False, []), grouped.get(True, [])
+	listPermutationSpaceCompleted.extend(iterable_pile_kOccupied)
+
+	if domain_r is None:
+		domain_r = getLeafDomain(state, leaf_r)
+
+	domain_r = filter(between(0, pile_k - inclusive), domain_r)
+
+	if rangePile_k is None:
+		rangePile_k = getPileRange(state, pile_k)
+
+	rangePile_k = frozenset(rangePile_k)
+
+	if leaf_k in rangePile_k:
+		for permutationSpace_kPinnedAt_pile_k, iterable_pile_kOccupied in segregateLeafByDeconstructingListPermutationSpaceAtPile(listPermutationSpace, leaf_k, pile_k, rangePile_k):
+			listPermutationSpaceCompleted.extend(iterable_pile_kOccupied)
+			iterator_kPinnedAt_pile_k.append(permutationSpace_kPinnedAt_pile_k)
+	else:
+		listPermutationSpaceCompleted.extend(listPermutationSpace)
+
+	for pile_r in domain_r:
+		iterator_kPinnedAt_pile_k = excludeLeafAtPile(iterator_kPinnedAt_pile_k, leaf_r, pile_r, tuple(filter(notLeaf_r, getPileRange(state, pile_r))))
+
+	state.listPermutationSpace.extend(listPermutationSpaceCompleted)
+	state.listPermutationSpace.extend(iterator_kPinnedAt_pile_k)
+
+	return state
+
+def excludeLeaf_rBeforeLeaf_k(state: EliminationState, leaf_k: Leaf, leaf_r: Leaf, domain_k: Iterable[Pile] | None = None, domain_r: Iterable[Pile] | None = None) -> EliminationState:
+	"""Exclude `leaf_r` from appearing before `leaf_k` in every `pile` in the domain of `leaf_k`.
+
+	Parameters
+	----------
+	state : EliminationState
+		Data basket, state of the local context, and state of the global context.
+	leaf_k : int
+		`leaf` that must be in a `pile` preceding the `pile` of `leaf_r`.
+	leaf_r : int
+		`leaf` that must be in a `pile` succeeding the `pile` of `leaf_k`.
+	domain_k : Iterable[int] | None = None
+		The domain of each `pile` at which `leaf_k` can be pinned. If `None`, every `pile` is in the domain.
+	domain_r : Iterable[int] | None = None
+		The domain of each `pile` at which `leaf_r` can be pinned. If `None`, every `pile` is in the domain.
+
+	Returns
+	-------
+	EliminationState
+		Same state instance, mutated with updated `listPermutationSpace`.
+
+	See Also
+	--------
+	_excludeLeafRBeforeLeafK, theorem4, theorem2b
+	"""
+	if domain_k is None:
+		domain_k = getLeafDomain(state, leaf_k)
+	for pile_k in reversed(tuple(domain_k)):
+		state = excludeLeaf_rBeforeLeaf_kAtPile_k(state, leaf_k, leaf_r, pile_k, domain_r=domain_r)
+	return state
+
+def excludeLeafAtPile(listPermutationSpace: Iterable[PermutationSpace], leaf: Leaf, pile: Pile, leavesToPin: Iterable[Leaf]) -> Iterator[PermutationSpace]:
+	"""Return a new list of pinned-leaves dictionaries that forbid `leaf` at `pile`.
+
+	Parameters
+	----------
+	listPermutationSpace : Iterable[PermutationSpace]
+		Collection of partial pinning dictionaries to transform.
+	leaf : int
+		`leaf` to exclude from `pile`.
+	pile : int
+		`pile` at which `leaf` must not be fixed.
+	leavesToPin : Iterable[int]
+		List of leaves available for pinning at `pile`. Don't include `leaf`.
+
+	Returns
+	-------
+	listPermutationSpace : Iterable[PermutationSpace]
+		Expanded / filtered list respecting the exclusion constraint.
+
+	See Also
+	--------
+	deconstructPermutationSpaceAtPile : Performs the expansion for one dictionary.
+	requireLeafPinnedAtPile : Complementary operation that forces a `leaf` at a `pile`.
+	"""
+	return deconstructListPermutationSpaceAtPile(getitem(_segregateLeafPinnedAtPile(list(listPermutationSpace), leaf, pile), 0), pile, leavesToPin)
+
+def requireLeafPinnedAtPile(listPermutationSpace: list[PermutationSpace], leaf: Leaf, pile: Pile) -> list[PermutationSpace]:
+	"""In every `PermutationSpace` dictionary, ensure `leaf`, and *only* `leaf`, is pinned at `pile`: excluding every other `leaf` at `pile`.
+
+	Parameters
+	----------
+	listPermutationSpace : list[PermutationSpace]
+		Collection of partial pinning dictionaries to transform.
+	leaf : int
+		`leaf` required at `pile`.
+	pile : int
+		`pile` at which to pin the leaf.
+
+	Returns
+	-------
+	listLeafAtPile : list[PermutationSpace]
+		`list` of `PermutationSpace` dictionaries with `leaf` pinned at `pile`.
+
+	See Also
+	--------
+	deconstructPermutationSpaceAtPile, excludeLeafAtPile
+	"""
+	listPermutationSpace, listLeafAtPile = _segregateLeafPinnedAtPile(listPermutationSpace, leaf, pile)
+	listLeafAtPile.extend(map(atPilePinLeaf(pile=pile, leaf=leaf), filter(pileIsOpen(pile=pile), filter(leafIsNotPinned(leaf=leaf), listPermutationSpace))))
+	return listLeafAtPile
+
+def segregateLeafByDeconstructingListPermutationSpaceAtPile(listPermutationSpace: Iterable[PermutationSpace], leaf: Leaf, pile: Pile, leavesToPin: Iterable[Leaf]) -> Iterator[tuple[PermutationSpace, tuple[PermutationSpace, ...]]]:
+	for permutationSpace in listPermutationSpace:
+		deconstructedPermutationSpaceAtPile: dict[Leaf, PermutationSpace] = deconstructPermutationSpaceAtPile(permutationSpace, pile, leavesToPin)
+		leafPinnedAtPile: PermutationSpace = deconstructedPermutationSpaceAtPile.pop(leaf)
+		yield (leafPinnedAtPile, tuple(deconstructedPermutationSpaceAtPile.values()))
+
+
+

mapFolding/_semiotics.py

@@ -0,0 +1,42 @@
+from typing import NamedTuple
+
+#======== Semantic replacements for ambiguous values =======
+
+decreasing: int = -1
+"""Adjust the value due to Python syntax."""
+inclusive: int = 1
+"""Include the last value in a `range`: change from [p, q) to [p, q]."""
+zeroIndexed: int = 1
+"""Adjust the value due to Python syntax."""
+
+#-------- Some color for printing text to the terminal -------
+# Many values and options at https://gist.github.com/JBlond/2fea43a3049b38287e5e9cefc87b2124
+# Many, many, many at https://stackoverflow.com/a/33206814/4403878
+# NOTE Always define color and background color at the same time.
+
+ansiColorReset: str = '\x1b[0m'
+
+class AnsiColors(NamedTuple):
+	BlackOnCyan: str = '\x1b[30;46m'
+	BlackOnMagenta: str = '\x1b[30;45m'
+	BlackOnWhite: str = '\x1b[30;47m'
+	BlackOnYellow: str = '\x1b[30;43m'
+	BlueOnWhite: str = '\x1b[34;47m'
+	BlueOnYellow: str = '\x1b[34;43m'
+	CyanOnBlack: str = '\x1b[36;40m'
+	CyanOnBlue: str = '\x1b[36;44m'
+	CyanOnMagenta: str = '\x1b[36;45m'
+	GreenOnBlack: str = '\x1b[32;40m'
+	MagentaOnBlack: str = '\x1b[35;40m'
+	MagentaOnBlue: str = '\x1b[35;44m'
+	MagentaOnCyan: str = '\x1b[35;46m'
+	RedOnWhite: str = '\x1b[31;47m'
+	WhiteOnBlack: str = '\x1b[37;40m'
+	WhiteOnBlue: str = '\x1b[37;44m'
+	WhiteOnMagenta: str = '\x1b[37;45m'
+	WhiteOnRed: str = '\x1b[37;41m'
+	YellowOnBlack: str = '\x1b[33;40m'
+	YellowOnBlue: str = '\x1b[33;44m'
+	YellowOnRed: str = '\x1b[33;41m'
+
+ansiColors = AnsiColors()

mapFolding/_theSSOT.py

@@ -1,10 +1,10 @@
 """Access and configure package settings and metadata."""
 
 from hunterMakesPy import PackageSettings
-from mapFolding._theTypes import MetadataOEISidManuallySet, MetadataOEISidMapFoldingManuallySet
+from mapFolding import MetadataOEISidManuallySet, MetadataOEISidMapFoldingManuallySet
+from more_itertools import loops
 from pathlib import Path
 import dataclasses
-import random
 
 @dataclasses.dataclass
 class mapFoldingPackageSettings(PackageSettings):
@@ -42,45 +42,14 @@ class mapFoldingPackageSettings(PackageSettings):
 
 	concurrencyPackage: str = 'multiprocessing'
 	"""Package identifier for concurrent execution operations."""
-# ruff: noqa: S311
 # TODO I made this a `TypedDict` before I knew how to make dataclasses and classes. Think about other data structures.
 OEISidMapFoldingManuallySet: dict[str, MetadataOEISidMapFoldingManuallySet] = {
-	'A000136': {
-		'getMapShape': lambda n: (1, n),
-		'valuesBenchmark': [14],
-		'valuesTestParallelization': [random.randint(3, 7)],
-		'valuesTestValidation': [random.randint(2, 9)],
-	},
-	'A001415': {
-		'getMapShape': lambda n: (2, n),
-		'valuesBenchmark': [14],
-		'valuesTestParallelization': [random.randint(3, 7)],
-		'valuesTestValidation': [random.randint(2, 9)],
-	},
-	'A001416': {
-		'getMapShape': lambda n: (3, n),
-		'valuesBenchmark': [9],
-		'valuesTestParallelization': [random.randint(3, 5)],
-		'valuesTestValidation': [random.randint(2, 6)],
-	},
-	'A001417': {
-		'getMapShape': lambda n: tuple(2 for _dimension in range(n)),
-		'valuesBenchmark': [6],
-		'valuesTestParallelization': [random.randint(2, 4)],
-		'valuesTestValidation': [random.randint(2, 4)],
-	},
-	'A195646': {
-		'getMapShape': lambda n: tuple(3 for _dimension in range(n)),
-		'valuesBenchmark': [3],
-		'valuesTestParallelization': [2],
-		'valuesTestValidation': [2],
-	},
-	'A001418': {
-		'getMapShape': lambda n: (n, n),
-		'valuesBenchmark': [5],
-		'valuesTestParallelization': [*range(2, 4)],
-		'valuesTestValidation': [random.randint(2, 4)],
-	},
+	'A000136': {'getMapShape': lambda n: (1, n)},
+	'A001415': {'getMapShape': lambda n: (2, n)},
+	'A001416': {'getMapShape': lambda n: (3, n)},
+	'A001417': {'getMapShape': lambda n: tuple(2 for _dimension in loops(n))},
+	'A195646': {'getMapShape': lambda n: tuple(3 for _dimension in loops(n))},
+	'A001418': {'getMapShape': lambda n: (n, n)},
 }
 
 identifierPackageFALLBACK = "mapFolding"
@@ -89,23 +58,9 @@ identifierPackageFALLBACK = "mapFolding"
 packageSettings = mapFoldingPackageSettings(identifierPackageFALLBACK=identifierPackageFALLBACK, OEISidMapFoldingManuallySet=OEISidMapFoldingManuallySet)
 """Global package settings."""
 
-OEISidManuallySet: dict[str, MetadataOEISidManuallySet] = {
-	'A000560': {'valuesTestValidation': [random.randint(3, 12)]},
-	'A000682': {'valuesTestValidation': [random.randint(3, 12), 32]},
-	'A001010': {'valuesTestValidation': [3, 4, random.randint(5, 11)]},
-	'A001011': {'valuesTestValidation': [3, 4, random.randint(5, 7)]},
-	'A005315': {'valuesTestValidation': [random.randint(3, 9)]},
-	'A005316': {'valuesTestValidation': [random.randint(3, 13)]},
-	'A007822': {'valuesTestValidation': [random.randint(2, 8)]}, #, 'valuesBenchmark': [7], 'valuesTestParallelization': [*range(2, 4)]},
-	'A060206': {'valuesTestValidation': [random.randint(3, 9)]},
-	'A077460': {'valuesTestValidation': [3, 4, random.randint(5, 8)]},
-	'A078591': {'valuesTestValidation': [random.randint(3, 10)]},
-	'A086345': {'valuesTestValidation': [random.randint(3, 10), random.randint(11, 20), random.randint(21, 30), random.randint(31, 40)]},
-	'A178961': {'valuesTestValidation': [random.randint(3, 11)]},
-	'A223094': {'valuesTestValidation': [random.randint(3, 11)]},
-	'A259702': {'valuesTestValidation': [random.randint(3, 13)]},
-	'A301620': {'valuesTestValidation': [random.randint(3, 11)]},
-}
+OEISidManuallySet: dict[str, MetadataOEISidManuallySet] = {'A000560': {}, 'A000682': {}, 'A001010': {}, 'A001011': {},
+	'A005315': {}, 'A005316': {}, 'A007822': {}, 'A060206': {}, 'A077460': {}, 'A078591': {},
+	'A086345': {}, 'A178961': {}, 'A223094': {}, 'A259702': {}, 'A301620': {}}
 
 # Recreate packageSettings with meanders settings included
 packageSettings = mapFoldingPackageSettings(