Simple, extendable, test-driven commandline editor written in ruby.
Features:
- **Intuitive interface**
- selecting via Shift+left/right/up/down and Ctrl+a(all)
- Tab -> indent / Shift+Tab -> unindent
- keeps indentation (+ paste-detection e.g. via Cmd+v)
- change (*) + writable (!) indicators
- find / go to line / delete line / search & replace
- configuration via `~/.ruco.rb`
- cut, copy and paste -> Ctrl+x/c/v
- undo / redo
- stays at last position when reopening a file
Install
=======
sudo gem install ruco
Usage
=====
ruco file.rb
Customize
=========
# ~/.ruco.rb
Ruco.configure do
# set options
options.window_line_scroll_offset = 5 # default 1
options.history_entries = 10 # default 100
...
# bind a key
# - you can use Integers and Symbols
# - use "ruco --debug-keys foo" to see which keys are possible
# - have a look at lib/ruco/keyboard.rb
bind(:"Ctrl+e") do
ask('foo') do |response|
if response == 'bar'
editor.insert('baz')
else
editor.move(:to, 0,0)
editor.delete(99999)
editor.insert('FAIL!')
end
end
end
# bind an existing action
puts @actions.keys
bind :"Ctrl+x", :quit
bind :"Ctrl+o", :save
bind :"Ctrl+k", :delete_line
# create reusable actions
action(:first){ editor.move(:to_column, 0) }
bind(:"Ctrl+a", :first)
bind(:home, :first)
end
TIPS
====
- [Tabs] Ruco does not like tabs. Existing tabs are displayed as ' ' and pressing tab inserts 2*' '
- [RVM] `alias r="rvm ree exec ruco"` and you only have to install ruco once
- [Ruby1.9] Unicode support -> install libncursesw5-dev before installing ruby (does not work for 1.8)
- [ssh vs clipboard] access your desktops clipboard by installing `xauth` on the server and then using `ssh -X`
- [Alt key] if Alt does not work try your Meta/Win/Cmd key
TODO
=====
- align soft-tabs
- strip whitespace after content / whitespace only lines, without removing intentional whitespace e.g. from markdown
- handle \\r and \\r\\n nicely <-> breaks curses output
- highlight tabs (e.g. strange character or reverse/underline/color)
- big warning when editing a not-writable file
- find next (Alt+n)
- add selection colors to forms in command_bar
- smart staying at column when changing line
- syntax highlighting
- raise when binding to a unsupported key
- search history via up/down arrow
- search options regex + case-sensitive
- add auto-confirm to 'replace?' dialog -> type s == skip, no enter needed
- 1.8: unicode support <-> already finished but unusable due to Curses (see encoding branch)
- support Alt+Fx keys
- (later) extract keyboard and html-style components into separate project
Author
======
[Michael Grosser](http://grosser.it)
grosser.michael@gmail.com
Hereby placed under public domain, do what you want, just do not hold me accountable...