callumenator / dabble

A repl for the D programming language
32 stars 6 forks source link

Dabble

A repl for the D programming language (Windows and Linux). Tested on Win 7, Arch Linux 32 and 64 bit.

Note

This repl is not sandboxed in any way - use it at your own risk.

Getting started:

You will need to have the Digital Mars D compiler installed and on your executable path.

  1. Get DUB (currently requires git-head): http://registry.vibed.org/download

  2. Get, build and run dabble:

    git clone https://github.com/callumenator/dabble
    cd dabble
    git submodule update --init --recursive
    dub run

How it works

(The idea for this comes from http://neugierig.org/software/c-repl/).

User input is minimally parsed to search for declarations (new variables, classes, structs, enums, aliases).

Variable declarations are replaced by code which places the variables on the heap, and references to existing variables are redirected to point at these heap copies. User type declarations and functions are extracted verbatim to be placed at module scope. All other statements are placed inside a dummy main function.

The parsed/modified code is then written to a temporary .d file, and compiled into a shared library. If compilation succeeds, the library is loaded into memory, and the dummy main function is called. Some attempt is made to catch exceptions thrown inside the user's code, for example to trap range violations.

If the user's code resulted in a value, that value is printed to the screen. Else, 'OK' is printed to indicate success. The loop then continues.

Read-eval-print latency is usually acceptable, since DMD compiles simple code blazingly fast.

Meta Commands

Meta commands are intercepted by the REPL environment and interpreted directly. They do not trigger compilation. The following list of commands are recognized. (Arguments enclosed in square brakets [] are optional, those in angle brackets <> indicate a choice.)

print

print [expression]

If expression is omitted, prints a list of all currently defined variables, along with their types and values. If expression is provided, it should be a comma separated list of sub-expressions, for example:

print a - prints the value of variable 'a'

print a.b - if 'a' is an aggregate, prints the value of member 'b'

print a[4] - if 'a' is an array, and index 4 is within it's array bounds, prints value at index 4

print *a - if 'a' is a pointer, and is not null, prints the value pointed to by 'a'

print cast(MyType)a - if 'MyType' is a known type, prints 'a' interpreted as MyType

More complex combinations of the above are also accepted, for example:

print ((cast(MyType)*a).b[3]).d - cast the value pointed to by 'a' to MyType, access index 3 of member 'b', print the value of member 'd'

type

type expression

This command is identical to the print command, however instead of outputting a value, information on the type is output. E.g.:

type *a.b[2] - print the type of the pointer target of index 2 of member 'b' of 'a'

delete

delete var1 [, var2, var3, ...]

Delete each of the variables named in the comma separated list. This allows you to re-use those identifiers for new variables.

use (currently windows only)

use module_filename

This command is used to include user modules in the compilation step. It allows you to reference type and function definitions, and call functions, in the user module. Note that this only set's the module up to be included in compilation - you will still need to import the module in your REPL session. If the used module contains other dependencies, these will also need to be use'd.

reset session

reset session

Clear all variables and definitions, remove all imports. Bascially reset the REPL to a clean state.

clear

clear [buffer]

Clear without arguments will clear the command console screen. If the buffer argument is supplied, the code input buffer will be cleared. This is useful if you make a mistake during multi-line input, and need to clear the current input.

debug

debug <on / off> <parseOnly / stages / times >

Turn on or off debug switches.

Issues: