aboutsummaryrefslogtreecommitdiff
path: root/src/console.h
blob: d8d270daf7b17de1ac782c25160deba245d2103e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
#ifndef IMV_CONSOLE
#define IMV_CONSOLE

#include <stdbool.h>
#include <unistd.h>

struct imv_console;

/* Create a console instance */
struct imv_console *imv_console_create(void);

/* Clean up a console */
void imv_console_free(struct imv_console *console);

/* Set the callback to be invoked when a command to run by the console */
typedef void (*imv_console_callback)(const char *command, void *data);
void imv_console_set_command_callback(struct imv_console *console,
    imv_console_callback callback, void *data);

/* Returns true if console is still active (i.e. user hasn't hit enter/escape yet */
bool imv_console_is_active(struct imv_console *console);

/* Mark console as activated until user exits or submits a command */
void imv_console_activate(struct imv_console *console);

/* Pass text input to the console */
void imv_console_input(struct imv_console *console, const char *text);

/* Pass a key input to the console. Returns true if consumed. If so,
 * do not also send input text to the console.
 */
bool imv_console_key(struct imv_console *console, const char *key);

/* What is the console prompt's current text? */
const char *imv_console_prompt(struct imv_console *console);

/* What is the console prompt's current cursor position? (bytes into UTF-8 string) */
size_t imv_console_prompt_cursor(struct imv_console *console);

/* What is the output history of the console? */
const char *imv_console_backlog(struct imv_console *console);

/* Write some text to the console's backlog */
void imv_console_write(struct imv_console *console, const char *text);

/* Add a tab-completion template. If the users hits tab, the rest of the
 * command will be suggested. If multiple matches, tab will cycle through them.
 */
void imv_console_add_completion(struct imv_console *console, const char *template);

#endif