corpdoc 0.4.0__tar.gz

corpdoc-0.4.0/LICENSE

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

corpdoc-0.4.0/PKG-INFO

@@ -0,0 +1,260 @@
+Metadata-Version: 2.4
+Name: corpdoc
+Version: 0.4.0
+Summary: Professional Corporate PDF Generator from Markdown + Logo
+Author-email: Alejandro Méndez <roccoco13@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/RoCCoCo13/corpdoc
+Project-URL: Documentation, https://github.com/RoCCoCo13/corpdoc/tree/main/docs
+Project-URL: Repository, https://github.com/RoCCoCo13/corpdoc
+Project-URL: Issues, https://github.com/RoCCoCo13/corpdoc/issues
+Project-URL: Changelog, https://github.com/RoCCoCo13/corpdoc/blob/main/CHANGELOG.md
+Keywords: pdf,markdown,corporate,branding,documents,reports,proposals,ai,llm
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business
+Classifier: Topic :: Text Processing :: Markup :: Markdown
+Classifier: Topic :: Printing
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: reportlab>=4.0
+Requires-Dist: Pillow>=10.0
+Requires-Dist: PyYAML>=6.0
+Requires-Dist: mistune>=3.0
+Requires-Dist: svglib<1.6,>=1.5
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Provides-Extra: mermaid
+Requires-Dist: requests>=2.28; extra == "mermaid"
+Requires-Dist: cairosvg>=2.6; extra == "mermaid"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/corpdoc-logo-card.svg" alt="CorpDoc" width="460"/>
+</p>
+
+<p align="center">
+  <strong>Turn Markdown into branded corporate PDFs. In seconds.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/RoCCoCo13/corpdoc/actions/workflows/test.yml"><img src="https://github.com/RoCCoCo13/corpdoc/actions/workflows/test.yml/badge.svg" alt="Tests"/></a>
+  <a href="https://github.com/RoCCoCo13/corpdoc/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"/></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python"/></a>
+</p>
+
+---
+
+## See it in action
+
+Drop in your logo and CorpDoc automatically derives your brand palette:
+
+<p align="center">
+  <img src="assets/preview-corpdoc-cover.png" alt="CorpDoc sample" width="60%"/>
+  <br/>
+  <em>CorpDoc self-demo — forest/camel palette from the CorpDoc logo</em>
+</p>
+
+---
+
+## What is CorpDoc?
+
+CorpDoc is an open-source tool that converts plain Markdown into professional
+corporate PDFs with almost zero manual layout work. Drop in your **logo** and
+a **YAML config** once, and every document you produce afterwards comes out
+branded, paginated, and ready to send to clients.
+
+**The killer feature:** CorpDoc is designed to be driven by AI. A single
+`SKILL.md` file teaches any LLM (Claude, GPT, Gemini, local Ollama models)
+how to generate CorpDoc-compatible Markdown. Your workflow becomes:
+
+```
+prompt the AI → AI generates Markdown → corpdoc render → done
+```
+
+## Why CorpDoc exists
+
+Because this shouldn't take an afternoon in Word every time you need to send
+an offer. It should take 30 seconds.
+
+AI models generate great text. They don't generate professional layouts.
+CorpDoc bridges that gap without requiring you (or the AI) to learn LaTeX,
+Typst, or fight with Word templates.
+
+---
+
+## Features
+
+- 🎨 **Extracts brand colors automatically** from your SVG logo
+- 📄 **Cover page** with 4 styles to pick from (classic, minimal,
+  bold-band, split) — configurable in the YAML
+- 📋 **Version history** page for document control (change log)
+- 📚 **Auto table of contents** from your headings
+- 🏷️ **Branded headers and footers** with company info on every page
+- 📊 **Auto-styled tables** with zebra striping in your brand colors
+- 📐 **Auto-landscape for wide tables** — 8+ column tables rotate the page
+  so content stays readable
+- 🌐 **Language detection** (English, Spanish, German, French) — pagination
+  and labels localize automatically
+- 📐 **Nested lists**, inline formatting, code blocks, Mermaid diagrams
+- 🤖 **AI-ready** — comes with a `SKILL.md` any LLM can follow
+
+---
+
+## Quickstart
+
+### 1. Install
+
+```bash
+pip install corpdoc
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/RoCCoCo13/corpdoc.git
+cd corpdoc
+pip install -e .
+```
+
+### 2. Create a config from your logo
+
+```bash
+corpdoc init --logo my-logo.svg --name "My Company SL"
+```
+
+This extracts the brand colors from your logo and writes a `corpdoc.yml`
+template. Open it and fill in your footer info (address, director, VAT, etc.).
+
+### 3. Write (or generate) a Markdown document
+
+```markdown
+---
+title: "Project Proposal"
+subtitle: "For ACME Industrial"
+reference: "OFR-2026-0042"
+version: "1.0"
+---
+
+# 1. Executive Summary
+
+We propose the installation of a 500 kWp photovoltaic system...
+```
+
+### 4. Render it
+
+```bash
+corpdoc render proposal.md --config corpdoc.yml
+```
+
+Open `proposal.pdf`. Done.
+
+---
+
+## AI-driven workflow
+
+The `skill/SKILL.md` file in this repo is the manual for any LLM. Paste it
+into your Claude / ChatGPT / Gemini / Ollama system prompt and the model will
+generate CorpDoc-compatible Markdown on demand.
+
+**Example prompt to your AI:**
+
+> "Using the CorpDoc skill, draft an offer for installing HVAC in a 2,000 m²
+> warehouse for ClienteCorp. Budget around €45k. Include timeline and team
+> section."
+
+The AI writes the Markdown. You run `corpdoc render`. The PDF lands in your
+clients' inbox 30 seconds later.
+
+See the [AI Integration Guide](docs/ai-integration.md) for detailed workflows.
+
+---
+
+## Examples
+
+A complete example is included in `examples/corpdoc-sample/` — a self-referential
+demo using CorpDoc's own logo (forest + camel) that exercises every feature in one file.
+
+```bash
+cd examples/corpdoc-sample
+corpdoc render demo.md --config corpdoc.yml
+```
+
+---
+
+## Project structure
+
+```
+corpdoc/
+├── src/corpdoc/            # Python package
+│   ├── api.py              # Main CorpDoc class
+│   ├── cli.py              # Command-line interface
+│   ├── colors.py           # SVG color extraction
+│   ├── parser.py           # Markdown parser
+│   ├── canvas.py           # Header/footer drawing
+│   ├── flowables.py        # Cover page, custom flowables
+│   └── styles.py           # Paragraph and table styles
+├── skill/
+│   └── SKILL.md            # Instructions for any LLM
+├── examples/
+│   └── corpdoc-sample/     # Self-referential demo
+├── assets/
+│   ├── corpdoc-logo.svg       # Brand mark (transparent — for in-product use)
+│   └── corpdoc-logo-card.svg  # Same logo with white card (for docs/README)
+├── docs/                   # Extended documentation
+└── tests/                  # Unit tests
+```
+
+---
+
+## Roadmap
+
+- [x] **v0.3** — Core rendering, SVG color extraction, AI skill
+- [x] **v0.4** — Native SVG rendering, auto-landscape for wide tables,
+  configurable cover styles, `highlight` color role, pastel cover
+  surfaces, hardened release pipeline (OIDC + pip-audit + Dependabot)
+- [ ] **v0.5** — Mermaid diagram rendering via Quarto/Kroki fallback
+- [ ] **v0.6** — DOCX export via Pandoc pipeline
+- [ ] **v0.7** — Template gallery (offers, reports, memos, contracts)
+- [ ] **v1.0** — Stable API, PyPI release, comprehensive test suite
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+---
+
+## Contributing
+
+Contributions welcome! Areas we'd love help with:
+
+- Additional document templates (legal briefs, academic papers, invoices)
+- Language support beyond en/es/de/fr
+- Better diagram rendering
+- Integrations (VS Code extension, Obsidian plugin, GitHub Action)
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE). Use it for anything, commercial or otherwise.
+
+---
+
+## Credits
+
+Built by [Alejandro Méndez](https://github.com/RoCCoCo13) because nobody should
+spend 2 hours maquetting a proposal in Word when an AI can generate the
+content in 30 seconds.
+
+If CorpDoc saves you time, a ⭐ on GitHub goes a long way.

corpdoc-0.4.0/README.md

@@ -0,0 +1,219 @@
+<p align="center">
+  <img src="assets/corpdoc-logo-card.svg" alt="CorpDoc" width="460"/>
+</p>
+
+<p align="center">
+  <strong>Turn Markdown into branded corporate PDFs. In seconds.</strong>
+</p>
+
+<p align="center">
+  <a href="https://github.com/RoCCoCo13/corpdoc/actions/workflows/test.yml"><img src="https://github.com/RoCCoCo13/corpdoc/actions/workflows/test.yml/badge.svg" alt="Tests"/></a>
+  <a href="https://github.com/RoCCoCo13/corpdoc/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-green" alt="License"/></a>
+  <a href="https://www.python.org/"><img src="https://img.shields.io/badge/python-3.10%2B-blue" alt="Python"/></a>
+</p>
+
+---
+
+## See it in action
+
+Drop in your logo and CorpDoc automatically derives your brand palette:
+
+<p align="center">
+  <img src="assets/preview-corpdoc-cover.png" alt="CorpDoc sample" width="60%"/>
+  <br/>
+  <em>CorpDoc self-demo — forest/camel palette from the CorpDoc logo</em>
+</p>
+
+---
+
+## What is CorpDoc?
+
+CorpDoc is an open-source tool that converts plain Markdown into professional
+corporate PDFs with almost zero manual layout work. Drop in your **logo** and
+a **YAML config** once, and every document you produce afterwards comes out
+branded, paginated, and ready to send to clients.
+
+**The killer feature:** CorpDoc is designed to be driven by AI. A single
+`SKILL.md` file teaches any LLM (Claude, GPT, Gemini, local Ollama models)
+how to generate CorpDoc-compatible Markdown. Your workflow becomes:
+
+```
+prompt the AI → AI generates Markdown → corpdoc render → done
+```
+
+## Why CorpDoc exists
+
+Because this shouldn't take an afternoon in Word every time you need to send
+an offer. It should take 30 seconds.
+
+AI models generate great text. They don't generate professional layouts.
+CorpDoc bridges that gap without requiring you (or the AI) to learn LaTeX,
+Typst, or fight with Word templates.
+
+---
+
+## Features
+
+- 🎨 **Extracts brand colors automatically** from your SVG logo
+- 📄 **Cover page** with 4 styles to pick from (classic, minimal,
+  bold-band, split) — configurable in the YAML
+- 📋 **Version history** page for document control (change log)
+- 📚 **Auto table of contents** from your headings
+- 🏷️ **Branded headers and footers** with company info on every page
+- 📊 **Auto-styled tables** with zebra striping in your brand colors
+- 📐 **Auto-landscape for wide tables** — 8+ column tables rotate the page
+  so content stays readable
+- 🌐 **Language detection** (English, Spanish, German, French) — pagination
+  and labels localize automatically
+- 📐 **Nested lists**, inline formatting, code blocks, Mermaid diagrams
+- 🤖 **AI-ready** — comes with a `SKILL.md` any LLM can follow
+
+---
+
+## Quickstart
+
+### 1. Install
+
+```bash
+pip install corpdoc
+```
+
+Or from source:
+
+```bash
+git clone https://github.com/RoCCoCo13/corpdoc.git
+cd corpdoc
+pip install -e .
+```
+
+### 2. Create a config from your logo
+
+```bash
+corpdoc init --logo my-logo.svg --name "My Company SL"
+```
+
+This extracts the brand colors from your logo and writes a `corpdoc.yml`
+template. Open it and fill in your footer info (address, director, VAT, etc.).
+
+### 3. Write (or generate) a Markdown document
+
+```markdown
+---
+title: "Project Proposal"
+subtitle: "For ACME Industrial"
+reference: "OFR-2026-0042"
+version: "1.0"
+---
+
+# 1. Executive Summary
+
+We propose the installation of a 500 kWp photovoltaic system...
+```
+
+### 4. Render it
+
+```bash
+corpdoc render proposal.md --config corpdoc.yml
+```
+
+Open `proposal.pdf`. Done.
+
+---
+
+## AI-driven workflow
+
+The `skill/SKILL.md` file in this repo is the manual for any LLM. Paste it
+into your Claude / ChatGPT / Gemini / Ollama system prompt and the model will
+generate CorpDoc-compatible Markdown on demand.
+
+**Example prompt to your AI:**
+
+> "Using the CorpDoc skill, draft an offer for installing HVAC in a 2,000 m²
+> warehouse for ClienteCorp. Budget around €45k. Include timeline and team
+> section."
+
+The AI writes the Markdown. You run `corpdoc render`. The PDF lands in your
+clients' inbox 30 seconds later.
+
+See the [AI Integration Guide](docs/ai-integration.md) for detailed workflows.
+
+---
+
+## Examples
+
+A complete example is included in `examples/corpdoc-sample/` — a self-referential
+demo using CorpDoc's own logo (forest + camel) that exercises every feature in one file.
+
+```bash
+cd examples/corpdoc-sample
+corpdoc render demo.md --config corpdoc.yml
+```
+
+---
+
+## Project structure
+
+```
+corpdoc/
+├── src/corpdoc/            # Python package
+│   ├── api.py              # Main CorpDoc class
+│   ├── cli.py              # Command-line interface
+│   ├── colors.py           # SVG color extraction
+│   ├── parser.py           # Markdown parser
+│   ├── canvas.py           # Header/footer drawing
+│   ├── flowables.py        # Cover page, custom flowables
+│   └── styles.py           # Paragraph and table styles
+├── skill/
+│   └── SKILL.md            # Instructions for any LLM
+├── examples/
+│   └── corpdoc-sample/     # Self-referential demo
+├── assets/
+│   ├── corpdoc-logo.svg       # Brand mark (transparent — for in-product use)
+│   └── corpdoc-logo-card.svg  # Same logo with white card (for docs/README)
+├── docs/                   # Extended documentation
+└── tests/                  # Unit tests
+```
+
+---
+
+## Roadmap
+
+- [x] **v0.3** — Core rendering, SVG color extraction, AI skill
+- [x] **v0.4** — Native SVG rendering, auto-landscape for wide tables,
+  configurable cover styles, `highlight` color role, pastel cover
+  surfaces, hardened release pipeline (OIDC + pip-audit + Dependabot)
+- [ ] **v0.5** — Mermaid diagram rendering via Quarto/Kroki fallback
+- [ ] **v0.6** — DOCX export via Pandoc pipeline
+- [ ] **v0.7** — Template gallery (offers, reports, memos, contracts)
+- [ ] **v1.0** — Stable API, PyPI release, comprehensive test suite
+
+See [CHANGELOG.md](CHANGELOG.md) for release history.
+
+---
+
+## Contributing
+
+Contributions welcome! Areas we'd love help with:
+
+- Additional document templates (legal briefs, academic papers, invoices)
+- Language support beyond en/es/de/fr
+- Better diagram rendering
+- Integrations (VS Code extension, Obsidian plugin, GitHub Action)
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE). Use it for anything, commercial or otherwise.
+
+---
+
+## Credits
+
+Built by [Alejandro Méndez](https://github.com/RoCCoCo13) because nobody should
+spend 2 hours maquetting a proposal in Word when an AI can generate the
+content in 30 seconds.
+
+If CorpDoc saves you time, a ⭐ on GitHub goes a long way.

corpdoc-0.4.0/pyproject.toml

@@ -0,0 +1,80 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "corpdoc"
+version = "0.4.0"
+description = "Professional Corporate PDF Generator from Markdown + Logo"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "Alejandro Méndez", email = "roccoco13@gmail.com" },
+]
+keywords = [
+    "pdf", "markdown", "corporate", "branding", "documents",
+    "reports", "proposals", "ai", "llm"
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Office/Business",
+    "Topic :: Text Processing :: Markup :: Markdown",
+    "Topic :: Printing",
+]
+dependencies = [
+    "reportlab>=4.0",
+    "Pillow>=10.0",
+    "PyYAML>=6.0",
+    "mistune>=3.0",
+    # Pinned < 1.6 because 1.6.0 added a hard dep on rlpycairo → pycairo,
+    # which requires libcairo system libs (no Linux wheels exist). We only
+    # use svglib's classic svg2rlg path, which 1.5.x supports cleanly.
+    "svglib>=1.5,<1.6",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-cov>=4.0",
+    "ruff>=0.1",
+]
+mermaid = [
+    "requests>=2.28",
+    "cairosvg>=2.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/RoCCoCo13/corpdoc"
+Documentation = "https://github.com/RoCCoCo13/corpdoc/tree/main/docs"
+Repository = "https://github.com/RoCCoCo13/corpdoc"
+Issues = "https://github.com/RoCCoCo13/corpdoc/issues"
+Changelog = "https://github.com/RoCCoCo13/corpdoc/blob/main/CHANGELOG.md"
+
+[project.scripts]
+corpdoc = "corpdoc.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+corpdoc = ["*.yml", "templates/*"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]

corpdoc-0.4.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

corpdoc-0.4.0/src/corpdoc/__init__.py

@@ -0,0 +1,19 @@
+"""
+CorpDoc — Professional Corporate PDF Generator from Markdown + Logo.
+
+Turn a Markdown file and a corporate logo into a branded PDF with cover page,
+version history, table of contents, headers, footers, and auto-styled tables.
+
+Basic usage:
+    from corpdoc import CorpDoc
+
+    doc = CorpDoc(config='corpdoc.yml')
+    doc.render('report.md', output='report.pdf')
+"""
+
+__version__ = "0.4.0"
+
+from corpdoc.api import CorpDoc
+from corpdoc.colors import extract_colors_from_svg, assign_roles
+
+__all__ = ["CorpDoc", "extract_colors_from_svg", "assign_roles", "__version__"]