Metadata-Version: 2.1
Name: laylight-cli
Version: 0.2.2
Summary: The Laylight command line: check, format and compile Laylight layout files to GDSII
Keywords: layout,gds,gdsii,photonics,eda
Project-URL: Documentation, https://laylight.photonstack.io/
Project-URL: Installation, https://laylight.photonstack.io/installation/
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: Electronic Design Automation (EDA)
Description-Content-Type: text/markdown

# laylight-cli

The `laylight` command line for [Laylight](https://laylight.photonstack.io/), a language for photonic and integrated-circuit layouts. It checks, formats and compiles Laylight files to GDSII, writes netlists, publishes cells as blackboxes and turns GDSII back into Laylight source.

```bash
pip install laylight-cli        # or: uv tool install laylight-cli, pipx install laylight-cli
```

The [Laylight Python library](https://pypi.org/project/laylight/) depends on this package, so `pip install laylight` installs the command too.

```bash
laylight check  ring.lyl              # syntax, types, units and evaluation
laylight build  ring.lyl -o ring.gds  # compile to GDSII
laylight ir     ring.lyl              # print the Laylight IR
laylight netlist ring.lyl             # connectivity as JSON; `lvs` compares it
laylight fmt    ring.lyl              # format in place
laylight decompile chip.gds -o chip.lyl
laylight blackbox ring.lyl -o ring.lyir  # publish outline and ports; `unbox` restores the cell
laylight build chip.gds -o filled.gds --dummy si   # add dummy fill to a layer
```

The wheels hold a native executable for Linux x86-64 and ARM64 (glibc 2.17 or later), macOS on Apple silicon and Windows x86-64; it does not depend on the Python version. On other systems the package installs a `laylight` command that only reports the missing build. See the [Installation Guide](https://laylight.photonstack.io/installation/) for other ways to install, and the [Changelog](https://laylight.photonstack.io/changelog/) for what each release changed.
