yunetas 0.17.0

TUI (Terminal User Interface) of Yunetas

TUI for yunetas

This is the TUI (Terminal User Interface) for Yuneta Simplified

Yuneta Simplified is a development framework about messages and services, based on Event-driven, Automata-based and Object-oriented programming.

Yuneta is based in functions, but it manages a system of virtual classes defined by programmatically and schematically.

All his philosophy is based on that virtual classes (namely GClass or class G).

All architecture done by configuration, based in schema, easy to see by human eye. Of course, you have an API functions to change configuration and data in real time.

For Linux and RTOS/ESP32.

Versions in C, Javascript and (TODO) Python.

For more details, see doc.yuneta.io

Commands

yunetas init                  # create build dirs, compiler/build-type from .config (menuconfig)
yunetas build                 # make install: SDK + registered projects
yunetas clean                 # make clean:   SDK + registered projects
yunetas test                  # ctest

# External projects (registry in ~/.yuneta/projects.json, machine-local)
yunetas register-project <path>     # <path> must contain yunos/CMakeLists.txt
yunetas unregister-project <name>
yunetas list-projects
yunetas init|build|clean <name>...  # only those projects (SDK skipped)
yunetas init|build|clean --sdk-only # only the SDK

# Deploy helpers (wrappers over $YUNETAS_BASE/tools/agent/sync_*.py)
yunetas sync                  [-n|-a|...]          # binaries AND configs together (recommended)
yunetas sync-binaries         [-n|-a|...]          # outputs/yunos vs the local agent
yunetas sync-configs          [-n|-a|-r|...]       # auto-match batches/<host>/ to the agent's realm_ids
yunetas sync-configs --host <host> [...]          # or target one batches dir explicitly
yunetas upgrade-yunos [--no-snap|--snap-name N|-y|-n]  # snapshot -> find-new-yunos -> deactivate-snap

On a runtime-only node (installed from the .deb/.rpm: outputs/, outputs_ext/, tools/ and .config, but no framework sources and no YUNETA_VERSION) there is no SDK to build, so init/build/clean with no arguments process the registered projects only — naming them is optional. --sdk-only is an error there.

Deploy flow

Two steps: push the artifacts, then promote them.

# 1. Push binaries AND configs in one go (so a binary bump never ships
#    without its matching config bump — the verify-by-default footgun:
#    a new fail-closed runtime against a stale no-CA config breaks OIDC).
yunetas sync                  # = sync-binaries + sync-configs

# 2. Promote the freshly installed releases to primary and restart.
yunetas upgrade-yunos         # snapshot -> find-new-yunos (confirm) -> deactivate-snap

sync does not restart anything by itself; upgrade-yunos is the promote step. It shoots a rollback snapshot first (idempotent by name; reuses an already-active snap instead of stacking a new one; --no-snap to skip), then previews find-new-yunos and asks before create=1, then deactivate-snap triggers restart_nodes() on the agent. Preview either step with -n.

For a same-version hot-patch (no APP_VERSION bump) you don't need upgrade-yunos: sync then bounce the affected yunos (kill-yuno + run-yuno / play-yuno).

How build this package

Install pdm

This package use pdm to build and publish.

    pip install pdm
    pip install cement
    pip install plumbum
    pip install fastapi
    pip install "uvicorn[standard]"
    pip install "typer[all]"

Build and publish

  # Firstly change the version (explained below)
  # Next go to source root folder
  pdm build
  pdm publish --username __token__ --password <your-api-token> # (me: the full command is saved in publish-tui_yunetas.sh)

Install the package in editable mode using pip from the source root folder:

  pip install -e .

Change the version

Edit the __version__.py file and change the variable __version__. Then build and publish