zebra_day

zebra_day is a Python library, CLI, simulator, and FastAPI web service for managing Zebra printer fleets and serving ZPL print workflows. Shared fleet state, templates, label profiles, observations, and print jobs now live in daylily-tapdb only.

What Changed

• TapDB is the only supported shared datastore.
• source ./activate <deploy-name> is the only supported repo activation path.
• The service/admin runtime uses direct TapDB access through ZebraDayClient.
• Downstream Python applications should use ZebraDayApiClient against a running zebra_day API.
• Cognito is the default auth mode. --no-auth remains the explicit runtime override.

Removed in this major cut:

• local fleet/config files as runtime state
• DynamoDB and S3 runtime support
• print_mgr.zpl() and package-root helper shims
• zday_start, zday_quickstart, and zday dynamo

Quickstart

source ./activate local
zday config init
zday config status
zday gui start

The default GUI port is 8118. HTTPS is enabled automatically when local certs are available.

Runtime Model

flowchart LR
    CLI["zday CLI"] --> Service["zebra_day service/runtime"]
    GUI["FastAPI + Jinja UI"] --> Service
    APIClient["ZebraDayApiClient"] --> API["zebra_day HTTP API"]
    API --> Service
    Service --> TapDB["daylily-tapdb namespace"]
    Service --> Printers["Zebra printers over TCP 9100"]
    Simulator["simulator"] --> Printers

Python Usage

Direct service/admin usage:

from zebra_day import ZebraDayClient, ZebraDaySettings

settings = ZebraDaySettings.from_context("local")
client = ZebraDayClient(settings)
printers = client.list_printers("default")

Downstream app usage:

from zebra_day import ZebraDayApiClient

with ZebraDayApiClient("https://localhost:8118", api_key="internal-token") as client:
    printers = client.list_printers("default")
    client.submit_print_job(
        lab="default",
        printer="printer-1",
        label_zpl_style="tube_2inX1in",
        uid_barcode="SAMPLE-001",
    )

CLI Surface

• zday gui ...: start, stop, restart, and inspect the GUI server
• zday printer ...: list, scan, and sync printers
• zday template ...: list, show, save, preview, and delete templates
• zday tapdb ...: pass through to TapDB lifecycle commands
• zday cognito ...: inspect or validate the daycog-backed auth contract
• zday users ...: manage Cognito group membership for operator/admin roles
• zday logs ...: inspect zebra_day GUI logs

Docs

• docs/README.md
• zebra_day/docs/programatic_guide.md
• zebra_day/docs/zebra_day_ui_guide.md
• docs/tapdb_hard_migration_plan.md

Development Checks

ruff check zebra_day tests
ruff format --check zebra_day tests
mypy zebra_day --ignore-missing-imports
pytest tests/ -v --tb=short