pdfgen-juanipis 0.1.3__tar.gz

pdfgen_juanipis-0.1.3/LICENSE

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

pdfgen_juanipis-0.1.3/PKG-INFO

@@ -0,0 +1,170 @@
+Metadata-Version: 2.4
+Name: pdfgen-juanipis
+Version: 0.1.3
+Summary: HTML-to-PDF generator with pagination and validation
+Author-email: Juan Pablo Díaz Correa <juanipis@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Juanipis/pdfgen-juanipis
+Project-URL: Issues, https://github.com/Juanipis/pdfgen-juanipis/issues
+Project-URL: Source, https://github.com/Juanipis/pdfgen-juanipis
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Jinja2==3.1.4
+Requires-Dist: WeasyPrint==59.0
+Requires-Dist: pydyf==0.10.0
+Requires-Dist: jsonschema==4.23.0
+Requires-Dist: PyYAML==6.0.2
+Dynamic: license-file
+
+# pdfgen
+
+Librería para generar PDFs a partir de data estructurada (HTML + WeasyPrint), con paginación, validación y soporte JSON/YAML.
+
+## Instalación
+
+Desde el repo:
+
+```bash
+pip install -e .
+```
+
+## Uso básico (Python)
+
+```python
+from pdfgen.api import PDFGenConfig, PDFGen
+
+config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
+pdf = PDFGen(config)
+
+pdf.render(data, output_path="salida.pdf", paginate=True, validate=True)
+```
+
+Atajo:
+
+```python
+from pdfgen.api import render_with_defaults
+
+render_with_defaults(data, output_path="salida.pdf", root_dir="/ruta/a/tu/proyecto")
+```
+
+## CLI
+
+Render (JSON o YAML):
+
+```bash
+pdfgen render data.json salida.pdf --root /ruta/proyecto
+pdfgen render data.yaml salida.pdf
+```
+
+Validar (sin generar PDF):
+
+```bash
+pdfgen validate data.yaml
+```
+
+Desde stdin (YAML por defecto):
+
+```bash
+cat data.yaml | pdfgen render - salida.pdf
+```
+
+Opciones útiles:
+- `--template-dir` usar tu template
+- `--css` usar tu CSS
+- `--fonts-conf` usar un `fonts.conf` propio
+- `--fonts-dir` usar un directorio con `.ttf`
+- `--css-extra` inyectar CSS adicional
+- `--no-validate` desactivar validación
+- `--no-paginate` desactivar paginación
+
+## Personalización
+
+### Fuentes propias
+
+Opción A: `fonts.conf` propio.
+
+```python
+config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
+config.fonts_conf = "/ruta/a/mi/fonts.conf"
+PDFGen(config).render(data, "salida.pdf")
+```
+
+Opción B: directorio con `.ttf` desde CLI:
+
+```bash
+pdfgen render data.json salida.pdf --fonts-dir /ruta/a/mis/fuentes
+```
+
+### Colores/estilos rápidos
+
+Puedes inyectar CSS extra para cambiar variables o estilos:
+
+```python
+css_extra = ":root { --blue-title: #0b7285; --orange-footer: #f08c00; }"
+render_with_defaults(data, "salida.pdf", root_dir="/ruta", css_extra=css_extra)
+```
+
+### Template y CSS propios
+
+```bash
+pdfgen render data.json salida.pdf --template-dir /ruta/template --css /ruta/template/boletin.css
+```
+
+## Estructura mínima del data
+
+```python
+data = {
+  "theme": {
+    "header_banner_path": "banner.png",
+    "header_logo_path": "logo.png",
+    "title_line1": "Titulo",
+    "title_line2": "Subtitulo",
+    "footer_site": "example.org",
+    "footer_phone": "Contacto: +1 555 0100"
+  },
+  "sections": [
+    {
+      "title": "I. Introduccion",
+      "content": [
+        {"type": "text", "text": "Texto con <strong>negrita</strong>."}
+      ]
+    }
+  ]
+}
+```
+
+## Estilos inline
+
+Los bloques de texto aceptan HTML:
+- `<strong>` negrita
+- `<em>` itálica
+- `<u>` subrayado
+- `<s>` tachado
+
+## Ejemplos
+
+- `examples/minimal.yaml`
+
+## Validación
+
+Se valida automáticamente con `schema.json`. Los warnings se imprimen en consola.
+
+Si quieres desactivar:
+
+```python
+pdf.render(data, output_path="salida.pdf", validate=False)
+```
+
+## Licencia
+
+MIT
+
+## Releases
+
+Al hacer push a `main`, el workflow **Auto Release** crea tag y Release si la versión en `pyproject.toml` es nueva, y publica automáticamente en PyPI.
+
+
+Hecho por Juanipis

