code: def get_parser():
      """Get the main CLI parser."""
      parser = ArgumentParser(
          prog=_PROGRAM_NAME,
          allow_abbrev=True,
          fromfile_prefix_chars="@",
          formatter_class=argparse.RawDescriptionHelpFormatter,
          description="""\
  Generates a searchable PDF or PDF/A from a regular PDF.
  
  OCRmyPDF rasterizes each page of the input PDF, optionally corrects page
  rotation and performs image processing, runs the Tesseract OCR engine on the
  image, and then creates a PDF from the OCR information.
  """,
          epilog="""\
  OCRmyPDF attempts to keep the output file at about the same size.  If a file
  contains losslessly compressed images, and images in the output file will be
  losslessly compressed as well.
  
  PDF is a page description file that attempts to preserve a layout exactly.
  A PDF can contain vector objects (such as text or lines) and raster objects
  (images).  A page might have multiple images.  OCRmyPDF is prepared to deal
  with the wide variety of PDFs that exist in the wild.
  
  When a PDF page contains text, OCRmyPDF assumes that the page has already
  been OCRed or is a "born digital" page that should not be OCRed.  The default
  behavior is to exit in this case without producing a file.  You can use the
  option --skip-text to ignore pages with text, or --force-ocr to rasterize
  all objects on the page and produce an image-only PDF as output.
  
      ocrmypdf --skip-text file_with_some_text_pages.pdf output.pdf
  
      ocrmypdf --force-ocr word_document.pdf output.pdf
  
  If you are concerned about long-term archiving of PDFs, use the default option
  --output-type pdfa which converts the PDF to a standardized PDF/A-2b.  This
  removes some features from the PDF such as Javascript or forms. If you want to
  minimize the number of changes made to your PDF, use --output-type pdf.
  
  If OCRmyPDF is given an image file as input, it will attempt to convert the
  image to a PDF before processing.  For more control over the conversion of
  images to PDF, use the Python package img2pdf or other image to PDF software.
  
  For example, this command uses img2pdf to convert all .png files beginning
  with the 'page' prefix to a PDF, fitting each image on A4-sized paper, and
  sending the result to OCRmyPDF through a pipe.
  
      img2pdf --pagesize A4 page*.png | ocrmypdf - myfile.pdf
  
  Online documentation is located at:
      https://ocrmypdf.readthedocs.io/en/latest/introduction.html
  
  """,
      )
  
      parser.add_argument(
          "input_file",
          metavar="input_pdf_or_image",
          help="PDF file containing the images to be OCRed (or '-' to read from "
          "standard input)",
      )
      parser.add_argument(
          "output_file",
          metavar="output_pdf",
          help="Output searchable PDF file (or '-' to write to standard output). "
          "Existing files will be overwritten. If same as input file, the "
          "input file will be updated only if processing is successful.",
      )
      parser.add_argument(
          "-l",
          "--language",
          dest="languages",
          action=LanguageSetAction,
          help="Language(s) of the file to be OCRed (see tesseract --list-langs for "
          "all language packs installed in your system). Use -l eng+deu for "
          "multiple languages.",
      )
      parser.add_argument(
          "--image-dpi",
          metavar="DPI",
          type=int,
          help="When the input file is an image, not a PDF, use this DPI instead "
          "of the DPI claimed by the input file. If the input does not claim a "
          "sensible DPI, this option will be required.",
      )
      parser.add_argument(
          "--output-type",
          choices=["pdfa", "pdf", "pdfa-1", "pdfa-2", "pdfa-3", "none"],
          default="pdfa",
          help="Choose output type. 'pdfa' creates a PDF/A-2b compliant file for "
          "long term archiving (default, recommended) but may not suitable "
          "for users who want their file altered as little as possible. 'pdfa' "
          "also has problems with full Unicode text. 'pdf' minimizes changes "
          "to the input file. 'pdf-a1' creates a "
          "PDF/A1-b file. 'pdf-a2' is equivalent to 'pdfa'. 'pdf-a3' creates a "
          "PDF/A3-b file. 'none' will produce no output, which may be helpful if "
          "only the --sidecar is desired.",
      )
  
      # Use null string '\0' as sentinel to indicate the user supplied no argument,
      # since that is the only invalid character for filepaths on all platforms
      # bool('\0') is True in Python
      parser.add_argument(
          "--sidecar",
          nargs="?",
          const="\0",
          default=None,
          metavar="FILE",
          help="Generate sidecar text files that contain the same text recognized "
          "by Tesseract. This may be useful for building a OCR text database. "
          "If FILE is omitted, the sidecar file be named {output_file}.txt; the next "
          "argument must NOT be the name of the input PDF. "
          "If FILE is set to '-', the sidecar is written to stdout (a "
          "convenient way to preview OCR quality). The output file and sidecar "
          "may not both use stdout at the same time.",
      )
  
      parser.add_argument(
          "--version",
          action="version",
          version=_VERSION,
          help="Print program version and exit",
      )
  
      jobcontrol = parser.add_argument_group("Job control options")
      jobcontrol.add_argument(
          "-j",
          "--jobs",
          metavar="N",
          type=numeric(int, 0, 256),
          help="Use up to N CPU cores simultaneously (default: use all).",
      )
      jobcontrol.add_argument(
          "-q",
          "--quiet",
          action="store_true",
          help="Suppress INFO messages",
      )
      jobcontrol.add_argument(
          "-v",
          "--verbose",
          type=numeric(int, 0, 2),
          default=0,
          const=1,
          nargs="?",
          help="Print more verbose messages for each additional verbose level. Use "
          "`-v 1` typically for much more detailed logging. Higher numbers "
          "are probably only useful in debugging.",
      )
      jobcontrol.add_argument(
          "--no-progress-bar",
          action="store_false",
          dest="progress_bar",
          help=argparse.SUPPRESS,
      )
      jobcontrol.add_argument(
          "--use-threads",
          action="store_true",
          default=True,
          help=argparse.SUPPRESS,
      )
      jobcontrol.add_argument(
          "--no-use-threads",
          action="store_false",
          dest="use_threads",
          help=argparse.SUPPRESS,
      )
  
      metadata = parser.add_argument_group(
          "Metadata options",
          "Set output PDF/A metadata (default: copy input document's metadata)",
      )
      metadata.add_argument(
          "--title",
          type=str,
          help="Set document title (place multiple words in quotes)",
      )
      metadata.add_argument(
          "--author", type=str, help="Set document author"
      )
      metadata.add_argument(
          "--subject", type=str, help="Set document subject description"
      )
      metadata.add_argument(
          "--keywords", type=str, help="Set document keywords"
      )
  
      preprocessing = parser.add_argument_group(
          "Image preprocessing options",
          "Options to improve the quality of the final PDF and OCR",
      )
      preprocessing.add_argument(
          "-r",
          "--rotate-pages",
          action="store_true",
          help="Automatically rotate pages based on detected text orientation",
      )
      preprocessing.add_argument(
          "--remove-background",
          action="store_true",
          help="Attempt to remove background from gray or color pages, setting it "
          "to white ",
      )
      preprocessing.add_argument(
          "-d",
          "--deskew",
          action="store_true",
          help="Deskew each page before performing OCR",
      )
      preprocessing.add_argument(
          "-c",
          "--clean",
          action="store_true",
          help="Clean pages from scanning artifacts before performing OCR, and send "
          "the cleaned page to OCR, but do not include the cleaned page in "
          "the output",
      )
      preprocessing.add_argument(
          "-i",
          "--clean-final",
          action="store_true",
          help="Clean page as above, and incorporate the cleaned image in the final "
          "PDF.  Might remove desired content.",
      )
      preprocessing.add_argument(
          "--unpaper-args",
          type=str,
          default=None,
          help="A quoted string of arguments to pass to unpaper. Requires --clean. "
          "Example: --unpaper-args '--layout double'.",
      )
      preprocessing.add_argument(
          "--oversample",
          metavar="DPI",
          type=numeric(int, 0, 5000),
          default=0,
          help="Oversample images to at least the specified DPI, to improve OCR "
          "results slightly",
      )
      preprocessing.add_argument(
          "--remove-vectors",
          action="store_true",
          help="EXPERIMENTAL. Mask out any vector objects in the PDF so that they "
          "will not be included in OCR. This can eliminate false characters.",
      )
  
      ocrsettings = parser.add_argument_group(
          "OCR options", "Control how OCR is applied"
      )
      ocrsettings.add_argument(
          "-f",
          "--force-ocr",
          action="store_true",
          help="Rasterize any text or vector objects on each page, apply OCR, and "
          "save the rastered output (this rewrites the PDF)",
      )
      ocrsettings.add_argument(
          "-s",
          "--skip-text",
          action="store_true",
          help="Skip OCR on any pages that already contain text, but include the "
          "page in final output; useful for PDFs that contain a mix of "
          "images, text pages, and/or previously OCRed pages",
      )
      ocrsettings.add_argument(
          "--redo-ocr",
          action="store_true",
          help="Attempt to detect and remove the hidden OCR layer from files that "
          "were previously OCRed with OCRmyPDF or another program. Apply OCR "
          "to text found in raster images. Existing visible text objects will "
          "not be changed. If there is no existing OCR, OCR will be added.",
      )
      ocrsettings.add_argument(
          "--skip-big",
          type=numeric(float, 0, 5000),
          metavar="MPixels",
          help="Skip OCR on pages larger than the specified amount of megapixels, "
          "but include skipped pages in final output",
      )
      ocrsettings.add_argument(
          "--invalidate-digital-signatures",
          action="store_true",
          help="Normally, OCRmyPDF will refuse to OCR a PDF that has a digital "
          "signature. This option allows OCR to proceed, but the digital signature "
          "will be invalidated.",
      )
  
      advanced = parser.add_argument_group(
          "Advanced", "Advanced options to control OCRmyPDF"
      )
      advanced.add_argument(
          "--pages",
          type=str,
          help=(
              "Limit OCR to the specified pages (ranges or comma separated), "
              "skipping others"
          ),
      )
      advanced.add_argument(
          "--max-image-mpixels",
          action="store",
          type=numeric(float, 0),
          metavar="MPixels",
          help="Set maximum number of pixels to unpack before treating an image as a "
          "decompression bomb",
          default=250.0,
      )
      advanced.add_argument(
          "--pdf-renderer",
          choices=["auto", "hocr", "sandwich", "hocrdebug"],
          default="auto",
          help="Choose OCR PDF renderer - the default option is to let OCRmyPDF "
          "choose.  See documentation for discussion.",
      )
      advanced.add_argument(
          "--rotate-pages-threshold",
          default=14.0,
          type=numeric(float, 0, 1000),
          metavar="CONFIDENCE",
          help="Only rotate pages when confidence is above this value (arbitrary "
          "units reported by tesseract)",
      )
      advanced.add_argument(
          "--fast-web-view",
          type=numeric(float, 0),
          default=1.0,
          metavar="MEGABYTES",
          help="If the size of file is more than this threshold (in MB), then "
          "linearize the PDF for fast web viewing. This allows the PDF to be "
          "displayed before it is fully downloaded in web browsers, but increases "
          "the space required slightly. By default we skip this for small files "
          "which do not benefit. If the threshold is 0 it will be apply to all files. "
          "Set the threshold very high to disable.",
      )
      advanced.add_argument(
          "--continue-on-soft-render-error",
          action="store_true",
          help="Continue processing pages after a recoverable PDF rendering error. "
          "A recoverable error is one that does not prevent the page from being "
          "rendered, but may result in visual differences compared to the input "
          "file. Missing fonts are a typical source of these errors.",
      )
      advanced.add_argument(
          "--plugin",
          dest="plugins",
          action="append",
          default=[],
          help="Name of plugin to import. Argument may be issued multiple times to "
          "import multiple plugins. Plugins may be specified as module names in "
          "Python syntax, provided they are installed in the same Python (virtual) "
          "environment as ocrmypdf; or you may give the path to the Python file that "
          "contains the plugin. Plugins must conform to the specification in the "
          "OCRmyPDF documentation.",
      )
  
      debugging = parser.add_argument_group(
          "Debugging",
          "Arguments to help with troubleshooting and debugging",
      )
      debugging.add_argument(
          "-k",
          "--keep-temporary-files",
          action="store_true",
          help="Keep temporary files (helpful for debugging)",
      )
      return parser
  
file_path: OCRmyPDF/src/ocrmypdf/cli.py
imports: from __future__ import annotations
  import argparse
  from collections.abc import Mapping
  from typing import Any, Callable, TypeVar
  from ocrmypdf._version import PROGRAM_NAME
  from ocrmypdf._version import __version__
label_desc: Use image node_id 3 for calling a global function with example usage: get_parser() and returns: parser