unleashed-firmware/applications/services/cli/shell/cli_shell_line.c

#include "cli_shell_line.h"

#define HISTORY_DEPTH 10

struct CliShellLine {
    size_t history_position;
    size_t line_position;
    FuriString* history[HISTORY_DEPTH];
    size_t history_entries;
    CliShell* shell;
};

// ==========
// Public API
// ==========

CliShellLine* cli_shell_line_alloc(CliShell* shell) {
    CliShellLine* line = malloc(sizeof(CliShellLine));
    line->shell = shell;

    line->history[0] = furi_string_alloc();
    line->history_entries = 1;

    return line;
}

void cli_shell_line_free(CliShellLine* line) {
    for(size_t i = 0; i < line->history_entries; i++)
        furi_string_free(line->history[i]);

    free(line);
}

FuriString* cli_shell_line_get_selected(CliShellLine* line) {
    return line->history[line->history_position];
}

FuriString* cli_shell_line_get_editing(CliShellLine* line) {
    return line->history[0];
}

size_t cli_shell_line_prompt_length(CliShellLine* line) {
    UNUSED(line);
    return strlen(">: ");
}

void cli_shell_line_format_prompt(CliShellLine* line, char* buf, size_t length) {
    UNUSED(line);
    snprintf(buf, length - 1, ">: ");
}

void cli_shell_line_prompt(CliShellLine* line) {
    char buffer[32];
    cli_shell_line_format_prompt(line, buffer, sizeof(buffer));
    printf("\r\n%s", buffer);
    fflush(stdout);
}

void cli_shell_line_ensure_not_overwriting_history(CliShellLine* line) {
    if(line->history_position > 0) {
        FuriString* source = cli_shell_line_get_selected(line);
        FuriString* destination = cli_shell_line_get_editing(line);
        furi_string_set(destination, source);
        line->history_position = 0;
    }
}

// ==============
// Input handlers
// ==============

static bool cli_shell_line_input_ctrl_c(CliKeyCombo combo, void* context) {
    UNUSED(combo);
    CliShellLine* line = context;
    // reset input
    furi_string_reset(cli_shell_line_get_editing(line));
    line->line_position = 0;
    line->history_position = 0;
    printf("^C");
    cli_shell_line_prompt(line);
    return true;
}

static bool cli_shell_line_input_cr(CliKeyCombo combo, void* context) {
    UNUSED(combo);
    CliShellLine* line = context;

    FuriString* command = cli_shell_line_get_selected(line);
    furi_string_trim(command);
    FuriString* command_copy = furi_string_alloc_set(command);

    if(line->history_position > 0) {
        // move selected command to the front
        memmove(
            &line->history[1], &line->history[0], line->history_position * sizeof(FuriString*));
        line->history[0] = command;
    }

    // insert empty command
    if(line->history_entries == HISTORY_DEPTH) {
        furi_string_free(line->history[HISTORY_DEPTH - 1]);
        line->history_entries--;
    }
    memmove(&line->history[1], &line->history[0], line->history_entries * sizeof(FuriString*));
    line->history[0] = furi_string_alloc();
    line->history_entries++;
    line->line_position = 0;
    line->history_position = 0;

    // execute command
    printf("\r\n");
    if(!furi_string_empty(command_copy)) cli_shell_execute_command(line->shell, command_copy);
    furi_string_free(command_copy);

    cli_shell_line_prompt(line);
    return true;
}

static bool cli_shell_line_input_up_down(CliKeyCombo combo, void* context) {
    CliShellLine* line = context;
    // go up and down in history
    int increment = (combo.key == CliKeyUp) ? 1 : -1;
    size_t new_pos =
        CLAMP((int)line->history_position + increment, (int)line->history_entries - 1, 0);

    // print prompt with selected command
    if(new_pos != line->history_position) {
        line->history_position = new_pos;
        FuriString* command = cli_shell_line_get_selected(line);
        printf(
            ANSI_CURSOR_HOR_POS("1") ">: %s" ANSI_ERASE_LINE(ANSI_ERASE_FROM_CURSOR_TO_END),
            furi_string_get_cstr(command));
        fflush(stdout);
        line->line_position = furi_string_size(command);
    }
    return true;
}

