anywidget-graph 0.2.5__tar.gz → 0.2.7__tar.gz

anywidget_graph-0.2.7/PKG-INFO

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: anywidget-graph
+Version: 0.2.7
+Summary: Interactive graph visualization for Python notebooks using anywidget
+Project-URL: Homepage, https://grafeo.dev/
+Project-URL: Repository, https://github.com/GrafeoDB/anywidget-graph
+Author-email: "S.T. Grond" <dev@grafeo.dev>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Keywords: anywidget,cypher,graph,jupyter,marimo,neo4j,visualization
+Classifier: Development Status :: 3 - Alpha
+Classifier: Framework :: Jupyter
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.12
+Requires-Dist: anywidget>=0.9.21
+Requires-Dist: marimo>=0.19.9
+Provides-Extra: cosmosdb
+Requires-Dist: gremlinpython>=3.7; extra == 'cosmosdb'
+Provides-Extra: demo
+Provides-Extra: dev
+Requires-Dist: marimo>=0.20; extra == 'dev'
+Requires-Dist: prek>=0.3; extra == 'dev'
+Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: ruff>=0.15; extra == 'dev'
+Requires-Dist: ty>=0.0.20; extra == 'dev'
+Provides-Extra: embed
+Provides-Extra: grafeo
+Requires-Dist: grafeo>=0.5; extra == 'grafeo'
+Provides-Extra: networkx
+Requires-Dist: networkx>=3.0; extra == 'networkx'
+Provides-Extra: pandas
+Requires-Dist: pandas>=2.0; extra == 'pandas'
+Description-Content-Type: text/markdown
+
+# anywidget-graph
+
+Interactive graph visualization for Python notebooks.
+
+Works with Marimo, Jupyter, VS Code, Colab, anywhere [anywidget](https://anywidget.dev/) runs.
+
+## Features
+
+- **Universal**: One widget, every notebook environment
+- **Backend-agnostic**: Grafeo, Neo4j, NetworkX, pandas, or raw dicts
+- **Interactive**: Pan, zoom, click, drag, pin, expand neighbors, box select
+- **Customizable**: Colors, sizes, layouts, dark mode
+- **Exportable**: HTML, JSON
+
+## Installation
+
+```bash
+uv add anywidget-graph
+```
+
+Optional extras:
+
+```bash
+uv add "anywidget-graph[networkx]"   # NetworkX support
+uv add "anywidget-graph[pandas]"     # pandas support
+uv add "anywidget-graph[grafeo]"     # Grafeo backend
+uv add "anywidget-graph[cosmosdb]"   # CosmosDB / Gremlin support
+```
+
+## Quick Start
+
+```python
+from anywidget_graph import Graph
+
+graph = Graph.from_dict({
+    "nodes": [
+        {"id": "alice", "label": "Alice", "group": "person"},
+        {"id": "bob", "label": "Bob", "group": "person"},
+        {"id": "paper", "label": "Graph Theory", "group": "document"},
+    ],
+    "edges": [
+        {"source": "alice", "target": "bob", "label": "knows"},
+        {"source": "alice", "target": "paper", "label": "authored"},
+    ]
+})
+
+graph
+```
+
+## Data Sources
+
+### Dictionary
+
+```python
+graph = Graph.from_dict({
+    "nodes": [{"id": "a"}, {"id": "b"}],
+    "edges": [{"source": "a", "target": "b"}]
+})
+```
+
+### Direct initialization
+
+```python
+graph = Graph(
+    nodes=[{"id": "a", "label": "Alice"}, {"id": "b", "label": "Bob"}],
+    edges=[{"source": "a", "target": "b", "label": "KNOWS"}],
+)
+```
+
+### Cypher results (Neo4j)
+
+```python
+from neo4j import GraphDatabase
+
+driver = GraphDatabase.driver("bolt://localhost:7687", auth=("neo4j", "password"))
+
+with driver.session() as session:
+    result = session.run("MATCH (a)-[r]->(b) RETURN a, r, b LIMIT 100")
+    graph = Graph.from_cypher(result)
+```
+
+### GQL results
+
+```python
+graph = Graph.from_gql(result)
+```
+
+### SPARQL results
+
+```python
+from rdflib import Graph as RDFGraph
+
+g = RDFGraph()
+g.parse("data.ttl")
+result = g.query("SELECT ?s ?p ?o WHERE { ?s ?p ?o }")
+graph = Graph.from_sparql(result)
+```
+
+### Gremlin results (CosmosDB, TinkerPop)
+
+```python
+graph = Graph.from_gremlin(result)
+```
+
+### GraphQL results
+
+```python
+graph = Graph.from_graphql(
+    response.json(),
+    nodes_path="data.characters.results",
+    id_field="id",
+    label_field="name",
+)
+```
+
+### NetworkX
+
+```python
+import networkx as nx
+
+G = nx.karate_club_graph()
+graph = Graph.from_networkx(G)
+```
+
+### pandas DataFrames
+
+```python
+import pandas as pd
+
+nodes_df = pd.DataFrame({"id": ["alice", "bob"], "group": ["person", "person"]})
+edges_df = pd.DataFrame({"source": ["alice"], "target": ["bob"], "weight": [1.0]})
+
+graph = Graph.from_dataframe(nodes_df, edges_df)
+```
+
+## Interactivity
+
+### Events
+
+```python
+graph = Graph.from_dict(data)
+
+@graph.on_node_click
+def handle_node(node_id, node_data):
+    print(f"Clicked: {node_id}")
+
+@graph.on_edge_click
+def handle_edge(edge_data):
+    print(f"Edge: {edge_data['label']}")
+
+@graph.on_selection
+def handle_selection(node_ids):
+    print(f"Selected: {node_ids}")
+```
+
+### Selection
+
+```python
+graph.selected_nodes            # Current selection (list of IDs)
+graph.selection_mode = "box"    # Switch to box-select mode
+```
+
+### Node expansion
+
+```python
+graph.expand_node("alice")      # Fetch and merge neighbors (requires backend)
+```
+
+### Node pinning
+
+```python
+graph.pin_nodes(["alice", "bob"])   # Pin at current positions
+graph.unpin_nodes(["alice"])        # Release back to layout
+graph.toggle_pin("bob")            # Toggle pin state
+graph.unpin_all()                   # Unpin everything
+```
+
+### Clear
+
+```python
+graph.clear()                   # Remove all nodes, edges, pins, and selection
+```
+
+## Styling
+
+### Property-based coloring
+
+```python
+graph = Graph.from_dict(
+    data,
+    color_field="group",               # Color nodes by field
+    color_scale="viridis",             # Scale: viridis, plasma, inferno, magma, cividis, turbo
+    size_field="score",                # Size nodes by field
+    size_range=[5, 30],                # Min/max node size
+)
+```
+
+### Edge styling
+
+```python
+graph.edge_color_field = "type"
+graph.edge_color_scale = "plasma"
+graph.edge_size_field = "weight"
+graph.edge_size_range = [1, 8]
+```
+
+### Layouts
+
+```python
+Graph.from_dict(data, layout="force")      # ForceAtlas2 (default)
+Graph.from_dict(data, layout="circular")
+Graph.from_dict(data, layout="random")
+```
+
+## Options
+
+```python
+graph = Graph(
+    nodes=nodes,
+    edges=edges,
+    width=800,                  # Widget width (px)
+    height=600,                 # Widget height (px)
+    background="#fafafa",       # Background color
+    show_labels=True,           # Node labels
+    show_edge_labels=False,     # Edge labels
+    show_toolbar=True,          # Toolbar visibility
+    show_settings=True,         # Settings panel
+    show_query_input=True,      # Query input box
+    dark_mode=True,             # Dark theme
+    show_tooltip=True,          # Hover tooltips
+    tooltip_fields=["label", "id"],
+    max_nodes=300,              # Limit for node expansion
+)
+```
+
+## Database Backends
+
+### Grafeo (default)
+
+```python
+import grafeo
+db = grafeo.GrafeoDB()
+graph = Graph(database_backend="grafeo", grafeo_db=db)
+```
+
+### Neo4j (browser-side)
+
+```python
+graph = Graph(
+    database_backend="neo4j",
+    connection_uri="neo4j+s://demo.neo4jlabs.com",
+    connection_username="neo4j",
+    connection_password="password",
+)
+```
+
+### Generic backend
+
+```python
+graph = Graph(backend=my_backend)  # Any object implementing DatabaseBackend protocol
+```
+
+## Export
+
+```python
+graph.to_json()                         # JSON string with nodes and edges
+graph.to_html()                         # Self-contained HTML string
+graph.to_html(title="My Graph")         # Custom title
+graph.save_html("graph.html")           # Write HTML to file
+```
+
+## Environment Support
+
+| Environment | Supported |
+|-------------|-----------|
+| Marimo | Yes |
+| JupyterLab | Yes |
+| Jupyter Notebook | Yes |
+| VS Code | Yes |
+| Google Colab | Yes |
+| Databricks | Yes |
+
+## Related
+
+- [anywidget](https://anywidget.dev/), custom Jupyter widgets made easy
+- [Grafeo](https://github.com/GrafeoDB/grafeo), embeddable graph database
+- [grafeo-web](https://github.com/GrafeoDB/grafeo-web), Grafeo in the browser
+
+## License
+
+Apache-2.0

anywidget_graph-0.2.7/README.md

@@ -0,0 +1,291 @@
+# anywidget-graph
+
+Interactive graph visualization for Python notebooks.
+
+Works with Marimo, Jupyter, VS Code, Colab, anywhere [anywidget](https://anywidget.dev/) runs.
+
+## Features
+
+- **Universal**: One widget, every notebook environment
+- **Backend-agnostic**: Grafeo, Neo4j, NetworkX, pandas, or raw dicts
+- **Interactive**: Pan, zoom, click, drag, pin, expand neighbors, box select
+- **Customizable**: Colors, sizes, layouts, dark mode
+- **Exportable**: HTML, JSON
+
+## Installation
+
+```bash
+uv add anywidget-graph
+```
+
+Optional extras:
+
+```bash
+uv add "anywidget-graph[networkx]"   # NetworkX support
+uv add "anywidget-graph[pandas]"     # pandas support
+uv add "anywidget-graph[grafeo]"     # Grafeo backend
+uv add "anywidget-graph[cosmosdb]"   # CosmosDB / Gremlin support
+```
+
+## Quick Start
+
+```python
+from anywidget_graph import Graph
+
+graph = Graph.from_dict({
+    "nodes": [
+        {"id": "alice", "label": "Alice", "group": "person"},
+        {"id": "bob", "label": "Bob", "group": "person"},
+        {"id": "paper", "label": "Graph Theory", "group": "document"},
+    ],
+    "edges": [
+        {"source": "alice", "target": "bob", "label": "knows"},
+        {"source": "alice", "target": "paper", "label": "authored"},
+    ]
+})
+
+graph
+```
+
+## Data Sources
+
+### Dictionary
+
+```python
+graph = Graph.from_dict({
+    "nodes": [{"id": "a"}, {"id": "b"}],
+    "edges": [{"source": "a", "target": "b"}]
+})
+```
+
+### Direct initialization
+
+```python
+graph = Graph(
+    nodes=[{"id": "a", "label": "Alice"}, {"id": "b", "label": "Bob"}],
+    edges=[{"source": "a", "target": "b", "label": "KNOWS"}],
+)
+```
+
+### Cypher results (Neo4j)
+
+```python
+from neo4j import GraphDatabase
+
+driver = GraphDatabase.driver("bolt://localhost:7687", auth=("neo4j", "password"))
+
+with driver.session() as session:
+    result = session.run("MATCH (a)-[r]->(b) RETURN a, r, b LIMIT 100")
+    graph = Graph.from_cypher(result)
+```
+
+### GQL results
+
+```python
+graph = Graph.from_gql(result)
+```
+
+### SPARQL results
+
+```python
+from rdflib import Graph as RDFGraph
+
+g = RDFGraph()
+g.parse("data.ttl")
+result = g.query("SELECT ?s ?p ?o WHERE { ?s ?p ?o }")
+graph = Graph.from_sparql(result)
+```
+
+### Gremlin results (CosmosDB, TinkerPop)
+
+```python
+graph = Graph.from_gremlin(result)
+```
+
+### GraphQL results
+
+```python
+graph = Graph.from_graphql(
+    response.json(),
+    nodes_path="data.characters.results",
+    id_field="id",
+    label_field="name",
+)
+```
+
+### NetworkX
+
+```python
+import networkx as nx
+
+G = nx.karate_club_graph()
+graph = Graph.from_networkx(G)
+```
+
+### pandas DataFrames
+
+```python
+import pandas as pd
+
+nodes_df = pd.DataFrame({"id": ["alice", "bob"], "group": ["person", "person"]})
+edges_df = pd.DataFrame({"source": ["alice"], "target": ["bob"], "weight": [1.0]})
+
+graph = Graph.from_dataframe(nodes_df, edges_df)
+```
+
+## Interactivity
+
+### Events
+
+```python
+graph = Graph.from_dict(data)
+
+@graph.on_node_click
+def handle_node(node_id, node_data):
+    print(f"Clicked: {node_id}")
+
+@graph.on_edge_click
+def handle_edge(edge_data):
+    print(f"Edge: {edge_data['label']}")
+
+@graph.on_selection
+def handle_selection(node_ids):
+    print(f"Selected: {node_ids}")
+```
+
+### Selection
+
+```python
+graph.selected_nodes            # Current selection (list of IDs)
+graph.selection_mode = "box"    # Switch to box-select mode
+```
+
+### Node expansion
+
+```python
+graph.expand_node("alice")      # Fetch and merge neighbors (requires backend)
+```
+
+### Node pinning
+
+```python
+graph.pin_nodes(["alice", "bob"])   # Pin at current positions
+graph.unpin_nodes(["alice"])        # Release back to layout
+graph.toggle_pin("bob")            # Toggle pin state
+graph.unpin_all()                   # Unpin everything
+```
+
+### Clear
+
+```python
+graph.clear()                   # Remove all nodes, edges, pins, and selection
+```
+
+## Styling
+
+### Property-based coloring
+
+```python
+graph = Graph.from_dict(
+    data,
+    color_field="group",               # Color nodes by field
+    color_scale="viridis",             # Scale: viridis, plasma, inferno, magma, cividis, turbo
+    size_field="score",                # Size nodes by field
+    size_range=[5, 30],                # Min/max node size
+)
+```
+
+### Edge styling
+
+```python
+graph.edge_color_field = "type"
+graph.edge_color_scale = "plasma"
+graph.edge_size_field = "weight"
+graph.edge_size_range = [1, 8]
+```
+
+### Layouts
+
+```python
+Graph.from_dict(data, layout="force")      # ForceAtlas2 (default)
+Graph.from_dict(data, layout="circular")
+Graph.from_dict(data, layout="random")
+```
+
+## Options
+
+```python
+graph = Graph(
+    nodes=nodes,
+    edges=edges,
+    width=800,                  # Widget width (px)
+    height=600,                 # Widget height (px)
+    background="#fafafa",       # Background color
+    show_labels=True,           # Node labels
+    show_edge_labels=False,     # Edge labels
+    show_toolbar=True,          # Toolbar visibility
+    show_settings=True,         # Settings panel
+    show_query_input=True,      # Query input box
+    dark_mode=True,             # Dark theme
+    show_tooltip=True,          # Hover tooltips
+    tooltip_fields=["label", "id"],
+    max_nodes=300,              # Limit for node expansion
+)
+```
+
+## Database Backends
+
+### Grafeo (default)
+
+```python
+import grafeo
+db = grafeo.GrafeoDB()
+graph = Graph(database_backend="grafeo", grafeo_db=db)
+```
+
+### Neo4j (browser-side)
+
+```python
+graph = Graph(
+    database_backend="neo4j",
+    connection_uri="neo4j+s://demo.neo4jlabs.com",
+    connection_username="neo4j",
+    connection_password="password",
+)
+```
+
+### Generic backend
+
+```python
+graph = Graph(backend=my_backend)  # Any object implementing DatabaseBackend protocol
+```
+
+## Export
+
+```python
+graph.to_json()                         # JSON string with nodes and edges
+graph.to_html()                         # Self-contained HTML string
+graph.to_html(title="My Graph")         # Custom title
+graph.save_html("graph.html")           # Write HTML to file
+```
+
+## Environment Support
+
+| Environment | Supported |
+|-------------|-----------|
+| Marimo | Yes |
+| JupyterLab | Yes |
+| Jupyter Notebook | Yes |
+| VS Code | Yes |
+| Google Colab | Yes |
+| Databricks | Yes |
+
+## Related
+
+- [anywidget](https://anywidget.dev/), custom Jupyter widgets made easy
+- [Grafeo](https://github.com/GrafeoDB/grafeo), embeddable graph database
+- [grafeo-web](https://github.com/GrafeoDB/grafeo-web), Grafeo in the browser
+
+## License
+
+Apache-2.0

{anywidget_graph-0.2.5 → anywidget_graph-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anywidget-graph"
-version = "0.2.5"
+version = "0.2.7"
 description = "Interactive graph visualization for Python notebooks using anywidget"
 readme = "README.md"
 license = "Apache-2.0"
@@ -27,15 +27,15 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "prek>=0.3.2",
+    "prek>=0.3",
     "pytest>=9.0.2",
-    "ruff>=0.15.0",
-    "ty>=0.0.16",
-    "marimo>=0.19.9",
+    "ruff>=0.15",
+    "ty>=0.0.20",
+    "marimo>=0.20",
 ]
 networkx = ["networkx>=3.0"]
 pandas = ["pandas>=2.0"]
-grafeo = ["grafeo>=0.5.0"]
+grafeo = ["grafeo>=0.5"]
 cosmosdb = ["gremlinpython>=3.7"]
 embed = []  # Marker extra — WASM loads from CDN on demand
 demo = []  # Marker extra — enables demo mode with pre-populated dataset

{anywidget_graph-0.2.5 → anywidget_graph-0.2.7}/src/anywidget_graph/__init__.py

@@ -3,4 +3,4 @@
 from anywidget_graph.widget import Graph
 
 __all__ = ["Graph"]
-__version__ = "0.2.5"
+__version__ = "0.2.7"

{anywidget_graph-0.2.5 → anywidget_graph-0.2.7}/src/anywidget_graph/ui/__init__.py

@@ -147,6 +147,9 @@ def get_esm() -> str:
 // === Auto-generated ESM bundle for anywidget-graph ===
 import Graph from "https://esm.sh/graphology@0.25.4";
 import Sigma from "https://esm.sh/sigma@3.0.0";
+import circular from "https://esm.sh/graphology-layout@0.6.1/circular.js";
+import random from "https://esm.sh/graphology-layout@0.6.1/random.js";
+import forceAtlas2 from "https://esm.sh/graphology-layout-forceatlas2@0.10.1";
 import neo4j from "https://cdn.jsdelivr.net/npm/neo4j-driver@5.28.0/lib/browser/neo4j-web.esm.min.js";
 
 // === Icons ===

{anywidget_graph-0.2.5 → anywidget_graph-0.2.7}/src/anywidget_graph/ui/icons.js

@@ -12,4 +12,8 @@ export const ICONS = {
   property: `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 7h16M4 12h16M4 17h10"/></svg>`,
   sidebar: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M9 3v18"/></svg>`,
   refresh: `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M23 4v6h-6M1 20v-6h6"/><path d="M3.51 9a9 9 0 0114.85-3.36L23 10M1 14l4.64 4.36A9 9 0 0020.49 15"/></svg>`,
+  zoomIn: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/><line x1="11" y1="8" x2="11" y2="14"/><line x1="8" y1="11" x2="14" y2="11"/></svg>`,
+  zoomOut: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/><line x1="8" y1="11" x2="14" y2="11"/></svg>`,
+  zoomFit: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"/></svg>`,
+  search: `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>`,
 };