Zener Language

Zener is Starlark plus PCB-specific modules, typed electrical connections, physical parts, sourcing, layout, and diagnostics.

Discover Before Authoring

Use pcb list -m -json @stdlib or pcb list -m -json <package>[@<version>] to find a package's local source directory, then read its .zen files for the public API and exact behavior.

For CLI behavior, use the installed command's --help; do not invent or infer subcommands or flags. When version history matters, inspect the installed version and nearby entries in the pcb changelog instead of relying on old examples.

Modules and Components

A .zen file can be:

• a normal Starlark module imported with load(); or
• an instantiable schematic module imported with Module().

Relative paths stay within the current package. Cross-package imports use full package URLs: