consolens

Discover and report on devices attached to terminal/console server ports via Netmiko.

consolens keeps two concerns separate:

1. Phase 1 — ask the terminal server. Vendor-specific drivers parse the server's port inventory (e.g. Opengear pmshell) to learn which ports exist and what label was configured for each.
2. Phase 2 — ask the attached device. A live console session is opened through the server to each occupied port, and consolens uses Netmiko to identify what is actually on the other end. Labels are often stale, so the report shows both the configured label and the discovered identity.

Quick start

poetry install
poetry run consolens report \
    --vendor opengear \
    --host console01.example.com \
    --username admin

By default, discovery is read-only: it wakes the line with a newline, captures the prompt, and attempts Netmiko SSHDetect autodetection followed by regex heuristics. Pass --probe-show-commands to allow hostname-discovery show commands to be sent to attached devices.

Driver support

Vendor	Status
Opengear	Implemented
Perle	Stub (raises)
Lantronix	Stub (raises)

Drivers self-register through consolens.registry.register_driver, so adding a new vendor only requires dropping a module into consolens.drivers and decorating the class.