forgegraph 0.0.1__tar.gz

forgegraph-0.0.1/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  checks:
+    name: Lint, types, secrets, deny-list
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: "3.12"
+      - run: uv sync --locked
+      - run: uv run ruff check
+      - run: uv run ruff format --check
+      - run: uv run pyright
+      - name: Deny-listed terms
+        run: uv run python scripts/check_denylist.py
+        env:
+          FORGEGRAPH_DENYLIST: ${{ secrets.DENYLIST }}
+          FORGEGRAPH_DENYLIST_REQUIRED: "1"
+      - name: Secrets (full history)
+        run: docker run --rm -v "$PWD:/repo" ghcr.io/gitleaks/gitleaks:v8.30.1 git /repo --redact --verbose
+
+  tests-linux:
+    name: Tests (Linux, Python ${{ matrix.python }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked
+      - run: uv run pytest --cov --cov-report=term-missing
+
+  tests-other-os:
+    # macOS and Windows minutes count heavily against a private repo's quota,
+    # so these run only on main and on demand.
+    if: github.ref == 'refs/heads/main' || github.event_name == 'workflow_dispatch'
+    name: Tests (${{ matrix.os }}, Python 3.12)
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+        with:
+          python-version: "3.12"
+      - run: uv sync --locked
+      - run: uv run pytest

forgegraph-0.0.1/.github/workflows/publish.yml

@@ -0,0 +1,17 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # trusted publishing: no password or token stored anywhere
+      contents: read
+    steps:
+      - uses: actions/checkout@v7
+      - uses: astral-sh/setup-uv@v10.3.0
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@v1.14.2

forgegraph-0.0.1/.gitignore

@@ -0,0 +1,20 @@
+# macOS
+.DS_Store
+
+# Confidential example graphs: kept locally only, never committed
+docs/examples/*.pdf
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.ipynb_checkpoints/

forgegraph-0.0.1/.pre-commit-config.yaml

@@ -0,0 +1,29 @@
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: check-yaml
+      - id: check-toml
+      - id: end-of-file-fixer
+        exclude: \.md$
+      - id: trailing-whitespace
+        exclude: \.md$
+      - id: check-added-large-files
+        args: [--maxkb=600]
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.17.1
+    hooks:
+      - id: ruff-check
+        args: [--fix]
+      - id: ruff-format
+  - repo: https://github.com/gitleaks/gitleaks
+    rev: v8.30.1
+    hooks:
+      - id: gitleaks
+  - repo: local
+    hooks:
+      - id: denylist
+        name: deny-listed terms
+        entry: python scripts/check_denylist.py
+        language: python
+        types: [text]

forgegraph-0.0.1/CONTRIBUTING.md

@@ -0,0 +1,15 @@
+# Contributing
+
+ForgeGraph is in early development and isn't accepting outside contributions yet. This page will grow before the first public release.
+
+## Development setup
+
+```bash
+uv sync
+uv run pre-commit install
+uv run pytest
+```
+
+## Requesting a chart type
+
+Open a GitHub issue describing the graph you need, ideally with an example image or sketch and a little sample data. No code is needed.

forgegraph-0.0.1/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,13 @@
+# 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/TRADEMARKS.md

@@ -0,0 +1,12 @@
+# Trademarks
+
+"ForgeGraph" is a trademark of Steven Kaye.
+
+The code is MIT-licensed, but the licence covers the code, not the name. You are welcome to:
+
+- say that your product or fork is "based on ForgeGraph" or "uses ForgeGraph";
+- refer to ForgeGraph by name when describing compatibility or discussing it.
+
+Please don't use "ForgeGraph", or a confusingly similar name, as the name of a fork, product, package or service. Give your project its own name.
+
+Bundled fonts carry their own licences and trademarks: "Source" is a trademark of Adobe (see `src/forgegraph/themes/fonts/OFL-SourceSans3.md`).