pdfgen-juanipis 0.1.3__tar.gz → 0.1.4__tar.gz

{pdfgen_juanipis-0.1.3 → pdfgen_juanipis-0.1.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pdfgen-juanipis
-Version: 0.1.3
+Version: 0.1.4
 Summary: HTML-to-PDF generator with pagination and validation
 Author-email: Juan Pablo Díaz Correa <juanipis@gmail.com>
 License-Expression: MIT
@@ -19,7 +19,7 @@ Requires-Dist: jsonschema==4.23.0
 Requires-Dist: PyYAML==6.0.2
 Dynamic: license-file
 
-# pdfgen
+# pdfgen-juanipis
 
 Librería para generar PDFs a partir de data estructurada (HTML + WeasyPrint), con paginación, validación y soporte JSON/YAML.
 
@@ -29,12 +29,18 @@ Desde el repo:
 
 ```bash
 pip install -e .
+
+Desde PyPI:
+
+```bash
+pip install pdfgen-juanipis
+```
 ```
 
 ## Uso básico (Python)
 
 ```python
-from pdfgen.api import PDFGenConfig, PDFGen
+from pdfgen_juanipis.api import PDFGenConfig, PDFGen
 
 config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
 pdf = PDFGen(config)
@@ -45,30 +51,40 @@ pdf.render(data, output_path="salida.pdf", paginate=True, validate=True)
 Atajo:
 
 ```python
-from pdfgen.api import render_with_defaults
+from pdfgen_juanipis.api import render_with_defaults
 
 render_with_defaults(data, output_path="salida.pdf", root_dir="/ruta/a/tu/proyecto")
 ```
 
+## Salida en bytes
+
+Si no quieres escribir a disco:
+
+```python
+from pdfgen_juanipis.api import render_with_defaults_bytes
+
+pdf_bytes = render_with_defaults_bytes(data, 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
+pdfgen-juanipis render data.json salida.pdf --root /ruta/proyecto
+pdfgen-juanipis render data.yaml salida.pdf
 ```
 
 Validar (sin generar PDF):
 
 ```bash
-pdfgen validate data.yaml
+pdfgen-juanipis validate data.yaml
 ```
 
 Desde stdin (YAML por defecto):
 
 ```bash
-cat data.yaml | pdfgen render - salida.pdf
+cat data.yaml | pdfgen-juanipis render - salida.pdf
 ```
 
 Opciones útiles:
@@ -79,6 +95,7 @@ Opciones útiles:
 - `--css-extra` inyectar CSS adicional
 - `--no-validate` desactivar validación
 - `--no-paginate` desactivar paginación
+- `--stdout` escribir bytes a stdout
 
 ## Personalización
 
@@ -95,7 +112,7 @@ 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
+pdfgen-juanipis render data.json salida.pdf --fonts-dir /ruta/a/mis/fuentes
 ```
 
 ### Colores/estilos rápidos
@@ -110,9 +127,13 @@ 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
+pdfgen-juanipis render data.json salida.pdf --template-dir /ruta/template --css /ruta/template/boletin.css
 ```
 
+### Assets
+
+El usuario debe proveer `banner.png` y `logo.png` (o rutas absolutas). Si no usas `assets/` en tu proyecto, indica rutas absolutas en `theme`.
+
 ## Estructura mínima del data
 
 ```python
@@ -147,6 +168,10 @@ Los bloques de texto aceptan HTML:
 ## Ejemplos
 
 - `examples/minimal.yaml`
+- `examples/minimal.json`
+- `notebooks/usage.ipynb`
+- `notebooks/bytes.ipynb`
+- `notebooks/advanced.ipynb`
 
 ## Validación
 

{pdfgen_juanipis-0.1.3 → pdfgen_juanipis-0.1.4}/README.md

@@ -1,4 +1,4 @@
-# pdfgen
+# pdfgen-juanipis
 
 Librería para generar PDFs a partir de data estructurada (HTML + WeasyPrint), con paginación, validación y soporte JSON/YAML.
 
@@ -8,12 +8,18 @@ Desde el repo:
 
 ```bash
 pip install -e .
+
+Desde PyPI:
+
+```bash
+pip install pdfgen-juanipis
+```
 ```
 
 ## Uso básico (Python)
 
 ```python
-from pdfgen.api import PDFGenConfig, PDFGen
+from pdfgen_juanipis.api import PDFGenConfig, PDFGen
 
 config = PDFGenConfig.from_root("/ruta/a/tu/proyecto")
 pdf = PDFGen(config)
@@ -24,30 +30,40 @@ pdf.render(data, output_path="salida.pdf", paginate=True, validate=True)
 Atajo:
 
 ```python
-from pdfgen.api import render_with_defaults
+from pdfgen_juanipis.api import render_with_defaults
 
 render_with_defaults(data, output_path="salida.pdf", root_dir="/ruta/a/tu/proyecto")
 ```
 
+## Salida en bytes
+
+Si no quieres escribir a disco:
+
+```python
+from pdfgen_juanipis.api import render_with_defaults_bytes
+
+pdf_bytes = render_with_defaults_bytes(data, 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
+pdfgen-juanipis render data.json salida.pdf --root /ruta/proyecto
+pdfgen-juanipis render data.yaml salida.pdf
 ```
 
 Validar (sin generar PDF):
 
 ```bash
-pdfgen validate data.yaml
+pdfgen-juanipis validate data.yaml
 ```
 
 Desde stdin (YAML por defecto):
 
 ```bash
-cat data.yaml | pdfgen render - salida.pdf
+cat data.yaml | pdfgen-juanipis render - salida.pdf
 ```
 
 Opciones útiles:
@@ -58,6 +74,7 @@ Opciones útiles:
 - `--css-extra` inyectar CSS adicional
 - `--no-validate` desactivar validación
 - `--no-paginate` desactivar paginación
+- `--stdout` escribir bytes a stdout
 
 ## Personalización
 
@@ -74,7 +91,7 @@ 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
+pdfgen-juanipis render data.json salida.pdf --fonts-dir /ruta/a/mis/fuentes
 ```
 
 ### Colores/estilos rápidos
@@ -89,9 +106,13 @@ 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
+pdfgen-juanipis render data.json salida.pdf --template-dir /ruta/template --css /ruta/template/boletin.css
 ```
 
+### Assets
+
+El usuario debe proveer `banner.png` y `logo.png` (o rutas absolutas). Si no usas `assets/` en tu proyecto, indica rutas absolutas en `theme`.
+
 ## Estructura mínima del data
 
 ```python
@@ -126,6 +147,10 @@ Los bloques de texto aceptan HTML:
 ## Ejemplos
 
 - `examples/minimal.yaml`
+- `examples/minimal.json`
+- `notebooks/usage.ipynb`
+- `notebooks/bytes.ipynb`
+- `notebooks/advanced.ipynb`
 
 ## Validación
 
@@ -146,4 +171,4 @@ MIT
 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
+Hecho por Juanipis

{pdfgen_juanipis-0.1.3 → pdfgen_juanipis-0.1.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pdfgen-juanipis"
-version = "0.1.3"
+version = "0.1.4"
 description = "HTML-to-PDF generator with pagination and validation"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -31,7 +31,7 @@ Issues = "https://github.com/Juanipis/pdfgen-juanipis/issues"
 Source = "https://github.com/Juanipis/pdfgen-juanipis"
 
 [project.scripts]
-pdfgen = "pdfgen.cli:main"
+pdfgen-juanipis = "pdfgen_juanipis.cli:main"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
@@ -40,7 +40,7 @@ package-dir = {"" = "src"}
 where = ["src"]
 
 [tool.setuptools.package-data]
-pdfgen = [
+pdfgen_juanipis = [
   "schema.json",
   "templates/*.css",
   "templates/*.jinja",

pdfgen_juanipis-0.1.4/src/pdfgen_juanipis/__init__.py

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

{pdfgen_juanipis-0.1.3/src/pdfgen → pdfgen_juanipis-0.1.4/src/pdfgen_juanipis}/api.py

@@ -2,7 +2,7 @@ import pathlib
 from dataclasses import dataclass
 from typing import Any, Dict, Optional
 
-from pdfgen.render import render_pdf
+from pdfgen_juanipis.render import render_pdf
 
 
 @dataclass
@@ -55,6 +55,26 @@ class PDFGen:
             root_dir=self.config.root_dir,
         )
 
+    def render_bytes(
+        self,
+        data: Dict[str, Any],
+        paginate: bool = True,
+        validate: bool = True,
+        css_extra: Optional[str] = None,
+    ) -> bytes:
+        return render_pdf(
+            data,
+            output_path=None,
+            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,
+            output_bytes=True,
+        )
+
 
 def render_with_defaults(
     data: Dict[str, Any],
@@ -67,3 +87,15 @@ def render_with_defaults(
     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)
+
+
+def render_with_defaults_bytes(
+    data: Dict[str, Any],
+    root_dir: Optional[pathlib.Path] = None,
+    paginate: bool = True,
+    validate: bool = True,
+    css_extra: Optional[str] = None,
+) -> bytes:
+    root = pathlib.Path(root_dir) if root_dir else pathlib.Path.cwd()
+    config = PDFGenConfig.from_root(root)
+    return PDFGen(config).render_bytes(data, paginate=paginate, validate=validate, css_extra=css_extra)

{pdfgen_juanipis-0.1.3/src/pdfgen → pdfgen_juanipis-0.1.4/src/pdfgen_juanipis}/cli.py

@@ -4,7 +4,7 @@ import pathlib
 import sys
 import tempfile
 
-from pdfgen.api import PDFGen, PDFGenConfig
+from pdfgen_juanipis.api import PDFGen, PDFGenConfig
 
 
 def _build_fonts_conf(fonts_dir: pathlib.Path) -> pathlib.Path:
@@ -45,7 +45,7 @@ def _load_data(path: pathlib.Path, fmt: str | None = None):
 
 
 def main(argv=None) -> int:
-    parser = argparse.ArgumentParser(description="pdfgen CLI")
+    parser = argparse.ArgumentParser(description="pdfgen-juanipis CLI")
     sub = parser.add_subparsers(dest="command", required=True)
 
     render = sub.add_parser("render", help="Render a PDF from JSON/YAML")
@@ -60,6 +60,7 @@ def main(argv=None) -> int:
     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")
+    render.add_argument("--stdout", action="store_true", help="Write PDF bytes to stdout")
 
     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)")
@@ -69,7 +70,7 @@ def main(argv=None) -> int:
     args = parser.parse_args(argv)
 
     if args.command == "validate":
-        from pdfgen.validator import validate_and_normalize
+        from pdfgen_juanipis.validator import validate_and_normalize
 
         root_dir = pathlib.Path(args.root_dir)
         data = _load_data(pathlib.Path(args.input), fmt=args.fmt)
@@ -92,6 +93,16 @@ def main(argv=None) -> int:
 
     data = _load_data(pathlib.Path(args.input), fmt=args.fmt)
 
+    if args.stdout:
+        pdf_bytes = PDFGen(config).render_bytes(
+            data,
+            paginate=not args.no_paginate,
+            validate=not args.no_validate,
+            css_extra=args.css_extra,
+        )
+        sys.stdout.buffer.write(pdf_bytes)
+        return 0
+
     PDFGen(config).render(
         data,
         output_path=pathlib.Path(args.output),

{pdfgen_juanipis-0.1.3/src/pdfgen → pdfgen_juanipis-0.1.4/src/pdfgen_juanipis}/render.py

@@ -8,8 +8,8 @@ from weasyprint import HTML, CSS
 if __name__ == "__main__" and __package__ is None:
     sys.path.insert(0, str(pathlib.Path(__file__).resolve().parents[2] / "src"))
 
-from pdfgen.pagination import LayoutConfig, Paginator
-from pdfgen.validator import validate_and_normalize
+from pdfgen_juanipis.pagination import LayoutConfig, Paginator
+from pdfgen_juanipis.validator import validate_and_normalize
 
 ROOT = pathlib.Path(__file__).resolve().parents[2]
 PACKAGE_ROOT = pathlib.Path(__file__).resolve().parent
@@ -303,6 +303,7 @@ def render_pdf(
     fonts_conf=None,
     css_extra=None,
     root_dir=None,
+    output_bytes=False,
 ):
     root_dir = pathlib.Path(root_dir) if root_dir else ROOT
     template_dir = pathlib.Path(template_dir) if template_dir else TEMPLATE_DIR
@@ -334,7 +335,13 @@ def render_pdf(
     if css_extra:
         stylesheets.append(CSS(string=str(css_extra)))
 
+    if output_bytes or output_path is None:
+        return HTML(string=html, base_url=str(root_dir)).write_pdf(
+            stylesheets=stylesheets
+        )
+
     HTML(string=html, base_url=str(root_dir)).write_pdf(output_path, stylesheets=stylesheets)
+    return None
 
     print(f"Wrote {output_path}")
 

pdfgen_juanipis-0.1.4/src/pdfgen_juanipis/schema.json

@@ -0,0 +1,272 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "PDFGenJuanipisDocument",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "refs_catalog": {
+      "type": "object",
+      "additionalProperties": {
+        "type": "string"
+      }
+    },
+    "theme": {
+      "type": "object",
+      "properties": {
+        "header_banner_path": {
+          "type": "string"
+        },
+        "header_banner_path_cont": {
+          "type": "string"
+        },
+        "header_logo_path": {
+          "type": "string"
+        },
+        "title_line1": {
+          "type": "string"
+        },
+        "title_line2": {
+          "type": "string"
+        },
+        "footer_site": {
+          "type": "string"
+        },
+        "footer_phone": {
+          "type": "string"
+        },
+        "show_header_titles": {
+          "type": "boolean"
+        }
+      },
+      "additionalProperties": true
+    },
+    "sections": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/section"
+      }
+    },
+    "pages": {
+      "type": "array",
+      "items": {
+        "$ref": "#/definitions/page"
+      }
+    }
+  },
+  "anyOf": [
+    {
+      "required": [
+        "sections"
+      ]
+    },
+    {
+      "required": [
+        "pages"
+      ]
+    }
+  ],
+  "definitions": {
+    "section": {
+      "type": "object",
+      "properties": {
+        "title": {
+          "type": "string"
+        },
+        "subtitle": {
+          "type": "string"
+        },
+        "content": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/block"
+          }
+        },
+        "refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "footer_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "content"
+      ],
+      "additionalProperties": true
+    },
+    "page": {
+      "type": "object",
+      "properties": {
+        "blocks": {
+          "type": "array",
+          "items": {
+            "$ref": "#/definitions/block"
+          }
+        },
+        "refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "footer_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        }
+      },
+      "required": [
+        "blocks"
+      ],
+      "additionalProperties": true
+    },
+    "block": {
+      "type": "object",
+      "properties": {
+        "type": {
+          "type": "string",
+          "enum": [
+            "text",
+            "table",
+            "figure",
+            "map_grid",
+            "html"
+          ]
+        },
+        "text": {
+          "type": [
+            "string",
+            "array"
+          ],
+          "items": {
+            "type": "string"
+          }
+        },
+        "html": {
+          "type": "string"
+        },
+        "refs": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "footer_notes": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "table": {
+          "$ref": "#/definitions/table"
+        },
+        "path": {
+          "type": "string"
+        },
+        "caption": {
+          "type": "string"
+        },
+        "wide": {
+          "type": "boolean"
+        },
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "path": {
+                "type": "string"
+              },
+              "label": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "path"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "source": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "additionalProperties": true
+    },
+    "table": {
+      "type": "object",
+      "properties": {
+        "groups": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "title": {
+                "type": "string"
+              },
+              "months": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "title",
+              "months"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "rows": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "dep": {
+                "type": "string"
+              },
+              "vals": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "dep",
+              "vals"
+            ],
+            "additionalProperties": true
+          }
+        },
+        "total_width": {
+          "type": "number"
+        },
+        "dep_width": {
+          "type": "number"
+        },
+        "show_header": {
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "groups",
+        "rows"
+      ],
+      "additionalProperties": true
+    }
+  }
+}

{pdfgen_juanipis-0.1.3/src/pdfgen → pdfgen_juanipis-0.1.4/src/pdfgen_juanipis}/validator.py

@@ -220,7 +220,7 @@ def _extract_ref_ids(text: str) -> List[str]:
 
 def _validate_schema(data: Dict[str, Any], root_dir: pathlib.Path) -> List[str]:
     warnings: List[str] = []
-    schema_path = root_dir / "src" / "pdfgen" / "schema.json"
+    schema_path = root_dir / "src" / "pdfgen_juanipis" / "schema.json"
     if not schema_path.exists():
         schema_path = pathlib.Path(__file__).resolve().parent / "schema.json"
     if not schema_path.exists():