PyPI - stouputils - Versions diffs - 1.18.5__tar.gz → 1.19.0__tar.gz - Mend

stouputils 1.18.5tar.gz → 1.19.0tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (161) hide show

{stouputils-1.18.5 → stouputils-1.19.0}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: stouputils
-Version: 1.18.5
+Version: 1.19.0
 Summary: Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more.
 Keywords: utilities,tools,helpers,development,python
 Author: Stoupy51
@@ -26,7 +26,6 @@ Requires-Dist: tensorflow ; extra == 'data-science'
 Requires-Dist: scikit-learn ; extra == 'data-science'
 Requires-Dist: pywavelets ; extra == 'data-science'
 Requires-Dist: mypy ; extra == 'docs'
-Requires-Dist: m2r2 ; extra == 'docs'
 Requires-Dist: myst-parser ; extra == 'docs'
 Requires-Dist: sphinx-copybutton ; extra == 'docs'
 Requires-Dist: sphinx-design ; extra == 'docs'
@@ -54,9 +53,11 @@ Stouputils is a collection of utility modules designed to simplify and enhance t
 It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers.<br>
 Start now by installing the package: `pip install stouputils`.<br>
-<a href="https://colab.research.google.com/drive/1mJ-KL-zXzIk1oKDxO6FC1SFfm-BVKG-P?usp=sharing" target="_blank" rel="noopener noreferrer" style="text-decoration: none;"><div class="admonition">
+<a href="https://colab.research.google.com/drive/1mJ-KL-zXzIk1oKDxO6FC1SFfm-BVKG-P?usp=sharing" target="_blank" rel="noopener noreferrer" style="text-decoration: none;">
+<div class="admonition" style="padding-bottom: 1rem;">
 📖 <b>Want to see examples?</b> Check out our <u>Google Colab notebook</u> with practical usage examples!
-</div></a>
+</div>
+</a>
 ## 🚀 Project File Tree
 <html>

{stouputils-1.18.5 → stouputils-1.19.0}/README.md RENAMED Viewed

@@ -9,9 +9,11 @@ Stouputils is a collection of utility modules designed to simplify and enhance t
 It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers.<br>
 Start now by installing the package: `pip install stouputils`.<br>
-<a href="https://colab.research.google.com/drive/1mJ-KL-zXzIk1oKDxO6FC1SFfm-BVKG-P?usp=sharing" target="_blank" rel="noopener noreferrer" style="text-decoration: none;"><div class="admonition">
+<a href="https://colab.research.google.com/drive/1mJ-KL-zXzIk1oKDxO6FC1SFfm-BVKG-P?usp=sharing" target="_blank" rel="noopener noreferrer" style="text-decoration: none;">
+<div class="admonition" style="padding-bottom: 1rem;">
 📖 <b>Want to see examples?</b> Check out our <u>Google Colab notebook</u> with practical usage examples!
-</div></a>
+</div>
+</a>
 ## 🚀 Project File Tree
 <html>

{stouputils-1.18.5 → stouputils-1.19.0}/pyproject.toml RENAMED Viewed

@@ -8,7 +8,7 @@ module-root = ""
 [project]
 name = "stouputils"
-version = "1.18.5"
+version = "1.19.0"
 description = "Stouputils is a collection of utility modules designed to simplify and enhance the development process. It includes a range of tools for tasks such as execution of doctests, display utilities, decorators, as well as context managers, and many more."
 readme = "README.md"
 keywords = ["utilities", "tools", "helpers", "development", "python"]
