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

{memory_graph-0.3.90 → memory_graph-0.3.92}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.90
+Version: 0.3.92
 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
@@ -1556,8 +1556,8 @@ mg.show(locals())
 # Extensions #
 Different extensions are available for types from other Python packages. 
 
-## Numpy ##
-For Numpy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
+## NumPy ##
+For NumPy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
 
 ```python
 import memory_graph as mg
@@ -1574,12 +1574,12 @@ mg.show(locals())
 ```
 ![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
 
-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).
+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&timestep=0.5&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()`:
+For Pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
 ```python
 import memory_graph as mg
@@ -1597,9 +1597,30 @@ mg.show(locals())
 ```
 ![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
 
-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).
+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&timestep=0.5&play).
+
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy,pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
+## Polars ##
+For Polars types `DataFrame`, use `mg.extend_polars()`:
+
+```python
+import memory_graph as mg
+import polars as pl
+mg.extend_polars()
+
+df = pl.DataFrame(
+    {
+        "name": ["Alice Archer", "Ben Brown", "Chloe Cooper", "Daniel Donovan"],
+        "weight": [57.9, 72.5, 53.6, 83.1],  # (kg)
+        "height": [1.56, 1.77, 1.65, 1.75],  # (m)
+    }
+)
+
+mg.show(locals())
+```
+![extension_polars.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_polars.png)
 
-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()`:
@@ -1618,6 +1639,39 @@ mg.show(locals())
 ```
 ![extension_torch.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_torch.png)
 
+## SQLite3 ##
+For sqlite3 use `mg.extend_sqlite3()`:
+
+```python
+import memory_graph as mg
+import sqlite3
+mg.extend_sqlite3()
+
+conn = sqlite3.connect(":memory:")
+
+conn.executescript("""
+    CREATE TABLE students (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        age INTEGER
+    );
+""")
+
+conn.executemany(
+    "INSERT INTO students VALUES (?, ?, ?)",
+    [
+        (1, "Alice", 20),
+        (2, "Bob", 21),
+        (3, "Charlie", 22),
+    ]
+)
+
+mg.show(locals())
+conn.close()
+```
+![extension_sqlite3.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_sqlite3.png)
+
+
 # Memory Graph Web Debugger #
 The <a href="https://memory-graph.com/#play" target="_blank">Memory Graph Web Debugger</a> lets us use memory_graph without any installation.
 ![memory_graph_web_debugger.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/memory_graph_web_debugger.png)

{memory_graph-0.3.90 → memory_graph-0.3.92}/README.md

@@ -1536,8 +1536,8 @@ mg.show(locals())
 # Extensions #
 Different extensions are available for types from other Python packages. 
 
-## Numpy ##
-For Numpy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
+## NumPy ##
+For NumPy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
 
 ```python
 import memory_graph as mg
@@ -1554,12 +1554,12 @@ mg.show(locals())
 ```
 ![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
 
-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).
+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&timestep=0.5&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()`:
+For Pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
 ```python
 import memory_graph as mg
@@ -1577,9 +1577,30 @@ mg.show(locals())
 ```
 ![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
 
-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).
+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&timestep=0.5&play).
+
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy,pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
+## Polars ##
+For Polars types `DataFrame`, use `mg.extend_polars()`:
+
+```python
+import memory_graph as mg
+import polars as pl
+mg.extend_polars()
+
+df = pl.DataFrame(
+    {
+        "name": ["Alice Archer", "Ben Brown", "Chloe Cooper", "Daniel Donovan"],
+        "weight": [57.9, 72.5, 53.6, 83.1],  # (kg)
+        "height": [1.56, 1.77, 1.65, 1.75],  # (m)
+    }
+)
+
+mg.show(locals())
+```
+![extension_polars.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_polars.png)
 
-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()`:
@@ -1598,6 +1619,39 @@ mg.show(locals())
 ```
 ![extension_torch.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_torch.png)
 
+## SQLite3 ##
+For sqlite3 use `mg.extend_sqlite3()`:
+
+```python
+import memory_graph as mg
+import sqlite3
+mg.extend_sqlite3()
+
+conn = sqlite3.connect(":memory:")
+
+conn.executescript("""
+    CREATE TABLE students (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        age INTEGER
+    );
+""")
+
+conn.executemany(
+    "INSERT INTO students VALUES (?, ?, ?)",
+    [
+        (1, "Alice", 20),
+        (2, "Bob", 21),
+        (3, "Charlie", 22),
+    ]
+)
+
+mg.show(locals())
+conn.close()
+```
+![extension_sqlite3.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_sqlite3.png)
+
+
 # Memory Graph Web Debugger #
 The <a href="https://memory-graph.com/#play" target="_blank">Memory Graph Web Debugger</a> lets us use memory_graph without any installation.
 ![memory_graph_web_debugger.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/memory_graph_web_debugger.png)

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

@@ -2,7 +2,7 @@
 # Copyright (c) 2023, Bas Terwijn.
 # SPDX-License-Identifier: BSD-2-Clause
 
-__version__ = "0.3.90"
+__version__ = "0.3.92"
 __author__ = 'Bas Terwijn'
 
 import memory_graph.memory_to_nodes as memory_to_nodes
@@ -520,6 +520,13 @@ def extend_pandas(on=True):
     else:
         ext_pd.unextend_pandas()
 
+def extend_polars(on=True):
+    import memory_graph.extension_polars as ext_pl
+    if on:
+        ext_pl.extend_polars()
+    else:
+        ext_pl.unextend_polars()
+
 def extend_torch(on=True):
     import memory_graph.extension_torch as ext_torch
     if on:
@@ -527,6 +534,12 @@ def extend_torch(on=True):
     else:
         ext_torch.unextend_torch()
 
+def extend_sqlite3(on=True):
+    import memory_graph.extension_sqlite3 as ext_sqlite3
+    if on:
+        ext_sqlite3.extend_sqlite3()
+    else:
+        ext_sqlite3.unextend_sqlite3()
 
 # ------------ collapse type
     

memory_graph-0.3.92/memory_graph/extension_polars.py

@@ -0,0 +1,30 @@
+# 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 Polars types. """
+from memory_graph.node_table import Node_Table
+
+import memory_graph.config as config
+import memory_graph.config_default as config_default
+
+def extend_polars():
+    import polars as pl
+
+    #config.type_to_color[pl.DataFrame] = "aquamarine"
+    config.type_to_node[pl.DataFrame] = lambda df: Node_Table(df,
+                                                            df.iter_rows(),
+                                                            col_names = df.columns)
+    config_default.type_to_color_light[pl.DataFrame] = "aquamarine"
+    config_default.type_to_color_dark[pl.DataFrame] = "#295345"
+
+    if not config.color_mode_dark:
+        config.type_to_color[pl.DataFrame] = config_default.type_to_color_light[pl.DataFrame]
+    else:
+        config.type_to_color[pl.DataFrame] = config_default.type_to_color_dark[pl.DataFrame]
+
+def unextend_polars():
+    import polars as pl
+    
+    del config.type_to_node[pl.DataFrame]
+    del config.type_to_color[pl.DataFrame]

memory_graph-0.3.92/memory_graph/extension_sqlite3.py

@@ -0,0 +1,119 @@
+# 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 SQLite3 types. """
+from memory_graph.node_key_value import Node_Key_Value
+from memory_graph.node_table import Node_Table
+
+
+import memory_graph.config as config
+import memory_graph.config_default as config_default
+
+
+class SQLite3_Table:
+    def __init__(self, header, rows, column_types, primary_keys, foreign_keys):
+        self.header = header
+        self.rows = rows
+        self.column_types = column_types
+        self.primary_keys = primary_keys
+        self.foreign_keys = foreign_keys
+
+
+def get_table(conn, table_name):
+    # Quote the table name safely
+    name = '"' + table_name.replace('"', '""') + '"'
+
+    cursor = conn.execute(f"SELECT * FROM {name}")
+    header = [col[0] for col in cursor.description]
+    rows = iter(cursor)  # lazy iteration
+    # Column types: column name -> declared SQLite type
+    # Primary keys: column name -> position in composite primary key
+    column_info = list(conn.execute(f"PRAGMA table_info({name})"))
+    column_types = {
+        col[1]: col[2]
+        for col in column_info
+    }
+    primary_keys = {
+        col[1]: col[5]
+        for col in column_info
+        if col[5] > 0
+    }
+    # Foreign keys: (column, referenced table, referenced column)
+    foreign_keys = [
+        (fk[3], fk[2], fk[4])
+        for fk in conn.execute(f"PRAGMA foreign_key_list({name})")
+    ]
+    return SQLite3_Table(
+        header, rows, column_types, primary_keys, foreign_keys
+    )
+
+
+def get_tables(conn):
+    import sqlite3
+    try:
+        table_names = (
+            row[0] for row in conn.execute(
+                "SELECT name FROM sqlite_master "
+                "WHERE type = 'table' AND name NOT LIKE 'sqlite_%'"
+            )
+        )
+        tables = {name: get_table(conn, name) for name in table_names}
+        return tables
+    except sqlite3.Error as e:
+        typename= type(e).__name__
+        error_msg = str(e)
+        tables = {typename: error_msg}
+        return tables
+
+def sqlite_table_node(d):
+    import sqlite3
+    try:
+        headers = []
+        for name in d.header:
+            labels = []
+            # Declared SQLite column type
+            column_type = d.column_types.get(name)
+            if column_type:
+                labels.append(column_type)
+            # Primary key
+            if name in d.primary_keys:
+                labels.append("PK")
+            # Foreign key
+            if any(fk[0] == name for fk in d.foreign_keys):
+                labels.append("FK")
+
+            suffix = f" ({', '.join(labels)})" if labels else ""
+            headers.append(name + suffix)
+        return Node_Table(
+            d,
+            list(d.rows),
+            col_names=headers
+        )
+    except sqlite3.Error as e:
+        typename= type(e).__name__
+        error_msg = str(e)
+        return Node_Table(
+            d,
+            [[typename, error_msg]],
+        )
+
+def extend_sqlite3():
+    import sqlite3
+
+    config.type_to_node[sqlite3.Connection] = (
+        lambda d: Node_Key_Value(d, get_tables(d).items())
+    )
+    config.type_to_node[SQLite3_Table] = sqlite_table_node
+
+    config_default.type_to_color_light[SQLite3_Table] = "lightcyan"
+    config_default.type_to_color_dark[SQLite3_Table] = "#2c4f52"
+
+    if not config.color_mode_dark:
+        config.type_to_color[SQLite3_Table] = config_default.type_to_color_light[SQLite3_Table]
+    else:
+        config.type_to_color[SQLite3_Table] = config_default.type_to_color_dark[SQLite3_Table]
+
+def unextend_sqlite3():
+    del config.type_to_node[SQLite3_Table]
+    del config.type_to_color[SQLite3_Table]

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.90
+Version: 0.3.92
 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
