anti
f2b3393669
Replaces LICENSE (GPLv3 -> AGPLv3) and prepends `SPDX-License-Identifier: AGPL-3.0-or-later` to every source file across decnet/, decnet_web/, tests/, scripts/, and tools/. Rationale: closes the GPLv3 ASP loophole so any party operating a modified DECNET as a network service must offer their modified source. Personal copyright (Samuel Paschuan) + inbound=outbound contributions make a future unilateral relicense infeasible. - LICENSE: full AGPL-3.0 text (gnu.org/licenses/agpl-3.0.txt) - COPYRIGHT: project copyright notice - tools/add_spdx_headers.py: idempotent header injector (shebang- and PEP 263-aware) Touches 1565 source files (.py, .ts, .tsx, .js, .jsx, .css, .sh). No behavior change; comments only.
41 lines
1.3 KiB
Python
41 lines
1.3 KiB
Python
# SPDX-License-Identifier: AGPL-3.0-or-later
|
|
"""
|
|
Log forwarding helpers.
|
|
|
|
DECNET is agnostic to what receives logs — any TCP/UDP listener works
|
|
(Logstash, Splunk, Graylog, netcat, etc.).
|
|
|
|
Each service plugin handles the actual forwarding by injecting the
|
|
LOG_TARGET environment variable into its container. This module provides
|
|
shared utilities for validating and parsing the log_target string.
|
|
"""
|
|
|
|
import socket
|
|
|
|
from decnet.telemetry import traced as _traced
|
|
|
|
|
|
def parse_log_target(log_target: str) -> tuple[str, int]:
|
|
"""
|
|
Parse "ip:port" into (host, port).
|
|
Raises ValueError on bad format.
|
|
"""
|
|
parts = log_target.rsplit(":", 1)
|
|
if len(parts) != 2 or not parts[1].isdigit():
|
|
raise ValueError(f"Invalid log_target '{log_target}'. Expected format: ip:port")
|
|
return parts[0], int(parts[1])
|
|
|
|
|
|
@_traced("logging.probe_log_target")
|
|
def probe_log_target(log_target: str, timeout: float = 2.0) -> bool:
|
|
"""
|
|
Return True if the log target is reachable (TCP connect succeeds).
|
|
Non-fatal — just used to warn the user before deployment.
|
|
"""
|
|
try:
|
|
host, port = parse_log_target(log_target)
|
|
with socket.create_connection((host, port), timeout=timeout):
|
|
return True
|
|
except (OSError, ValueError):
|
|
return False
|