Add --print-path option + README enhance

Dieser Commit ist enthalten in:
Bruno Duyé 2024-03-21 18:50:01 +01:00
Ursprung f7c4c7da37
Commit 6a358c38c1
2 geänderte Dateien mit 24 neuen und 6 gelöschten Zeilen

Datei anzeigen

@ -27,16 +27,27 @@ Run `pdf-sign -h` or `pdf-create-empty -h` for details.
* Install dependencies: `python3.7` or later with module `tkinter`, `gs` (Ghostscript), `pdftk` and `pdfinfo`. * Install dependencies: `python3.7` or later with module `tkinter`, `gs` (Ghostscript), `pdftk` and `pdfinfo`.
* Copy one or both tools to a directory in your `$PATH`. * Copy one or both tools to a directory in your `$PATH`.
**Installation on Debian** **Installation and usage on Debian**
```sh ```sh
apt-get update apt-get update
apt-get install -y coreutils git python3 python3-tk ghostscript pdftk poppler-utils apt-get install -y coreutils git python3 python3-tk ghostscript pdftk poppler-utils
git clone https://github.com/svenssonaxel/pdf-sign.git git clone https://github.com/svenssonaxel/pdf-sign.git
cd pdf-sign cd pdf-sign
./pdf-create-empty /usr/local/bin/ # Get signatures folder
./pdf-sign "" --print-path
# Create this folder
mkdir $(./pdf-sign "" --print-path)
``` ```
Now you'll have to put your signature in a PDF file in this folder, you can use `empty-3inx2in.pdf` empty PDF template for example.
```
./pdf-sign my_document.pdf
```
This will generate a second file with `my_document.signed.pdf` in the same directory.
## Why ## Why
There appears to be a lack of applications that run on Linux and allow for attaching free-hand signatures to PDF files in a good way. There appears to be a lack of applications that run on Linux and allow for attaching free-hand signatures to PDF files in a good way.

Datei anzeigen

@ -6,6 +6,9 @@ import argparse, os, queue, re, subprocess, sys, tempfile, time
# Inspired by https://unix.stackexchange.com/a/141496 # Inspired by https://unix.stackexchange.com/a/141496
def main(args): def main(args):
if args.print_path:
print(getSignatureDir())
sys.exit()
filePath=args.input filePath=args.input
if not m("^.*\.(pdf|PDF)$", filePath): if not m("^.*\.(pdf|PDF)$", filePath):
die("Input file must end with .pdf or .PDF") die("Input file must end with .pdf or .PDF")
@ -34,6 +37,7 @@ def main(args):
if not args.signature and args.batch: if not args.signature and args.batch:
die('In batch mode, signature must be specified.') die('In batch mode, signature must be specified.')
signatureDir=getSignatureDir() signatureDir=getSignatureDir()
checkSignatureDir(signatureDir)
signatures=[*filter(lambda x: m("^.*\.pdf$", x), os.listdir(signatureDir))] if not args.signature else [None] signatures=[*filter(lambda x: m("^.*\.pdf$", x), os.listdir(signatureDir))] if not args.signature else [None]
if not signatures: if not signatures:
die(f'No .pdf files found in {signatureDir}') die(f'No .pdf files found in {signatureDir}')
@ -292,12 +296,14 @@ def getSignatureDir():
else: else:
sd="~/.pdf_signatures" sd="~/.pdf_signatures"
sd=os.path.expanduser(sd) sd=os.path.expanduser(sd)
if not os.path.exists(sd):
raise Exception(f'Signature directory {sd} does not exist')
if not os.path.isdir(sd):
raise Exception(f'Signature directory {sd} is not a directory')
return sd return sd
def checkSignatureDir(signatureDir):
if not os.path.exists(signatureDir):
raise Exception(f'Signature directory {signatureDir} does not exist')
if not os.path.isdir(signatureDir):
raise Exception(f'Signature directory {signatureDir} is not a directory')
# Simple dependency tracking. # Simple dependency tracking.
# Init with a value or function to calculate the value. # Init with a value or function to calculate the value.
# Update by calling with one argument (as in init). # Update by calling with one argument (as in init).
@ -402,6 +408,7 @@ parser = argparse.ArgumentParser(description='Sign a PDF file.')
parser.add_argument('input', metavar='input.pdf', type=str, help='Input PDF file.') parser.add_argument('input', metavar='input.pdf', type=str, help='Input PDF file.')
parser.add_argument('-p', '--page', type=int, default=-1, help='The page to sign, negative for counting from the end. (default: -1)') parser.add_argument('-p', '--page', type=int, default=-1, help='The page to sign, negative for counting from the end. (default: -1)')
parser.add_argument('-s', '--signature', type=str, help='Path to file used as signature. Required in batch mode. In GUI mode, the user can choose among files in $PDF_SIGNATURE_DIR, $XDG_CONFIG_HOME/pdf_signatures (defaulting to ~/.config/pdf_signatures), or ~/.pdf_signatures.') parser.add_argument('-s', '--signature', type=str, help='Path to file used as signature. Required in batch mode. In GUI mode, the user can choose among files in $PDF_SIGNATURE_DIR, $XDG_CONFIG_HOME/pdf_signatures (defaulting to ~/.config/pdf_signatures), or ~/.pdf_signatures.')
parser.add_argument('-S', '--print-path', help='Print signatures path.', action='store_true')
parser.add_argument('-x', '--x-coordinate', type=float, default=0.5, help='Horizontal coordinate of signature center, in page width units. (default: 0.5)') parser.add_argument('-x', '--x-coordinate', type=float, default=0.5, help='Horizontal coordinate of signature center, in page width units. (default: 0.5)')
parser.add_argument('-y', '--y-coordinate', type=float, default=0.75, help='Vertical coordinate of signature center, in page height units. (default: 0.75)') parser.add_argument('-y', '--y-coordinate', type=float, default=0.75, help='Vertical coordinate of signature center, in page height units. (default: 0.75)')
parser.add_argument('-W', '--width', type=float, default=0.28, help='Width of box to fit signature to, in page width units. (default: 0.28)') parser.add_argument('-W', '--width', type=float, default=0.28, help='Width of box to fit signature to, in page width units. (default: 0.28)')