irssi/msg_flow.md

ANALIZA KROK PO KROKU - FLOW WIADOMOŚCI W IRSSI

1. WIADOMOŚCI PRZYCHODZĄCE (od serwera do wyświetlenia)

Krok 1: Odbieranie z serwera

Funkcja: irc_parse_incoming() w src/irc/core/irc.c:543

• Czyta dane z socketu przez net_sendbuffer_receive_line()
• Emituje sygnał "server incoming" z surową linią

Krok 2: Parsowanie IRC

Funkcja: irc_parse_incoming_line() w src/irc/core/irc.c:528

• Parsuje prefix (nick, address, tags) przez irc_parse_prefix()
• Emituje sygnał "server event tags" z parsowanymi danymi

Krok 3: Rozpoznanie typu wiadomości

Funkcja: irc_server_event() w src/irc/core/irc.c:370

• Parsuje komendę IRC (PRIVMSG, JOIN, etc.)
• Emituje odpowiedni sygnał np. "event privmsg"

Krok 4: Konwersja na sygnały wiadomości

Funkcja: event_privmsg() w src/fe-common/irc/fe-events.c:42

• Dekoduje wiadomość przez recode_in()
• Rozróżnia kanał vs prywatna
• Emituje "message public" lub "message private"

Krok 5: Obsługa sygnału wiadomości

Funkcja: sig_message_public() w src/fe-common/core/fe-messages.c:168

• Znajduje kanał i nick record
• Pobiera nickmode przez channel_get_nickmode()
• Sprawdza highlight przez hilight_match()
• WYWOŁUJE: printformat_module("fe-common/core", server, target, level, TXT_PUBMSG, nick, address, msg, nickmode)

2. FORMATOWANIE I THEME

Krok 6: printformat_module

Funkcja: printformat_module() w src/fe-common/core/printtext.c:101

• Tworzy TEXT_DEST_REC przez format_create_dest()
• Wywołuje printformat_module_dest_args()

Krok 7: Emisja sygnału formatowania

Funkcja: printformat_module_dest_charargs() w src/fe-common/core/printtext.c:64

• Pobiera theme przez window_get_theme()
• EMITUJE: signal_emit_id(signal_print_format, 5, theme, module, dest, formatnum, arglist)

Krok 8: Obsługa sygnału formatowania

Funkcja: sig_print_format() w src/fe-common/core/printtext.c:459

• WYWOŁUJE: format_get_text_theme_charargs(theme, module, dest, formatnum, arglist)

Krok 9: Pobieranie tekstu z theme

Funkcja: format_get_text_theme_charargs() w src/fe-common/core/formats.c:831

• Znajduje moduł theme w theme->modules
• Pobiera expanded format: text = module_theme->expanded_formats[formatnum]
• WYWOŁUJE: format_get_text_args(dest, text, args)

Krok 10: Parsowanie expandos i zmiennych

Funkcja: format_get_text_args() w src/fe-common/core/formats.c:737

• Iteruje przez tekst formatujący
• Gdy napotka $, wywołuje parse_special()

Krok 11: Parsowanie expandos

Funkcja: parse_special() w src/core/special-vars.c:425

• Parsuje składnię $[alignment]variable
• WYWOŁUJE: get_special_value() → get_variable() → get_long_variable_value()

Krok 12: Wykonanie expando

Funkcja: get_long_variable_value() w src/core/special-vars.c:95

• WYWOŁUJE: func = expando_find_long(key)
• WYWOŁUJE: return func(server, item, free_ret) ← TU SĄ NASZE EXPANDOS!

3. WIADOMOŚCI WYCHODZĄCE (nasze wiadomości)

Krok 1: Input od użytkownika

Funkcja: Obsługa klawiatury w src/fe-text/gui-readline.c

• Przechwytuje Enter, wywołuje signal_emit("send command", ...)

Krok 2: Parsowanie komendy

Funkcja: cmd_msg() lub podobne w src/irc/core/irc-commands.c

• Wysyła PRIVMSG do serwera
• Emituje "message own_public" lub "message own_private"

Krok 3: Formatowanie własnej wiadomości

Funkcja: sig_message_own_public() w src/fe-common/core/fe-messages.c:281

• Pobiera nickmode przez channel_get_nickmode(channel, server->nick)
• WYWOŁUJE: printformat_module("fe-common/core", server, target, level, TXT_OWN_MSG, server->nick, target, msg, nickmode)

Dalej flow jest identyczny jak dla wiadomości przychodzących od kroku 6.