perfect-binding-converter 0.1.0__tar.gz

perfect_binding_converter-0.1.0/LICENSE

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

perfect_binding_converter-0.1.0/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: perfect-binding-converter
+Version: 0.1.0
+Summary: Perfect binding converter: imposes PDF pages into A4 cut-stack layout with a center fold line
+License: MIT License
+        
+        Copyright (c) 2026 Amr Bassem
+        
+        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.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Printing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pypdf>=3.0
+Dynamic: license-file
+
+# perfect-binding-converter
+
+Imposes a PDF into a **perfect-binding** cut-stack layout for A4 booklet
+printing. Pairs pages in opposite halves of the document onto landscape A4
+sheets with a spine gutter, and draws a dashed center cut/fold line on each
+sheet.
+
+The CLI command is **`pbc`** (the bare `pbc` name is taken on PyPI by an
+unrelated project, so the package is published under this longer name).
+
+## Install
+
+Requires Python 3.9+.
+
+### PyPI (pip / pipx)
+
+```sh
+pip install perfect-binding-converter
+# or, isolated:
+pipx install perfect-binding-converter
+```
+
+The `pbc` command will then be on your PATH.
+
+### Arch Linux (AUR, system-wide)
+
+A PKGBUILD is provided in `packaging/aur/PKGBUILD`. It builds the PyPI
+package and installs the `pbc` binary into `/usr/bin`:
+
+```sh
+cd packaging/aur
+makepkg -si          # build + install with pacman
+# or, once published to the AUR:
+# yay -S python-perfect-binding-converter
+```
+
+Installing this way puts `pbc` on your system PATH for all users, with no venv.
+
+## Usage
+
+```sh
+pbc input.pdf [-o output.pdf] [-g gutter_mm]
+```
+
+- `input` (required): PDF to impose.
+- `-o, --output`: output path (default `cut_stack_output.pdf`).
+- `-g, --gutter`: spine gutter in millimeters (default `12`).
+
+### Example
+
+```sh
+pbc my_book.pdf -o print_ready.pdf
+```
+
+Each output sheet holds two source pages side by side on a landscape A4 page,
+with the second half of the book mapped behind the first for cut-and-stack
+collation. The dashed vertical line marks the fold/cut position.
+# perfect-binding-converter

perfect_binding_converter-0.1.0/README.md

@@ -0,0 +1,58 @@
+# perfect-binding-converter
+
+Imposes a PDF into a **perfect-binding** cut-stack layout for A4 booklet
+printing. Pairs pages in opposite halves of the document onto landscape A4
+sheets with a spine gutter, and draws a dashed center cut/fold line on each
+sheet.
+
+The CLI command is **`pbc`** (the bare `pbc` name is taken on PyPI by an
+unrelated project, so the package is published under this longer name).
+
+## Install
+
+Requires Python 3.9+.
+
+### PyPI (pip / pipx)
+
+```sh
+pip install perfect-binding-converter
+# or, isolated:
+pipx install perfect-binding-converter
+```
+
+The `pbc` command will then be on your PATH.
+
+### Arch Linux (AUR, system-wide)
+
+A PKGBUILD is provided in `packaging/aur/PKGBUILD`. It builds the PyPI
+package and installs the `pbc` binary into `/usr/bin`:
+
+```sh
+cd packaging/aur
+makepkg -si          # build + install with pacman
+# or, once published to the AUR:
+# yay -S python-perfect-binding-converter
+```
+
+Installing this way puts `pbc` on your system PATH for all users, with no venv.
+
+## Usage
+
+```sh
+pbc input.pdf [-o output.pdf] [-g gutter_mm]
+```
+
+- `input` (required): PDF to impose.
+- `-o, --output`: output path (default `cut_stack_output.pdf`).
+- `-g, --gutter`: spine gutter in millimeters (default `12`).
+
+### Example
+
+```sh
+pbc my_book.pdf -o print_ready.pdf
+```
+
+Each output sheet holds two source pages side by side on a landscape A4 page,
+with the second half of the book mapped behind the first for cut-and-stack
+collation. The dashed vertical line marks the fold/cut position.
+# perfect-binding-converter

perfect_binding_converter-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "perfect-binding-converter"
+version = "0.1.0"
+description = "Perfect binding converter: imposes PDF pages into A4 cut-stack layout with a center fold line"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { file = "LICENSE" }
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: POSIX :: Linux",
+    "Operating System :: MacOS",
+    "Topic :: Printing",
+]
+dependencies = ["pypdf>=3.0"]
+
+[project.scripts]
+pbc = "pbc.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

perfect_binding_converter-0.1.0/setup.cfg

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

perfect_binding_converter-0.1.0/src/pbc/cli.py

