Module `LNoise`Source

OCaml bindings to linenoise, functions that can fail use result type

Sourcetype completions

Abstract type of completions, given to your completion callback

Sourceval add_completion : completions -> string -> unit

This function is used by the callback function registered by the user in order to add completion options given the input string when the user typed <TAB>.

Sourceval set_completion_callback : (string -> completions -> unit) -> unit

Sourceval linenoise : string -> string option

The high level function that is the main API of the linenoise library. This function checks if the terminal has basic capabilities, just checking for a blacklist of stupid terminals, and later either calls the line editing function or uses dummy fgets() so that you will be able to type something even in the most desperate of the conditions.

Sourceval history_add : string -> (unit, string) Result.result

Add a string to the history

Sourceval history_set : max_length:int -> (unit, string) Result.result

Set the maximum length for the history. This function can be called even if there is already some history, the function will make sure to retain just the latest 'len' elements if the new history length value is smaller than the amount of items already inside the history.

Sourceval history_save : filename:string -> (unit, string) Result.result

Save the history in the specified file

Sourceval history_load : filename:string -> (unit, string) Result.result

Load the history from the specified file.

Sourceval clear_screen : unit -> unit

Clear the screen; used to handle CTRL+L

Sourceval catch_break : bool -> unit

If true, ctrl-c during a call to linenoise will raise Sys.Break instead of returning an empty string.

since 1.1

Sourceval set_multiline : bool -> unit

Set if to use or not use the multi line mode.

Sourceval print_keycodes : unit -> unit

This special mode is used by linenoise in order to print scan codes on screen for debugging / development purposes.

Sourcetype hint_color =

| Red
| Green
| Yellow
| Blue
| Magenta
| Cyan
| White

What color you want the hints to be.

Source

val set_hints_callback : 
  (string -> (string * hint_color * bool) option) ->
  unit

Set a hints callback, callback gets a string, aka the line input, and you get a chance to give a hint to the user. Example, imagine if user types git remote add, then you can give a hint of <this is where you add a remote name> <this is where you add the remote's URL>, see animated gif in source repo for clear example. Returned tuple represents the hint message, color, and whether it ought to be bold.

package linenoise

Module LNoiseSource

Module `LNoise`Source