garphield 0.1.0__tar.gz

garphield-0.1.0/.gitignore

@@ -0,0 +1,91 @@
+toms-air*
+# dependencies
+node_modules
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.pnp.*
+.npm
+web_modules/
+
+# blitz
+/.blitz/
+/.next/
+/out/
+*.sqlite
+*.sqlite-journal
+.now
+.blitz-console-history
+blitz-log.log
+.blitz.config.compiled.js
+
+# misc
+.DS_Store
+
+# local env files
+.env
+.env.local
+.env.*.local
+.env.*
+!.env.example
+.envrc
+
+# Logs
+logs
+*.log
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Testing
+.coverage
+coverage
+playwright-report
+test-results
+*.lcov
+.nyc_output
+lib-cov
+
+# Caches
+.astro/
+*.tsbuildinfo
+.eslintcache
+.pnpm-store/
+.node_repl_history
+.yarn-integrity
+
+# Serverless directories
+.serverless/
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+.nova
+dist
+
+# Bench screenshots (regenerated by scripts/test-node-size-cap.mjs)
+screenshots/
+
+# git worktrees created inside the repo (parallel agents / wt)
+.worktrees/
+
+# Python environments and their caches (scripts/bootstrap-python.sh,
+# scripts/lock-python-requirements.sh) — all disposable, all rebuildable.
+__pycache__/
+*.py[cod]
+/.venv-python/
+/.venv-python-tools-py310/
+/.venv-python-tools-py311/
+/.venv-python-tools-py312/
+/.cache/pip/
+/.cache/pycache/
+/.cache/ms-playwright/
+/.tmp/python-lock/
+/.tmp/python-bootstrap/
+
+# Generated by `pnpm python:app:stage` immediately before Python packaging.
+/python/src/garphield/static/app/
+/python/THIRD_PARTY_NOTICES.md

garphield-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ammil Industries
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

