discovery_tui.c File Reference

TUI-based service discovery wrapper for interactive server selection. More...

Go to the source code of this file.

Macros
#define	ANSI_CLEAR   "\033[2J\033[H"
	ANSI escape codes for TUI.
#define	ANSI_BOLD   "\033[1m"
#define	ANSI_RESET   "\033[0m"
#define	ANSI_CYAN   "\033[36m"
#define	ANSI_GREEN   "\033[32m"
#define	ANSI_YELLOW   "\033[33m"
#define	ANSI_HIDE_CURSOR   "\033[?25l"
#define	ANSI_SHOW_CURSOR   "\033[?25h"
#define	ANSI_CLEAR_LINE   "\033[K"

Functions
discovery_tui_server_t *	discovery_tui_query (const discovery_tui_config_t *config, int *out_count)
	TUI wrapper around core mDNS discovery.
void	discovery_tui_free_results (discovery_tui_server_t *servers)
	Free results from mDNS discovery.
int	discovery_tui_prompt_selection (const discovery_tui_server_t *servers, int count)
	Interactive server selection.
int	discovery_tui_select (const discovery_tui_server_t *servers, int count)
	TUI-based server selection with formatted display.
const char *	discovery_tui_get_best_address (const discovery_tui_server_t *server)
	Get best address for a server.

Detailed Description

TUI-based service discovery wrapper for interactive server selection.

Pure TUI wrapper that calls discovery_mdns_query() from discovery.c. Provides interactive terminal UI for server selection and address resolution.

Definition in file discovery_tui.c.

Macro Definition Documentation

ANSI_BOLD

#define ANSI_BOLD   "\033[1m"

Definition at line 98 of file discovery_tui.c.

ANSI_CLEAR

#define ANSI_CLEAR   "\033[2J\033[H"

ANSI escape codes for TUI.

Definition at line 97 of file discovery_tui.c.

ANSI_CLEAR_LINE

#define ANSI_CLEAR_LINE   "\033[K"

Definition at line 105 of file discovery_tui.c.

ANSI_CYAN

#define ANSI_CYAN   "\033[36m"

Definition at line 100 of file discovery_tui.c.

ANSI_GREEN

#define ANSI_GREEN   "\033[32m"

Definition at line 101 of file discovery_tui.c.

ANSI_HIDE_CURSOR

#define ANSI_HIDE_CURSOR   "\033[?25l"

Definition at line 103 of file discovery_tui.c.

ANSI_RESET

#define ANSI_RESET   "\033[0m"

Definition at line 99 of file discovery_tui.c.

ANSI_SHOW_CURSOR

#define ANSI_SHOW_CURSOR   "\033[?25h"

Definition at line 104 of file discovery_tui.c.

ANSI_YELLOW

#define ANSI_YELLOW   "\033[33m"

Definition at line 102 of file discovery_tui.c.

Function Documentation

discovery_tui_free_results()

void discovery_tui_free_results

(

discovery_tui_server_t *

servers

)

Free results from mDNS discovery.

Free results from TUI discovery query.

Definition at line 45 of file discovery_tui.c.

                                                                 {
  discovery_mdns_free(servers);
}

References discovery_mdns_free().

Referenced by client_main().

discovery_tui_get_best_address()

const char * discovery_tui_get_best_address

(

const discovery_tui_server_t *

server

)

Get best address for a server.

Get best address representation for a discovered server.

Definition at line 206 of file discovery_tui.c.

                                                                                 {
  if (!server) {
    return "";
  }
 
  // Prefer IPv4 > name > IPv6
  if (server->ipv4[0] != '\0') {
    return server->ipv4;
  }
  if (server->name[0] != '\0') {
    return server->name;
  }
  if (server->ipv6[0] != '\0') {
    return server->ipv6;
  }
 
  return server->address; // Fallback to address field
}

References discovery_tui_server_t::address, discovery_tui_server_t::ipv4, discovery_tui_server_t::ipv6, and discovery_tui_server_t::name.

Referenced by client_main(), discovery_tui_prompt_selection(), and discovery_tui_select().

discovery_tui_prompt_selection()

int discovery_tui_prompt_selection	(	const discovery_tui_server_t *	servers,
		int	count
	)

Interactive server selection.

Display discovered servers to user and prompt for selection.

Definition at line 52 of file discovery_tui.c.

                                                                                     {
  if (!servers || count <= 0) {
    return -1;
  }
 
  // Display available servers
  printf("\nAvailable ASCII-Chat servers on LAN:\n");
  for (int i = 0; i < count; i++) {
    const discovery_tui_server_t *srv = &servers[i];
    const char *addr = discovery_tui_get_best_address(srv);
    printf("  %d. %s (%s:%u)\n", i + 1, srv->name, addr, srv->port);
  }
 
  // Prompt for selection
  printf("\nSelect server (1-%d) or press Enter to cancel: ", count);
  fflush(stdout);
 
  // Read user input
  char input[32];
  if (fgets(input, sizeof(input), stdin) == NULL) {
    printf("\n");
    return -1; // EOF or error
  }
 
  // Check for empty input (Enter pressed)
  if (input[0] == '\n' || input[0] == '\r' || input[0] == '\0') {
    return -1; // User cancelled
  }
 
  // Parse input as number
  char *endptr;
  long selection = strtol(input, &endptr, 10);
 
  // Validate input
  if (selection < 1 || selection > count) {
    printf("⚠️  Invalid selection. Please enter a number between 1 and %d\n", count);
    return discovery_tui_prompt_selection(servers, count); // Re-prompt
  }
 
  return (int)(selection - 1); // Convert to 0-based index
}

