CLI command design

extract

Extracts symbols, footprints, or project source contents from Altium design documents.

Usage

altium-cruncher extract schematic.SchDoc --combined -o output/extract
altium-cruncher extract board.PcbDoc --split -o output/extract
altium-cruncher extract project.PrjPcb -o output/extract
altium-cruncher extract vendor.IntLib -o output/extract

Arguments

file accepts schematic, PCB, project, and integrated-library inputs. Options select combined or split extraction and the output directory. For .IntLib, --stream-filenames uses IntLib stream basenames, --no-libpkg skips generated LibPkg, and --no-overwrite fails if extracted source files already exist.

Output

The command writes extracted SchLib or PcbLib artifacts, organized by source. Project schematic split output is namespaced under schlib/<SchDocStem>/ so duplicate symbols from different sheets cannot overwrite each other; combined project schematic libraries are written as schlib/<SchDocStem>.SchLib. .IntLib extraction writes source files under kind folders such as SchLib/ and PCBLib/, writes a generated LibPkg by default, and emits *_intlib_extract_manifest.json with stream paths, output paths, source kinds, and parse metadata.

Tests

L3 exercises schematic extraction on Hydroscope and IntLib source extraction on the redistributable RT_SUPER_C1.IntLib fixture. Planned corpus tests should mirror the broader underlying Altium Monkey extraction tests.