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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: memory_graph
-Version: 0.3.90
+Version: 0.3.91
 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
@@ -1579,7 +1579,7 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 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
@@ -1601,6 +1601,27 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 
 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).
 
+## 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)
+
+
 ## 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/PKG-INFO → memory_graph-0.3.91/README.md

@@ -1,23 +1,3 @@
-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:
 ```
@@ -1556,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
@@ -1579,7 +1559,7 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 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
@@ -1601,6 +1581,27 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 
 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).
 
+## 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)
+
+
 ## PyTorch ##
 For torch type `tensor`, use `mg.extend_torch()`:
 
@@ -1618,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.91}/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.91"
 __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.91/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.91/memory_graph/extension_sqlite3.py

@@ -0,0 +1,104 @@
+# 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 Numpy 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):
+    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
+
+
+def sqlite_table_node(d):
+    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
+    )
+
+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/README.md → memory_graph-0.3.91/memory_graph.egg-info/PKG-INFO

@@ -1,3 +1,23 @@
+Metadata-Version: 2.4
+Name: memory_graph
+Version: 0.3.91
+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:
 ```
@@ -1536,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
@@ -1559,7 +1579,7 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 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
@@ -1581,6 +1601,27 @@ Or see it in the [Memory Graph Web Debugger](https://memory-graph.com/#micropip=
 
 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).
 
+## 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)
+
+
 ## PyTorch ##
 For torch type `tensor`, use `mg.extend_torch()`:
 
@@ -1598,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.91}/memory_graph.egg-info/SOURCES.txt

@@ -9,6 +9,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.91}/pyproject.toml

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