# Deprecated

Historical artifacts kept for reference. Nothing in this directory is
imported by the live framework or test suite.

## Contents

| Path | Was | Why retired |
|---|---|---|
| `gen_lin_api.py` | `scripts/gen_lin_api.py` — LDF → Python generator | Replaced by hand-maintained `AlmTester` in `tests/hardware/alm_helpers.py`. The generated layer had one consumer (`AlmTester`) and adding signals to the generator was less ergonomic than adding methods to the facade. |
| `_generated/lin_api.py` | `tests/hardware/_generated/lin_api.py` — auto-emitted typed frame classes + enum classes | Same — its enum classes were inlined into `alm_helpers.py` so test bodies need only one import. |

## If you want to bring this back

The design is documented in
[`../docs/22_generated_lin_api.md`](../docs/22_generated_lin_api.md).
Reasons it might be worth reviving:

- A second ECU joins the framework and adding `<ecu>_helpers.py`
  facades by hand becomes painful.
- The LDF starts churning fast enough that hand-syncing
  `alm_helpers.py` enums against it is missing changes.
- The team grows to where mypy-in-CI becomes worth it and the
  generated dataclass shape (with typed signal attributes) starts
  paying for itself.

The generator is self-contained and parses a single LDF — re-runnable
in place from this directory:

```
python deprecated/gen_lin_api.py vendor/4SEVEN_color_lib_test.ldf \
    --out tests/hardware/_generated/lin_api.py
```

(Restoring also requires adding `tests/hardware/_generated/__init__.py`
back, which is currently inside this folder.)