Skip to main content

Breaking Changes

Terminology Restructure: Gateway/DUT to Box

This release standardizes terminology across the entire codebase, replacing “gateway” and “DUT” (Device Under Test) with the unified term “box”. CLI Changes:
  • The --dut option is now --box (hidden alias kept for backward compatibility)
  • The --gateway option is now --box where applicable
  • All help text and error messages now use “box” terminology
Configuration Changes:
  • The DUTS key in .lager configuration files is now BOXES (backward compatible - old format is still read)
  • Box storage functions renamed (e.g., load_duts()load_boxes())
Directory Structure:
  • gateway/ directory renamed to box/
  • gateway/lager/lager/ flattened to box/lager/
  • gateway_http_server.py renamed to box_http_server.py
  • start_lager.sh renamed to start_box.sh
  • Deployment scripts renamed:
    • setup_and_deploy_gateway.shsetup_and_deploy_box.sh
    • secure_gateway_firewall.shsecure_box_firewall.sh
    • verify_gateway_security.shverify_box_security.sh
Migration:
  • Existing .lager configuration files will continue to work
  • The --dut CLI option works as a hidden alias for --box
  • Update any scripts or automation to use the new --box option

Features

Unified Box Terminology

  • Consistent “box” terminology throughout CLI, Python API, and documentation
  • Simplified mental model for users - one term for all hardware targets
  • Cleaner codebase with consistent naming conventions

Flattened Directory Structure

  • Removed redundant gateway/lager/lager/ nesting
  • More intuitive project navigation
  • Cleaner import paths

Improvements

Documentation

  • All documentation updated with “box” terminology
  • Unified help text and error messages
  • Updated training data for AI assistants

Code Quality

  • Removed deprecated modules and unused code
  • Standardized naming conventions throughout codebase
  • Improved code organization and readability

Installation

To install this version:
pip install lager-cli==0.2.36
To upgrade from a previous version:
pip install --upgrade lager-cli

Migration Guide

For CLI Users

Replace --dut with --box in your commands:
# Before
lager hello --dut my-device
lager supply voltage --dut my-device 3.3

# After
lager hello --box my-device
lager supply voltage --box my-device 3.3

For Script Authors

Update any automation scripts to use the new flag names:
# Before
BOX_NAME="my-device"
lager hello --dut $BOX_NAME

# After
BOX_NAME="my-device"
lager hello --box $BOX_NAME

For Box Administrators

Update deployment commands:
# Before
cd deployment
./setup_and_deploy_gateway.sh <BOX_IP>

# After
cd deployment
./setup_and_deploy_box.sh <BOX_IP>

Resources

View Release on PyPI