stouputils 1.7.3__tar.gz → 1.8.0__tar.gz

{stouputils-1.7.3 → stouputils-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stouputils
-Version: 1.7.3
+Version: 1.8.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.
 Project-URL: Homepage, https://github.com/Stoupy51/stouputils
 Project-URL: Issues, https://github.com/Stoupy51/stouputils/issues

{stouputils-1.7.3 → stouputils-1.8.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "stouputils"
-version = "1.7.3"
+version = "1.8.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"
 requires-python = ">=3.10"

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/__init__.py

@@ -20,12 +20,11 @@ Key Features:
 from importlib.metadata import PackageNotFoundError, version
 
 # Imports
+from ._deprecated import *
 from .all_doctests import *
 from .archive import *
 from .backup import *
 from .collections import *
-
-# Folders
 from .continuous_delivery import *
 from .ctx import *
 from .decorators import *

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/__init__.pyi

@@ -1,3 +1,4 @@
+from ._deprecated import *
 from .all_doctests import *
 from .archive import *
 from .backup import *

stouputils-1.8.0/stouputils/_deprecated.py

@@ -0,0 +1,37 @@
+""" Deprecated functions and classes.
+
+This module contains deprecated functions that have been replaced by new implementations
+These functions are retained for backward compatibility and will log deprecation warnings when used.
+"""
+
+# Imports
+from typing import Any
+
+from .decorators import LogLevels, deprecated
+from .io import csv_dump, csv_load, json_dump, json_load
+
+
+# Deprecated functions
+@deprecated(message="super_csv_dump has been renamed to csv_dump.", version="v1.8.0", error_log=LogLevels.WARNING)
+def super_csv_dump(*args: Any, **kwargs: Any) -> Any:
+	""" Deprecated function, use "csv_dump" instead. """
+	return csv_dump(*args, **kwargs)
+
+
+@deprecated(message="super_csv_load has been renamed to csv_load.", version="v1.8.0", error_log=LogLevels.WARNING)
+def super_csv_load(*args: Any, **kwargs: Any) -> Any:
+	""" Deprecated function, use "csv_load" instead. """
+	return csv_load(*args, **kwargs)
+
+
+@deprecated(message="super_json_dump has been renamed to json_dump.", version="v1.8.0", error_log=LogLevels.WARNING)
+def super_json_dump(*args: Any, **kwargs: Any) -> Any:
+	""" Deprecated function, use "json_dump" instead. """
+	return json_dump(*args, **kwargs)
+
+
+@deprecated(message="super_json_load has been renamed to json_load.", version="v1.8.0", error_log=LogLevels.WARNING)
+def super_json_load(*args: Any, **kwargs: Any) -> Any:
+	""" Deprecated function, use "json_load" instead. """
+	return json_load(*args, **kwargs)
+

stouputils-1.8.0/stouputils/_deprecated.pyi

@@ -0,0 +1,12 @@
+from .decorators import LogLevels as LogLevels, deprecated as deprecated
+from .io import csv_dump as csv_dump, csv_load as csv_load, json_dump as json_dump, json_load as json_load
+from typing import Any
+
+def super_csv_dump(*args: Any, **kwargs: Any) -> Any:
+    ''' Deprecated function, use "csv_dump" instead. '''
+def super_csv_load(*args: Any, **kwargs: Any) -> Any:
+    ''' Deprecated function, use "csv_load" instead. '''
+def super_json_dump(*args: Any, **kwargs: Any) -> Any:
+    ''' Deprecated function, use "json_dump" instead. '''
+def super_json_load(*args: Any, **kwargs: Any) -> Any:
+    ''' Deprecated function, use "json_load" instead. '''

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/applications/automatic_docs.py

@@ -75,7 +75,7 @@ from typing import Any
 
 from ..continuous_delivery import version_to_float
 from ..decorators import LogLevels, handle_error, simple_cache
-from ..io import clean_path, super_json_dump, super_open
+from ..io import clean_path, json_dump, super_open
 from ..print import info
 
 # Constants
@@ -214,7 +214,7 @@ html_theme_options: dict[str, Any] = {{
 			"versions": version_list,
 			"current_version": current_version,
 		})
-	html_context_str: str = super_json_dump(html_context, max_level=1).replace("true", "True").replace("false", "False")
+	html_context_str: str = json_dump(html_context, max_level=1).replace("true", "True").replace("false", "False")
 
 	conf_content += f"""
 html_context = {html_context_str}

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/applications/automatic_docs.pyi

@@ -1,6 +1,6 @@
 from ..continuous_delivery import version_to_float as version_to_float
 from ..decorators import LogLevels as LogLevels, handle_error as handle_error, simple_cache as simple_cache
-from ..io import clean_path as clean_path, super_json_dump as super_json_dump, super_open as super_open
+from ..io import clean_path as clean_path, json_dump as json_dump, super_open as super_open
 from ..print import info as info
 from collections.abc import Callable as Callable
 

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/continuous_delivery/cd_utils.py

@@ -7,7 +7,7 @@ import os
 from typing import TYPE_CHECKING, Any
 
 from ..decorators import handle_error
-from ..io import clean_path, super_json_load
+from ..io import clean_path, json_load
 from ..print import warning
 
 if TYPE_CHECKING:
@@ -59,7 +59,7 @@ def load_credentials(credentials_path: str) -> dict[str, Any]:
 
 	# Load the file if it's a JSON file
 	if credentials_path.endswith(".json"):
-		return super_json_load(credentials_path)
+		return json_load(credentials_path)
 
 	# Else, load the file if it's a YAML file
 	elif credentials_path.endswith((".yml", ".yaml")):

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/continuous_delivery/cd_utils.pyi

@@ -1,6 +1,6 @@
 import requests
 from ..decorators import handle_error as handle_error
-from ..io import clean_path as clean_path, super_json_load as super_json_load
+from ..io import clean_path as clean_path, json_load as json_load
 from ..print import warning as warning
 from typing import Any
 

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/decorators.py

@@ -358,6 +358,7 @@ def deprecated(
 	func: Callable[..., Any] | None = None,
 	*,
 	message: str = "",
+	version: str = "",
 	error_log: LogLevels = LogLevels.WARNING
 ) -> Callable[..., Any]:
 	""" Decorator that marks a function as deprecated.
@@ -365,6 +366,7 @@ def deprecated(
 	Args:
 		func        (Callable[..., Any] | None): Function to mark as deprecated
 		message     (str):                       Additional message to display with the deprecation warning
+		version     (str):                       Version since when the function is deprecated (e.g. "v1.2.0")
 		error_log   (LogLevels):                 Log level for the deprecation warning
 			LogLevels.NONE:              None
 			LogLevels.WARNING:           Show as warning
@@ -388,6 +390,8 @@ def deprecated(
 		def wrapper(*args: tuple[Any, ...], **kwargs: dict[str, Any]) -> Any:
 			# Build deprecation message
 			msg: str = f"Function '{_get_func_name(func)}()' is deprecated"
+			if version:
+				msg += f" since {version}"
 			if message:
 				msg += f". {message}"
 

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/decorators.pyi

@@ -147,12 +147,13 @@ def abstract(func: Callable[..., Any] | None = None, *, error_log: LogLevels = .
 \t\t\t...
 \t\tNotImplementedError: Function 'method' is abstract and must be implemented by a subclass
 \t"""
-def deprecated(func: Callable[..., Any] | None = None, *, message: str = '', error_log: LogLevels = ...) -> Callable[..., Any]:
+def deprecated(func: Callable[..., Any] | None = None, *, message: str = '', version: str = '', error_log: LogLevels = ...) -> Callable[..., Any]:
     ''' Decorator that marks a function as deprecated.
 
 \tArgs:
 \t\tfunc        (Callable[..., Any] | None): Function to mark as deprecated
 \t\tmessage     (str):                       Additional message to display with the deprecation warning
+\t\tversion     (str):                       Version since when the function is deprecated (e.g. "v1.2.0")
 \t\terror_log   (LogLevels):                 Log level for the deprecation warning
 \t\t\tLogLevels.NONE:              None
 \t\t\tLogLevels.WARNING:           Show as warning

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/image.py

@@ -262,7 +262,7 @@ def auto_crop(
 
 def numpy_to_gif(
 	path: str,
-	array: "NDArray[np.number]",
+	array: "NDArray[np.integer | np.floating | np.bool_]",
 	duration: int = 100,
 	loop: int = 0,
 	mkdir: bool = True,
@@ -300,9 +300,10 @@ def numpy_to_gif(
 		os.makedirs(os.path.dirname(path), exist_ok=True)
 
 	# Normalize array if outside [0-255] range to [0-1]
+	array = array.astype(np.float32)
 	mini, maxi = np.min(array), np.max(array)
 	if mini < 0 or maxi > 255:
-		array = ((array.astype(np.float32) - mini) / (maxi - mini + 1e-8))
+		array = ((array - mini) / (maxi - mini + 1e-8))
 
 	# Scale to [0-255] if in [0-1] range
 	mini, maxi = np.min(array), np.max(array)
@@ -328,7 +329,7 @@ def numpy_to_gif(
 
 def numpy_to_obj(
 	path: str,
-	array: "NDArray[np.number]",
+	array: "NDArray[np.integer | np.floating | np.bool_]",
 	threshold: float = 0.5,
 	step_size: int = 1,
 	pad_array: bool = True,
@@ -356,6 +357,7 @@ def numpy_to_obj(
 	"""
 	# Imports
 	import numpy as np
+	from numpy.typing import NDArray
 	from skimage import measure
 
 	# Assertions
@@ -374,9 +376,10 @@ def numpy_to_obj(
 		threshold = 0.5
 	elif np.issubdtype(array.dtype, np.integer):
 		# For integer arrays, normalize to 0-1 range
+		array = array.astype(np.float32)
 		min_val, max_val = np.min(array), np.max(array)
 		if min_val != max_val:
-			volume = (array.astype(np.float32) - min_val) / (max_val - min_val)
+			volume = (array - min_val) / (max_val - min_val)
 
 	# Pad array with zeros to ensure closed volumes for border cells
 	if pad_array:

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/image.pyi

@@ -119,7 +119,7 @@ def auto_crop(image: Image.Image | NDArray[np.number], mask: NDArray[np.bool_] |
 \t>>> cropped_3d.shape  # Should crop all 3 dimensions
 \t(30, 30, 6)
 \t'''
-def numpy_to_gif(path: str, array: NDArray[np.number], duration: int = 100, loop: int = 0, mkdir: bool = True, **kwargs: Any) -> None:
+def numpy_to_gif(path: str, array: NDArray[np.integer | np.floating | np.bool_], duration: int = 100, loop: int = 0, mkdir: bool = True, **kwargs: Any) -> None:
     ''' Generate a \'.gif\' file from a numpy array for 3D visualization.
 
 \tArgs:
@@ -140,7 +140,7 @@ def numpy_to_gif(path: str, array: NDArray[np.number], duration: int = 100, loop
 \t\t\t> total_duration = 1000  # 1 second
 \t\t\t> numpy_to_gif("output_1s.gif", array, duration=total_duration // len(array))
 \t'''
-def numpy_to_obj(path: str, array: NDArray[np.number], threshold: float = 0.5, step_size: int = 1, pad_array: bool = True, verbose: int = 0) -> None:
+def numpy_to_obj(path: str, array: NDArray[np.integer | np.floating | np.bool_], threshold: float = 0.5, step_size: int = 1, pad_array: bool = True, verbose: int = 0) -> None:
     ''' Generate a \'.obj\' file from a numpy array for 3D visualization using marching cubes.
 
 \tArgs:

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/io.py

@@ -3,10 +3,10 @@ This module provides utilities for file management.
 
 - get_root_path: Get the absolute path of the directory
 - relative_path: Get the relative path of a file relative to a given directory
-- super_json_dump: Writes the provided data to a JSON file with a specified indentation depth.
-- super_json_load: Load a JSON file from the given path
-- super_csv_dump: Writes data to a CSV file with customizable options
-- super_csv_load: Load a CSV file from the given path
+- json_dump: Writes the provided data to a JSON file with a specified indentation depth.
+- json_load: Load a JSON file from the given path
+- csv_dump: Writes data to a CSV file with customizable options
+- csv_load: Load a CSV file from the given path
 - super_copy: Copy a file (or a folder) from the source to the destination (always create the directory)
 - super_open: Open a file with the given mode, creating the directory if it doesn't exist (only if writing)
 - replace_tilde: Replace the "~" by the user's home directory
@@ -79,7 +79,7 @@ def relative_path(file_path: str, relative_to: str = "") -> str:
 		return file_path or "."
 
 # JSON dump with indentation for levels
-def super_json_dump(
+def json_dump(
 	data: Any,
 	file: IO[Any] | str | None = None,
 	max_level: int | None = 2,
@@ -98,13 +98,13 @@ def super_json_dump(
 	Returns:
 		str: The content of the file in every case
 
-	>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 0)
+	>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 0)
 	'{"a": [[1,2,3]],"b": 2}\n'
-	>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 1)
+	>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 1)
 	'{\n\t"a": [[1,2,3]],\n\t"b": 2\n}\n'
-	>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 2)
+	>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 2)
 	'{\n\t"a": [\n\t\t[1,2,3]\n\t],\n\t"b": 2\n}\n'
-	>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 3)
+	>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 3)
 	'{\n\t"a": [\n\t\t[\n\t\t\t1,\n\t\t\t2,\n\t\t\t3\n\t\t]\n\t],\n\t"b": 2\n}\n'
 	"""
 	# Imports
@@ -146,7 +146,7 @@ def super_json_dump(
 	return content
 
 # JSON load from file path
-def super_json_load(file_path: str) -> Any:
+def json_load(file_path: str) -> Any:
 	""" Load a JSON file from the given path
 
 	Args:
@@ -159,7 +159,7 @@ def super_json_load(file_path: str) -> Any:
 		return orjson.loads(f.read())
 
 # CSV dump to file
-def super_csv_dump(
+def csv_dump(
 	data: Any,
 	file: IO[Any] | str | None = None,
 	delimiter: str = ',',
@@ -184,10 +184,10 @@ def super_csv_dump(
 
 	Examples:
 
-		>>> super_csv_dump([["a", "b", "c"], [1, 2, 3], [4, 5, 6]])
+		>>> csv_dump([["a", "b", "c"], [1, 2, 3], [4, 5, 6]])
 		'a,b,c\\r\\n1,2,3\\r\\n4,5,6\\r\\n'
 
-		>>> super_csv_dump([{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}])
+		>>> csv_dump([{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}])
 		'name,age\\r\\nAlice,30\\r\\nBob,25\\r\\n'
 	"""
 	if isinstance(data, str | bytes | dict):
@@ -256,7 +256,7 @@ def super_csv_dump(
 	return content
 
 # CSV load from file path
-def super_csv_load(file_path: str, delimiter: str = ',', has_header: bool = True, as_dict: bool = False, as_dataframe: bool = False, use_polars: bool = False, *args: Any, **kwargs: Any) -> Any:
+def csv_load(file_path: str, delimiter: str = ',', has_header: bool = True, as_dict: bool = False, as_dataframe: bool = False, use_polars: bool = False, *args: Any, **kwargs: Any) -> Any:
 	""" Load a CSV file from the given path
 
 	Args:
@@ -276,20 +276,20 @@ def super_csv_load(file_path: str, delimiter: str = ',', has_header: bool = True
 		.. code-block:: python
 
 			> Assuming "test.csv" contains: a,b,c\\n1,2,3\\n4,5,6
-			> super_csv_load("test.csv")
+			> csv_load("test.csv")
 			[['1', '2', '3'], ['4', '5', '6']]
 
-			> super_csv_load("test.csv", as_dict=True)
+			> csv_load("test.csv", as_dict=True)
 			[{'a': '1', 'b': '2', 'c': '3'}, {'a': '4', 'b': '5', 'c': '6'}]
 
-			> super_csv_load("test.csv", as_dataframe=True)
+			> csv_load("test.csv", as_dataframe=True)
 			   a  b  c
 			0  1  2  3
 			1  4  5  6
 
 		.. code-block:: console
 
-			> super_csv_load("test.csv", as_dataframe=True, use_polars=True)
+			> csv_load("test.csv", as_dataframe=True, use_polars=True)
 			shape: (2, 3)
 			┌─────┬─────┬─────┐
 			│ a   ┆ b   ┆ c   │

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/io.pyi

@@ -35,7 +35,7 @@ def relative_path(file_path: str, relative_to: str = '') -> str:
 \t\t>>> relative_path("D:/some/random/path/stouputils/io.py", "D:\\\\some\\\\")
 \t\t\'random/path/stouputils/io.py\'
 \t'''
-def super_json_dump(data: Any, file: IO[Any] | str | None = None, max_level: int | None = 2, indent: str | int = '\t', suffix: str = '\n') -> str:
+def json_dump(data: Any, file: IO[Any] | str | None = None, max_level: int | None = 2, indent: str | int = '\t', suffix: str = '\n') -> str:
     ''' Writes the provided data to a JSON file with a specified indentation depth.
 \tFor instance, setting max_level to 2 will limit the indentation to 2 levels.
 
@@ -48,16 +48,16 @@ def super_json_dump(data: Any, file: IO[Any] | str | None = None, max_level: int
 \tReturns:
 \t\tstr: The content of the file in every case
 
-\t>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 0)
+\t>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 0)
 \t\'{"a": [[1,2,3]],"b": 2}\\n\'
-\t>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 1)
+\t>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 1)
 \t\'{\\n\\t"a": [[1,2,3]],\\n\\t"b": 2\\n}\\n\'
-\t>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 2)
+\t>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 2)
 \t\'{\\n\\t"a": [\\n\\t\\t[1,2,3]\\n\\t],\\n\\t"b": 2\\n}\\n\'
-\t>>> super_json_dump({"a": [[1,2,3]], "b": 2}, max_level = 3)
+\t>>> json_dump({"a": [[1,2,3]], "b": 2}, max_level = 3)
 \t\'{\\n\\t"a": [\\n\\t\\t[\\n\\t\\t\\t1,\\n\\t\\t\\t2,\\n\\t\\t\\t3\\n\\t\\t]\\n\\t],\\n\\t"b": 2\\n}\\n\'
 \t'''
-def super_json_load(file_path: str) -> Any:
+def json_load(file_path: str) -> Any:
     """ Load a JSON file from the given path
 
 \tArgs:
@@ -65,7 +65,7 @@ def super_json_load(file_path: str) -> Any:
 \tReturns:
 \t\tAny: The content of the JSON file
 \t"""
-def super_csv_dump(data: Any, file: IO[Any] | str | None = None, delimiter: str = ',', has_header: bool = True, index: bool = False, *args: Any, **kwargs: Any) -> str:
+def csv_dump(data: Any, file: IO[Any] | str | None = None, delimiter: str = ',', has_header: bool = True, index: bool = False, *args: Any, **kwargs: Any) -> str:
     ''' Writes data to a CSV file with customizable options and returns the CSV content as a string.
 
 \tArgs:
@@ -82,13 +82,13 @@ def super_csv_dump(data: Any, file: IO[Any] | str | None = None, delimiter: str
 
 \tExamples:
 
-\t\t>>> super_csv_dump([["a", "b", "c"], [1, 2, 3], [4, 5, 6]])
+\t\t>>> csv_dump([["a", "b", "c"], [1, 2, 3], [4, 5, 6]])
 \t\t\'a,b,c\\r\\n1,2,3\\r\\n4,5,6\\r\\n\'
 
-\t\t>>> super_csv_dump([{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}])
+\t\t>>> csv_dump([{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}])
 \t\t\'name,age\\r\\nAlice,30\\r\\nBob,25\\r\\n\'
 \t'''
-def super_csv_load(file_path: str, delimiter: str = ',', has_header: bool = True, as_dict: bool = False, as_dataframe: bool = False, use_polars: bool = False, *args: Any, **kwargs: Any) -> Any:
+def csv_load(file_path: str, delimiter: str = ',', has_header: bool = True, as_dict: bool = False, as_dataframe: bool = False, use_polars: bool = False, *args: Any, **kwargs: Any) -> Any:
     ''' Load a CSV file from the given path
 
 \tArgs:
@@ -108,20 +108,20 @@ def super_csv_load(file_path: str, delimiter: str = ',', has_header: bool = True
 \t\t.. code-block:: python
 
 \t\t\t> Assuming "test.csv" contains: a,b,c\\n1,2,3\\n4,5,6
-\t\t\t> super_csv_load("test.csv")
+\t\t\t> csv_load("test.csv")
 \t\t\t[[\'1\', \'2\', \'3\'], [\'4\', \'5\', \'6\']]
 
-\t\t\t> super_csv_load("test.csv", as_dict=True)
+\t\t\t> csv_load("test.csv", as_dict=True)
 \t\t\t[{\'a\': \'1\', \'b\': \'2\', \'c\': \'3\'}, {\'a\': \'4\', \'b\': \'5\', \'c\': \'6\'}]
 
-\t\t\t> super_csv_load("test.csv", as_dataframe=True)
+\t\t\t> csv_load("test.csv", as_dataframe=True)
 \t\t\t   a  b  c
 \t\t\t0  1  2  3
 \t\t\t1  4  5  6
 
 \t\t.. code-block:: console
 
-\t\t\t> super_csv_load("test.csv", as_dataframe=True, use_polars=True)
+\t\t\t> csv_load("test.csv", as_dataframe=True, use_polars=True)
 \t\t\tshape: (2, 3)
 \t\t\t┌─────┬─────┬─────┐
 \t\t\t│ a   ┆ b   ┆ c   │

{stouputils-1.7.3 → stouputils-1.8.0}/stouputils/print.py

@@ -202,25 +202,38 @@ def whatisit(
 	def _internal(value: Any) -> str:
 		""" Get the string representation of the value, with length or shape instead of length if shape is available """
 
-		# Get the length or shape of the value
-		length: str = ""
+		# Build metadata parts list
+		metadata_parts: list[str] = []
+
+		# Get the dtype if available
 		try:
-			length = f"(length: {len(value)}) "
+			metadata_parts.append(f"dtype: {value.dtype}")
 		except (AttributeError, TypeError):
 			pass
+
+		# Get the shape or length of the value
 		try:
-			length = f"(shape: {value.shape}) "
+			metadata_parts.append(f"shape: {value.shape}")
 		except (AttributeError, TypeError):
-			pass
+			try:
+				metadata_parts.append(f"length: {len(value)}")
+			except (AttributeError, TypeError):
+				pass
 
-		# Get the dtype if available
-		dtype: str = ""
+		# Get the min and max if available (Iterable of numbers)
 		try:
-			dtype = f"(dtype: {value.dtype}) "
-		except (AttributeError, TypeError):
+			if not isinstance(value, str | bytes | bytearray | dict | int | float):
+				import numpy as np
+				metadata_parts.append(f"min: {np.min(value)}")
+				metadata_parts.append(f"max: {np.max(value)}")
+		except (Exception):
 			pass
 
+		# Combine metadata into a single parenthesized string
+		metadata_str: str = f"({', '.join(metadata_parts)}) " if metadata_parts else ""
+
 		# Get the string representation of the value
+		value = cast(Any, value)
 		value_str: str = str(value)
 		if len(value_str) > max_length:
 			value_str = value_str[:max_length] + "..."
@@ -228,7 +241,7 @@ def whatisit(
 			value_str = "\n" + value_str	# Add a newline before the value if there is a newline in it.
 
 		# Return the formatted string
-		return f"{type(value)}, <id {id(value)}>: {dtype}{length}{value_str}"
+		return f"{type(value)}, <id {id(value)}>: {metadata_str}{value_str}"
 
 	# Add the color to the message
 	if "color" not in print_kwargs:
@@ -479,3 +492,14 @@ if __name__ == "__main__":
 	error("Hello", "World", exit=False)
 	whatisit("Hello", "World")
 
+	# Test whatisit with different types
+	import numpy as np
+	print()
+	whatisit(
+		123,
+		"Hello World",
+		[1, 2, 3, 4, 5],
+		np.array([[1, 2, 3], [4, 5, 6]]),
+		{"a": 1, "b": 2},
+	)
+