memory-graph 0.3.87__tar.gz → 0.3.88__tar.gz

{memory_graph-0.3.87 → memory_graph-0.3.88}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.87
+Version: 0.3.88
 Summary: Teaching tool and debugging aid in context of references, mutable data types, and shallow and deep copy.
 Author-email: Bas Terwijn <bterwijn@gmail.com>
 License-Expression: BSD-2-Clause
@@ -753,7 +753,7 @@ Visualization of different sorting algorithms in Memory Graph Web Debugger.
 # Bitwise Operators #
 In this configuration example we show the decimal, binary and [two's complement representation](https://www.cs.cornell.edu/~tomf/notes/cps104/twoscomp.html) representation of `int` values of dictionary subclass `Bits` to show the result of [bitwise operators](https://docs.python.org/3/library/stdtypes.html?utm_source=chatgpt.com#bitwise-operations-on-integer-types). The `~` (inverse) operator can be a bit confusing if not shown with two's complement representation.
 
-- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=23&continues=1&play)
+- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=22&continues=1&play)
 
 ![bitwise_operators.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/bitwise_operators.png)
 
@@ -915,12 +915,12 @@ Run a Linked_List iterator example in the [Memory Graph Web Debugger](https://me
 This example shows the flow of control when using a decorator. A decorator wraps a function and is active before and after the function is called.
 
 ```python
-def log_call(function):
+def log_call(function):  # decorator example
     def wrapper(*args, **kwargs):
-        print(f"Calling {function.__name__} with: {args}, {kwargs}")
-        returned = function(*args, **kwargs)
-        print(f"Finished {function.__name__} with return value: {returned}")
-        return returned
+        print(f"log: '{function.__name__}' called with: {args}, {kwargs}")
+        return_value = function(*args, **kwargs)
+        print(f"log: '{function.__name__}' returned with: {return_value}")
+        return return_value
     return wrapper
 
 @log_call
@@ -932,11 +932,11 @@ def calculate_total(price, quantity, rounding=False):
 def send_email(receiver, message, sender="support@company.com"):
     print(f"Sending email to:{receiver} from:{sender}, {message}")
 
-total = calculate_total(7.5, 3, rounding=True)
+total = calculate_total(2.4, 3, rounding=True)
 print(total)
 send_email("alice@example.com", "Your order is ready")
 ```
-Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=18&continues=1&play).
+Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=19&continues=1&play).
 
 ## Exception Handling ##
 

{memory_graph-0.3.87 → memory_graph-0.3.88}/README.md

@@ -733,7 +733,7 @@ Visualization of different sorting algorithms in Memory Graph Web Debugger.
 # Bitwise Operators #
 In this configuration example we show the decimal, binary and [two's complement representation](https://www.cs.cornell.edu/~tomf/notes/cps104/twoscomp.html) representation of `int` values of dictionary subclass `Bits` to show the result of [bitwise operators](https://docs.python.org/3/library/stdtypes.html?utm_source=chatgpt.com#bitwise-operations-on-integer-types). The `~` (inverse) operator can be a bit confusing if not shown with two's complement representation.
 
-- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=23&continues=1&play)
+- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=22&continues=1&play)
 
 ![bitwise_operators.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/bitwise_operators.png)
 
@@ -895,12 +895,12 @@ Run a Linked_List iterator example in the [Memory Graph Web Debugger](https://me
 This example shows the flow of control when using a decorator. A decorator wraps a function and is active before and after the function is called.
 
 ```python
-def log_call(function):
+def log_call(function):  # decorator example
     def wrapper(*args, **kwargs):
-        print(f"Calling {function.__name__} with: {args}, {kwargs}")
-        returned = function(*args, **kwargs)
-        print(f"Finished {function.__name__} with return value: {returned}")
-        return returned
+        print(f"log: '{function.__name__}' called with: {args}, {kwargs}")
+        return_value = function(*args, **kwargs)
+        print(f"log: '{function.__name__}' returned with: {return_value}")
+        return return_value
     return wrapper
 
 @log_call
@@ -912,11 +912,11 @@ def calculate_total(price, quantity, rounding=False):
 def send_email(receiver, message, sender="support@company.com"):
     print(f"Sending email to:{receiver} from:{sender}, {message}")
 
-total = calculate_total(7.5, 3, rounding=True)
+total = calculate_total(2.4, 3, rounding=True)
 print(total)
 send_email("alice@example.com", "Your order is ready")
 ```
-Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=18&continues=1&play).
+Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=19&continues=1&play).
 
 ## Exception Handling ##
 

{memory_graph-0.3.87 → memory_graph-0.3.88}/memory_graph/__init__.py

@@ -2,7 +2,7 @@
 # Copyright (c) 2023, Bas Terwijn.
 # SPDX-License-Identifier: BSD-2-Clause
 
-__version__ = "0.3.87"
+__version__ = "0.3.88"
 __author__ = 'Bas Terwijn'
 
 import memory_graph.memory_to_nodes as memory_to_nodes

memory_graph-0.3.88/memory_graph/extension_pandas.py

