Skip to content

gateway_cmd

gateway_cmd

diapason gateway start|stop|status|logs — multi-channel gateway management.

Functions:

gateway 

gateway() -> None

Manage the Diapason multi-channel gateway.

Source code in src/diapason/cli/gateway_cmd.py 
11
12
13
@click.group()
def gateway() -> None:
    """Manage the Diapason multi-channel gateway."""

start 

start(install: bool) -> None

Start the gateway daemon.

Source code in src/diapason/cli/gateway_cmd.py 
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
@gateway.command()
@click.option(
    "--install",
    is_flag=True,
    help="Generate and enable systemd/launchd service",
)
def start(install: bool) -> None:
    """Start the gateway daemon."""
    if install:
        import platform as plat

        from diapason.daemon.service import (
            generate_launchd_plist,
            generate_systemd_service,
        )

        if plat.system() == "Darwin":
            plist_path = Path.home() / "Library/LaunchAgents/com.diapason.gateway.plist"
            generate_launchd_plist(plist_path)
            click.echo(f"Wrote {plist_path}")
            subprocess.run(
                ["launchctl", "load", str(plist_path)],
                check=False,
            )
        else:
            service_path = Path.home() / ".config/systemd/user/diapason-gateway.service"
            generate_systemd_service(service_path)
            click.echo(f"Wrote {service_path}")
            subprocess.run(
                ["systemctl", "--user", "daemon-reload"],
                check=False,
            )
            subprocess.run(
                ["systemctl", "--user", "enable", "--now", "diapason-gateway"],
                check=False,
            )
    else:
        click.echo("Starting Diapason gateway (foreground)...")
        click.echo("Gateway started. Press Ctrl+C to stop.")

stop 

stop() -> None

Stop the gateway daemon.

Source code in src/diapason/cli/gateway_cmd.py 
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
@gateway.command()
def stop() -> None:
    """Stop the gateway daemon."""
    import platform as plat

    if plat.system() == "Darwin":
        subprocess.run(
            ["launchctl", "remove", "com.diapason.gateway"],
            check=False,
        )
    else:
        subprocess.run(
            ["systemctl", "--user", "stop", "diapason-gateway"],
            check=False,
        )
    click.echo("Gateway stopped.")

status 

status() -> None

Check gateway status.

Source code in src/diapason/cli/gateway_cmd.py 
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
@gateway.command()
def status() -> None:
    """Check gateway status."""
    import platform as plat

    if plat.system() == "Darwin":
        subprocess.run(
            ["launchctl", "list", "com.diapason.gateway"],
            check=False,
        )
    else:
        subprocess.run(
            ["systemctl", "--user", "status", "diapason-gateway"],
            check=False,
        )

logs 

logs() -> None

View gateway logs.

Source code in src/diapason/cli/gateway_cmd.py 
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
@gateway.command()
def logs() -> None:
    """View gateway logs."""
    import platform as plat

    if plat.system() == "Darwin":
        click.echo("Check ~/Library/Logs/com.diapason.gateway.log")
    else:
        subprocess.run(
            ["journalctl", "--user", "-u", "diapason-gateway", "-f"],
            check=False,
        )