mirror of https://github.com/mruby/mruby synced 2026-06-08 16:11:16 +00:00

Files

T

Yukihiro "Matz" Matsumoto 624272b15d mruby-bin-mirb: add syntax highlighting for keywords and strings

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>

2025-12-29 11:56:58 +09:00

bintest

class.c (mrb_method_missing): add receiver's class to clarify

2024-11-15 15:13:24 +09:00

tools/mirb

mruby-bin-mirb: add syntax highlighting for keywords and strings

2025-12-29 11:56:58 +09:00

mrbgem.rake

mruby-bin-mirb: replace readline with custom multi-line editor

2025-12-11 18:09:10 +09:00

README.md

mruby-bin-mirb: add README with tab completion documentation

2025-12-11 18:09:10 +09:00

README.md

mruby-bin-mirb

mirb (mruby interactive) is an interactive Ruby shell for mruby.

Usage

mirb [options]

Options

-v - print version and exit
-d - set $DEBUG to true
-r library - load the library before executing
--verbose - verbose mode

Tab Completion

mirb supports context-aware tab completion when built with a readline library.

Supported Completions

Methods on objects: Type an expression followed by . and press Tab
```
> "hello".up<Tab>
upcase  upcase!  upto
```
Local variables: Variables defined in the session
```
> my_var = 123
> my<Tab>
my_var
```
Global variables: Press Tab after $
```
> $std<Tab>
$stdout  $stderr  $stdin
```
Constants and classes: Capital letter followed by Tab
```
> Str<Tab>
String  Struct
```
Ruby keywords: At the start of expressions
```
> cla<Tab>
class
```

Readline Library Support

Tab completion works with:

GNU readline (default on Linux)
libedit (default on macOS/BSD)
linenoise (lightweight alternative)

Configuration

The readline library can be configured via the MRUBY_MIRB_READLINE environment variable:

# Auto-detect (default)
rake

# Force specific library
MRUBY_MIRB_READLINE=readline rake    # GNU readline
MRUBY_MIRB_READLINE=libedit rake     # libedit
MRUBY_MIRB_READLINE=linenoise rake   # linenoise

# Disable readline (plain input mode)
MRUBY_MIRB_READLINE=none rake

Notes

Completion evaluates receiver expressions to determine available methods
Only simple receivers (variable names, constants) are evaluated for safety
Complex expressions like obj.method(). are not completed to avoid side effects
File path completion in require/load statements is planned for future versions

License

MIT License - see the mruby LICENSE file.