Yoda is a Language Server (http://langserver.org/) for Ruby. Yoda infers signatures of your Ruby program and its dependencies from various data sources (RBS and YARD documentation) and provides autocompletion and code analysis (go-to-definition, code information, etc...).
Note: Yoda is alpha version. Please use with caution. Contributions are welcome!
Yoda provides these features by analyzing Ruby code and its dependencies in Gemfile.lock with YARD.
- Code completion (method, constant, variables, etc...)
- Comment completion (YARD tag, types)
- Hover code information (method, constant, etc...)
- Go to definition (method, constant, require file, etc...)
Yoda can be available as VSCode extension at: https://marketplace.visualstudio.com/items?itemName=tomoasleep.yoda On launch of VSCode, Yoda will be installed automatically.
Yoda is hosted on RubyGems.
gem install yoda-language-server
See Instation of Editor Plugin section to install Yoda on your editor.
Yoda can be also used as a cli tool.
$ yoda setup # You must run this command first for your each project.
$ yoda infer path-to-your-code:line_num:char_num # Show information of the code at the specified position.
$ yoda complete <path-to-your-code>:<line-num>:<char-num> # Show completion at the specified position.
apm install tomoasleep/yoda
rake vscode:install
Please use language server client such as LanguageClient-neovim. Here is a configuration example for LanguageClient-neovim.
let g:LanguageClient_serverCommands = {
\ 'ruby': ['yoda', 'server'],
\ }TBW
Yoda figures structures of your source codes and library codes with YARD.
Yoda intepret YARD tags such as @return tags and @param tags and infer code types from these information.
Yoda built index files for fast inference under <your-project-dir>/.yoda at startup.
These index files contains structures of external sources (gems and standard libraries).
Your project codes are parsed at startup but does not stored in indexes.
After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to rubygems.org.
Bug reports and pull requests are welcome on GitHub at https://github.com/tomoasleep/yoda.
The gem is available as open source under the terms of the MIT License.