References discovery_tui_get_best_address(), discovery_tui_prompt_selection(), discovery_tui_server_t::name, and discovery_tui_server_t::port.

Referenced by discovery_tui_prompt_selection().

discovery_tui_query()

discovery_tui_server_t * discovery_tui_query	(	const discovery_tui_config_t *	config,
		int *	out_count
	)

TUI wrapper around core mDNS discovery.

Discover ASCII-Chat servers on the local network via mDNS.

Calls discovery_mdns_query() from discovery.c with TUI-friendly configuration.

Definition at line 25 of file discovery_tui.c.

                                                                                                  {
  if (!out_count) {
    SET_ERRNO(ERROR_INVALID_PARAM, "out_count pointer is NULL");
    return NULL;
  }
 
  *out_count = 0;
 
  // Apply defaults if needed
  int timeout_ms = (config && config->timeout_ms > 0) ? config->timeout_ms : 2000;
  int max_servers = (config && config->max_servers > 0) ? config->max_servers : 20;
  bool quiet = (config && config->quiet);
 
  // Call the core mDNS discovery function from discovery.c
  return discovery_mdns_query(timeout_ms, max_servers, quiet, out_count);
}

References discovery_mdns_query(), ERROR_INVALID_PARAM, discovery_tui_config_t::max_servers, discovery_tui_config_t::quiet, SET_ERRNO, and discovery_tui_config_t::timeout_ms.

Referenced by client_main().

discovery_tui_select()

int discovery_tui_select	(	const discovery_tui_server_t *	servers,
		int	count
	)

TUI-based server selection with formatted display.

Displays discovered servers in a terminal UI with the following features:

• Clears terminal and displays formatted server list
• Shows "No results" message if no servers available
• Allows numeric input for selection
• Shows helpful prompts and icons

Parameters

servers	Array of discovered servers
count	Number of servers

Returns

0-based index of selected server, or -1 to cancel

Definition at line 120 of file discovery_tui.c.

                                                                           {
  if (!servers || count <= 0) {
    // No servers found - return special code
    // Message will be printed at exit in client main
    return -1;
  }
 
  // Lock terminal to prevent concurrent logging from overwriting TUI
  bool prev_lock_state = log_lock_terminal();
 
  // Clear terminal
  log_plain("%s", ANSI_CLEAR);
 
  // Display header
  log_plain("\n");
  log_plain("%s╭─ 🔍 ASCII-Chat Server Discovery %s────────────╮%s\n", ANSI_BOLD, ANSI_RESET, ANSI_BOLD);
  log_plain("│%s\n", ANSI_RESET);
  log_plain("%s│%s Found %d server%s on your local network:%s\n", ANSI_BOLD, ANSI_GREEN, count, count == 1 ? "" : "s",
            ANSI_RESET);
  log_plain("%s│%s\n", ANSI_BOLD, ANSI_RESET);
 
  // Display server list with formatting
  for (int i = 0; i < count; i++) {
    const discovery_tui_server_t *srv = &servers[i];
    const char *addr = discovery_tui_get_best_address(srv);
 
    log_plain("%s│%s  ", ANSI_BOLD, ANSI_RESET);
    log_plain("%s[%d]%s %-30s %s%s:%u%s", ANSI_CYAN, i + 1, ANSI_RESET, srv->name, ANSI_YELLOW, addr, srv->port,
              ANSI_RESET);
    log_plain("\n");
  }
 
  log_plain("%s│%s\n", ANSI_BOLD, ANSI_RESET);
  log_plain("%s╰────────────────────────────────────────────╯%s\n", ANSI_BOLD, ANSI_RESET);
 
  // Prompt for selection
  log_plain("\n");
  log_plain("Enter server number (1-%d) or press Enter to cancel: ", count);
  fflush(stdout);
 
  // Unlock before waiting for input (user might take time)
  log_unlock_terminal(prev_lock_state);
 
  // Read user input
  char input[32];
  if (fgets(input, sizeof(input), stdin) == NULL) {
    return -1;
  }
 
  // Check for empty input (Enter pressed)
  if (input[0] == '\n' || input[0] == '\r' || input[0] == '\0') {
    return -1;
  }
 
  // Parse input as number
  char *endptr;
  long selection = strtol(input, &endptr, 10);
 
  // Validate input
  if (selection < 1 || selection > count) {
    printf("%sError:%s Please enter a number between 1 and %d\n\n", ANSI_YELLOW, ANSI_RESET, count);
    return discovery_tui_select(servers, count); // Re-prompt
  }
 
  // Lock terminal again for final output
  prev_lock_state = log_lock_terminal();
 
  // Clear screen and show connection status
  log_plain("%s", ANSI_CLEAR);
  log_plain("\n");
  log_plain("%s🔗 Connecting to %s...%s\n", ANSI_GREEN, servers[selection - 1].name, ANSI_RESET);
  log_plain("\n");
  fflush(stdout);
 
  // Brief delay so user can see the selection before logs overwrite it
  platform_sleep_ms(200);
 
  // Unlock terminal now that TUI is complete
  log_unlock_terminal(prev_lock_state);
 
  return (int)(selection - 1); // Convert to 0-based index
}

References ANSI_BOLD, ANSI_CLEAR, ANSI_CYAN, ANSI_GREEN, ANSI_RESET, ANSI_YELLOW, discovery_tui_get_best_address(), discovery_tui_select(), log_lock_terminal(), log_plain, log_unlock_terminal(), discovery_tui_server_t::name, platform_sleep_ms(), and discovery_tui_server_t::port.

Referenced by client_main(), and discovery_tui_select().