Project

coolline

0.12
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
A readline-like library that allows to change how the input is displayed.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0

Runtime

 Project Readme

Coolline

Coolline is a readline-like library written in pure Ruby.

It offers all of the core readline features, but with a cleaner, simpler implementation, and the ability to easily customize its behaviour.

Customizations include: modifying all key bindings, binding keys custom functions, full control over history and tab completion, and control over what's displayed to the user (transforms).

Usage

If you don't need anything fancy, it can work like Ruby's built-in Readline.readline:

result = Coolline.readline

But, of course you want something fancy, otherwise you'd be using readline! Here's how to create a simple REPL with live syntax highlighting and tab completion:

require 'coolline'
require 'coderay'
require 'pp'

cool = Coolline.new do |c|

  # Before the line is displayed, it gets passed through this proc,
  # which performs syntax highlighting.
  c.transform_proc = proc do
    CodeRay.scan(c.line, :ruby).term
  end

  # Add tab completion for constants (and classes)
  c.completion_proc = proc do
    word = c.completed_word
    Object.constants.map(&:to_s).select { |w| w.start_with? word }
  end

  # Alt-R should reverse the line, because we like to look at our code in the mirror
  c.bind "\er" do |cool|
    cool.line.reverse!
  end

end

loop do
  # READ
  line = cool.readline

  # EVAL
  obj = eval(line)

  # PRINT
  print "=> "
  pp obj

  # LOOP
end

Configuration

Coolline automatically loads a config file before starting, which allows adding new key bindings to it. The file is just a chunk of arbitrary ruby code located at $XDG_CONFIG_HOME/coolline/coolline.rb.

Coolline.bind "\C-z" do |cool|
  puts "Testing key binding with #{cool}!"
end

Installation

gem install coolline

Note: If your Ruby version is less than 1.9.3, you also need to install the io-console gem.