anywidget-graph 0.1.0__tar.gz

anywidget_graph-0.1.0/.gitignore

@@ -0,0 +1,33 @@
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.cl*/
+*.egg-info/
+.installed.cfg
+*.egg
+.venv/
+venv/
+ENV/
+.env
+*.log
+.coverage
+htmlcov/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.ty/
+node_modules/

anywidget_graph-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

anywidget_graph-0.1.0/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.4
+Name: anywidget-graph
+Version: 0.1.0
+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" <widget@grafeo.dev>
+License: Apache-2.0
+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
+Provides-Extra: dev
+Requires-Dist: marimo>=0.19.7; extra == 'dev'
+Requires-Dist: prek>=0.3.1; extra == 'dev'
+Requires-Dist: pytest>=9.0.2; extra == 'dev'
+Requires-Dist: ruff>=0.14.14; extra == 'dev'
+Requires-Dist: ty>=0.0.14; extra == 'dev'
+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, expand neighbors, select paths
+- **Customizable** — Colors, sizes, shapes, layouts
+- **Performant** — Virtualized rendering for large graphs
+- **Exportable** — PNG, SVG, JSON
+
+## Installation
+
+```bash
+uv add anywidget-graph
+```
+
+## 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
+from anywidget_graph import Graph
+
+graph = Graph.from_dict({
+    "nodes": [{"id": "a"}, {"id": "b"}],
+    "edges": [{"source": "a", "target": "b"}]
+})
+```
+
+### Grafeo
+
+```python
+from grafeo import GrafeoDB
+from anywidget_graph import Graph
+
+db = GrafeoDB()
+db.execute("INSERT (:Person {name: 'Alice'})-[:KNOWS]->(:Person {name: 'Bob'})")
+
+result = db.execute("MATCH (a)-[r]->(b) RETURN a, r, b")
+graph = Graph.from_grafeo(result)
+```
+
+### Neo4j
+
+```python
+from neo4j import GraphDatabase
+from anywidget_graph import Graph
+
+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_neo4j(result)
+```
+
+### NetworkX
+
+```python
+import networkx as nx
+from anywidget_graph import Graph
+
+G = nx.karate_club_graph()
+graph = Graph.from_networkx(G)
+```
+
+### pandas
+
+```python
+import pandas as pd
+from anywidget_graph import Graph
+
+edges = pd.DataFrame({
+    "source": ["alice", "alice", "bob"],
+    "target": ["bob", "carol", "carol"],
+    "weight": [1.0, 0.5, 0.8]
+})
+
+graph = Graph.from_pandas(edges)
+```
+
+## 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_id, edge_data):
+    print(f"Edge: {edge_data['label']}")
+```
+
+### Selection
+
+```python
+graph.selected_nodes         # Get current selection
+graph.select(["alice"])      # Select nodes
+graph.clear_selection()      # Clear
+```
+
+### Expansion
+
+```python
+graph.expand("alice")        # Show neighbors
+graph.collapse("alice")      # Hide neighbors
+```
+
+## Styling
+
+### By Group
+
+```python
+graph = Graph.from_dict(
+    data,
+    node_styles={
+        "person": {"color": "#4CAF50", "size": 30},
+        "document": {"color": "#2196F3", "shape": "square"},
+    }
+)
+```
+
+### By Property
+
+```python
+graph = Graph.from_dict(
+    data,
+    node_color="group",                    # Color by field
+    node_size=lambda n: n["score"] * 10,   # Size by function
+    edge_width="weight",                   # Width by field
+)
+```
+
+### Layouts
+
+```python
+Graph.from_dict(data, layout="force")        # Default
+Graph.from_dict(data, layout="hierarchical")
+Graph.from_dict(data, layout="circular")
+Graph.from_dict(data, layout="grid")
+```
+
+## Options
+
+```python
+graph = Graph.from_dict(
+    data,
+    width=800,
+    height=600,
+    directed=True,
+    labels=True,
+    edge_labels=False,
+    physics=True,
+    zoom=(0.1, 4),
+)
+```
+
+## Large Graphs
+
+For 1000+ nodes:
+
+```python
+graph = Graph.from_dict(
+    data,
+    virtualize=True,
+    cluster=True,
+)
+```
+
+## Export
+
+```python
+graph.to_png("graph.png")
+graph.to_svg("graph.svg")
+graph.to_json("graph.json")
+```
+
+## Environment Support
+
+| Environment | Supported |
+|-------------|-----------|
+| Marimo | ✅ |
+| JupyterLab | ✅ |
+| Jupyter Notebook | ✅ |
+| VS Code | ✅ |
+| Google Colab | ✅ |
+| Databricks | ✅ |
+
+## Related
+
+- [anywidget](https://anywidget.dev/) — Custom Jupyter widgets made easy
+- [Grafeo](https://github.com/GrafeoDB/grafeo) — Embeddable graph database
+- [grafeo-wasm](https://github.com/GrafeoDB/grafeo-wasm) — Grafeo in the browser
+
+## License
+
+Apache-2.0

anywidget_graph-0.1.0/README.md

@@ -0,0 +1,225 @@
+# 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, expand neighbors, select paths
+- **Customizable** — Colors, sizes, shapes, layouts
+- **Performant** — Virtualized rendering for large graphs
+- **Exportable** — PNG, SVG, JSON
+
+## Installation
+
+```bash
+uv add anywidget-graph
+```
+
+## 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
+from anywidget_graph import Graph
+
+graph = Graph.from_dict({
+    "nodes": [{"id": "a"}, {"id": "b"}],
+    "edges": [{"source": "a", "target": "b"}]
+})
+```
+
+### Grafeo
+
+```python
+from grafeo import GrafeoDB
+from anywidget_graph import Graph
+
+db = GrafeoDB()
+db.execute("INSERT (:Person {name: 'Alice'})-[:KNOWS]->(:Person {name: 'Bob'})")
+
+result = db.execute("MATCH (a)-[r]->(b) RETURN a, r, b")
+graph = Graph.from_grafeo(result)
+```
+
+### Neo4j
+
+```python
+from neo4j import GraphDatabase
+from anywidget_graph import Graph
+
+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_neo4j(result)
+```
+
+### NetworkX
+
+```python
+import networkx as nx
+from anywidget_graph import Graph
+
+G = nx.karate_club_graph()
+graph = Graph.from_networkx(G)
+```
+
+### pandas
+
+```python
+import pandas as pd
+from anywidget_graph import Graph
+
+edges = pd.DataFrame({
+    "source": ["alice", "alice", "bob"],
+    "target": ["bob", "carol", "carol"],
+    "weight": [1.0, 0.5, 0.8]
+})
+
+graph = Graph.from_pandas(edges)
+```
+
+## 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_id, edge_data):
+    print(f"Edge: {edge_data['label']}")
+```
+
+### Selection
+
+```python
+graph.selected_nodes         # Get current selection
+graph.select(["alice"])      # Select nodes
+graph.clear_selection()      # Clear
+```
+
+### Expansion
+
+```python
+graph.expand("alice")        # Show neighbors
+graph.collapse("alice")      # Hide neighbors
+```
+
+## Styling
+
+### By Group
+
+```python
+graph = Graph.from_dict(
+    data,
+    node_styles={
+        "person": {"color": "#4CAF50", "size": 30},
+        "document": {"color": "#2196F3", "shape": "square"},
+    }
+)
+```
+
+### By Property
+
+```python
+graph = Graph.from_dict(
+    data,
+    node_color="group",                    # Color by field
+    node_size=lambda n: n["score"] * 10,   # Size by function
+    edge_width="weight",                   # Width by field
+)
+```
+
+### Layouts
+
+```python
+Graph.from_dict(data, layout="force")        # Default
+Graph.from_dict(data, layout="hierarchical")
+Graph.from_dict(data, layout="circular")
+Graph.from_dict(data, layout="grid")
+```
+
+## Options
+
+```python
+graph = Graph.from_dict(
+    data,
+    width=800,
+    height=600,
+    directed=True,
+    labels=True,
+    edge_labels=False,
+    physics=True,
+    zoom=(0.1, 4),
+)
+```
+
+## Large Graphs
+
+For 1000+ nodes:
+
+```python
+graph = Graph.from_dict(
+    data,
+    virtualize=True,
+    cluster=True,
+)
+```
+
+## Export
+
+```python
+graph.to_png("graph.png")
+graph.to_svg("graph.svg")
+graph.to_json("graph.json")
+```
+
+## Environment Support
+
+| Environment | Supported |
+|-------------|-----------|
+| Marimo | ✅ |
+| JupyterLab | ✅ |
+| Jupyter Notebook | ✅ |
+| VS Code | ✅ |
+| Google Colab | ✅ |
+| Databricks | ✅ |
+
+## Related
+
+- [anywidget](https://anywidget.dev/) — Custom Jupyter widgets made easy
+- [Grafeo](https://github.com/GrafeoDB/grafeo) — Embeddable graph database
+- [grafeo-wasm](https://github.com/GrafeoDB/grafeo-wasm) — Grafeo in the browser
+
+## License
+
+Apache-2.0

anywidget_graph-0.1.0/examples/demo.py

@@ -0,0 +1,58 @@
+"""Marimo demo for anywidget-graph."""
+
+import marimo
+
+__generated_with = "0.19.5"
+app = marimo.App(width="medium")
+
+
+@app.cell
+def _():
+    import marimo as mo
+
+    return (mo,)
+
+
+@app.cell
+def _():
+    from anywidget_graph import Graph
+
+    return (Graph,)
+
+
+@app.cell
+def _(Graph):
+    # Create a simple graph from a dictionary
+    graph = Graph.from_dict(
+        {
+            "nodes": [
+                {"id": "alice", "label": "Alice", "color": "#4CAF50"},
+                {"id": "bob", "label": "Bob", "color": "#2196F3"},
+                {"id": "carol", "label": "Carol", "color": "#FF9800"},
+                {"id": "paper", "label": "Graph Theory", "color": "#9C27B0"},
+            ],
+            "edges": [
+                {"source": "alice", "target": "bob", "label": "knows"},
+                {"source": "alice", "target": "carol", "label": "knows"},
+                {"source": "bob", "target": "carol", "label": "knows"},
+                {"source": "alice", "target": "paper", "label": "authored"},
+                {"source": "bob", "target": "paper", "label": "reviewed"},
+            ],
+        },
+        width=800,
+        height=500,
+    )
+
+    graph
+    return (graph,)
+
+
+@app.cell
+def _(graph, mo):
+    # Display selected node info
+    mo.md(f"**Selected node:** {graph.selected_node}")
+    return ()
+
+
+if __name__ == "__main__":
+    app.run()

anywidget_graph-0.1.0/pyproject.toml

@@ -0,0 +1,87 @@
+[project]
+name = "anywidget-graph"
+version = "0.1.0"
+description = "Interactive graph visualization for Python notebooks using anywidget"
+readme = "README.md"
+license = { text = "Apache-2.0" }
+requires-python = ">=3.12"
+authors = [{ name = "S.T. Grond", email = "widget@grafeo.dev" }]
+keywords = ["anywidget", "graph", "visualization", "jupyter", "marimo", "cypher", "neo4j"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Framework :: Jupyter",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Science/Research",
+    "License :: OSI Approved :: Apache Software License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+
+dependencies = [
+    "anywidget>=0.9.21",
+]
+
+[project.optional-dependencies]
+dev = [
+    "prek>=0.3.1",
+    "pytest>=9.0.2",
+    "ruff>=0.14.14",
+    "ty>=0.0.14",
+    "marimo>=0.19.7",
+]
+networkx = ["networkx>=3.0"]
+pandas = ["pandas>=2.0"]
+
+[project.urls]
+Homepage = "https://grafeo.dev/"
+Repository = "https://github.com/GrafeoDB/anywidget-graph"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/anywidget_graph"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "UP",
+    "FA",
+    "Q",
+]
+
+[tool.ruff.lint.flake8-quotes]
+inline-quotes = "double"
+docstring-quotes = "double"
+
+[tool.ty.environment]
+python-version = "3.12"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+addopts = "-v"
+
+[tool.prek]
+repos = [
+    { repo = "ruff", hooks = [
+        { id = "ruff-check", args = ["--fix", "--exit-non-zero-on-fix"] },
+        { id = "ruff-format" },
+    ]},
+]
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=9.0.2",
+    "ruff>=0.14.14",
+]

anywidget_graph-0.1.0/src/anywidget_graph/__init__.py

@@ -0,0 +1,6 @@
+"""Interactive graph visualization for Python notebooks."""
+
+from anywidget_graph.widget import Graph
+
+__all__ = ["Graph"]
+__version__ = "0.1.0"