imposer 0.3.0

A Rust library and CLI for imposing single-sheet PDFs into booklet layouts with configurable n-up binding.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

from typing import Optional


class PageSize:
    """Page size factory helpers (A4, A3, A5, Letter, Legal, Tabloid)."""

    @staticmethod
    def a4() -> "PageSize": ...

    @staticmethod
    def a3() -> "PageSize": ...

    @staticmethod
    def a5() -> "PageSize": ...

    @staticmethod
    def letter() -> "PageSize": ...

    @staticmethod
    def legal() -> "PageSize": ...

    @staticmethod
    def tabloid() -> "PageSize": ...


class BindingType:
    """Binding type factories."""

    @staticmethod
    def saddle_stitch() -> "BindingType": ...

    @staticmethod
    def perfect_bound(sheets_per_signature: Optional[int] = None, num_signatures: Optional[int] = None) -> "BindingType": ...


class BookletConfig:
    """Builder-style configuration object for booklet generation.

    The class is constructed with no arguments and exposes chainable
    `with_*` methods that return the same object for chaining.
    """

    def __init__(self) -> None: ...

    def with_page_size(self, page_size: PageSize) -> "BookletConfig": ...

    def with_pages_per_sheet(self, pages: int) -> "BookletConfig": ...

    def with_scale_to_fit(self, scale: bool) -> "BookletConfig": ...

    def with_preserve_aspect_ratio(self, preserve: bool) -> "BookletConfig": ...

    def with_draw_guides(self, draw: bool) -> "BookletConfig": ...

    def with_number_pages(self, number: bool) -> "BookletConfig": ...

    def with_binding_type(self, binding_type: BindingType) -> "BookletConfig": ...

    def with_sheets_per_signature(self, sheets: int) -> "BookletConfig": ...

    def with_num_signatures(self, num: Optional[int] = None) -> "BookletConfig": ...


def generate_booklet(pdf_bytes: bytes, config: BookletConfig) -> bytes: ...


def generate_booklet_from_file(input_path: str, output_path: str, config: BookletConfig) -> None: ...