readline.c 11.2 KB
Newer Older
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
/*
 * This file is part of the Micro Python project, http://micropython.org/
 *
 * The MIT License (MIT)
 *
 * Copyright (c) 2013, 2014 Damien P. George
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

27
#include <stdio.h>
Dave Hylands's avatar
Dave Hylands committed
28
#include <stdint.h>
29
30
#include <string.h>

31
#include "py/mpstate.h"
32
#include "py/repl.h"
33
#include "readline.h"
34
#ifdef MICROPY_HAL_H
35
#include MICROPY_HAL_H
36
#endif
37

38
39
40
41
42
43
44
#if 0 // print debugging info
#define DEBUG_PRINT (1)
#define DEBUG_printf printf
#else // don't print debugging info
#define DEBUG_printf(...) (void)0
#endif

45
#define READLINE_HIST_SIZE (MP_ARRAY_SIZE(MP_STATE_PORT(readline_hist)))
46

47
enum { ESEQ_NONE, ESEQ_ESC, ESEQ_ESC_BRACKET, ESEQ_ESC_BRACKET_DIGIT, ESEQ_ESC_O };
48

49
void readline_init0(void) {
50
    memset(MP_STATE_PORT(readline_hist), 0, READLINE_HIST_SIZE * sizeof(const char*));
51
52
}

53
STATIC char *str_dup_maybe(const char *str) {
54
    uint32_t len = strlen(str);
55
56
57
58
59
    char *s2 = m_new_maybe(char, len + 1);
    if (s2 == NULL) {
        return NULL;
    }
    memcpy(s2, str, len + 1);
60
61
62
    return s2;
}

63
64
65
STATIC void move_cursor_back(uint pos) {
    if (pos <= 4) {
        // fast path for most common case of 1 step back
66
        mp_hal_stdout_tx_strn("\b\b\b\b", pos);
67
68
69
70
71
72
    } else {
        char vt100_command[6];
        // snprintf needs space for the terminating null character
        int n = snprintf(&vt100_command[0], sizeof(vt100_command), "\x1b[%u", pos);
        if (n > 0) {
            vt100_command[n] = 'D'; // replace null char
73
            mp_hal_stdout_tx_strn(vt100_command, n + 1);
74
75
76
77
78
        }
    }
}

STATIC void erase_line_from_cursor(void) {
79
    mp_hal_stdout_tx_strn("\x1b[K", 3);
80
81
}

82
83
typedef struct _readline_t {
    vstr_t *line;
84
    size_t orig_line_len;
85
86
    int escape_seq;
    int hist_cur;
87
    size_t cursor_pos;
88
    char escape_seq_buf[1];
89
    const char *prompt;
90
91
} readline_t;

92
STATIC readline_t rl;
93
94

int readline_process_char(int c) {
95
    size_t last_line_len = rl.line->len;
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
    int redraw_step_back = 0;
    bool redraw_from_cursor = false;
    int redraw_step_forward = 0;
    if (rl.escape_seq == ESEQ_NONE) {
        if (CHAR_CTRL_A <= c && c <= CHAR_CTRL_D && vstr_len(rl.line) == rl.orig_line_len) {
            // control character with empty line
            return c;
        } else if (c == CHAR_CTRL_A) {
            // CTRL-A with non-empty line is go-to-start-of-line
            goto home_key;
        } else if (c == CHAR_CTRL_C) {
            // CTRL-C with non-empty line is cancel
            return c;
        } else if (c == CHAR_CTRL_E) {
            // CTRL-E is go-to-end-of-line
            goto end_key;
        } else if (c == '\r') {
            // newline
114
            mp_hal_stdout_tx_str("\r\n");
115
            readline_push_history(vstr_null_terminated_str(rl.line) + rl.orig_line_len);
116
117
118
119
120
121
122
123
            return 0;
        } else if (c == 27) {
            // escape sequence
            rl.escape_seq = ESEQ_ESC;
        } else if (c == 8 || c == 127) {
            // backspace/delete
            if (rl.cursor_pos > rl.orig_line_len) {
                vstr_cut_out_bytes(rl.line, rl.cursor_pos - 1, 1);
124
                // set redraw parameters
125
                redraw_step_back = 1;
126
127
                redraw_from_cursor = true;
            }
128
129
130
131
132
133
134
135
136
137
138
139
140
141
        #if MICROPY_HELPER_REPL
        } else if (c == 9) {
            // tab magic
            const char *compl_str;
            mp_uint_t compl_len = mp_repl_autocomplete(rl.line->buf + rl.orig_line_len, rl.cursor_pos - rl.orig_line_len, &mp_plat_print, &compl_str);
            if (compl_len == 0) {
                // no match
            } else if (compl_len == (mp_uint_t)(-1)) {
                // many matches
                mp_hal_stdout_tx_str(rl.prompt);
                mp_hal_stdout_tx_strn(rl.line->buf + rl.orig_line_len, rl.cursor_pos - rl.orig_line_len);
                redraw_from_cursor = true;
            } else {
                // one match
142
                for (mp_uint_t i = 0; i < compl_len; ++i) {
143
144
145
146
147
148
149
                    vstr_ins_byte(rl.line, rl.cursor_pos + i, *compl_str++);
                }
                // set redraw parameters
                redraw_from_cursor = true;
                redraw_step_forward = compl_len;
            }
        #endif
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
        } else if (32 <= c && c <= 126) {
            // printable character
            vstr_ins_char(rl.line, rl.cursor_pos, c);
            // set redraw parameters
            redraw_from_cursor = true;
            redraw_step_forward = 1;
        }
    } else if (rl.escape_seq == ESEQ_ESC) {
        switch (c) {
            case '[':
                rl.escape_seq = ESEQ_ESC_BRACKET;
                break;
            case 'O':
                rl.escape_seq = ESEQ_ESC_O;
                break;
            default:
                DEBUG_printf("(ESC %d)", c);
                rl.escape_seq = ESEQ_NONE;
        }
    } else if (rl.escape_seq == ESEQ_ESC_BRACKET) {
        if ('0' <= c && c <= '9') {
            rl.escape_seq = ESEQ_ESC_BRACKET_DIGIT;
            rl.escape_seq_buf[0] = c;
        } else {
            rl.escape_seq = ESEQ_NONE;
            if (c == 'A') {
                // up arrow
177
                if (rl.hist_cur + 1 < (int)READLINE_HIST_SIZE && MP_STATE_PORT(readline_hist)[rl.hist_cur + 1] != NULL) {
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
                    // increase hist num
                    rl.hist_cur += 1;
                    // set line to history
                    rl.line->len = rl.orig_line_len;
                    vstr_add_str(rl.line, MP_STATE_PORT(readline_hist)[rl.hist_cur]);
                    // set redraw parameters
                    redraw_step_back = rl.cursor_pos - rl.orig_line_len;
                    redraw_from_cursor = true;
                    redraw_step_forward = rl.line->len - rl.orig_line_len;
                }
            } else if (c == 'B') {
                // down arrow
                if (rl.hist_cur >= 0) {
                    // decrease hist num
                    rl.hist_cur -= 1;
                    // set line to history
                    vstr_cut_tail_bytes(rl.line, rl.line->len - rl.orig_line_len);
                    if (rl.hist_cur >= 0) {
                        vstr_add_str(rl.line, MP_STATE_PORT(readline_hist)[rl.hist_cur]);
197
                    }
198
199
200
201
202
203
204
205
206
207
208
209
210
211
                    // set redraw parameters
                    redraw_step_back = rl.cursor_pos - rl.orig_line_len;
                    redraw_from_cursor = true;
                    redraw_step_forward = rl.line->len - rl.orig_line_len;
                }
            } else if (c == 'C') {
                // right arrow
                if (rl.cursor_pos < rl.line->len) {
                    redraw_step_forward = 1;
                }
            } else if (c == 'D') {
                // left arrow
                if (rl.cursor_pos > rl.orig_line_len) {
                    redraw_step_back = 1;
212
                }
213
214
215
216
217
218
219
220
            } else if (c == 'H') {
                // home
                goto home_key;
            } else if (c == 'F') {
                // end
                goto end_key;
            } else {
                DEBUG_printf("(ESC [ %d)", c);
221
            }
222
223
224
225
        }
    } else if (rl.escape_seq == ESEQ_ESC_BRACKET_DIGIT) {
        if (c == '~') {
            if (rl.escape_seq_buf[0] == '1' || rl.escape_seq_buf[0] == '7') {
226
home_key:
227
228
                redraw_step_back = rl.cursor_pos - rl.orig_line_len;
            } else if (rl.escape_seq_buf[0] == '4' || rl.escape_seq_buf[0] == '8') {
229
end_key:
230
                redraw_step_forward = rl.line->len - rl.cursor_pos;
231
            } else {
232
                DEBUG_printf("(ESC [ %c %d)", rl.escape_seq_buf[0], c);
233
            }
234
        } else {
235
            DEBUG_printf("(ESC [ %c %d)", rl.escape_seq_buf[0], c);
236
        }
237
238
239
240
241
242
243
244
245
246
247
248
249
250
        rl.escape_seq = ESEQ_NONE;
    } else if (rl.escape_seq == ESEQ_ESC_O) {
        switch (c) {
            case 'H':
                goto home_key;
            case 'F':
                goto end_key;
            default:
                DEBUG_printf("(ESC O %d)", c);
                rl.escape_seq = ESEQ_NONE;
        }
    } else {
        rl.escape_seq = ESEQ_NONE;
    }
251

252
253
    // redraw command prompt, efficiently
    if (redraw_step_back > 0) {
254
        move_cursor_back(redraw_step_back);
255
256
257
258
259
        rl.cursor_pos -= redraw_step_back;
    }
    if (redraw_from_cursor) {
        if (rl.line->len < last_line_len) {
            // erase old chars
260
261
            // (number of chars to erase: last_line_len - rl.cursor_pos)
            erase_line_from_cursor();
262
263
        }
        // draw new chars
264
        mp_hal_stdout_tx_strn(rl.line->buf + rl.cursor_pos, rl.line->len - rl.cursor_pos);
265
        // move cursor forward if needed (already moved forward by length of line, so move it back)
266
        move_cursor_back(rl.line->len - (rl.cursor_pos + redraw_step_forward));
267
268
269
        rl.cursor_pos += redraw_step_forward;
    } else if (redraw_step_forward > 0) {
        // draw over old chars to move cursor forwards
270
        mp_hal_stdout_tx_strn(rl.line->buf + rl.cursor_pos, redraw_step_forward);
271
272
273
274
275
276
        rl.cursor_pos += redraw_step_forward;
    }

    return -1;
}

277
void readline_note_newline(const char *prompt) {
278
279
    rl.orig_line_len = rl.line->len;
    rl.cursor_pos = rl.orig_line_len;
280
281
    rl.prompt = prompt;
    mp_hal_stdout_tx_str(prompt);
282
283
}

284
void readline_init(vstr_t *line, const char *prompt) {
285
286
287
288
289
290
    rl.line = line;
    rl.orig_line_len = line->len;
    rl.escape_seq = ESEQ_NONE;
    rl.escape_seq_buf[0] = 0;
    rl.hist_cur = -1;
    rl.cursor_pos = rl.orig_line_len;
291
292
    rl.prompt = prompt;
    mp_hal_stdout_tx_str(prompt);
293
294
295
}

int readline(vstr_t *line, const char *prompt) {
296
    readline_init(line, prompt);
297
    for (;;) {
298
        int c = mp_hal_stdin_rx_chr();
299
300
301
        int r = readline_process_char(c);
        if (r >= 0) {
            return r;
302
303
304
        }
    }
}
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320

void readline_push_history(const char *line) {
    if (line[0] != '\0'
        && (MP_STATE_PORT(readline_hist)[0] == NULL
            || strcmp(MP_STATE_PORT(readline_hist)[0], line) != 0)) {
        // a line which is not empty and different from the last one
        // so update the history
        char *most_recent_hist = str_dup_maybe(line);
        if (most_recent_hist != NULL) {
            for (int i = READLINE_HIST_SIZE - 1; i > 0; i--) {
                MP_STATE_PORT(readline_hist)[i] = MP_STATE_PORT(readline_hist)[i - 1];
            }
            MP_STATE_PORT(readline_hist)[0] = most_recent_hist;
        }
    }
}