@@ -37,7 +37,6 @@ authors = [
 [project.optional-dependencies]
 docs = [
     "mypy",
-    "m2r2",
     "myst_parser",
     "sphinx_copybutton",
     "sphinx_design",

{stouputils-1.18.5 → stouputils-1.19.0}/stouputils/all_doctests.py RENAMED Viewed

@@ -94,15 +94,22 @@ def launch_tests(root_dir: str, strict: bool = True, pattern: str = "*") -> int:
 	if not modules_file_paths:
 		raise ValueError(f"No modules found in '{relative_path(root_dir)}'")
+	# Sort module by number of submodules and alphabetically
+	modules_file_paths.sort(key=lambda x: (x.count('.'), x))
 	# Filter modules based on pattern
 	if pattern != "*":
 		import fnmatch
-		modules_file_paths = [
+		new_paths: list[str] = [
 			path for path in modules_file_paths
 			if fnmatch.fnmatch(path, pattern)
 		]
-		if not modules_file_paths:
-			raise ValueError(f"No modules matching pattern '{pattern}' found in '{relative_path(root_dir)}'")
+		if not new_paths:
+			raise ValueError(
+				f"No modules matching pattern '{pattern}' found in '{relative_path(root_dir)}'.\n"
+				f"Candidates were: {', '.join(relative_path(p) for p in modules_file_paths)[:500]}..."
+			)
+		modules_file_paths = new_paths
 	# Find longest module path for alignment
 	max_length: int = max(len(path) for path in modules_file_paths)

{stouputils-1.18.5 → stouputils-1.19.0}/stouputils/applications/automatic_docs.py RENAMED Viewed

@@ -68,8 +68,6 @@ Example of GitHub Actions workflow:
 # Imports
 import os
 import shutil
-import subprocess
-import sys
 from collections.abc import Callable
 from typing import Any
@@ -79,7 +77,7 @@ from ..io import clean_path, json_dump, super_open
 from ..print import info
 # Constants
-REQUIREMENTS: list[str] = ["m2r2", "myst_parser"]
+REQUIREMENTS: list[str] = ["myst_parser"]
 """ List of requirements for automatic_docs to work. """
 # Functions
@@ -185,6 +183,12 @@ copybutton_selector = ":not(.prompt) > div.highlight pre"
 templates_path: list[str] = ["_templates"]
 exclude_patterns: list[str] = []
+# Allow both .rst and .md (MyST) sources
+source_suffix = {{
+    ".rst": "restructuredtext",
+    ".md": "markdown",
+}}
 # HTML output options
 html_theme: str = "{html_theme}"
 html_static_path: list[str] = ["_static"]
@@ -205,7 +209,6 @@ html_theme_options: dict[str, Any] = {{
 		"github_repo": github_repo,
 		"github_version": "main",
 		"conf_py_path": "/docs/source/",
-		"source_suffix": [".rst", ".md"],
 		"default_mode": "dark",
 	}
@@ -318,23 +321,7 @@ def get_versions_from_github(github_user: str, github_repo: str, recent_minor_ve
 		version_list = ["latest"]
 	return version_list
-def markdown_to_rst(markdown_content: str) -> str:
-	""" Convert markdown content to RST format.
-	Args:
-		markdown_content (str): Markdown content
-	Returns:
-		str: RST content
-	"""
-	if not markdown_content:
-		return ""
-	# Convert markdown to RST and return it
-	import m2r2  # type: ignore
-	return m2r2.convert(markdown_content)	# type: ignore
-def generate_index_rst(
+def generate_index_md(
 	readme_path: str,
 	index_path: str,
 	project: str,
@@ -343,11 +330,14 @@ def generate_index_rst(
 	get_versions_function: Callable[[str, str, int], list[str]] = get_versions_from_github,
 	recent_minor_versions: int = 2,
 ) -> None:
-	""" Generate index.rst from README.md content.
+	""" Generate `index.md` (MyST) from README.md content.
+	This keeps the README content as Markdown (no conversion) and uses the MyST
+	`toctree` directive to include module docs.
 	Args:
 		readme_path            (str): Path to the README.md file
-		index_path             (str): Path where index.rst should be created
+		index_path             (str): Path where index.md should be created
 		project                (str): Name of the project
 		github_user            (str): GitHub username
 		github_repo            (str): GitHub repository name
@@ -358,50 +348,44 @@ def generate_index_rst(
 	with open(readme_path, encoding="utf-8") as f:
 		readme_content: str = f.read()
-	# Generate version selector
-	version_selector: str = "\n\n**Versions**: "
-	# Get versions from GitHub
+	# Generate version selector (markdown links)
 	version_list: list[str] = get_versions_function(github_user, github_repo, recent_minor_versions)
-	# Create version links
 	version_links: list[str] = []
 	for version in version_list:
 		if version == "latest":
-			version_links.append("`latest <../latest/>`_")
+			version_links.append("[latest](../latest/)")
 		else:
-			version_links.append(f"`v{version} <../v{version}/>`_")
-	version_selector += ", ".join(version_links)
+			version_links.append(f"[v{version}](../v{version}/)")
+	version_selector: str = "\n\n**Versions**: " + ", ".join(version_links)
-	# Generate module documentation section
+	# Module documentation toctree (MyST)
 	project_module: str = project.lower()
 	module_docs: str = f"""
-.. toctree::
-   :maxdepth: 10
+```{{toctree}}
+:maxdepth: 10
-   modules/{project_module}
+modules/{project_module}
+```
 """
-	module_docs = markdown_to_rst(f"""
-Here is the complete unsorted documentation for all modules in the {project} project.<br>
-Prefer to use the search button at the top to find what you need!
-""") + module_docs
-	# Convert markdown to RST
-	rst_content: str = f"""
-✨ Welcome to {project.capitalize()} Documentation ✨
-{'=' * 100}
+	# Build final markdown content
+	md_content: str = f"""
+# ✨ Welcome to {project.capitalize()} Documentation ✨
 {version_selector}
-{markdown_to_rst(readme_content)}
+{readme_content}
+---
+## Module Documentation
-📖 Module Documentation
-{'-' * 100}
 {module_docs}
 """
-	# Write the RST file
+	# Write the Markdown file
 	with open(index_path, "w", encoding="utf-8") as f:
-		f.write(rst_content)
+		f.write(md_content)
 def generate_documentation(
 	source_dir: str,
@@ -418,9 +402,8 @@ def generate_documentation(
 		build_dir         (str): Build directory
 	"""
 	# Generate module documentation using sphinx-apidoc
-	subprocess.run([
-		sys.executable,
-		"-m", "sphinx.ext.apidoc",
+	from sphinx.ext.apidoc import main as sphinx_apidoc_main
+	sphinx_apidoc_main([
 		"-o", modules_dir,
 		"-f", "-e", "-M",
 		"--no-toc",
@@ -428,17 +411,16 @@ def generate_documentation(
 		"--implicit-namespaces",
 		"--module-first",
 		project_dir,
-	], check=True)
+	])
 	# Build HTML documentation
-	subprocess.run([
-		sys.executable,
-		"-m", "sphinx",
+	from sphinx.cmd.build import main as sphinx_build_main
+	sphinx_build_main([
 		"-b", "html",
 		"-a",
 		source_dir,
 		build_dir,
-	], check=True)
+	])
 def generate_redirect_html(filepath: str) -> None:
 	""" Generate HTML content for redirect page.
@@ -478,7 +460,7 @@ def update_documentation(
 	recent_minor_versions: int = 2,
 	get_versions_function: Callable[[str, str, int], list[str]] = get_versions_from_github,
-	generate_index_function: Callable[..., None] = generate_index_rst,
+	generate_index_function: Callable[..., None] = generate_index_md,
 	generate_docs_function: Callable[..., None] = generate_documentation,
 	generate_redirect_function: Callable[[str], None] = generate_redirect_html,
 	get_conf_content_function: Callable[..., str] = get_sphinx_conf_content
@@ -501,7 +483,7 @@ def update_documentation(
 		recent_minor_versions      (int): Number of recent minor versions to show all patches for. Defaults to 2
 		get_versions_function      (Callable[[str, str, int], list[str]]): Function to get versions from GitHub
-		generate_index_function    (Callable[..., None]): Function to generate index.rst
+		generate_index_function    (Callable[..., None]): Function to generate index.md
 		generate_docs_function     (Callable[..., None]): Function to generate documentation
 		generate_redirect_function (Callable[[str], None]): Function to create redirect file
 		get_conf_content_function  (Callable[..., str]): Function to get Sphinx conf.py content
@@ -573,9 +555,9 @@ a:hover {
 }
 """)
-	# Generate index.rst from README.md
+	# Generate index.md from README.md (use MyST instead of converting to RST)
 	readme_path: str = f"{root_path}/README.md"
-	index_path: str = f"{source_dir}/index.rst"
+	index_path: str = f"{source_dir}/index.md"
 	generate_index_function(
 		readme_path=readme_path,
 		index_path=index_path,

{stouputils-1.18.5 → stouputils-1.19.0}/stouputils/applications/automatic_docs.pyi RENAMED Viewed

@@ -44,21 +44,15 @@ def get_versions_from_github(github_user: str, github_repo: str, recent_minor_ve
 \tReturns:
 \t\tlist[str]: List of versions, with 'latest' as first element
 \t"""
-def markdown_to_rst(markdown_content: str) -> str:
-    """ Convert markdown content to RST format.
+def generate_index_md(readme_path: str, index_path: str, project: str, github_user: str, github_repo: str, get_versions_function: Callable[[str, str, int], list[str]] = ..., recent_minor_versions: int = 2) -> None:
+    """ Generate `index.md` (MyST) from README.md content.
-\tArgs:
-\t\tmarkdown_content (str): Markdown content
-\tReturns:
-\t\tstr: RST content
-\t"""
-def generate_index_rst(readme_path: str, index_path: str, project: str, github_user: str, github_repo: str, get_versions_function: Callable[[str, str, int], list[str]] = ..., recent_minor_versions: int = 2) -> None:
-    """ Generate index.rst from README.md content.
+\tThis keeps the README content as Markdown (no conversion) and uses the MyST
+\t`toctree` directive to include module docs.
 \tArgs:
 \t\treadme_path            (str): Path to the README.md file
-\t\tindex_path             (str): Path where index.rst should be created
+\t\tindex_path             (str): Path where index.md should be created
 \t\tproject                (str): Name of the project
 \t\tgithub_user            (str): GitHub username
 \t\tgithub_repo            (str): GitHub repository name
@@ -99,7 +93,7 @@ def update_documentation(root_path: str, project: str, project_dir: str = '', au
 \t\trecent_minor_versions      (int): Number of recent minor versions to show all patches for. Defaults to 2
 \t\tget_versions_function      (Callable[[str, str, int], list[str]]): Function to get versions from GitHub
-\t\tgenerate_index_function    (Callable[..., None]): Function to generate index.rst
+\t\tgenerate_index_function    (Callable[..., None]): Function to generate index.md
 \t\tgenerate_docs_function     (Callable[..., None]): Function to generate documentation
 \t\tgenerate_redirect_function (Callable[[str], None]): Function to create redirect file
 \t\tget_conf_content_function  (Callable[..., str]): Function to get Sphinx conf.py content

{stouputils-1.18.5 → stouputils-1.19.0}/stouputils/print.py RENAMED Viewed

@@ -107,45 +107,67 @@ def format_colored(*values: Any) -> str:
 	Examples:
 		>>> # Test function names with parentheses
 		>>> result = format_colored("Call print() with 42 items")
-		>>> result.count(MAGENTA) == 2  # print and 42
-		True
+		>>> result.count(MAGENTA)  # print and 42
+		2
 		>>> # Test function names without parentheses
 		>>> result = format_colored("Use len and sum functions")
-		>>> result.count(MAGENTA) == 2  # len and sum
-		True
+		>>> result.count(MAGENTA)  # len and sum
+		2
 		>>> # Test exceptions (bold magenta)
 		>>> result = format_colored("Got ValueError when parsing")
-		>>> result.count(MAGENTA) == 1 and result.count(BOLD) == 1  # ValueError in bold magenta
-		True
+		>>> result.count(MAGENTA), result.count(BOLD)  # ValueError in bold magenta
+		(1, 1)
 		>>> # Test file paths
 		>>> result = format_colored("Processing ./data.csv file")
-		>>> result.count(MAGENTA) == 1  # ./data.csv
-		True
+		>>> result.count(MAGENTA)  # ./data.csv
+		1
 		>>> # Test file paths with quotes
 		>>> result = format_colored('File "/path/to/script.py" line 42')
-		>>> result.count(MAGENTA) == 2  # /path/to/script.py and 42
-		True
+		>>> result.count(MAGENTA)  # /path/to/script.py and 42
+		2
 		>>> # Test numbers
-		>>> result = format_colored("Found 100 items and 3.14 value")
-		>>> result.count(MAGENTA) == 2  # 100 and 3.14
-		True
+		>>> result = format_colored("Found 100 items and 3.14 value, 3.0e+10 is big")
+		>>> result.count(MAGENTA)  # 100 and 3.14
+		3
 		>>> # Test mixed content
 		>>> result = format_colored("Call sum() got IndexError at line 256 in utils.py")
-		>>> result.count(MAGENTA) == 3  # sum, IndexError (bold), and 256
-		True
-		>>> result.count(BOLD) == 1  # IndexError is bold
-		True
+		>>> result.count(MAGENTA)  # sum, IndexError (bold), and 256
+		3
+		>>> result.count(BOLD)  # IndexError is bold
+		1
+		>>> # Test keywords always colored
+		>>> result = format_colored("Check class dtype type")
+		>>> result.count(MAGENTA)  # class, dtype, type
+		3
 		>>> # Test plain text (no coloring)
 		>>> result = format_colored("This is plain text")
 		>>> result.count(MAGENTA) == 0 and result == "This is plain text"
 		True
+		>>> # Affix punctuation should not be colored (assert exact coloring, punctuation uncolored)
+		>>> result = format_colored("<class")
+		>>> result == "<" + MAGENTA + "class" + RESET
+		True
+		>>> result = format_colored("(dtype:")
+		>>> result == "(" + MAGENTA + "dtype" + RESET + ":"
+		True
+		>>> result = format_colored("[1.")
+		>>> result == "[" + MAGENTA + "1" + RESET + "."
+		True
+		>>> # Test complex
+		>>> text = "<class 'numpy.ndarray'>, <id 140357548266896>: (dtype: float32, shape: (6,), min: 0.0, max: 1.0) [1. 0. 0. 0. 1. 0.]"
+		>>> result = format_colored(text)
+		>>> result.count(MAGENTA)  # class, numpy, ndarray, float32, 6, 0.0, 1.0, 1. 0.
+		16
 	"""
 	import builtins
 	import re
@@ -163,6 +185,9 @@ def format_colored(*values: Any) -> str:
 			and issubclass(getattr(builtins, name), BaseException))
 	}
+	# Additional keywords always colored (case-insensitive on stripped words)
+	KEYWORDS: set[str] = {"class", "dtype", "type"}
 	def is_filepath(word: str) -> bool:
 		""" Check if a word looks like a file path """
 		# Remove quotes if present
@@ -187,7 +212,7 @@ def format_colored(*values: Any) -> str:
 	def is_number(word: str) -> bool:
 		try:
-			float(word.strip('.,;:!?'))
+			float(''.join(c for c in word if c.isdigit() or c in '.-+e'))
 			return True
 		except ValueError:
 			return False
@@ -201,7 +226,22 @@ def format_colored(*values: Any) -> str:
 	def is_exception(word: str) -> bool:
 		""" Check if a word is a known exception name """
-		return word.strip('.,;:!?') in EXCEPTION_NAMES
+		return ''.join(c for c in word if c.isalnum()) in EXCEPTION_NAMES
+	def is_keyword(word: str) -> bool:
+		""" Check if a word is one of the always-colored keywords """
+		clean_alnum = ''.join(c for c in word if c.isalnum())
+		return clean_alnum in KEYWORDS
+	def split_affixes(w: str) -> tuple[str, str, str]:
+		""" Split leading/trailing non-word characters and return (prefix, core, suffix).
+		This preserves punctuation like '<', '(', '[', '"', etc., while operating on the core text.
+		"""
+		m = re.match(r'^(\W*)(.*?)(\W*)$', w, re.ASCII)
+		if m:
+			return m.group(1), m.group(2), m.group(3)
+		return "", w, ""
 	# Convert all values to strings and join them and split into words while preserving separators
 	text: str = " ".join(str(v) for v in values)
@@ -219,36 +259,43 @@ def format_colored(*values: Any) -> str:
 			i += 1
 			continue
-		# Try to identify and color the word
+		# If the whole token looks like a filepath (e.g. './data.csv' or '/path/to/file'), color it as-is
 		colored: bool = False
 		if is_filepath(word):
 			colored_words.append(f"{MAGENTA}{word}{RESET}")
 			colored = True
-		elif is_exception(word):
-			colored_words.append(f"{BOLD}{MAGENTA}{word}{RESET}")
-			colored = True
-		elif is_number(word):
-			# Preserve punctuation
-			clean_word = word.strip('.,;:!?')
-			prefix = word[:len(word) - len(word.lstrip('.,;:!?'))]
-			suffix = word[len(clean_word) + len(prefix):]
-			colored_words.append(f"{prefix}{MAGENTA}{clean_word}{RESET}{suffix}")
-			colored = True
-		elif is_function_name(word)[0]:
-			func_name = is_function_name(word)[1]
-			# Find where the function name ends in the original word
-			func_start = word.find(func_name)
-			if func_start != -1:
-				prefix = word[:func_start]
-				func_end = func_start + len(func_name)
-				suffix = word[func_end:]
-				colored_words.append(f"{prefix}{MAGENTA}{func_name}{RESET}{suffix}")
-			else:
-				# Fallback if we can't find it (shouldn't happen)
-				colored_words.append(f"{MAGENTA}{word}{RESET}")
-			colored = True
+		else:
+			# Split affixes to preserve punctuation like '<', '(', '[' etc.
+			prefix, core, suffix = split_affixes(word)
+			# Try to identify and color the word (operate on core where applicable)
+			if is_filepath(core):
+				colored_words.append(f"{prefix}{MAGENTA}{core}{RESET}{suffix}")
+				colored = True
+			elif is_exception(core):
+				colored_words.append(f"{prefix}{BOLD}{MAGENTA}{core}{RESET}{suffix}")
+				colored = True
+			elif is_number(core):
+				colored_words.append(f"{prefix}{MAGENTA}{core}{RESET}{suffix}")
+				colored = True
+			elif is_keyword(core):
+				colored_words.append(f"{prefix}{MAGENTA}{core}{RESET}{suffix}")
+				colored = True
+			elif is_function_name(core)[0]:
+				func_name = is_function_name(core)[1]
+				# Find where the function name ends in the core
+				func_start = core.find(func_name)
+				if func_start != -1:
+					pre_core = core[:func_start]
+					func_end = func_start + len(func_name)
+					post_core = core[func_end:]
+					colored_words.append(f"{prefix}{pre_core}{MAGENTA}{func_name}{RESET}{post_core}{suffix}")
+				else:
+					# Fallback if we can't find it (shouldn't happen)
+					colored_words.append(f"{prefix}{MAGENTA}{core}{RESET}{suffix}")
+				colored = True
-		# If nothing matched, keep the word as is
+		# If nothing matched, keep the original word
 		if not colored:
 			colored_words.append(word)
 		i += 1

{stouputils-1.18.5 → stouputils-1.19.0}/stouputils/print.pyi RENAMED Viewed

@@ -53,45 +53,67 @@ def format_colored(*values: Any) -> str:
 \tExamples:
 \t\t>>> # Test function names with parentheses
 \t\t>>> result = format_colored("Call print() with 42 items")
-\t\t>>> result.count(MAGENTA) == 2  # print and 42
-\t\tTrue
+\t\t>>> result.count(MAGENTA)  # print and 42
+\t\t2
 \t\t>>> # Test function names without parentheses
 \t\t>>> result = format_colored("Use len and sum functions")
-\t\t>>> result.count(MAGENTA) == 2  # len and sum
-\t\tTrue
+\t\t>>> result.count(MAGENTA)  # len and sum
+\t\t2
 \t\t>>> # Test exceptions (bold magenta)
 \t\t>>> result = format_colored("Got ValueError when parsing")
-\t\t>>> result.count(MAGENTA) == 1 and result.count(BOLD) == 1  # ValueError in bold magenta
-\t\tTrue
+\t\t>>> result.count(MAGENTA), result.count(BOLD)  # ValueError in bold magenta
+\t\t(1, 1)
 \t\t>>> # Test file paths
 \t\t>>> result = format_colored("Processing ./data.csv file")
-\t\t>>> result.count(MAGENTA) == 1  # ./data.csv
-\t\tTrue
+\t\t>>> result.count(MAGENTA)  # ./data.csv
+\t\t1
 \t\t>>> # Test file paths with quotes
 \t\t>>> result = format_colored(\'File "/path/to/script.py" line 42\')
-\t\t>>> result.count(MAGENTA) == 2  # /path/to/script.py and 42
-\t\tTrue
+\t\t>>> result.count(MAGENTA)  # /path/to/script.py and 42
+\t\t2
 \t\t>>> # Test numbers
-\t\t>>> result = format_colored("Found 100 items and 3.14 value")
-\t\t>>> result.count(MAGENTA) == 2  # 100 and 3.14
-\t\tTrue
+\t\t>>> result = format_colored("Found 100 items and 3.14 value, 3.0e+10 is big")
+\t\t>>> result.count(MAGENTA)  # 100 and 3.14
+\t\t3
 \t\t>>> # Test mixed content
 \t\t>>> result = format_colored("Call sum() got IndexError at line 256 in utils.py")
-\t\t>>> result.count(MAGENTA) == 3  # sum, IndexError (bold), and 256
-\t\tTrue
-\t\t>>> result.count(BOLD) == 1  # IndexError is bold
-\t\tTrue
+\t\t>>> result.count(MAGENTA)  # sum, IndexError (bold), and 256
+\t\t3
+\t\t>>> result.count(BOLD)  # IndexError is bold
+\t\t1
+\t\t>>> # Test keywords always colored
+\t\t>>> result = format_colored("Check class dtype type")
+\t\t>>> result.count(MAGENTA)  # class, dtype, type
+\t\t3
 \t\t>>> # Test plain text (no coloring)
 \t\t>>> result = format_colored("This is plain text")
 \t\t>>> result.count(MAGENTA) == 0 and result == "This is plain text"
 \t\tTrue
+\t\t>>> # Affix punctuation should not be colored (assert exact coloring, punctuation uncolored)
+\t\t>>> result = format_colored("<class")
+\t\t>>> result == "<" + MAGENTA + "class" + RESET
+\t\tTrue
+\t\t>>> result = format_colored("(dtype:")
+\t\t>>> result == "(" + MAGENTA + "dtype" + RESET + ":"
+\t\tTrue
+\t\t>>> result = format_colored("[1.")
+\t\t>>> result == "[" + MAGENTA + "1" + RESET + "."
+\t\tTrue
+\t\t>>> # Test complex
+\t\t>>> text = "<class \'numpy.ndarray\'>, <id 140357548266896>: (dtype: float32, shape: (6,), min: 0.0, max: 1.0) [1. 0. 0. 0. 1. 0.]"
+\t\t>>> result = format_colored(text)
+\t\t>>> result.count(MAGENTA)  # class, numpy, ndarray, float32, 6, 0.0, 1.0, 1. 0.
+\t\t16
 \t'''
 def colored(*values: Any, file: TextIO | None = None, **print_kwargs: Any) -> None:
     ''' Print with Python 3.14 style colored formatting.