@@ -0,0 +1,142 @@
+# This file is part of memory_graph.
+# Copyright (c) 2023, Bas Terwijn.
+# SPDX-License-Identifier: BSD-2-Clause
+
+"""Extension to add memory graph configuration for public Pandas values."""
+import reprlib
+
+from memory_graph.node_leaf import Node_Leaf
+from memory_graph.node_table import Node_Table
+
+import memory_graph.config as config
+import memory_graph.config_default as config_default
+
+
+def _display_value(value):
+    """Keep object references, but display Pandas scalar values without internals."""
+    import pandas as pd
+
+    if value is pd.NA or value is pd.NaT:
+        return str(value)
+    if isinstance(value, (pd.Timestamp, pd.Timedelta, pd.Period, pd.Interval)):
+        return str(value)
+    return value
+
+
+def _column_name(name, default="value"):
+    return default if name is None else str(name)
+
+
+def _dataframe_to_node(data):
+    # Unlike .values, itertuples does not coerce all numeric columns to one dtype.
+    return Node_Table(
+        data,
+        [[_display_value(value) for value in row]
+         for row in data.itertuples(index=False, name=None)],
+        col_names=[str(name) for name in data.columns],
+        row_names=[str(name) for name in data.index],
+    )
+
+
+def _series_to_node(data):
+    return Node_Table(
+        data,
+        [[_display_value(value)] for value in data.tolist()],
+        col_names=[_column_name(data.name)],
+        row_names=[str(name) for name in data.index],
+    )
+
+
+def _index_to_node(data):
+    # Also handles RangeIndex, DatetimeIndex, TimedeltaIndex and PeriodIndex
+    # through config's base-class lookup.
+    return Node_Table(
+        data,
+        [[_display_value(value)] for value in data.tolist()],
+        col_names=[_column_name(data.name)],
+    )
+
+
+def _multiindex_to_node(data):
+    # Use the actual row labels, not .levels (which includes unused labels).
+    return Node_Table(
+        data,
+        [[_display_value(value) for value in row] for row in data.tolist()],
+        col_names=[_column_name(name, f"level_{i}")
+                   for i, name in enumerate(data.names)],
+    )
+
+
+class _Categorical_Table(Node_Table):
+    """Show values as a table, with category order as compact metadata."""
+
+    def get_label(self, slices):
+        data = self.get_data()
+        return (super().get_label(slices)
+                + f"\ncategories={reprlib.repr(data.categories.tolist())}"
+                + f"\nordered={data.ordered}")
+
+
+def _categorical_to_node(data):
+    return _Categorical_Table(
+        data,
+        [[_display_value(value)] for value in data.tolist()],
+        col_names=[_column_name(getattr(data, "name", None))],
+    )
+
+
+def _intervalindex_to_node(data):
+    return Node_Table(
+        data,
+        [[_display_value(left), _display_value(right), data.closed]
+         for left, right in zip(data.left.tolist(), data.right.tolist())],
+        col_names=["left", "right", "closed"],
+    )
+
+
+def _scalar_to_node(data):
+    return Node_Leaf(data, str(data))
+
+
+def _pandas_types():
+    """Keep optional Pandas imports inside the extension, as before."""
+    import pandas as pd
+
+    return {
+        pd.DataFrame: (_dataframe_to_node, "olivedrab1", "#3a4d13"),
+        pd.Series: (_series_to_node, "olivedrab2", "#3a4d13"),
+        pd.Index: (_index_to_node, "olivedrab3", "#384d24"),
+        pd.MultiIndex: (_multiindex_to_node, "palegreen2", "#244d32"),
+        pd.CategoricalIndex: (_categorical_to_node, "darkseagreen2", "#324d39"),
+        pd.Categorical: (_categorical_to_node, "darkseagreen2", "#324d39"),
+        pd.IntervalIndex: (_intervalindex_to_node, "lightgoldenrod1", "#5c5125"),
+        # IndexSlice is an instance, not a public class or a table. Obtain its
+        # type from the public singleton instead of importing a private type.
+        type(pd.IndexSlice): (
+            lambda data: Node_Leaf(data, "pd.IndexSlice (slice helper)"),
+            "lightsteelblue1", "#30465c",
+        ),
+        pd.Timestamp: (_scalar_to_node, "olivedrab2", "#3a4d13"),
+        pd.Timedelta: (_scalar_to_node, "olivedrab2", "#3a4d13"),
+        pd.Period: (_scalar_to_node, "olivedrab2", "#3a4d13"),
+        pd.Interval: (_scalar_to_node, "lightgoldenrod1", "#5c5125"),
+        type(pd.NA): (_scalar_to_node, "gray85", "#454545"),
+        type(pd.NaT): (_scalar_to_node, "gray85", "#454545"),
+    }
+
+
+def extend_pandas():
+    for data_type, (to_node, light, dark) in _pandas_types().items():
+        config.type_to_node[data_type] = to_node
+        config_default.type_to_color_light[data_type] = light
+        config_default.type_to_color_dark[data_type] = dark
+        config.type_to_color[data_type] = dark if config.color_mode_dark else light
+
+
+def unextend_pandas():
+    for data_type in _pandas_types():
+        config.type_to_node.pop(data_type, None)
+        config.type_to_color.pop(data_type, None)
+        # Remove theme defaults too, so changing theme cannot re-enable colors.
+        config_default.type_to_color_light.pop(data_type, None)
+        config_default.type_to_color_dark.pop(data_type, None)