pdfgen_juanipis-0.1.3/README.md

@@ -0,0 +1,149 @@
+# pdfgen
+
+Librería para generar PDFs a partir de data estructurada (HTML + WeasyPrint), con paginación, validación y soporte JSON/YAML.
+
+## Instalación
+
+Desde el repo:
+
+```bash
+pip install -e .
+```
+
+## Uso básico (Python)
+
+```python
+from pdfgen.api import PDFGenConfig, PDFGen
+
+config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
+pdf = PDFGen(config)
+
+pdf.render(data, output_path="salida.pdf", paginate=True, validate=True)
+```
+
+Atajo:
+
+```python
+from pdfgen.api import render_with_defaults
+
+render_with_defaults(data, output_path="salida.pdf", root_dir="/ruta/a/tu/proyecto")
+```
+
+## CLI
+
+Render (JSON o YAML):
+
+```bash
+pdfgen render data.json salida.pdf --root /ruta/proyecto
+pdfgen render data.yaml salida.pdf
+```
+
+Validar (sin generar PDF):
+
+```bash
+pdfgen validate data.yaml
+```
+
+Desde stdin (YAML por defecto):
+
+```bash
+cat data.yaml | pdfgen render - salida.pdf
+```
+
+Opciones útiles:
+- `--template-dir` usar tu template
+- `--css` usar tu CSS
+- `--fonts-conf` usar un `fonts.conf` propio
+- `--fonts-dir` usar un directorio con `.ttf`
+- `--css-extra` inyectar CSS adicional
+- `--no-validate` desactivar validación
+- `--no-paginate` desactivar paginación
+
+## Personalización
+
+### Fuentes propias
+
+Opción A: `fonts.conf` propio.
+
+```python
+config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
+config.fonts_conf = "/ruta/a/mi/fonts.conf"
+PDFGen(config).render(data, "salida.pdf")
+```
+
+Opción B: directorio con `.ttf` desde CLI:
+
+```bash
+pdfgen render data.json salida.pdf --fonts-dir /ruta/a/mis/fuentes
+```
+
+### Colores/estilos rápidos
+
+Puedes inyectar CSS extra para cambiar variables o estilos:
+
+```python
+css_extra = ":root { --blue-title: #0b7285; --orange-footer: #f08c00; }"
+render_with_defaults(data, "salida.pdf", root_dir="/ruta", css_extra=css_extra)
+```
+
+### Template y CSS propios
+
+```bash
+pdfgen render data.json salida.pdf --template-dir /ruta/template --css /ruta/template/boletin.css
+```
+
+## Estructura mínima del data
+
+```python
+data = {
+  "theme": {
+    "header_banner_path": "banner.png",
+    "header_logo_path": "logo.png",
+    "title_line1": "Titulo",
+    "title_line2": "Subtitulo",
+    "footer_site": "example.org",
+    "footer_phone": "Contacto: +1 555 0100"
+  },
+  "sections": [
+    {
+      "title": "I. Introduccion",
+      "content": [
+        {"type": "text", "text": "Texto con <strong>negrita</strong>."}
+      ]
+    }
+  ]
+}
+```
+
+## Estilos inline
+
+Los bloques de texto aceptan HTML:
+- `<strong>` negrita
+- `<em>` itálica
+- `<u>` subrayado
+- `<s>` tachado
+
+## Ejemplos
+
+- `examples/minimal.yaml`
+
+## Validación
+
+Se valida automáticamente con `schema.json`. Los warnings se imprimen en consola.
+
+Si quieres desactivar:
+
+```python
+pdf.render(data, output_path="salida.pdf", validate=False)
+```
+
+## Licencia
+
+MIT
+
+## Releases
+
+Al hacer push a `main`, el workflow **Auto Release** crea tag y Release si la versión en `pyproject.toml` es nueva, y publica automáticamente en PyPI.
+
+
+Hecho por Juanipis

