imagetyler 0.1.0__tar.gz

imagetyler-0.1.0/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, Adityarup Laha
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice,
+   this list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

imagetyler-0.1.0/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: imagetyler
+Version: 0.1.0
+Summary: Tile an image across a PDF page for print-ready output.
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, Adityarup Laha
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice,
+           this list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: reportlab
+Requires-Dist: pillow
+Dynamic: license-file
+
+# ImageTyler
+
+[![BSD-3-Clause](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+ImageTyler tiles a source image across a PDF page for print-ready output. Entirely vibe-coded, but reviewed and tested by humans. It supports mixed-unit dimensions, padding, and cutting guides.
+
+## Installation
+
+Install as a standalone tool with `uv`:
+
+```bash
+uv tool install imagetyler
+```
+
+Add it as a dependency in your project:
+
+```bash
+uv add imagetyler
+```
+
+## CLI Usage
+
+Basic usage:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper A4
+```
+
+ImageTyler accepts mixed-unit dimensions and inherits missing units from either side of the `WxH` expression. These all work:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper 210x297mm
+imagetyler photo.jpg --size 35mmx45 --paper Letter
+imagetyler photo.jpg --padding 2mm --landscape --border
+```
+
+Useful flags include `--padding` for spacing between tiles, `--landscape` for rotating the target page, and `--border` with `--border-width` for cutting guides.
+
+Use `--list-units` to inspect supported measurement units and `--list-paper` to list recognized paper aliases.
+
+## API Usage
+
+```python
+from pathlib import Path
+
+from imagetyler import generate_tiled_pdf
+
+output = generate_tiled_pdf(
+    image_path=Path("photo.jpg"),
+    output_pdf=Path("tiled_output.pdf"),
+    paper="A4",
+    image_size="35x45mm",
+    padding="2mm",
+)
+
+print(output)
+```
+
+## License
+
+ImageTyler is distributed under the BSD-3-Clause license.

imagetyler-0.1.0/README.md

@@ -0,0 +1,61 @@
+# ImageTyler
+
+[![BSD-3-Clause](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+ImageTyler tiles a source image across a PDF page for print-ready output. Entirely vibe-coded, but reviewed and tested by humans. It supports mixed-unit dimensions, padding, and cutting guides.
+
+## Installation
+
+Install as a standalone tool with `uv`:
+
+```bash
+uv tool install imagetyler
+```
+
+Add it as a dependency in your project:
+
+```bash
+uv add imagetyler
+```
+
+## CLI Usage
+
+Basic usage:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper A4
+```
+
+ImageTyler accepts mixed-unit dimensions and inherits missing units from either side of the `WxH` expression. These all work:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper 210x297mm
+imagetyler photo.jpg --size 35mmx45 --paper Letter
+imagetyler photo.jpg --padding 2mm --landscape --border
+```
+
+Useful flags include `--padding` for spacing between tiles, `--landscape` for rotating the target page, and `--border` with `--border-width` for cutting guides.
+
+Use `--list-units` to inspect supported measurement units and `--list-paper` to list recognized paper aliases.
+
+## API Usage
+
+```python
+from pathlib import Path
+
+from imagetyler import generate_tiled_pdf
+
+output = generate_tiled_pdf(
+    image_path=Path("photo.jpg"),
+    output_pdf=Path("tiled_output.pdf"),
+    paper="A4",
+    image_size="35x45mm",
+    padding="2mm",
+)
+
+print(output)
+```
+
+## License
+
+ImageTyler is distributed under the BSD-3-Clause license.

imagetyler-0.1.0/pyproject.toml

@@ -0,0 +1,34 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "imagetyler"
+version = "0.1.0"
+description = "Tile an image across a PDF page for print-ready output."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { file = "LICENSE" }
+dependencies = ["typer", "reportlab", "pillow"]
+
+[project.scripts]
+imagetyler = "imagetyler.cli:app"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[dependency-groups]
+dev = ["pytest", "ruff"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "B", "UP"]

imagetyler-0.1.0/setup.cfg

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

imagetyler-0.1.0/src/imagetyler/__init__.py

@@ -0,0 +1,31 @@
+"""Public API for ImageTyler."""
+
+from .core import generate_tiled_pdf
+from .layout import ASPECT_RATIO_TOLERANCE, calculate_grid_layout, validate_aspect_ratio
+from .parser import (
+    AVAILABLE_PAGESIZES,
+    AVAILABLE_UNITS,
+    DEFAULT_BORDER_WIDTH_STR,
+    DEFAULT_IMAGE_SIZE_STR,
+    DEFAULT_PAPER_STR,
+    DEFAULT_PADDING_STR,
+    DEFAULT_UNIT_STR,
+    parse_dimensions,
+    parse_length,
+)
+
+__all__ = [
+    "ASPECT_RATIO_TOLERANCE",
+    "AVAILABLE_PAGESIZES",
+    "AVAILABLE_UNITS",
+    "DEFAULT_BORDER_WIDTH_STR",
+    "DEFAULT_IMAGE_SIZE_STR",
+    "DEFAULT_PAPER_STR",
+    "DEFAULT_PADDING_STR",
+    "DEFAULT_UNIT_STR",
+    "calculate_grid_layout",
+    "generate_tiled_pdf",
+    "parse_dimensions",
+    "parse_length",
+    "validate_aspect_ratio",
+]

imagetyler-0.1.0/src/imagetyler/cli.py

@@ -0,0 +1,150 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+from typing import Annotated, Optional
+
+import typer
+
+from .core import generate_tiled_pdf
+from .parser import AVAILABLE_PAGESIZES, AVAILABLE_UNITS
+
+LOG_FORMAT = "%(asctime)s | %(levelname)-8s | %(message)s"
+DATE_FORMAT = "%Y-%m-%d %H:%M:%S"
+
+app = typer.Typer(
+    help="Automagically tile images onto a PDF page using regex dimension parsing.",
+    add_completion=True,
+)
+
+
+def setup_logger(verbose: bool) -> logging.Logger:
+    level = logging.DEBUG if verbose else logging.INFO
+    logging.basicConfig(level=level, format=LOG_FORMAT, datefmt=DATE_FORMAT)
+    return logging.getLogger(__name__)
+
+
+def list_units_callback(value: bool) -> None:
+    if value:
+        typer.echo("Supported measurement units (case-insensitive):")
+        typer.echo(f"  {', '.join(sorted(AVAILABLE_UNITS.keys()))}")
+        raise typer.Exit()
+
+
+def list_paper_callback(value: bool) -> None:
+    if value:
+        typer.echo("Supported paper size aliases (case-insensitive):")
+        typer.echo(f"  {', '.join(sorted(AVAILABLE_PAGESIZES.keys()))}")
+        raise typer.Exit()
+
+
+@app.command()
+def tile_image(
+    image_path: Annotated[
+        Optional[Path],
+        typer.Argument(
+            help="Path to the input image file (JPEG, PNG, etc).",
+            exists=True,
+            file_okay=True,
+            dir_okay=False,
+            readable=True,
+            resolve_path=True,
+        ),
+    ] = None,
+    output_pdf: Annotated[
+        Path,
+        typer.Option("--output", "-o", help="Path to save the generated PDF file.", writable=True),
+    ] = Path("tiled_output.pdf"),
+    paper: Annotated[
+        str,
+        typer.Option(
+            "--paper",
+            "-p",
+            help="Paper size alias (e.g., A4) or explicit dimensions (e.g., 210x297mm).",
+        ),
+    ] = "A4",
+    landscape: Annotated[
+        bool,
+        typer.Option(
+            "--landscape",
+            "-l",
+            help="Rotate the target paper orientation to landscape.",
+        ),
+    ] = False,
+    image_size: Annotated[
+        str,
+        typer.Option(
+            "--size",
+            "-s",
+            help="Target image size formatted as WxH with optional mixed units.",
+        ),
+    ] = "35x45mm",
+    padding_str: Annotated[
+        str, typer.Option("--padding", help="Minimum padding between images.")
+    ] = "2mm",
+    draw_border: Annotated[
+        bool,
+        typer.Option(
+            "--border",
+            "-b",
+            help="Draw a solid black border around each image for ease of cutting.",
+        ),
+    ] = False,
+    border_width_str: Annotated[
+        str,
+        typer.Option(
+            "--border-width",
+            help="Width of the border if enabled, supporting standard units.",
+        ),
+    ] = "2pt",
+    verbose: Annotated[
+        bool, typer.Option("--verbose", "-v", help="Enable verbose debug logging.")
+    ] = False,
+    list_units: Annotated[
+        bool,
+        typer.Option(
+            "--list-units",
+            help="List all supported measurement units (case-insensitive) and exit.",
+            callback=list_units_callback,
+            is_eager=True,
+        ),
+    ] = False,
+    list_paper: Annotated[
+        bool,
+        typer.Option(
+            "--list-paper",
+            help="List all supported paper size aliases (case-insensitive) and exit.",
+            callback=list_paper_callback,
+            is_eager=True,
+        ),
+    ] = False,
+) -> None:
+    if not image_path:
+        typer.echo(
+            "Error: Missing argument 'IMAGE_PATH'. Use --help for usage details.",
+            err=True,
+        )
+        raise typer.Exit(code=1)
+
+    setup_logger(verbose)
+
+    try:
+        generate_tiled_pdf(
+            image_path=image_path,
+            output_pdf=output_pdf,
+            paper=paper,
+            landscape=landscape,
+            image_size=image_size,
+            padding=padding_str,
+            draw_border=draw_border,
+            border_width=border_width_str,
+        )
+    except (ValueError, RuntimeError) as exc:
+        logging.getLogger(__name__).error(str(exc))
+        raise typer.Exit(code=1) from exc
+
+    logging.getLogger(__name__).info("Successfully generated PDF: '%s'", output_pdf)
+
+
+if __name__ == "__main__":
+    app()

imagetyler-0.1.0/src/imagetyler/core.py

@@ -0,0 +1,48 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from .layout import calculate_grid_layout, validate_aspect_ratio
+from .pdf import generate_pdf
+from .parser import parse_dimensions, parse_length
+
+logger = logging.getLogger(__name__)
+
+
+def generate_tiled_pdf(
+    image_path: Path | str,
+    output_pdf: Path | str = Path("tiled_output.pdf"),
+    paper: str = "A4",
+    landscape: bool = False,
+    image_size: str = "35x45mm",
+    padding: str = "2mm",
+    draw_border: bool = False,
+    border_width: str = "2pt",
+) -> Path:
+    image_path = Path(image_path)
+    output_pdf = Path(output_pdf)
+
+    paper_width, paper_height = parse_dimensions(paper)
+    if landscape:
+        paper_width, paper_height = paper_height, paper_width
+
+    img_width, img_height = parse_dimensions(image_size)
+    padding_value = parse_length(padding)
+    border_width_value = parse_length(border_width) if draw_border else 0.0
+
+    validate_aspect_ratio(image_path, img_width, img_height, logger)
+
+    grid = calculate_grid_layout(paper_width, paper_height, img_width, img_height, padding_value)
+    generate_pdf(
+        image_path=image_path,
+        output_pdf=output_pdf,
+        paper_size=(paper_width, paper_height),
+        grid=grid,
+        image_size=(img_width, img_height),
+        padding=padding_value,
+        draw_border=draw_border,
+        border_width=border_width_value,
+    )
+
+    return output_pdf

imagetyler-0.1.0/src/imagetyler/layout.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from PIL import Image
+
+ASPECT_RATIO_TOLERANCE: float = 0.05
+
+
+def calculate_grid_layout(
+    paper_width: float,
+    paper_height: float,
+    img_width: float,
+    img_height: float,
+    padding: float,
+) -> tuple[int, int, float, float]:
+    cols = int((paper_width + padding) / (img_width + padding))
+    rows = int((paper_height + padding) / (img_height + padding))
+
+    if cols <= 0 or rows <= 0:
+        raise ValueError("The specified image dimensions and padding exceed the paper size.")
+
+    total_grid_width = (cols * img_width) + ((cols - 1) * padding)
+    total_grid_height = (rows * img_height) + ((rows - 1) * padding)
+
+    margin_x = (paper_width - total_grid_width) / 2.0
+    margin_y = (paper_height - total_grid_height) / 2.0
+
+    return cols, rows, margin_x, margin_y
+
+
+def validate_aspect_ratio(
+    image_path: Path,
+    target_width: float,
+    target_height: float,
+    logger: logging.Logger,
+    tolerance: float = ASPECT_RATIO_TOLERANCE,
+) -> None:
+    try:
+        with Image.open(image_path) as img:
+            native_width_px, native_height_px = img.size
+            native_ratio = native_width_px / native_height_px
+            target_ratio = target_width / target_height
+
+            difference = abs((native_ratio / target_ratio) - 1.0)
+            logger.debug(
+                "Native aspect ratio: %.3f, Target aspect ratio: %.3f",
+                native_ratio,
+                target_ratio,
+            )
+
+            if difference > tolerance:
+                logger.warning(
+                    "ASPECT RATIO MISMATCH: The input image differs from the target dimensions by %.1f%%. "
+                    "The image will be visibly stretched or squashed.",
+                    difference * 100,
+                )
+    except Exception as exc:  # pragma: no cover - surface-level file/image failure
+        raise ValueError(f"Failed to read image '{image_path}': {exc}") from exc

imagetyler-0.1.0/src/imagetyler/parser.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+import inspect
+import re
+
+from reportlab.lib import pagesizes, units
+
+AVAILABLE_UNITS: dict[str, float] = {
+    name.lower(): value
+    for name, value in inspect.getmembers(units)
+    if not name.startswith("_") and isinstance(value, (int, float))
+}
+AVAILABLE_UNITS["pt"] = 1.0
+
+AVAILABLE_PAGESIZES: dict[str, tuple[float, float]] = {
+    name.lower(): value
+    for name, value in inspect.getmembers(pagesizes)
+    if not name.startswith("_") and isinstance(value, tuple) and len(value) == 2
+}
+
+DEFAULT_PAPER_STR: str = "A4"
+DEFAULT_IMAGE_SIZE_STR: str = "35x45mm"
+DEFAULT_PADDING_STR: str = "2mm"
+DEFAULT_UNIT_STR: str = "mm"
+DEFAULT_BORDER_WIDTH_STR: str = "2pt"
+
+
+def parse_dimensions(val: str) -> tuple[float, float]:
+    """Parse a `WxH` string or paper alias into points."""
+
+    clean_val = re.sub(r"\s+", "", val.lower())
+
+    if clean_val in AVAILABLE_PAGESIZES:
+        return AVAILABLE_PAGESIZES[clean_val]
+
+    match = re.match(r"^([\d.]+)([a-z]*)x([\d.]+)([a-z]*)$", clean_val)
+    if not match:
+        raise ValueError(
+            f"Invalid dimension format: '{val}'. Expected 'WxH' or a standard paper alias."
+        )
+
+    w_num_str, w_unit_str, h_num_str, h_unit_str = match.groups()
+
+    if not w_unit_str and not h_unit_str:
+        resolved_w_unit = DEFAULT_UNIT_STR
+        resolved_h_unit = DEFAULT_UNIT_STR
+    elif not w_unit_str:
+        resolved_w_unit = h_unit_str
+        resolved_h_unit = h_unit_str
+    elif not h_unit_str:
+        resolved_w_unit = w_unit_str
+        resolved_h_unit = w_unit_str
+    else:
+        resolved_w_unit = w_unit_str
+        resolved_h_unit = h_unit_str
+
+    if resolved_w_unit not in AVAILABLE_UNITS:
+        raise ValueError(f"Unknown unit for width: '{resolved_w_unit}'")
+    if resolved_h_unit not in AVAILABLE_UNITS:
+        raise ValueError(f"Unknown unit for height: '{resolved_h_unit}'")
+
+    return float(w_num_str) * AVAILABLE_UNITS[resolved_w_unit], float(h_num_str) * AVAILABLE_UNITS[
+        resolved_h_unit
+    ]
+
+
+def parse_length(val: str) -> float:
+    """Parse a single length string into points."""
+
+    clean_val = re.sub(r"\s+", "", val.lower())
+    match = re.match(r"^([\d.]+)([a-z]*)$", clean_val)
+    if not match:
+        raise ValueError(f"Cannot parse length value: '{val}'")
+
+    num_str, unit_str = match.groups()
+    resolved_unit = unit_str if unit_str else DEFAULT_UNIT_STR
+
+    if resolved_unit not in AVAILABLE_UNITS:
+        raise ValueError(f"Unknown unit: '{resolved_unit}'")
+
+    return float(num_str) * AVAILABLE_UNITS[resolved_unit]

imagetyler-0.1.0/src/imagetyler/pdf.py

@@ -0,0 +1,42 @@
+from __future__ import annotations
+
+import logging
+from pathlib import Path
+
+from reportlab.pdfgen import canvas
+
+
+def generate_pdf(
+    image_path: Path,
+    output_pdf: Path,
+    paper_size: tuple[float, float],
+    grid: tuple[int, int, float, float],
+    image_size: tuple[float, float],
+    padding: float,
+    draw_border: bool,
+    border_width: float,
+) -> None:
+    cols, rows, margin_x, margin_y = grid
+    img_width, img_height = image_size
+
+    try:
+        pdf_canvas = canvas.Canvas(str(output_pdf), pagesize=paper_size)
+
+        for row in range(rows):
+            for col in range(cols):
+                x_pos = margin_x + (col * (img_width + padding))
+                y_pos = margin_y + (row * (img_height + padding))
+
+                pdf_canvas.drawImage(
+                    str(image_path), x_pos, y_pos, width=img_width, height=img_height
+                )
+
+                if draw_border:
+                    pdf_canvas.setLineWidth(border_width)
+                    pdf_canvas.setStrokeColorRGB(0, 0, 0)
+                    pdf_canvas.rect(x_pos, y_pos, img_width, img_height, stroke=1, fill=0)
+
+        pdf_canvas.showPage()
+        pdf_canvas.save()
+    except Exception as exc:
+        raise RuntimeError(f"An error occurred while generating the PDF: {exc}") from exc

imagetyler-0.1.0/src/imagetyler.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: imagetyler
+Version: 0.1.0
+Summary: Tile an image across a PDF page for print-ready output.
+License: BSD 3-Clause License
+        
+        Copyright (c) 2026, Adityarup Laha
+        All rights reserved.
+        
+        Redistribution and use in source and binary forms, with or without
+        modification, are permitted provided that the following conditions are met:
+        
+        1. Redistributions of source code must retain the above copyright notice,
+           this list of conditions and the following disclaimer.
+        
+        2. Redistributions in binary form must reproduce the above copyright notice,
+           this list of conditions and the following disclaimer in the documentation
+           and/or other materials provided with the distribution.
+        
+        3. Neither the name of the copyright holder nor the names of its
+           contributors may be used to endorse or promote products derived from
+           this software without specific prior written permission.
+        
+        THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+        AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+        IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+        DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+        FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+        DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+        SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+        CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+        OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+        OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+        
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: typer
+Requires-Dist: reportlab
+Requires-Dist: pillow
+Dynamic: license-file
+
+# ImageTyler
+
+[![BSD-3-Clause](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](LICENSE)
+
+ImageTyler tiles a source image across a PDF page for print-ready output. Entirely vibe-coded, but reviewed and tested by humans. It supports mixed-unit dimensions, padding, and cutting guides.
+
+## Installation
+
+Install as a standalone tool with `uv`:
+
+```bash
+uv tool install imagetyler
+```
+
+Add it as a dependency in your project:
+
+```bash
+uv add imagetyler
+```
+
+## CLI Usage
+
+Basic usage:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper A4
+```
+
+ImageTyler accepts mixed-unit dimensions and inherits missing units from either side of the `WxH` expression. These all work:
+
+```bash
+imagetyler photo.jpg --size 35x45mm --paper 210x297mm
+imagetyler photo.jpg --size 35mmx45 --paper Letter
+imagetyler photo.jpg --padding 2mm --landscape --border
+```
+
+Useful flags include `--padding` for spacing between tiles, `--landscape` for rotating the target page, and `--border` with `--border-width` for cutting guides.
+
+Use `--list-units` to inspect supported measurement units and `--list-paper` to list recognized paper aliases.
+
+## API Usage
+
+```python
+from pathlib import Path
+
+from imagetyler import generate_tiled_pdf
+
+output = generate_tiled_pdf(
+    image_path=Path("photo.jpg"),
+    output_pdf=Path("tiled_output.pdf"),
+    paper="A4",
+    image_size="35x45mm",
+    padding="2mm",
+)
+
+print(output)
+```
+
+## License
+
+ImageTyler is distributed under the BSD-3-Clause license.

imagetyler-0.1.0/src/imagetyler.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+pyproject.toml
+src/imagetyler/__init__.py
+src/imagetyler/cli.py
+src/imagetyler/core.py
+src/imagetyler/layout.py
+src/imagetyler/parser.py
+src/imagetyler/pdf.py
+src/imagetyler.egg-info/PKG-INFO
+src/imagetyler.egg-info/SOURCES.txt
+src/imagetyler.egg-info/dependency_links.txt
+src/imagetyler.egg-info/entry_points.txt
+src/imagetyler.egg-info/requires.txt
+src/imagetyler.egg-info/top_level.txt
+tests/test_core.py
+tests/test_parser.py

imagetyler-0.1.0/src/imagetyler.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

imagetyler-0.1.0/src/imagetyler.egg-info/entry_points.txt

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

imagetyler-0.1.0/src/imagetyler.egg-info/requires.txt

@@ -0,0 +1,3 @@
+typer
+reportlab
+pillow

imagetyler-0.1.0/src/imagetyler.egg-info/top_level.txt

@@ -0,0 +1 @@
+imagetyler

imagetyler-0.1.0/tests/test_core.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+from PIL import Image
+
+from imagetyler.core import generate_tiled_pdf
+
+
+def test_generate_tiled_pdf_creates_output(tmp_path: Path):
+    image_path = tmp_path / "sample.png"
+    output_pdf = tmp_path / "output.pdf"
+
+    image = Image.new("RGB", (350, 450), color="white")
+    image.save(image_path)
+
+    result = generate_tiled_pdf(image_path=image_path, output_pdf=output_pdf)
+
+    assert result == output_pdf
+    assert output_pdf.exists()
+    assert output_pdf.stat().st_size > 0

imagetyler-0.1.0/tests/test_parser.py

@@ -0,0 +1,28 @@
+from __future__ import annotations
+
+import math
+
+from reportlab.lib import pagesizes, units
+
+from imagetyler.parser import parse_dimensions, parse_length
+
+
+def test_parse_dimensions_inherits_units_from_right():
+    width, height = parse_dimensions("35x45mm")
+    assert math.isclose(width, 35 * units.mm)
+    assert math.isclose(height, 45 * units.mm)
+
+
+def test_parse_dimensions_inherits_units_from_left():
+    width, height = parse_dimensions("35mmx45")
+    assert math.isclose(width, 35 * units.mm)
+    assert math.isclose(height, 45 * units.mm)
+
+
+def test_parse_dimensions_accepts_pagesize_alias():
+    width, height = parse_dimensions("A4")
+    assert (width, height) == pagesizes.A4
+
+
+def test_parse_length_defaults_to_millimeters():
+    assert math.isclose(parse_length("2"), 2 * units.mm)