mirror of
https://github.com/mruby/mruby
synced 2026-06-08 16:11:16 +00:00
Yukihiro "Matz" Matsumoto
624272b15d
Add syntax highlighting to mirb's multi-line editor with support for:
- keywords (def, if, class, end, etc.) in magenta
- strings ("...", '...', %q{...}) in green
- comments (#...) in gray
- numbers (42, 3.14, 0xff) in cyan
- symbols (:foo) in yellow
- constants (Array, Foo) in bold yellow
- instance variables (@var) in blue
- global variables ($var) in bold blue
Features:
- auto-detects light/dark theme via COLORFGBG env var
- MIRB_THEME=light/dark for explicit override
- method calls like obj.class correctly not highlighted as keywords
- enabled automatically when terminal supports color
Co-authored-by: Claude <noreply@anthropic.com>
154 lines
4.7 KiB
C
154 lines
4.7 KiB
C
/*
|
|
** mirb_editor.h - Multi-line editor for mirb
|
|
**
|
|
** See Copyright Notice in mruby.h
|
|
*/
|
|
|
|
#ifndef MIRB_EDITOR_H
|
|
#define MIRB_EDITOR_H
|
|
|
|
#include <mruby.h>
|
|
#include "mirb_term.h"
|
|
#include "mirb_buffer.h"
|
|
#include "mirb_history.h"
|
|
#include "mirb_highlight.h"
|
|
|
|
/*
|
|
* Editor result codes
|
|
*/
|
|
typedef enum mirb_edit_result {
|
|
MIRB_EDIT_OK = 0, /* Input ready (Enter pressed) */
|
|
MIRB_EDIT_CONTINUE, /* Need more input (multi-line) */
|
|
MIRB_EDIT_EOF, /* End of file (Ctrl+D on empty) */
|
|
MIRB_EDIT_INTERRUPT, /* Interrupted (Ctrl+C) */
|
|
MIRB_EDIT_ERROR /* Error occurred */
|
|
} mirb_edit_result;
|
|
|
|
/*
|
|
* Callback to check if input is complete
|
|
* Returns TRUE if the code is syntactically complete
|
|
*/
|
|
typedef mrb_bool mirb_check_complete_fn(const char *code, void *user_data);
|
|
|
|
/*
|
|
* Callback for tab completion
|
|
* Returns number of completions, sets completions_out and prefix_len_out
|
|
* Caller must free completions using mirb_tab_complete_free_fn
|
|
*/
|
|
typedef int mirb_tab_complete_fn(const char *line, int cursor_pos,
|
|
char ***completions_out, int *prefix_len_out,
|
|
void *user_data);
|
|
|
|
/*
|
|
* Callback to free tab completions
|
|
*/
|
|
typedef void mirb_tab_complete_free_fn(char **completions, int count, void *user_data);
|
|
|
|
/*
|
|
* Editor state
|
|
*/
|
|
typedef struct mirb_editor {
|
|
mirb_term term; /* terminal state */
|
|
mirb_buffer buf; /* editing buffer */
|
|
mirb_history hist; /* command history */
|
|
|
|
const char *prompt; /* primary prompt (e.g., "> ") */
|
|
const char *prompt_cont; /* continuation prompt (e.g., "* ") */
|
|
size_t prompt_len; /* length of primary prompt */
|
|
size_t prompt_cont_len; /* length of continuation prompt */
|
|
|
|
const char *prompt_fmt; /* prompt format string (e.g., "%d> ") */
|
|
const char *prompt_cont_fmt;/* continuation format (e.g., "%d* ") */
|
|
int line_num_base; /* starting line number for prompts */
|
|
|
|
mirb_check_complete_fn *check_complete; /* completion checker */
|
|
void *check_complete_data; /* user data for checker */
|
|
|
|
mirb_tab_complete_fn *tab_complete; /* tab completion callback */
|
|
mirb_tab_complete_free_fn *tab_complete_free; /* free completions callback */
|
|
void *tab_complete_data; /* user data for tab completion */
|
|
|
|
size_t display_cursor_row; /* cursor row in buffer (for refresh tracking) */
|
|
size_t prev_line_count; /* line count from last refresh */
|
|
|
|
mrb_bool initialized; /* editor is initialized */
|
|
mrb_bool use_color; /* use colored output */
|
|
|
|
mirb_highlighter highlight; /* syntax highlighting state */
|
|
} mirb_editor;
|
|
|
|
/*
|
|
* Initialize editor
|
|
* Returns TRUE on success
|
|
*/
|
|
mrb_bool mirb_editor_init(mirb_editor *ed);
|
|
|
|
/*
|
|
* Cleanup editor
|
|
*/
|
|
void mirb_editor_cleanup(mirb_editor *ed);
|
|
|
|
/*
|
|
* Set prompts (fixed strings)
|
|
*/
|
|
void mirb_editor_set_prompts(mirb_editor *ed,
|
|
const char *prompt,
|
|
const char *prompt_cont);
|
|
|
|
/*
|
|
* Set prompt format strings for line-numbered prompts
|
|
* Format strings should contain %d for line number (e.g., "%d> ", "%d* ")
|
|
* line_num is the starting line number
|
|
*/
|
|
void mirb_editor_set_prompt_format(mirb_editor *ed,
|
|
const char *prompt_fmt,
|
|
const char *prompt_cont_fmt,
|
|
int line_num);
|
|
|
|
/*
|
|
* Set completion checker callback
|
|
*/
|
|
void mirb_editor_set_check_complete(mirb_editor *ed,
|
|
mirb_check_complete_fn *fn,
|
|
void *user_data);
|
|
|
|
/*
|
|
* Set tab completion callbacks
|
|
*/
|
|
void mirb_editor_set_tab_complete(mirb_editor *ed,
|
|
mirb_tab_complete_fn *complete_fn,
|
|
mirb_tab_complete_free_fn *free_fn,
|
|
void *user_data);
|
|
|
|
/*
|
|
* Enable or disable colored output
|
|
*/
|
|
void mirb_editor_set_color(mirb_editor *ed, mrb_bool enable);
|
|
|
|
/*
|
|
* Check if multi-line editing is supported
|
|
*/
|
|
mrb_bool mirb_editor_supported(mirb_editor *ed);
|
|
|
|
/*
|
|
* Read input with multi-line editing
|
|
*
|
|
* Returns result code (OK, EOF, INTERRUPT, ERROR)
|
|
* On success (OK), caller must free the returned string
|
|
*/
|
|
mirb_edit_result mirb_editor_read(mirb_editor *ed, char **out_str);
|
|
|
|
/*
|
|
* Simple single-line input (fallback when raw mode not supported)
|
|
* Used internally but can be called directly
|
|
*/
|
|
mirb_edit_result mirb_editor_read_simple(mirb_editor *ed, char **out_str);
|
|
|
|
/*
|
|
* Add entry to history
|
|
* Called after successful command execution
|
|
*/
|
|
void mirb_editor_history_add(mirb_editor *ed, const char *entry);
|
|
|
|
#endif /* MIRB_EDITOR_H */
|