pdfgen_juanipis-0.1.3/pyproject.toml

@@ -0,0 +1,49 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pdfgen-juanipis"
+version = "0.1.3"
+description = "HTML-to-PDF generator with pagination and validation"
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "Juan Pablo Díaz Correa", email = "juanipis@gmail.com" }
+]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Operating System :: OS Independent"
+]
+license-files = ["LICENSE"]
+dependencies = [
+  "Jinja2==3.1.4",
+  "WeasyPrint==59.0",
+  "pydyf==0.10.0",
+  "jsonschema==4.23.0",
+  "PyYAML==6.0.2"
+]
+
+[project.urls]
+Homepage = "https://github.com/Juanipis/pdfgen-juanipis"
+Issues = "https://github.com/Juanipis/pdfgen-juanipis/issues"
+Source = "https://github.com/Juanipis/pdfgen-juanipis"
+
+[project.scripts]
+pdfgen = "pdfgen.cli:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+pdfgen = [
+  "schema.json",
+  "templates/*.css",
+  "templates/*.jinja",
+  "assets/fonts/*",
+  "assets/*.png"
+]

pdfgen_juanipis-0.1.3/setup.cfg

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

pdfgen_juanipis-0.1.3/src/pdfgen/__init__.py

@@ -0,0 +1,17 @@
+"""PDF generation package."""
+
+from pdfgen.render import render_pdf, build_sample_data
+from pdfgen.validator import validate_and_normalize
+from pdfgen.pagination import LayoutConfig, Paginator
+from pdfgen.api import PDFGen, PDFGenConfig, render_with_defaults
+
+__all__ = [
+    "render_pdf",
+    "build_sample_data",
+    "validate_and_normalize",
+    "LayoutConfig",
+    "Paginator",
+    "PDFGen",
+    "PDFGenConfig",
+    "render_with_defaults",
+]

pdfgen_juanipis-0.1.3/src/pdfgen/api.py

@@ -0,0 +1,69 @@
+import pathlib
+from dataclasses import dataclass
+from typing import Any, Dict, Optional
+
+from pdfgen.render import render_pdf
+
+
+@dataclass
+class PDFGenConfig:
+    root_dir: pathlib.Path
+    template_dir: pathlib.Path
+    css_path: pathlib.Path
+    fonts_conf: Optional[pathlib.Path]
+
+    @classmethod
+    def from_root(cls, root_dir: pathlib.Path) -> "PDFGenConfig":
+        root_dir = pathlib.Path(root_dir)
+        package_root = pathlib.Path(__file__).resolve().parent
+        template_dir = root_dir / "template"
+        if not template_dir.exists():
+            template_dir = package_root / "templates"
+        css_path = template_dir / "boletin.css"
+        fonts_conf = root_dir / "fonts.conf"
+        if not fonts_conf.exists():
+            fonts_conf = None
+        return cls(
+            root_dir=root_dir,
+            template_dir=template_dir,
+            css_path=css_path,
+            fonts_conf=fonts_conf,
+        )
+
+
+class PDFGen:
+    def __init__(self, config: PDFGenConfig):
+        self.config = config
+
+    def render(
+        self,
+        data: Dict[str, Any],
+        output_path: pathlib.Path,
+        paginate: bool = True,
+        validate: bool = True,
+        css_extra: Optional[str] = None,
+    ) -> None:
+        render_pdf(
+            data,
+            output_path=output_path,
+            paginate=paginate,
+            validate=validate,
+            css_extra=css_extra,
+            template_dir=self.config.template_dir,
+            css_path=self.config.css_path,
+            fonts_conf=self.config.fonts_conf,
+            root_dir=self.config.root_dir,
+        )
+
+
+def render_with_defaults(
+    data: Dict[str, Any],
+    output_path: pathlib.Path,
+    root_dir: Optional[pathlib.Path] = None,
+    paginate: bool = True,
+    validate: bool = True,
+    css_extra: Optional[str] = None,
+) -> None:
+    root = pathlib.Path(root_dir) if root_dir else pathlib.Path.cwd()
+    config = PDFGenConfig.from_root(root)
+    PDFGen(config).render(data, output_path, paginate=paginate, validate=validate, css_extra=css_extra)

