scan-pdf

simple script to create pdf files from a scanner with document feeder

Examples

scan double sided pages to pdf

Example:

scan-pdf --resolution 100 --duplex test.pdf

supported options

> scan-pdf -h
usage: scan-pdf [-h] [--resolution RESOLUTION] [--flatbed] [-d] [--duplex] [--color-mode {bw,gray,color}] [--threshold THRESHOLD] [--color-depth COLOR_DEPTH] [--paper-format {A4,A5}] [--paper-left PAPER_LEFT] [--paper-top PAPER_TOP]
                [--paper-height PAPER_HEIGHT] [--paper-width PAPER_WIDTH]
                output_file_name

Produce PDF from Scanner with document-feeder

positional arguments:
  output_file_name      name of the produced output file

optional arguments:
  -h, --help            show this help message and exit
  --resolution RESOLUTION
                        scan resolution DPI (default: 300)
  --flatbed             scan only one page from flatbed glass
  -d                    enable debug output
  --duplex              scan both sides of document
  --color-mode {bw,gray,color}
                        default: gray
  --threshold THRESHOLD
                        disabled by default
  --color-depth COLOR_DEPTH
  --paper-format {A3,A4,A5,A6,A7}
                        default: A4
  --paper-left PAPER_LEFT
                        override left offset
  --paper-top PAPER_TOP
                        override top offset
  --paper-height PAPER_HEIGHT
                        override paper height
  --paper-width PAPER_WIDTH
                        override paper width

Mutation testing

The project uses pytest-gremlins for mutation testing. Run it locally with:

uv run pytest --gremlins

This executes the test suite against injected mutants and prints a console report of zapped and surviving gremlins. A JSON report is written to coverage/gremlins/gremlins.json and uploaded as a CI artifact on every pull request. Surviving gremlins do not fail the build.