Разработка простого клиента
При разработке собственного локального клиента для 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 больше не нужны.