fix: make script help paths lightweight (#1937)

## Summary

Consolidate the script help/startup fixes so standalone helper commands
can show usage without requiring runtime-only dependencies or generating
files.

## Details

Several helper scripts imported optional packages, evaluated newer
annotations, or started generation before users could inspect CLI usage.
On a fresh checkout, this made common help paths fail on missing
packages such as `cairosvg`, `Pillow`, `freetype-py`, `fontTools`,
`pyphen`, `pyserial`, or on Python 3.9 annotation evaluation. A few
generators also treated `--help` as a normal output argument and wrote
files instead of printing usage.

This change keeps runtime dependencies on the code paths that need them,
handles lightweight help/list commands first, and adds explicit `--help`
handling for generator scripts that previously started work.

## Validation

- `python3 <script> --help` across tracked Python scripts, excluding
`scripts/patch_jpegdec.py` because it is a PlatformIO pre-build hook
rather than a standalone CLI
- `python3 scripts/convert_icon.py` still exits with usage for missing
required arguments
- `python3 lib/EpdFont/scripts/fontconvert_sdcard.py --list-presets`
- `python3 -m py_compile` for the changed scripts

This commit is contained in:

Danila Yudin

2026-05-11 11:21:13 -05:00

committed by

GitHub

parent accd50b593

commit 63e92ec74e

10 changed files with 81 additions and 40 deletions

									
										scripts/generate_test_epub.py
									
		+5
		
												View File
												
				@@ -11,9 +11,14 @@ Creates EPUBs with annotated JPEG and PNG images to verify:

				"""

				import os

				import sys

				import zipfile

				from pathlib import Path

				if any(arg in ("-h", "--help") for arg in sys.argv[1:]):

				    print(__doc__.strip())

				    sys.exit(0)

				try:

				    from PIL import Image, ImageDraw, ImageFont

				except ImportError: