# sPyTial: Lightweight Diagrams for Structured Python Data
```
pip install spytial-diagramming
```
Sometimes you just want to see your data.
You’re working with a tree, a graph, a recursive object -- maybe an AST, a neural network, or a symbolic term. You don’t need an interactive dashboard or a production-grade visualization system. You just need a diagram, something that lays it out clearly so you can understand what’s going on.
That’s what `sPyTial` is for. It’s designed for developers, educators, and researchers who work with structured data and need to make that structure visible — to themselves or to others — with minimal effort.
## Why Spatial Representation Matters
There’s strong evidence — from cognitive science, human-computer interaction, and decades of programming tool design — that **spatial representations help people understand structure**. When elements are placed meaningfully in space — grouped, aligned, oriented — we can spot patterns, detect errors, and reason more effectively. This idea shows up in research from Barbara Tversky, Larkin & Simon, and in the design of tools like Alloy and Scratch.
`sPyTial` gives you that kind of spatial layout **by default**. When you visualize a Python object, the diagram reflects how the parts are connected, not just how they're stored. You get:
- A **box-and-arrow diagram** that shows the shape of your data
- A layout that follows cognitive and structural conventions
- A tool that knows when something doesn't make sense
## License
This project is licensed under the MIT License. See the LICENSE file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/sidprasad/spytial",
"name": "spytial-diagramming",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "visualization, diagrams, spatial, constraints, data-structures",
"author": "Siddhartha Prasad",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/76/21/029f068669abc93395edce6333a919a65e952b29e8e889d9d70155c924d5/spytial-diagramming-0.1.4.tar.gz",
"platform": null,
"description": "# sPyTial: Lightweight Diagrams for Structured Python Data\n\n```\npip install spytial-diagramming\n```\n\n\nSometimes you just want to see your data.\n\nYou\u2019re working with a tree, a graph, a recursive object -- maybe an AST, a neural network, or a symbolic term. You don\u2019t need an interactive dashboard or a production-grade visualization system. You just need a diagram, something that lays it out clearly so you can understand what\u2019s going on.\n\nThat\u2019s what `sPyTial` is for. It\u2019s designed for developers, educators, and researchers who work with structured data and need to make that structure visible \u2014 to themselves or to others \u2014 with minimal effort. \n\n## Why Spatial Representation Matters\n\nThere\u2019s strong evidence \u2014 from cognitive science, human-computer interaction, and decades of programming tool design \u2014 that **spatial representations help people understand structure**. When elements are placed meaningfully in space \u2014 grouped, aligned, oriented \u2014 we can spot patterns, detect errors, and reason more effectively. This idea shows up in research from Barbara Tversky, Larkin & Simon, and in the design of tools like Alloy and Scratch. \n\n`sPyTial` gives you that kind of spatial layout **by default**. When you visualize a Python object, the diagram reflects how the parts are connected, not just how they're stored. You get:\n- A **box-and-arrow diagram** that shows the shape of your data\n- A layout that follows cognitive and structural conventions\n- A tool that knows when something doesn't make sense\n\n\n\n## License\nThis project is licensed under the MIT License. See the LICENSE file for details.\n\n\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "sPyTial: Spatial Python visualization with declarative constraints",
"version": "0.1.4",
"project_urls": {
"Bug Reports": "https://github.com/sidprasad/spytial/issues",
"Homepage": "https://github.com/sidprasad/spytial",
"Source": "https://github.com/sidprasad/spytial"
},
"split_keywords": [
"visualization",
" diagrams",
" spatial",
" constraints",
" data-structures"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "302c590f0107f498470e00b0f136bbf71ad98dc0d7ed15bb274e451556ad2027",
"md5": "79bafb3f79d6f4804a79eaf8056946e3",
"sha256": "18380b46bf65c19eafefc435da9c12972e90b897c7ccb49803a0969b53a5fc80"
},
"downloads": -1,
"filename": "spytial_diagramming-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "79bafb3f79d6f4804a79eaf8056946e3",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 46196,
"upload_time": "2025-10-07T15:33:06",
"upload_time_iso_8601": "2025-10-07T15:33:06.862898Z",
"url": "https://files.pythonhosted.org/packages/30/2c/590f0107f498470e00b0f136bbf71ad98dc0d7ed15bb274e451556ad2027/spytial_diagramming-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "7621029f068669abc93395edce6333a919a65e952b29e8e889d9d70155c924d5",
"md5": "e6ec4f7e87b5cf2e403dd63b4b6151c6",
"sha256": "7a2ec25574a5345ee3814495aa213e5ffb8ec31ba399c5c5cdd8de742078906a"
},
"downloads": -1,
"filename": "spytial-diagramming-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "e6ec4f7e87b5cf2e403dd63b4b6151c6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 503470,
"upload_time": "2025-10-07T15:33:09",
"upload_time_iso_8601": "2025-10-07T15:33:09.106201Z",
"url": "https://files.pythonhosted.org/packages/76/21/029f068669abc93395edce6333a919a65e952b29e8e889d9d70155c924d5/spytial-diagramming-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-07 15:33:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sidprasad",
"github_project": "spytial",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "jinja2",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "pyyaml",
"specs": [
[
">=",
"6.0"
]
]
},
{
"name": "ipython",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"23.0.0"
]
]
}
],
"lcname": "spytial-diagramming"
}
JSON