garphield-0.1.0/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: garphield
+Version: 0.1.0
+Summary: Validated Python round-trip primitives for Garphield projects
+Author: Garphield contributors
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: <3.15,>=3.10
+Requires-Dist: anywidget<1,>=0.9
+Requires-Dist: jsonschema<5,>=4.23
+Requires-Dist: jupyter-ui-poll<2,>=1.0
+Requires-Dist: rfc8785<0.2,>=0.1.4
+Provides-Extra: networkx
+Requires-Dist: networkx<3.5,>=3.4.2; (python_version == '3.10') and extra == 'networkx'
+Requires-Dist: networkx<4,>=3.6.1; (python_version >= '3.11') and extra == 'networkx'
+Requires-Dist: pandas<4,>=2.2; extra == 'networkx'
+Provides-Extra: tables
+Requires-Dist: pandas<3,>=2.2; extra == 'tables'
+Description-Content-Type: text/markdown
+
+# garphield for Python
+
+Explore graphs visually from a notebook. Pass a NetworkX graph or pandas
+DataFrame to `show()` and get an interactive Garphield view inline - then
+open the full workbench to build stories, apply layouts, and return the
+result to Python.
+
+```python
+import garphield as gf
+import networkx as nx
+
+G = nx.karate_club_graph()
+view = gf.show(
+    G,
+    node_color="club",
+    node_size=G.degree,
+    node_label=str,
+)
+```
+
+Once the view is displayed, drive it from Python:
+
+```python
+view.select([0, 1, 2]).fit()
+view.bind("node_color", gf.algorithm("louvain", resolution=1.1))
+edited = view.to_project()
+```
+
+## Install
+
+```bash
+pip install garphield
+```
+
+With NetworkX and pandas adapters:
+
+```bash
+pip install 'garphield[tables,networkx]'
+```
+
+## From pandas
+
+```python
+import pandas as pd
+from garphield import Project
+
+edges = pd.DataFrame({"source": ["a"], "target": ["b"], "weight": [1.5]})
+project = Project.from_pandas(edges)
+tables = project.to_pandas()
+```
+
+## Project files
+
+Read, validate, and write `.gph` project files:
+
+```python
+from garphield import Project
+
+project = Project.load("project.gph")
+print(project.semantic_fingerprint())
+project.save("project-copy.gph")
+```
+
+`Project.save()` writes deterministic, human-readable JSON. Semantic and
+project fingerprints use RFC 8785/JCS canonical bytes.
+
+## Notebook round-trip
+
+The wheel carries a version-matched notebook renderer, so the view works
+without a hosted renderer or CDN. Use **Open in Garphield** to continue
+in the full workbench at [garphield.com](https://garphield.com), then
+**Return to notebook** to bring the result back to Python.
+
+Use `chrome=["minimap"]` or `chrome=["toolbar"]` to keep embeds
+lightweight. `project.save_html("graph.html", chrome=["minimap"])` writes
+a standalone interactive HTML file.
+
+## Environments
+
+Local Jupyter, VS Code notebooks, JupyterHub, Google Colab, and Snowflake
+Snowpark notebooks are resolved automatically. For Snowpark, use
+`show_snowpark()` which materializes selected tables in the kernel before
+handoff.
+
+## Links
+
+- [garphield.com](https://garphield.com)
+- [GitHub](https://github.com/ammil-industries/garphield)

garphield-0.1.0/README.md

@@ -0,0 +1,88 @@
+# garphield for Python
+
+Explore graphs visually from a notebook. Pass a NetworkX graph or pandas
+DataFrame to `show()` and get an interactive Garphield view inline - then
+open the full workbench to build stories, apply layouts, and return the
+result to Python.
+
+```python
+import garphield as gf
+import networkx as nx
+
+G = nx.karate_club_graph()
+view = gf.show(
+    G,
+    node_color="club",
+    node_size=G.degree,
+    node_label=str,
+)
+```
+
+Once the view is displayed, drive it from Python:
+
+```python
+view.select([0, 1, 2]).fit()
+view.bind("node_color", gf.algorithm("louvain", resolution=1.1))
+edited = view.to_project()
+```
+
+## Install
+
+```bash
+pip install garphield
+```
+
+With NetworkX and pandas adapters:
+
+```bash
+pip install 'garphield[tables,networkx]'
+```
+
+## From pandas
+
+```python
+import pandas as pd
+from garphield import Project
+
+edges = pd.DataFrame({"source": ["a"], "target": ["b"], "weight": [1.5]})
+project = Project.from_pandas(edges)
+tables = project.to_pandas()
+```
+
+## Project files
+
+Read, validate, and write `.gph` project files:
+
+```python
+from garphield import Project
+
+project = Project.load("project.gph")
+print(project.semantic_fingerprint())
+project.save("project-copy.gph")
+```
+
+`Project.save()` writes deterministic, human-readable JSON. Semantic and
+project fingerprints use RFC 8785/JCS canonical bytes.
+
+## Notebook round-trip
+
+The wheel carries a version-matched notebook renderer, so the view works
+without a hosted renderer or CDN. Use **Open in Garphield** to continue
+in the full workbench at [garphield.com](https://garphield.com), then
+**Return to notebook** to bring the result back to Python.
+
+Use `chrome=["minimap"]` or `chrome=["toolbar"]` to keep embeds
+lightweight. `project.save_html("graph.html", chrome=["minimap"])` writes
+a standalone interactive HTML file.
+
+## Environments
+
+Local Jupyter, VS Code notebooks, JupyterHub, Google Colab, and Snowflake
+Snowpark notebooks are resolved automatically. For Snowpark, use
+`show_snowpark()` which materializes selected tables in the kernel before
+handoff.
+
+## Links
+
+- [garphield.com](https://garphield.com)
+- [GitHub](https://github.com/ammil-industries/garphield)

garphield-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["hatchling==1.27.0"]
+build-backend = "hatchling.build"
+
+[project]
+name = "garphield"
+version = "0.1.0"
+description = "Validated Python round-trip primitives for Garphield projects"
+readme = "README.md"
+requires-python = ">=3.10,<3.15"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "Garphield contributors" }]
+dependencies = [
+  "anywidget>=0.9,<1",
+  "jsonschema>=4.23,<5",
+  "jupyter-ui-poll>=1.0,<2",
+  "rfc8785>=0.1.4,<0.2",
+]
+[project.optional-dependencies]
+tables = ["pandas>=2.2,<3"]
+networkx = [
+  "pandas>=2.2,<4",
+  "networkx>=3.4.2,<3.5; python_version == '3.10'",
+  "networkx>=3.6.1,<4; python_version >= '3.11'",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/garphield"]
+
+[tool.hatch.build]
+artifacts = ["/src/garphield/static/app/**"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+  "/src/garphield",
+  "/LICENSE",
+  "/THIRD_PARTY_NOTICES.md",
+  "/README.md",
+  "/pyproject.toml",
+]

garphield-0.1.0/src/garphield/__init__.py

@@ -0,0 +1,85 @@
+"""Validated Python primitives for Garphield project files."""
+
+from ._canonical import CanonicalizationError, canonicalize_jcs_v1
+from ._bindings import AlgorithmSpec, BindingOptions, algorithm
+from ._html import save_html
+from ._identity import AttributeNameCodecV1, EdgeIdentityCodecV1, IdentityCodecV1
+from ._project import (
+    DuplicatePropertyError,
+    Project,
+    ProjectValidationError,
+    canonicalize_project_v1,
+    canonicalize_semantic_graph_v1,
+    load,
+)
+from ._transport import (
+    AnyWidgetTransportEndpoint,
+    TRANSPORT_RUNTIME_CONFIG_V1,
+    PreparedBudgetedJson,
+    TransportError,
+    TransportRuntimeConfigV1,
+    prepare_budgeted_json,
+    receive_budgeted_json,
+)
+from ._transforms import Transformation, TransformSpec, transform
+from ._view import GraphView
+from ._widget import (
+    OwnershipError,
+    ProjectWidget,
+    WidgetEnvironmentUnsupportedError,
+    WidgetNotDisplayedError,
+    WidgetTransportError,
+    show,
+    show_snowpark,
+)
+
+
+def __getattr__(name: str) -> object:
+    if name == "Tables":
+        from ._pandas import Tables
+
+        return Tables
+    if name == "IdentityCollisionError":
+        from ._networkx import IdentityCollisionError
+
+        return IdentityCollisionError
+    raise AttributeError(name)
+
+
+__all__ = [
+    "AttributeNameCodecV1",
+    "AlgorithmSpec",
+    "AnyWidgetTransportEndpoint",
+    "CanonicalizationError",
+    "BindingOptions",
+    "DuplicatePropertyError",
+    "EdgeIdentityCodecV1",
+    "IdentityCodecV1",
+    "GraphView",
+    "OwnershipError",
+    "Project",
+    "ProjectWidget",
+    "ProjectValidationError",
+    "PreparedBudgetedJson",
+    "TransportError",
+    "TransportRuntimeConfigV1",
+    "TransformSpec",
+    "Transformation",
+    "TRANSPORT_RUNTIME_CONFIG_V1",
+    "WidgetEnvironmentUnsupportedError",
+    "WidgetNotDisplayedError",
+    "WidgetTransportError",
+    "IdentityCollisionError",
+    "Tables",
+    "canonicalize_jcs_v1",
+    "algorithm",
+    "transform",
+    "canonicalize_project_v1",
+    "canonicalize_semantic_graph_v1",
+    "load",
+    "prepare_budgeted_json",
+    "receive_budgeted_json",
+    "show",
+    "show_snowpark",
+    "save_html",
+]