Skip to content
Program allowing for smart jump-to-definitions, autocompletion, constant renaming and more.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
exe
lib
script
spec
.gitignore
.rspec
CHANGELOG.md
Gemfile
Gemfile.lock
LICENSE
Makefile
README.md
circle.yml
index.html
orbacle.gemspec

README.md

Orbacle

Orbacle logo

Language server using engine allowing for smart jump-to-definitions, understanding metaprogramming definitions, refactoring and more.

Doing as MSc thesis for Institute of Computer Science, University of Wrocław.

Objectives

Create a language server for ruby, which can be used across different code editors, like Vim, Emacs or Atom. Focus on understanding of the code in order to provide best functionalities of "go-to definition", autocompletion and refactorings. The idea is to infer information about variables (i.e. their "types"), without requiring developer to write any annotations, just like IDEs do that - through static analysis.

Current status

Currently language server supports:

Hover request

Information about "type" of an expression

Jump to definition

Works in following cases:

  • used on constant -> jump to constant definition
  • used on method call -> jump to definition of that method
  • used on super keyword -> jump to the definition of method from the parent class (doesn't respect include / prepend yet)

V i d e o

vokoscreen-2018-08-01_21-38-46

Setup

Prerequisite indexing

  1. Install orbacle gem.
  2. Run orbaclerun -d <your_project_directory> index

It will show you how long does it take to index your project, i.e. how long do you have to wait after editor start to have language server functional underneath.

Vim

Using vim-plug:

Plug 'autozimu/LanguageClient-neovim', { 'branch': 'next', 'do': 'bash install.sh' }

let g:LanguageClient_serverCommands = {
  \ 'ruby': ['orbaclerun', 'file-server'],
  \ }
nnoremap <localleader>lj :call LanguageClient_textDocument_definition()<CR>
nnoremap T :call LanguageClient_textDocument_hover()<CR>
" timeout has to be bigger than time needed to index your project
let g:LanguageClient_waitOutputTimeout = 240

Contributing

Currently I do not accept contributions, as this is part of MSc thesis. However features ideas and bug reports are accepted.

Support

If you have found a bug, feel free to create an issue. However, because of the fact that I'm focusing now more on the features required to MSc, support for other developers are lower priority for me.

Code status

CircleCI Gem Version

Bibliography

  • Tern
  • Fast Interprocedural Class Analysis, Greg DeFouw, David Grove, Craig Chambers, July 1997
You can’t perform that action at this time.