IOC

The ioc subpackage manages IOC processes via two backends: procServ (TCP-based console, asyncio port check) and GNU Screen (named sessions, subprocess check). Both share the same ProcessDefinition and expose the same interface.

Usage

For apps that manage multiple processes, use IOCGroup to get list, start-all, stop-all, and status-all operations. Individual entry points call start() then connect() to replicate the original start-and-attach default behavior:

from gselib.ioc import IOCGroup, ProcessDefinition, ProcServManager

P1 = ProcServManager(ProcessDefinition(name="process1", command="path/to/.py/or/st.cmd", port=34567, log_dir="/tmp/app_logs"))
P2 = ProcServManager(ProcessDefinition(name="process2", command="path/to/.py/or/st.cmd", port=34568, log_dir="/tmp/app_logs"))
GROUP = IOCGroup([P1, P2])


def p1_start() -> None:
    P1.start()
    P1.connect()


def p1_stop() -> None:
    P1.stop()


def p2_start() -> None:
    P2.start()
    P2.connect()


def start_all() -> None:
    GROUP.start_all()


def stop_all() -> None:
    GROUP.stop_all()


def list_all() -> None:
    GROUP.list_all()


def status_all() -> None:
    GROUP.status_all()

To use the GNU Screen instead, swap ProcServManager for ScreenManager, the interface is identical.

ProcessDefinition fields

Field	Default	Used by
name	required	both
command	required	both
log_dir	required	both
port	None	ProcServManager only
autorestart	True	ProcServManager only

procserv_bin is a constructor argument on ProcServManager(process_def, procserv_bin="procServ"). The running user and host are taken from the environment at runtime via gselib.utils.sysinfo. port and autostart are ignore by ScreenManager, do not set them when using the Screen backend.