pdfgen_juanipis-0.1.3/src/pdfgen/cli.py

@@ -0,0 +1,106 @@
+import argparse
+import json
+import pathlib
+import sys
+import tempfile
+
+from pdfgen.api import PDFGen, PDFGenConfig
+
+
+def _build_fonts_conf(fonts_dir: pathlib.Path) -> pathlib.Path:
+    fonts_dir = pathlib.Path(fonts_dir).resolve()
+    content = f"""<?xml version=\"1.0\"?>
+<!DOCTYPE fontconfig SYSTEM \"fonts.dtd\">
+<fontconfig>
+  <dir>{fonts_dir}</dir>
+  <cache>
+    <dir>~/.cache/fontconfig</dir>
+  </cache>
+</fontconfig>
+"""
+    tmp = tempfile.NamedTemporaryFile("w", delete=False, suffix=".conf")
+    tmp.write(content)
+    tmp.flush()
+    tmp.close()
+    return pathlib.Path(tmp.name)
+
+
+def _load_data(path: pathlib.Path, fmt: str | None = None):
+    if str(path) == "-":
+        raw = sys.stdin.read()
+        inferred = fmt or "yaml"
+    else:
+        raw = path.read_text(encoding="utf-8")
+        inferred = fmt or path.suffix.lower().lstrip(".")
+
+    if inferred in ("yaml", "yml"):
+        try:
+            import yaml
+        except Exception as exc:
+            raise SystemExit("PyYAML is required for YAML input. Install with: pip install pyyaml") from exc
+        return yaml.safe_load(raw)
+
+    # default JSON
+    return json.loads(raw)
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(description="pdfgen CLI")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    render = sub.add_parser("render", help="Render a PDF from JSON/YAML")
+    render.add_argument("input", help="Path to JSON/YAML data (or - for stdin)")
+    render.add_argument("output", help="Output PDF path")
+    render.add_argument("--root", dest="root_dir", default=".", help="Project root dir")
+    render.add_argument("--template-dir", dest="template_dir", default=None)
+    render.add_argument("--css", dest="css_path", default=None)
+    render.add_argument("--fonts-conf", dest="fonts_conf", default=None)
+    render.add_argument("--fonts-dir", dest="fonts_dir", default=None)
+    render.add_argument("--css-extra", dest="css_extra", default=None, help="Extra CSS string")
+    render.add_argument("--format", dest="fmt", default=None, help="Input format: json|yaml")
+    render.add_argument("--no-validate", action="store_true")
+    render.add_argument("--no-paginate", action="store_true")
+
+    validate = sub.add_parser("validate", help="Validate JSON/YAML input against schema")
+    validate.add_argument("input", help="Path to JSON/YAML data (or - for stdin)")
+    validate.add_argument("--root", dest="root_dir", default=".", help="Project root dir")
+    validate.add_argument("--format", dest="fmt", default=None, help="Input format: json|yaml")
+
+    args = parser.parse_args(argv)
+
+    if args.command == "validate":
+        from pdfgen.validator import validate_and_normalize
+
+        root_dir = pathlib.Path(args.root_dir)
+        data = _load_data(pathlib.Path(args.input), fmt=args.fmt)
+        _, warnings = validate_and_normalize(data, root_dir=root_dir)
+        for warning in warnings:
+            print(f"[validate] {warning}")
+        return 0 if not warnings else 1
+
+    root_dir = pathlib.Path(args.root_dir)
+    config = PDFGenConfig.from_root(root_dir)
+
+    if args.template_dir:
+        config.template_dir = pathlib.Path(args.template_dir)
+    if args.css_path:
+        config.css_path = pathlib.Path(args.css_path)
+    if args.fonts_conf:
+        config.fonts_conf = pathlib.Path(args.fonts_conf)
+    if args.fonts_dir:
+        config.fonts_conf = _build_fonts_conf(pathlib.Path(args.fonts_dir))
+
+    data = _load_data(pathlib.Path(args.input), fmt=args.fmt)
+
+    PDFGen(config).render(
+        data,
+        output_path=pathlib.Path(args.output),
+        paginate=not args.no_paginate,
+        validate=not args.no_validate,
+        css_extra=args.css_extra,
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())