editline.h

/* SPDX-License-Identifier: BSD-3-Clause
 * Copyright 2018, Olivier MATZ <zer0@droids-corp.org>
 */

 
#pragma once
 
#include <stdbool.h>
 
#include <histedit.h>
 
struct ec_editline;
struct ec_node;
struct ec_pnode;
struct ec_comp;

struct ec_editline_help {
    char *desc; 
    char *help; 
};

#define EC_EDITLINE_HISTORY_SIZE 128

#define EC_EDITLINE_HELP_ATTR "_help"

#define EC_EDITLINE_CB_ATTR "_cb"

#define EC_EDITLINE_DESC_ATTR "_desc"

enum ec_editline_init_flags {
    EC_EDITLINE_DISABLE_SIGNALS = 1 << 0,

    EC_EDITLINE_DISABLE_HISTORY = 1 << 1,

    EC_EDITLINE_DISABLE_COMPLETION = 1 << 2,

    EC_EDITLINE_DEFAULT_SIGHANDLER = 1 << 3,
};

typedef int (*ec_editline_command_cb_t)(const struct ec_pnode *);

typedef int (*ec_editline_check_exit_cb_t)(void *opaque);

struct ec_editline *ec_editline(
    const char *prog,
    FILE *f_in,
    FILE *f_out,
    FILE *f_err,
    enum ec_editline_init_flags flags
);

void ec_editline_free(struct ec_editline *editline);

EditLine *ec_editline_get_el(struct ec_editline *editline);

int ec_editline_term_size(
    const struct ec_editline *editline,
    unsigned int *width,
    unsigned int *height
);

int ec_editline_set_node(struct ec_editline *editline, const struct ec_node *node);

const struct ec_node *ec_editline_get_node(const struct ec_editline *editline);

int ec_editline_set_history(struct ec_editline *editline, size_t hist_size, const char *hist_file);

ssize_t ec_editline_get_completions(const struct ec_comp *cmpl, char ***matches_out);

void ec_editline_free_completions(char **matches, size_t n);

int ec_editline_print_cols(struct ec_editline *editline, char const *const *matches, size_t n);

char *ec_editline_append_chars(const struct ec_comp *cmpl);

ssize_t ec_editline_get_helps(
    const struct ec_editline *editline,
    const char *line,
    struct ec_editline_help **helps_out
);

int ec_editline_print_helps(
    const struct ec_editline *editline,
    const struct ec_editline_help *helps,
    size_t n
);

void ec_editline_free_helps(struct ec_editline_help *helps, size_t n);

ssize_t ec_editline_get_error_helps(
    const struct ec_editline *editline,
    struct ec_editline_help **helps_out,
    size_t *char_idx
);

int ec_editline_print_error_helps(
    const struct ec_editline *editline,
    const struct ec_editline_help *helps,
    size_t n,
    size_t char_idx
);

int ec_editline_set_prompt(struct ec_editline *editline, const char *prompt);

int ec_editline_set_prompt_esc(struct ec_editline *editline, const char *prompt, char delim);

char *ec_editline_curline(const struct ec_editline *editline, bool trim_after_cursor);

char *ec_editline_gets(struct ec_editline *editline);

struct ec_pnode *ec_editline_parse(struct ec_editline *editline);

int ec_editline_interact(
    struct ec_editline *el,
    ec_editline_check_exit_cb_t check_exit_cb,
    void *opaque
);

int ec_editline_complete(EditLine *el, int c);

int ec_editline_set_help(struct ec_node *node, const char *help);

int ec_editline_set_callback(struct ec_node *node, ec_editline_command_cb_t cb);

int ec_editline_set_desc(struct ec_node *node, const char *desc);