Разработка простого клиента

При разработке собственного локального клиента для Altera есть два варианта:

  • создать базовый клиент с нуля
  • использовать altera-cli

Во всех шаблонах example-module — условное имя backend4-модуля, а read с параметром name — пример его предметного контракта. Для своего клиента задайте имя, запрос и обработку ответа выбранного модуля.

Базовый клиент

Здесь показаны минимальные шаблоны для Altera: подключиться, отправить один запрос и вывести все ответы.

Примеры рассчитаны на обычную сборку без legacy-unix-peer (Linux 6.5+).

Unix-сокет /run/altera/.socket принимает JSON Lines: каждый запрос заканчивается \n. После отправки закрываем только направление записи. Сервер обработает запрос и закроет соединение; клиент тем временем читает ответы до EOF.

Rust

use std::io::{self, Write};
use std::net::Shutdown;
use std::os::unix::net::UnixStream;

fn main() {
    let mut socket = UnixStream::connect("/run/altera/.socket").unwrap();
    socket.write_all(br#"{"/backend4/example-module":{"action":{"read":{"name":"eth0"}}}}"#).unwrap();
    socket.write_all(b"\n").unwrap();
    socket.shutdown(Shutdown::Write).unwrap();
    io::copy(&mut socket, &mut io::stdout()).unwrap();
}

Golang

package main

import (
    "io"
    "net"
    "os"
)

func main() {
    socket, _ := net.DialUnix("unix", nil, &net.UnixAddr{
        Name: "/run/altera/.socket", Net: "unix",
    })
    defer socket.Close()
    io.WriteString(socket, `{"/backend4/example-module":{"action":{"read":{"name":"eth0"}}}}`+"\n")
    socket.CloseWrite()
    io.Copy(os.Stdout, socket)
}

Python

import socket

with socket.socket(socket.AF_UNIX, socket.SOCK_STREAM) as client:
    client.connect("/run/altera/.socket")
    client.sendall(b'{"/backend4/example-module":{"action":{"read":{"name":"eth0"}}}}\n')
    client.shutdown(socket.SHUT_WR)
    with client.makefile("r", encoding="utf-8") as replies:
        for line in replies:
            print(line, end="", flush=True)

Клиент через altera-cli

Вместо прямого подключения к сокету клиент может запустить altera-cli как дочерний процесс:

клиент → stdin altera-cli → Unix-сокет → служба Altera → модуль
клиент ← stdout altera-cli ← Unix-сокет ← служба Altera ← модуль

Rust

use std::io::{self, Write};
use std::process::{Command, Stdio};

fn main() -> io::Result<()> {
    let mut cli = Command::new("altera-cli")
        .arg("/backend4/example-module")
        .stdin(Stdio::piped())
        .spawn()?;
    let sent = {
        let mut input = cli.stdin.take().unwrap();
        input.write_all(b"{\"action\":{\"read\":{\"name\":\"eth0\"}}}\n")
    };
    let status = cli.wait()?;
    sent?;
    if !status.success() {
        return Err(io::Error::other(format!("altera-cli: {status}")));
    }
    Ok(())
}

Go (Golang)

package main

import (
    "fmt"
    "os"
    "os/exec"
    "strings"
)

func main() {
    cli := exec.Command("altera-cli", "/backend4/example-module")
    cli.Stdin = strings.NewReader(`{"action":{"read":{"name":"eth0"}}}` + "\n")
    cli.Stdout = os.Stdout
    cli.Stderr = os.Stderr
    if err := cli.Run(); err != nil {
        fmt.Fprintln(os.Stderr, err)
        os.Exit(1)
    }
}

Python

import subprocess

subprocess.run(
    ["altera-cli", "/backend4/example-module"],
    input='{"action":{"read":{"name":"eth0"}}}\n',
    text=True,
    check=True,
)

Для нескольких модулей запускайте altera-cli без аргумента и передавайте полные объекты с путями, как в примерах прямого подключения выше. Ответы тогда тоже сохраняют внешние пути. Для длительной сессии держите stdin открытым и читайте stdout по строкам параллельно с отправкой запросов; закрывайте stdin, когда новые запросы и ответы на вопросы Polkit больше не нужны.