static bool cli_shell_line_input_left_right(CliKeyCombo combo, void* context) {
    CliShellLine* line = context;
    // go left and right in the current line
    FuriString* command = cli_shell_line_get_selected(line);
    int increment = (combo.key == CliKeyRight) ? 1 : -1;
    size_t new_pos =
        CLAMP((int)line->line_position + increment, (int)furi_string_size(command), 0);

    // move cursor
    if(new_pos != line->line_position) {
        line->line_position = new_pos;
        printf("%s", (increment == 1) ? ANSI_CURSOR_RIGHT_BY("1") : ANSI_CURSOR_LEFT_BY("1"));
        fflush(stdout);
    }
    return true;
}

static bool cli_shell_line_input_home(CliKeyCombo combo, void* context) {
    UNUSED(combo);
    CliShellLine* line = context;
    // go to the start
    line->line_position = 0;
    printf(ANSI_CURSOR_HOR_POS("%zu"), cli_shell_line_prompt_length(line) + 1);
    fflush(stdout);
    return true;
}

static bool cli_shell_line_input_end(CliKeyCombo combo, void* context) {
    UNUSED(combo);
    CliShellLine* line = context;
    // go to the end
    line->line_position = furi_string_size(cli_shell_line_get_selected(line));
    printf(
        ANSI_CURSOR_HOR_POS("%zu"), cli_shell_line_prompt_length(line) + line->line_position + 1);
    fflush(stdout);
    return true;
}

static bool cli_shell_line_input_bksp(CliKeyCombo combo, void* context) {
    UNUSED(combo);
    CliShellLine* line = context;
    // erase one character
    cli_shell_line_ensure_not_overwriting_history(line);
    FuriString* editing_line = cli_shell_line_get_editing(line);
    if(line->line_position == 0) {
        putc(CliKeyBell, stdout);
        fflush(stdout);
        return true;
    }
    line->line_position--;
    furi_string_replace_at(editing_line, line->line_position, 1, "");

    // move cursor, print the rest of the line, restore cursor
    printf(
        ANSI_CURSOR_LEFT_BY("1") "%s" ANSI_ERASE_LINE(ANSI_ERASE_FROM_CURSOR_TO_END),
        furi_string_get_cstr(editing_line) + line->line_position);
    size_t left_by = furi_string_size(editing_line) - line->line_position;
    if(left_by) // apparently LEFT_BY("0") still shifts left by one ._ .
        printf(ANSI_CURSOR_LEFT_BY("%zu"), left_by);
    fflush(stdout);
    return true;
}

static bool cli_shell_line_input_fallback(CliKeyCombo combo, void* context) {
    CliShellLine* line = context;
    if(combo.modifiers != CliModKeyNo) return false;
    if(combo.key < CliKeySpace || combo.key >= CliKeyDEL) return false;
    // insert character
    cli_shell_line_ensure_not_overwriting_history(line);
    FuriString* editing_line = cli_shell_line_get_editing(line);
    if(line->line_position == furi_string_size(editing_line)) {
        furi_string_push_back(editing_line, combo.key);
        printf("%c", combo.key);
    } else {
        const char in_str[2] = {combo.key, 0};
        furi_string_replace_at(editing_line, line->line_position, 0, in_str);
        printf(ANSI_INSERT_MODE_ENABLE "%c" ANSI_INSERT_MODE_DISABLE, combo.key);
    }
    fflush(stdout);
    line->line_position++;
    return true;
}

CliShellKeyComboSet cli_shell_line_key_combo_set = {
    .fallback = cli_shell_line_input_fallback,
    .count = 10,
    .records =
        {
            {{CliModKeyNo, CliKeyETX}, cli_shell_line_input_ctrl_c},
            {{CliModKeyNo, CliKeyCR}, cli_shell_line_input_cr},
            {{CliModKeyNo, CliKeyUp}, cli_shell_line_input_up_down},
            {{CliModKeyNo, CliKeyDown}, cli_shell_line_input_up_down},
            {{CliModKeyNo, CliKeyLeft}, cli_shell_line_input_left_right},
            {{CliModKeyNo, CliKeyRight}, cli_shell_line_input_left_right},
            {{CliModKeyNo, CliKeyHome}, cli_shell_line_input_home},
            {{CliModKeyNo, CliKeyEnd}, cli_shell_line_input_end},
            {{CliModKeyNo, CliKeyBackspace}, cli_shell_line_input_bksp},
            {{CliModKeyNo, CliKeyDEL}, cli_shell_line_input_bksp},
        },
};