amun
A minimal CLI text editor, built on Ruby, looking for Emacs as it's father and idol.
Amun (Work in progress)
“King of the gods and god of the wind”
A minimal CLI text editor, built on Ruby, looking for Emacs as it’s father and idol.
As developing packages for Emacs with Elisp wasn’t always a fun or easy task, Starting a project that leverage ruby ability for fast development will be a good move towards an open, easy to extend editor.
When I started this project I had 2 options, taking the VIM way or emacs way, looking in the current state of the two editors, It’s obvious that emacs approach has a better extensibility over VIM, emacs customizability is far superior to VIM, so building this project as a minimal and emacs-like would open the door for vim users to have their own bindings as a package like emacs Evil mode, but doing the other way around won’t help emacs users.
Advantages of building an editor in ruby
- We can use ruby gems as package management
- we already have bundler to fix dependencies, upgrade, downgrade gems (plugins in this case), you can even add sources for gems or get a gem from github or company inhouse gems.
- you can reflect on the runtime and autocomplete commands
- plugins can mutate all parts of the runtime application classes/objects included
- ruby is easy to learn so it’ll be easier to build gems that is specifically for this editor
- lots of gems already exists and could be loaded into the editor environment
- you can use it locally or remotly as it’s terminal based
- documentation included, rdoc is already there to be used
Installation
$ gem install amun
Usage
amun install an executable to your path, so executing amun from your command-line should launch amun
Structure
Helpers
Helpers are modules that any class can use to do side tasks, think of it like Ruby on rails helpers.
- Only modules no classes
- doesn’t depend on each other
- depends on the project dependencies only like “Curses”
MajorModes
Classes that are responsible the following for a buffer object:
- event handling
- manipulating IO
- Rendering IO into a curses window
Development
After checking out the repo, run bundle install to install dependencies. Then, run rake test to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
Tests
guard file will run rspec tests whenever a relevant file changes
$ guard
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/emad-elsaid/amun.
License
The gem is available as open source under the terms of the MIT License.