@@ -0,0 +1,113 @@
+import argparse
+
+from pypdf import PdfReader, PdfWriter, Transformation
+from pypdf import PdfReader, PdfWriter, Transformation
+from pypdf.generic import (
+    ArrayObject,
+    DictionaryObject,
+    NameObject,
+    StreamObject,
+)
+
+SPINE_GUTTER_MM = 12
+A4_W, A4_H = 595.28, 841.89
+
+
+def mm_to_pt(mm):
+    return mm * 2.83465
+
+
+def build_cutline_page(out_w, out_h):
+    # Center spine of the imposed landscape page is the fold/cut location.
+    x = out_w / 2
+    content = (
+        f"{x:.4f} 0 m\n"
+        f"{x:.4f} {out_h:.4f} l\n"
+        "2 w\n"
+        "[4 4] 0 d\n"
+        "0.75 0.75 0.75 RG\n"
+        "S\n"
+    )
+    writer = PdfWriter()
+    page = writer.add_blank_page(out_w, out_h)
+    resources = DictionaryObject(
+        {
+            NameObject("/ProcSet"): ArrayObject([NameObject("/PDF")]),
+        }
+    )
+    page[NameObject("/Resources")] = resources
+    stream = StreamObject()
+    stream.set_data(content.encode("latin-1"))
+    page[NameObject("/Contents")] = stream
+    return page
+
+
+def main(argv=None):
+    parser = argparse.ArgumentParser(
+        prog="pbc",
+        description="Impose a PDF into cut-stack layout for A4 booklet printing.",
+    )
+    parser.add_argument("input", help="Input PDF path")
+    parser.add_argument(
+        "-o", "--output", default="cut_stack_output.pdf", help="Output PDF path"
+    )
+    parser.add_argument(
+        "-g", "--gutter", type=float, default=SPINE_GUTTER_MM,
+        help=("Spine gutter width in millimeters "
+              f"(default {SPINE_GUTTER_MM})"),
+    )
+    args = parser.parse_args(argv)
+
+    reader = PdfReader(args.input)
+    pages = reader.pages
+    n = len(pages)
+    if n < 2:
+        parser.error("input PDF must have at least 2 pages")
+
+    out_w = A4_H
+    out_h = A4_W
+    g = mm_to_pt(args.gutter)
+
+    half = n // 2
+    half_w = (out_w - g) / 2
+
+    writer = PdfWriter()
+
+    for i in range(half):
+        if i % 2 == 0:
+            left_page = pages[i]
+            right_page = pages[i + half]
+        else:
+            left_page = pages[i + half]
+            right_page = pages[i]
+
+        new_page = writer.add_blank_page(out_w, out_h)
+
+        lw = float(left_page.mediabox.width)
+        lh = float(left_page.mediabox.height)
+        lsx = half_w / lw
+        lsy = out_h / lh
+        new_page.merge_transformed_page(
+            left_page, Transformation().scale(lsx, lsy).translate(0, 0), over=True
+        )
+
+        rw = float(right_page.mediabox.width)
+        rh = float(right_page.mediabox.height)
+        rsx = half_w / rw
+        rsy = out_h / rh
+        new_page.merge_transformed_page(
+            right_page,
+            Transformation().scale(rsx, rsy).translate(out_w / 2 + g / 2, 0),
+            over=True,
+        )
+
+        new_page.merge_page(build_cutline_page(out_w, out_h), over=True)
+
+    writer.write(args.output)
+    writer.close()
+
+    print(f"Done: {args.output} ({half} imposed pages)")
+
+
+if __name__ == "__main__":
+    main()

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

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: perfect-binding-converter
+Version: 0.1.0
+Summary: Perfect binding converter: imposes PDF pages into A4 cut-stack layout with a center fold line
+License: MIT License
+        
+        Copyright (c) 2026 Amr Bassem
+        
+        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.
+        
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Operating System :: MacOS
+Classifier: Topic :: Printing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pypdf>=3.0
+Dynamic: license-file
+
+# perfect-binding-converter
+
+Imposes a PDF into a **perfect-binding** cut-stack layout for A4 booklet
+printing. Pairs pages in opposite halves of the document onto landscape A4
+sheets with a spine gutter, and draws a dashed center cut/fold line on each
+sheet.
+
+The CLI command is **`pbc`** (the bare `pbc` name is taken on PyPI by an
+unrelated project, so the package is published under this longer name).
+
+## Install
+
+Requires Python 3.9+.
+
+### PyPI (pip / pipx)
+
+```sh
+pip install perfect-binding-converter
+# or, isolated:
+pipx install perfect-binding-converter
+```
+
+The `pbc` command will then be on your PATH.
+
+### Arch Linux (AUR, system-wide)
+
+A PKGBUILD is provided in `packaging/aur/PKGBUILD`. It builds the PyPI
+package and installs the `pbc` binary into `/usr/bin`:
+
+```sh
+cd packaging/aur
+makepkg -si          # build + install with pacman
+# or, once published to the AUR:
+# yay -S python-perfect-binding-converter
+```
+
+Installing this way puts `pbc` on your system PATH for all users, with no venv.
+
+## Usage
+
+```sh
+pbc input.pdf [-o output.pdf] [-g gutter_mm]
+```
+
+- `input` (required): PDF to impose.
+- `-o, --output`: output path (default `cut_stack_output.pdf`).
+- `-g, --gutter`: spine gutter in millimeters (default `12`).
+
+### Example
+
+```sh
+pbc my_book.pdf -o print_ready.pdf
+```
+
+Each output sheet holds two source pages side by side on a landscape A4 page,
+with the second half of the book mapped behind the first for cut-and-stack
+collation. The dashed vertical line marks the fold/cut position.
+# perfect-binding-converter

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

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+pyproject.toml
+src/pbc/cli.py
+src/perfect_binding_converter.egg-info/PKG-INFO
+src/perfect_binding_converter.egg-info/SOURCES.txt
+src/perfect_binding_converter.egg-info/dependency_links.txt
+src/perfect_binding_converter.egg-info/entry_points.txt
+src/perfect_binding_converter.egg-info/requires.txt
+src/perfect_binding_converter.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,2 @@
+[console_scripts]
+pbc = pbc.cli:main

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

@@ -0,0 +1 @@
+pypdf>=3.0

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

@@ -0,0 +1 @@
+pbc