Skip to content

signals

signals

Signal handling constants and utilities for Marianne error classification.

This module provides signal-related constants and helper functions used by the error classifier to determine whether a process killed by a signal should be retried or treated as a fatal error.

Signal Categories: - RETRIABLE_SIGNALS: Signals that indicate transient conditions (network, termination) - FATAL_SIGNALS: Signals that indicate crashes or unrecoverable errors

Functions

get_signal_name 

get_signal_name(sig_num)

Get human-readable signal name.

Parameters:

Name Type Description Default
sig_num int

The signal number (e.g., signal.SIGTERM)

 required

Returns:

Type Description
str

Human-readable signal name (e.g., "SIGTERM") or "signal N" if unknown
Source code in src/marianne/core/errors/signals.py 
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
def get_signal_name(sig_num: int) -> str:
    """Get human-readable signal name.

    Args:
        sig_num: The signal number (e.g., signal.SIGTERM)

    Returns:
        Human-readable signal name (e.g., "SIGTERM") or "signal N" if unknown
    """
    signal_names: dict[int, str] = {
        signal.SIGTERM: "SIGTERM",
        signal.SIGKILL: "SIGKILL",
        signal.SIGINT: "SIGINT",
        signal.SIGSEGV: "SIGSEGV",
        signal.SIGABRT: "SIGABRT",
        signal.SIGBUS: "SIGBUS",
        signal.SIGFPE: "SIGFPE",
        signal.SIGHUP: "SIGHUP",
        signal.SIGPIPE: "SIGPIPE",
    }
    return signal_names.get(sig_num, f"signal {sig_num}")