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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.88
+Version: 0.3.90
 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
@@ -1190,8 +1190,28 @@ mg.show(locals())
 ```
 ![avltree_fail.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_fail.png)
 
-## All attributes using dir() ##
-A useful start is to give it some color, show the list of all its attributes using `dir()`, and setting an empty Slicer to see the attribute list in full.
+## Show attributes using build_node() ##
+Then first give it some color, show its attributes using:
+
+```python
+mg.build_node(data)
+```
+
+optionally filter attributes using:
+
+```python
+mg.build_node(data,
+    filters=[mg.filter_non_callable,
+             mg.filter_non_dunder,
+             mg.filter_non_underscore
+             mg.filter_names({'left', 'right'}),
+             lambda kvs : ((k,v) for k,v in kvs
+                             if k in {'left', 'right'} and
+                                not callable(v))
+            ])
+```
+
+and set an empty Slicer to show all attributes even if the sequence is long.
 
 ```python
 import memory_graph as mg
@@ -1205,15 +1225,16 @@ tree.insert(20, "twenty")
 tree.insert(15, "fifteen")
 
 mg.config.type_to_color[bintrees.avltree.Node] = "sandybrown"
-mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.Node_Linear(data,
-                                                dir(data))
+mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.build_node(data,
+                                                  filters=[mg.filter_non_dunder])
 mg.config.type_to_slicer[bintrees.avltree.Node] = mg.Slicer()
 
 mg.show(locals())
 ```
-![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_dir.png)
 
-Next figure out what the attributes are you want to graph and choose a Node type, there are four options:
+![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_non_dunder.png)
+
+Next figure out what the attributes are you actually want to graph and choose a Node type, there are four options:
 
 ## 1) Node_Leaf ##
 Node_Leaf is a node with no children and shows just a single value.
@@ -1555,6 +1576,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_numpy.py&play).
 
+See this [introduction to NumPy operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/numpy_operations.py&timestep=0.5&play).
+
 ## Pandas ##
 For pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
@@ -1576,6 +1599,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_pandas.py&play).
 
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
 ## PyTorch ##
 For torch type `tensor`, use `mg.extend_torch()`:
 

memory_graph-0.3.88/PKG-INFO → memory_graph-0.3.90/README.md

@@ -1,23 +1,3 @@
-Metadata-Version: 2.4
-Name: memory_graph
-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
-Project-URL: Homepage, https://github.com/bterwijn/memory_graph
-Project-URL: Repository, https://github.com/bterwijn/memory_graph.git
-Classifier: Development Status :: 4 - Beta
-Classifier: Intended Audience :: Education
-Classifier: Intended Audience :: Developers
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Education
-Classifier: Topic :: Software Development :: Debuggers
-Requires-Python: >=3.7
-Description-Content-Type: text/markdown
-License-File: LICENSE.txt
-Requires-Dist: graphviz
-Dynamic: license-file
-
 # Installation #
 Install (or upgrade) `memory_graph` using pip:
 ```
@@ -1190,8 +1170,28 @@ mg.show(locals())
 ```
 ![avltree_fail.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_fail.png)
 
-## All attributes using dir() ##
-A useful start is to give it some color, show the list of all its attributes using `dir()`, and setting an empty Slicer to see the attribute list in full.
+## Show attributes using build_node() ##
+Then first give it some color, show its attributes using:
+
+```python
+mg.build_node(data)
+```
+
+optionally filter attributes using:
+
+```python
+mg.build_node(data,
+    filters=[mg.filter_non_callable,
+             mg.filter_non_dunder,
+             mg.filter_non_underscore
+             mg.filter_names({'left', 'right'}),
+             lambda kvs : ((k,v) for k,v in kvs
+                             if k in {'left', 'right'} and
+                                not callable(v))
+            ])
+```
+
+and set an empty Slicer to show all attributes even if the sequence is long.
 
 ```python
 import memory_graph as mg
@@ -1205,15 +1205,16 @@ tree.insert(20, "twenty")
 tree.insert(15, "fifteen")
 
 mg.config.type_to_color[bintrees.avltree.Node] = "sandybrown"
-mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.Node_Linear(data,
-                                                dir(data))
+mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.build_node(data,
+                                                  filters=[mg.filter_non_dunder])
 mg.config.type_to_slicer[bintrees.avltree.Node] = mg.Slicer()
 
 mg.show(locals())
 ```
-![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_dir.png)
 
-Next figure out what the attributes are you want to graph and choose a Node type, there are four options:
+![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_non_dunder.png)
+
+Next figure out what the attributes are you actually want to graph and choose a Node type, there are four options:
 
 ## 1) Node_Leaf ##
 Node_Leaf is a node with no children and shows just a single value.
@@ -1555,6 +1556,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_numpy.py&play).
 
+See this [introduction to NumPy operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/numpy_operations.py&timestep=0.5&play).
+
 ## Pandas ##
 For pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
@@ -1576,6 +1579,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_pandas.py&play).
 
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
 ## PyTorch ##
 For torch type `tensor`, use `mg.extend_torch()`:
 

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

@@ -2,7 +2,7 @@
 # Copyright (c) 2023, Bas Terwijn.
 # SPDX-License-Identifier: BSD-2-Clause
 
-__version__ = "0.3.88"
+__version__ = "0.3.90"
 __author__ = 'Bas Terwijn'
 
 import memory_graph.memory_to_nodes as memory_to_nodes
@@ -537,3 +537,26 @@ def collapse_type(type_name):
 def reset_type(type_name):
     del mg.config.type_to_node[type_name]
     del mg.config.type_to_color[type_name]
+
+# ------------ atributes to Node_Key_Value
+
+def build_node(data, filters=None):
+    attr_values = ((attr, utils.safe_getattr(data, attr)) for attr in dir(data))
+    if filters is not None:
+        for filter in filters:
+            attr_values = filter(attr_values)
+    return Node_Key_Value(data, ((attr, value)
+                                 for attr, value in attr_values
+                                   if value is not utils.SENTINEL
+                                ))
+
+def filter_non_callable(tuples):
+    return ((k,v) for k, v in tuples if not callable(v))
+def filter_non_dunder(tuples):
+    return ((k,v) for k, v in tuples if not k.startswith('__'))
+def filter_non_underscore(tuples):
+    return ((k,v) for k, v in tuples if not k.startswith('_'))
+def filter_names(names):
+    def filter(tuples):
+        return ((k,v) for k, v in tuples if k in names)
+    return filter

{memory_graph-0.3.88 → memory_graph-0.3.90}/memory_graph/config_default.py

@@ -179,6 +179,11 @@ def reset():
         call_stack: lambda data: Node_Key_Value(data, data.items()),
         type: lambda data: Node_Key_Value(data, utils.filter_type_attributes(vars(data).items())),
         range: lambda data: Node_Key_Value(data, {'start':data.start, 'stop':data.stop, 'step':data.step}.items()),
+        tuple: lambda data: (
+            Node_Key_Value(data, zip(data._fields, iter(data)))
+            if utils.is_namedtuple(data) else
+            Node_Linear(data, iter(data))
+        ),
         dict: lambda data: (
             Node_Key_Value(data, utils.filter_dict(data) )
             if dict in config.embedding_types else 

{memory_graph-0.3.88 → memory_graph-0.3.90}/memory_graph/utils.py

@@ -11,6 +11,14 @@ import html
 
 import memory_graph.config as config
 
+SENTINEL = object()
+
+def safe_getattr(obj, attr):
+    try:
+        return getattr(obj, attr, SENTINEL)
+    except Exception:
+        return SENTINEL
+
 class Base_Str():
     def __init__(self, s):
         self.s = s
@@ -165,6 +173,10 @@ def is_finite_iterable(data):
         return True
     except TypeError:
         return False
+
+def is_namedtuple(data):
+    """ Returns 'True' if 'data' is a namedtuple. """
+    return isinstance(data, tuple) and hasattr(data, '_fields')
     
 def get_type_name(data):
     """ Returns the name of the type of 'data'. """
@@ -194,3 +206,4 @@ def generator_has_data(generator):
         return True
     except StopIteration:
         return False
+

memory_graph-0.3.88/README.md → memory_graph-0.3.90/memory_graph.egg-info/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: memory_graph
+Version: 0.3.90
+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
+Project-URL: Homepage, https://github.com/bterwijn/memory_graph
+Project-URL: Repository, https://github.com/bterwijn/memory_graph.git
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Education
+Classifier: Topic :: Software Development :: Debuggers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: graphviz
+Dynamic: license-file
+
 # Installation #
 Install (or upgrade) `memory_graph` using pip:
 ```
@@ -1170,8 +1190,28 @@ mg.show(locals())
 ```
 ![avltree_fail.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_fail.png)
 
-## All attributes using dir() ##
-A useful start is to give it some color, show the list of all its attributes using `dir()`, and setting an empty Slicer to see the attribute list in full.
+## Show attributes using build_node() ##
+Then first give it some color, show its attributes using:
+
+```python
+mg.build_node(data)
+```
+
+optionally filter attributes using:
+
+```python
+mg.build_node(data,
+    filters=[mg.filter_non_callable,
+             mg.filter_non_dunder,
+             mg.filter_non_underscore
+             mg.filter_names({'left', 'right'}),
+             lambda kvs : ((k,v) for k,v in kvs
+                             if k in {'left', 'right'} and
+                                not callable(v))
+            ])
+```
+
+and set an empty Slicer to show all attributes even if the sequence is long.
 
 ```python
 import memory_graph as mg
@@ -1185,15 +1225,16 @@ tree.insert(20, "twenty")
 tree.insert(15, "fifteen")
 
 mg.config.type_to_color[bintrees.avltree.Node] = "sandybrown"
-mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.Node_Linear(data,
-                                                dir(data))
+mg.config.type_to_node[bintrees.avltree.Node] = lambda data: mg.build_node(data,
+                                                  filters=[mg.filter_non_dunder])
 mg.config.type_to_slicer[bintrees.avltree.Node] = mg.Slicer()
 
 mg.show(locals())
 ```
-![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_dir.png)
 
-Next figure out what the attributes are you want to graph and choose a Node type, there are four options:
+![avltree_dir.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/avltree_non_dunder.png)
+
+Next figure out what the attributes are you actually want to graph and choose a Node type, there are four options:
 
 ## 1) Node_Leaf ##
 Node_Leaf is a node with no children and shows just a single value.
@@ -1535,6 +1576,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_numpy.py&play).
 
+See this [introduction to NumPy operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/numpy_operations.py&timestep=0.5&play).
+
 ## Pandas ##
 For pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
@@ -1556,6 +1599,8 @@ mg.show(locals())
 
 Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/mg_pandas.py&play).
 
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
 ## PyTorch ##
 For torch type `tensor`, use `mg.extend_torch()`:
 

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory_graph"
-version = "0.3.88"
+version = "0.3.90"
 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"}