{memory_graph-0.3.87 → memory_graph-0.3.88}/memory_graph.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.87
+Version: 0.3.88
 Summary: Teaching tool and debugging aid in context of references, mutable data types, and shallow and deep copy.
 Author-email: Bas Terwijn <bterwijn@gmail.com>
 License-Expression: BSD-2-Clause
@@ -753,7 +753,7 @@ Visualization of different sorting algorithms in Memory Graph Web Debugger.
 # Bitwise Operators #
 In this configuration example we show the decimal, binary and [two's complement representation](https://www.cs.cornell.edu/~tomf/notes/cps104/twoscomp.html) representation of `int` values of dictionary subclass `Bits` to show the result of [bitwise operators](https://docs.python.org/3/library/stdtypes.html?utm_source=chatgpt.com#bitwise-operations-on-integer-types). The `~` (inverse) operator can be a bit confusing if not shown with two's complement representation.
 
-- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=23&continues=1&play)
+- [bitwise operators](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/bitwise_operators.py&breakpoints=22&continues=1&play)
 
 ![bitwise_operators.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/bitwise_operators.png)
 
@@ -915,12 +915,12 @@ Run a Linked_List iterator example in the [Memory Graph Web Debugger](https://me
 This example shows the flow of control when using a decorator. A decorator wraps a function and is active before and after the function is called.
 
 ```python
-def log_call(function):
+def log_call(function):  # decorator example
     def wrapper(*args, **kwargs):
-        print(f"Calling {function.__name__} with: {args}, {kwargs}")
-        returned = function(*args, **kwargs)
-        print(f"Finished {function.__name__} with return value: {returned}")
-        return returned
+        print(f"log: '{function.__name__}' called with: {args}, {kwargs}")
+        return_value = function(*args, **kwargs)
+        print(f"log: '{function.__name__}' returned with: {return_value}")
+        return return_value
     return wrapper
 
 @log_call
@@ -932,11 +932,11 @@ def calculate_total(price, quantity, rounding=False):
 def send_email(receiver, message, sender="support@company.com"):
     print(f"Sending email to:{receiver} from:{sender}, {message}")
 
-total = calculate_total(7.5, 3, rounding=True)
+total = calculate_total(2.4, 3, rounding=True)
 print(total)
 send_email("alice@example.com", "Your order is ready")
 ```
-Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=18&continues=1&play).
+Run it in the [Memory Graph Web Debugger](https://memory-graph.com/#codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/decorator.py&breakpoints=19&continues=1&play).
 
 ## Exception Handling ##
 

{memory_graph-0.3.87 → memory_graph-0.3.88}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory_graph"
-version = "0.3.87"
+version = "0.3.88"
 description = "Teaching tool and debugging aid in context of references, mutable data types, and shallow and deep copy."
 authors = [
     {name = "Bas Terwijn", email = "bterwijn@gmail.com"}

memory_graph-0.3.87/memory_graph/extension_pandas.py

@@ -1,48 +0,0 @@
-# This file is part of memory_graph.
-# Copyright (c) 2023, Bas Terwijn.
-# SPDX-License-Identifier: BSD-2-Clause
-
-""" Extension to add the memory graph configuration for Pandas types. """
-from memory_graph.node_linear import Node_Linear
-from memory_graph.node_table import Node_Table
-
-import memory_graph.config as config
-import memory_graph.config_default as config_default
-
-def extend_pandas():
-    import pandas as pd
-    
-    config.type_to_node[pd.DataFrame] = lambda data : (
-        Node_Table(data, 
-                data.values.tolist(),
-                col_names = data.columns.tolist(),
-                row_names = [ str(i) for i in data.index.tolist()]
-                )
-    )
-
-    config.type_to_node[pd.Series] = lambda data : (
-        Node_Linear(data, data.tolist())
-    )
-
-    config_default.type_to_color_light[pd.DataFrame] = "olivedrab1"
-    config_default.type_to_color_light[pd.Series] = "olivedrab2"
-
-    config_default.type_to_color_dark[pd.DataFrame] = "#3a4d13"
-    config_default.type_to_color_dark[pd.Series] = "#3a4d13"
-
-    if not config.color_mode_dark:
-        config.type_to_color[pd.DataFrame] = config_default.type_to_color_light[pd.DataFrame]
-        config.type_to_color[pd.Series] = config_default.type_to_color_light[pd.Series]
-    else:
-        config.type_to_color[pd.DataFrame] = config_default.type_to_color_dark[pd.DataFrame]
-        config.type_to_color[pd.Series] = config_default.type_to_color_dark[pd.Series]
-
-
-def unextend_pandas():
-    import pandas as pd
-
-    del config.type_to_node[pd.DataFrame]
-    del config.type_to_node[pd.Series]
-
-    del config.type_to_color[pd.DataFrame]
-    del config.type_to_color[pd.Series]