voidmesh 0.1.0__tar.gz

voidmesh-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aahan
+
+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.

voidmesh-0.1.0/PKG-INFO

@@ -0,0 +1,115 @@
+Metadata-Version: 2.4
+Name: voidmesh
+Version: 0.1.0
+Summary: Live force-directed graphs and systematic trees for Python
+Keywords: graph,visualization,nodes,physics,canvas
+Author: Aahan
+Author-email: Aahan <188063520+aahan0511@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Dist: pygame-ce>=2.5.8
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# Voidmesh
+
+A small Python 3.14 library for building and displaying live, Obsidian-inspired
+force-directed graphs. Values are rendered inside draggable rounded nodes;
+links act like springs; gravity and repulsion settle the graph into place.
+
+## Install
+
+```console
+uv add voidmesh
+```
+
+For local development:
+
+```console
+uv sync
+uv run voidmesh-demo
+```
+
+## Quick start
+
+```python
+from voidmesh import Canvas
+
+canvas = Canvas(title="My graph", grid=True)
+python = canvas.add_node("Python", color="#fbbf24")
+graphs = canvas.add_node("Graphs", color="#a78bfa")
+edge = canvas.link(python, graphs, color="#38bdf8")
+
+# Keep executing code while the window stays responsive.
+canvas.show(block=False)
+
+canvas.update_node(graphs, value="Live graphs", color="#34d399")
+canvas.update_link(edge, color="#fb7185", elasticity=0.06)
+canvas.wait()  # Keep the script alive until the window is closed.
+```
+
+All mutating methods update an open window immediately:
+
+```python
+third = canvas.add_node("New")
+canvas.relink(edge, target=third)
+canvas.unlink(edge)  # or canvas.unlink(python, third)
+canvas.delete_node(graphs)  # also deletes attached links
+canvas.clear()
+canvas.close()
+```
+
+Call `canvas.show()` without arguments for a blocking window. Drag nodes with
+the left mouse button, pan with the right mouse button, zoom with the wheel, and
+press Escape to close. `fixed=True` pins a node after it is dragged.
+
+The **Controls** panel changes center force, repulsion, link force, and link
+distance while the graph is moving. Drag its heading to reposition it, or click
+the chevron to collapse it. Press `F` to hide or show the panel and `G` to
+toggle the background grid.
+
+Physics and the grid can also be controlled from Python:
+
+```python
+canvas.configure_physics(
+    center_force=0.2,
+    repel_force=8,
+    link_force=0.4,
+    link_distance=190,
+    damping=0.92,
+)
+canvas.toggle_grid(True)
+```
+
+The same values can be passed to `Canvas(...)`. Set `controls=False` for a
+minimal window without the controls panel. Controls scale automatically with the
+window; use `ui_scale=1.5` (or another positive multiplier) to override their
+size on a HiDPI display. Graph zoom and UI scale are intentionally independent.
+
+Switch to a deterministic, physics-free hierarchy with `layout="tree"`, the
+Tree button in the panel, or the `T` key. Links are interpreted as parent to
+child in this view. See the bundled example:
+
+```console
+uv run python examples/tree_view.py
+```
+
+Fonts, type size, node padding and roundness, link thickness, and grid color
+can be set on `Canvas(...)` or changed live with `configure_style()`.
+
+## Development
+
+```console
+uv run pytest
+uv run ruff check .
+uv build
+uv run mkdocs serve
+```
+
+Complete documentation lives in [`docs/`](docs/index.md). Build it with
+`uv run mkdocs build --strict`.
+
+Voidmesh is licensed under the MIT License.

voidmesh-0.1.0/README.md

@@ -0,0 +1,99 @@
+# Voidmesh
+
+A small Python 3.14 library for building and displaying live, Obsidian-inspired
+force-directed graphs. Values are rendered inside draggable rounded nodes;
+links act like springs; gravity and repulsion settle the graph into place.
+
+## Install
+
+```console
+uv add voidmesh
+```
+
+For local development:
+
+```console
+uv sync
+uv run voidmesh-demo
+```
+
+## Quick start
+
+```python
+from voidmesh import Canvas
+
+canvas = Canvas(title="My graph", grid=True)
+python = canvas.add_node("Python", color="#fbbf24")
+graphs = canvas.add_node("Graphs", color="#a78bfa")
+edge = canvas.link(python, graphs, color="#38bdf8")
+
+# Keep executing code while the window stays responsive.
+canvas.show(block=False)
+
+canvas.update_node(graphs, value="Live graphs", color="#34d399")
+canvas.update_link(edge, color="#fb7185", elasticity=0.06)
+canvas.wait()  # Keep the script alive until the window is closed.
+```
+
+All mutating methods update an open window immediately:
+
+```python
+third = canvas.add_node("New")
+canvas.relink(edge, target=third)
+canvas.unlink(edge)  # or canvas.unlink(python, third)
+canvas.delete_node(graphs)  # also deletes attached links
+canvas.clear()
+canvas.close()
+```
+
+Call `canvas.show()` without arguments for a blocking window. Drag nodes with
+the left mouse button, pan with the right mouse button, zoom with the wheel, and
+press Escape to close. `fixed=True` pins a node after it is dragged.
+
+The **Controls** panel changes center force, repulsion, link force, and link
+distance while the graph is moving. Drag its heading to reposition it, or click
+the chevron to collapse it. Press `F` to hide or show the panel and `G` to
+toggle the background grid.
+
+Physics and the grid can also be controlled from Python:
+
+```python
+canvas.configure_physics(
+    center_force=0.2,
+    repel_force=8,
+    link_force=0.4,
+    link_distance=190,
+    damping=0.92,
+)
+canvas.toggle_grid(True)
+```
+
+The same values can be passed to `Canvas(...)`. Set `controls=False` for a
+minimal window without the controls panel. Controls scale automatically with the
+window; use `ui_scale=1.5` (or another positive multiplier) to override their
+size on a HiDPI display. Graph zoom and UI scale are intentionally independent.
+
+Switch to a deterministic, physics-free hierarchy with `layout="tree"`, the
+Tree button in the panel, or the `T` key. Links are interpreted as parent to
+child in this view. See the bundled example:
+
+```console
+uv run python examples/tree_view.py
+```
+
+Fonts, type size, node padding and roundness, link thickness, and grid color
+can be set on `Canvas(...)` or changed live with `configure_style()`.
+
+## Development
+
+```console
+uv run pytest
+uv run ruff check .
+uv build
+uv run mkdocs serve
+```
+
+Complete documentation lives in [`docs/`](docs/index.md). Build it with
+`uv run mkdocs build --strict`.
+
+Voidmesh is licensed under the MIT License.

voidmesh-0.1.0/pyproject.toml

@@ -0,0 +1,45 @@
+[project]
+name = "voidmesh"
+version = "0.1.0"
+description = "Live force-directed graphs and systematic trees for Python"
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "graph",
+    "visualization",
+    "nodes",
+    "physics",
+    "canvas",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = ["pygame-ce>=2.5.8"]
+
+[[project.authors]]
+name = "Aahan"
+email = "188063520+aahan0511@users.noreply.github.com"
+
+[project.scripts]
+voidmesh-demo = "voidmesh.demo:main"
+
+[build-system]
+requires = ["uv_build>=0.12.6,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 96
+
+[dependency-groups]
+dev = [
+    "mkdocs-material>=9.7.7",
+    "pytest>=9.1.1",
+    "ruff>=0.16.8",
+]

voidmesh-0.1.0/pyproject.toml.orig

@@ -0,0 +1,40 @@
+[project]
+name = "voidmesh"
+version = "0.1.0"
+description = "Live force-directed graphs and systematic trees for Python"
+readme = "README.md"
+authors = [
+    { name = "Aahan", email = "188063520+aahan0511@users.noreply.github.com" }
+]
+requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = ["graph", "visualization", "nodes", "physics", "canvas"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Scientific/Engineering :: Visualization",
+]
+dependencies = [
+    "pygame-ce>=2.5.8",
+]
+
+[project.scripts]
+voidmesh-demo = "voidmesh.demo:main"
+
+[build-system]
+requires = ["uv_build>=0.12.6,<0.13.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 96
+
+[dependency-groups]
+dev = [
+    "mkdocs-material>=9.7.7",
+    "pytest>=9.1.1",
+    "ruff>=0.16.8",
+]

voidmesh-0.1.0/src/voidmesh/__init__.py

@@ -0,0 +1,7 @@
+"""A tiny, live, physics-based graph canvas."""
+
+from .canvas import Canvas
+from .models import Link, Node
+
+__all__ = ["Canvas", "Link", "Node"]
+__version__ = "0.1.0"