Workshop Staging Demo Filemaker

Creates small batches of files for demonstrating the BDR Workshop staging upload flow.

The script supports two batch types:

• simple: two independent image objects. Each object has one TIFF generated from lib/lincoln_1200px_tall_under_25k.tif and one matching .mods metadata file.
• parent-child: one parent book .mods file and two child image objects. Each child has one TIFF generated from lib/lincoln_1200px_tall_under_25k.tif and one matching .mods metadata file.

The source TIFF is 1200 pixels tall and under 25 KB. The height matters for parent-child demo uploads because the Studio parent page uses a portfolio default display. If child images are too small, that display can try to upsize them in a way that causes a display error.

Generated files include a shared timestamp in the filenames, MODS titles, and image annotations so repeated demos do not reuse the same filenames. Simple-object filenames use dashes and no underscores. Parent-child child filenames use the Workshop convention of exactly one underscore plus a numeric child order.

The generated MODS files include the title, resource type, and a title-based abstract. Image-level MODS also includes an image_accessibility_alt_text note required for staged image metadata. Parent book MODS does not include that note. Image notes include the timestamp and page/image context while staying under 250 characters.

Usage

uv run ./main.py --output-dir /path/to/demo_batch --type simple
uv run ./main.py --output-dir /path/to/demo_batch --type parent-child

Upload all generated .tif and .mods files together through the Workshop staging URL endpoint.

Tests

uv run ./run_tests.py