@@ -1556,8 +1556,8 @@ mg.show(locals())
 # Extensions #
 Different extensions are available for types from other Python packages. 
 
-## Numpy ##
-For Numpy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
+## NumPy ##
+For NumPy types `array` and `matrix` and `ndarray`, use `mg.extend_numpy()`:
 
 ```python
 import memory_graph as mg
@@ -1574,12 +1574,12 @@ mg.show(locals())
 ```
 ![extension_numpy.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_numpy.png)
 
-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).
+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&timestep=0.5&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()`:
+For Pandas types `Series` and `DataFrame`, use `mg.extend_pandas()`:
 
 ```python
 import memory_graph as mg
@@ -1597,9 +1597,30 @@ mg.show(locals())
 ```
 ![extension_pandas.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_pandas.png)
 
-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).
+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&timestep=0.5&play).
+
+See this [introduction to Pandas operations](https://memory-graph.com/#micropip=numpy,pandas&codeurl=https://raw.githubusercontent.com/bterwijn/memory_graph/refs/heads/main/src/pandas_operations.py&timestep=0.5&play).
+
+## Polars ##
+For Polars types `DataFrame`, use `mg.extend_polars()`:
+
+```python
+import memory_graph as mg
+import polars as pl
+mg.extend_polars()
+
+df = pl.DataFrame(
+    {
+        "name": ["Alice Archer", "Ben Brown", "Chloe Cooper", "Daniel Donovan"],
+        "weight": [57.9, 72.5, 53.6, 83.1],  # (kg)
+        "height": [1.56, 1.77, 1.65, 1.75],  # (m)
+    }
+)
+
+mg.show(locals())
+```
+![extension_polars.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_polars.png)
 
-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()`:
@@ -1618,6 +1639,39 @@ mg.show(locals())
 ```
 ![extension_torch.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_torch.png)
 
+## SQLite3 ##
+For sqlite3 use `mg.extend_sqlite3()`:
+
+```python
+import memory_graph as mg
+import sqlite3
+mg.extend_sqlite3()
+
+conn = sqlite3.connect(":memory:")
+
+conn.executescript("""
+    CREATE TABLE students (
+        id INTEGER PRIMARY KEY,
+        name TEXT NOT NULL,
+        age INTEGER
+    );
+""")
+
+conn.executemany(
+    "INSERT INTO students VALUES (?, ?, ?)",
+    [
+        (1, "Alice", 20),
+        (2, "Bob", 21),
+        (3, "Charlie", 22),
+    ]
+)
+
+mg.show(locals())
+conn.close()
+```
+![extension_sqlite3.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/extension_sqlite3.png)
+
+
 # Memory Graph Web Debugger #
 The <a href="https://memory-graph.com/#play" target="_blank">Memory Graph Web Debugger</a> lets us use memory_graph without any installation.
 ![memory_graph_web_debugger.png](https://raw.githubusercontent.com/bterwijn/memory_graph/main/images/memory_graph_web_debugger.png)

{memory_graph-0.3.90 → memory_graph-0.3.92}/memory_graph.egg-info/SOURCES.txt

@@ -1,7 +1,6 @@
 LICENSE.txt
 README.md
 pyproject.toml
-setup.py
 memory_graph/__init__.py
 memory_graph/call_stack.py
 memory_graph/config.py
@@ -9,6 +8,8 @@ memory_graph/config_default.py
 memory_graph/config_helpers.py
 memory_graph/extension_numpy.py
 memory_graph/extension_pandas.py
+memory_graph/extension_polars.py
+memory_graph/extension_sqlite3.py
 memory_graph/extension_torch.py
 memory_graph/html_table.py
 memory_graph/list_view.py

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

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "memory_graph"
-version = "0.3.90"
+version = "0.3.92"
 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.90/setup.py

@@ -1,7 +0,0 @@
-from setuptools import setup
-
-setup(
-    name="memory-graph",
-    version="0.3.30",
-    packages=["memory_graph"],
-)