forgegraph 0.0.1__py3-none-any.whl

forgegraph/__init__.py

@@ -0,0 +1,10 @@
+"""ForgeGraph: consistent, high-quality graphs from a declarative GraphSpec."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("forgegraph")
+except PackageNotFoundError:  # running from a source tree without installation
+    __version__ = "0.0.0"
+
+__all__ = ["__version__"]

forgegraph/catalog/__init__.py

@@ -0,0 +1 @@
+"""The HTML review catalog and Forgemark comment carry-over."""

forgegraph/charts/__init__.py

@@ -0,0 +1 @@
+"""Chart types: one folder per type with chart.yaml, render.py and sample data."""

forgegraph/cli/__init__.py

@@ -0,0 +1,22 @@
+"""The `fg` command-line interface."""
+
+import typer
+
+from forgegraph import __version__
+
+app = typer.Typer(help="ForgeGraph: consistent, high-quality graphs.", no_args_is_help=True)
+
+
+def _show_version(value: bool) -> None:
+    if value:
+        typer.echo(f"forgegraph {__version__}")
+        raise typer.Exit()
+
+
+@app.callback()
+def main(
+    version: bool = typer.Option(
+        False, "--version", help="Show the version and exit.", callback=_show_version, is_eager=True
+    ),
+) -> None:
+    """ForgeGraph command-line interface."""

forgegraph/data/__init__.py

@@ -0,0 +1 @@
+"""Data connectors (files, DataFrame, SQL), inspect, and declarative transforms."""

forgegraph/formats/__init__.py

@@ -0,0 +1 @@
+"""Built-in formats: output destinations such as paper, report, slide, poster and dashboard tile."""

forgegraph/jobs/__init__.py

@@ -0,0 +1 @@
+"""Scheduled renders: install, list and remove OS scheduler entries; status files."""

forgegraph/layers/__init__.py

@@ -0,0 +1 @@
+"""Layers: one folder per layer with layer.yaml and render.py."""

forgegraph/layout/__init__.py

@@ -0,0 +1 @@
+"""Layouts: multi-panel figures and dashboards rendered as one figure."""

forgegraph/packs/__init__.py

@@ -0,0 +1 @@
+"""Pack discovery, user and project config, and the registry."""

forgegraph/render/__init__.py

@@ -0,0 +1 @@
+"""The matplotlib rendering engine, label markup, lint, export and provenance."""

forgegraph/skill/__init__.py

@@ -0,0 +1 @@
+"""The agent skill (SKILL.md and references), installed by `fg skill install`."""

forgegraph/spec/__init__.py

@@ -0,0 +1,3 @@
+"""Document models (GraphSpec, theme, format, layout), generated chart and layer models,
+resolve and explain.
+"""

forgegraph/themes/__init__.py

@@ -0,0 +1,21 @@
+"""Themes and the bundled fonts."""
+
+from importlib.resources import files
+from pathlib import Path
+
+FONT_FAMILY = "Source Sans 3"
+
+
+def font_dir() -> Path:
+    """Return the folder holding the bundled font files."""
+    return Path(str(files(__package__) / "fonts"))
+
+
+def register_fonts() -> list[Path]:
+    """Register the bundled fonts with matplotlib and return their paths."""
+    from matplotlib import font_manager
+
+    paths = sorted(font_dir().glob("*.ttf"))
+    for path in paths:
+        font_manager.fontManager.addfont(str(path))
+    return paths

forgegraph/themes/fonts/OFL-SourceSans3.md

@@ -0,0 +1,93 @@
+Copyright 2010-2022 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe in the United States and/or other countries.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

forgegraph-0.0.1.dist-info/METADATA

@@ -0,0 +1,42 @@
+Metadata-Version: 2.5
+Name: forgegraph
+Version: 0.0.1
+Summary: Low-labor, consistent, high-quality graphs from many data sources, for people and AI agents. Early development.
+Project-URL: Repository, https://github.com/sskaye/forgegraph
+Author: Steven Kaye
+License-Expression: MIT
+License-File: LICENSE
+License-File: src/forgegraph/themes/fonts/OFL-SourceSans3.md
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Science/Research
+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: matplotlib>=3.9
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: pandas>=2.2
+Requires-Dist: pydantic>=2.7
+Requires-Dist: ruamel-yaml>=0.18
+Requires-Dist: typer>=0.12
+Requires-Dist: xlrd>=2.0
+Provides-Extra: sql
+Requires-Dist: psycopg[binary]>=3.1; extra == 'sql'
+Requires-Dist: sqlalchemy>=2.0; extra == 'sql'
+Description-Content-Type: text/markdown
+
+# ForgeGraph
+
+Low-labor, fast and consistent construction of high-quality graphs from a variety of data sources, for people and AI agents alike.
+
+ForgeGraph is a Python library, CLI and agent skill that turns a short declarative **GraphSpec** into a graph styled to a house standard, set once by a theme and a format.
+
+**Status:** early development. Nothing usable yet.
+
+- [Initial specification](docs/initial%20specification.md)
+- [Architecture](docs/architecture.md)
+- [Build plan](docs/build-plan.md)
+
+Licence: [MIT](LICENSE). Graphs and other output you make with ForgeGraph are yours; no attribution or licence terms apply to them. See [TRADEMARKS.md](TRADEMARKS.md) for use of the name.

forgegraph-0.0.1.dist-info/RECORD

@@ -0,0 +1,25 @@
+forgegraph/__init__.py,sha256=oJC14O85-hqraaGDzsifSKemhsKV3t4IIFvrQLfPqgM,321
+forgegraph/catalog/__init__.py,sha256=G1655g81COp4F5-VSmqSuCRMFB6yLo1A0M63e6HvO8U,64
+forgegraph/charts/__init__.py,sha256=eNsZzC_iWVU-CPBxYvhXZ_nLxObcZ6goURh9bA9lVOM,83
+forgegraph/cli/__init__.py,sha256=xPN5-CJbn94g43aT8CqCUTtBpGzphV9NqcY73wrp7t8,540
+forgegraph/data/__init__.py,sha256=lWqEuEyvz1HijhY4ShjwrR-IM3Q_iXAM_H_a6kxvWLA,84
+forgegraph/formats/__init__.py,sha256=uMXmztpogfiq48urqUdjBbrxb3T-JOvdl1xHDHEj47s,101
+forgegraph/jobs/__init__.py,sha256=0IYvs8LDCXCuimfEGTVKoWBwwbf6hC5PwqyRAFbgFrE,86
+forgegraph/layers/__init__.py,sha256=bSRXsa6c1sg7htCZIcAJXjD5Z_EL9oe0ITfl2RGV-mA,66
+forgegraph/layout/__init__.py,sha256=OLKTKrppHVoqd0qbPZ4-R6W5VHBcSyGZGiJKWwmFH7I,74
+forgegraph/packs/__init__.py,sha256=iLHpH7k05HhvemJiPWNeX-5qk69y02yjqsRpCr3lrmU,65
+forgegraph/render/__init__.py,sha256=x8K7AAV3JMPU1Lx3tMz7Ryl33b5S6udcIV7OsQoyIjg,82
+forgegraph/skill/__init__.py,sha256=ZY6SQ3AS7Ai3fndj8t_QKsF8BtXzeE8NmGs6AgFqmro,82
+forgegraph/spec/__init__.py,sha256=C5u88QYXte8g-3BivuueXSRi-2Ekm_ArVFNsY3E9qmo,114
+forgegraph/themes/__init__.py,sha256=eVAV6WQZldH37UqGiqfcCnN2fF8ZV4EYsA9W_s2dH0Y,561
+forgegraph/themes/fonts/OFL-SourceSans3.md,sha256=20coAjw3vR21Qv0U_55PO8wjg2uDdPb-HyNR04wpltU,4486
+forgegraph/themes/fonts/SourceSans3-Bold.ttf,sha256=khS52V5CMcYJgCgVwmRsmBdOIQLQ03-Il4p_jnEAbmo,428176
+forgegraph/themes/fonts/SourceSans3-It.ttf,sha256=GSr9ePD1Sjxp6vAtQ_TZqCHp1hEOQdPSXWGnOFzVgOQ,315812
+forgegraph/themes/fonts/SourceSans3-Regular.ttf,sha256=RkTIG4bsnKqna2NIiZaO08T09S8FSFWTOsx8KyHlOw8,431196
+forgegraph/themes/fonts/SourceSans3-Semibold.ttf,sha256=o_T43PNDqPJNxhlR3pPzuhVYsVzSULokr4pA6VcIG30,425904
+forgegraph-0.0.1.dist-info/METADATA,sha256=92SQk5C7f-FBux4HR5y8vjEXIxvEiv91YB3_ZnO2Eyc,1801
+forgegraph-0.0.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+forgegraph-0.0.1.dist-info/entry_points.txt,sha256=u753fR_Ao1n74wZH_AdAM28nxDWcA8fk1bEItGQGYRY,42
+forgegraph-0.0.1.dist-info/licenses/LICENSE,sha256=FeqjfFfC5Et196pzYrqQi8876fTwXptxExJcGbYlbig,1068
+forgegraph-0.0.1.dist-info/licenses/src/forgegraph/themes/fonts/OFL-SourceSans3.md,sha256=20coAjw3vR21Qv0U_55PO8wjg2uDdPb-HyNR04wpltU,4486
+forgegraph-0.0.1.dist-info/RECORD,,

forgegraph-0.0.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

forgegraph-0.0.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fg = forgegraph.cli:app

forgegraph-0.0.1.dist-info/licenses/LICENSE

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

forgegraph-0.0.1.dist-info/licenses/src/forgegraph/themes/fonts/OFL-SourceSans3.md

@@ -0,0 +1,93 @@
+Copyright 2010-2022 Adobe (http://www.adobe.com/), with Reserved Font Name 'Source'. All Rights Reserved. Source is a trademark of Adobe in the United States and/or other countries.
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+
+This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.