Consider pair of typical Rails models like this:
rails g model Author lastname:string firstnames:string rails g model Book title:string isbn:string author:belongs_to
class Author < ApplicationRecord has_many :books def sortable_name "#{lastname}, #{firstnames}" end end class Book < ApplicationRecord belongs_to :author def label [author.sortable_name, title, isbn].join("\n") end end
The various Ruby intellisense tools are ok at knowing that there are Book
and Author
constants, and some (including Solargraph) are aware that objects like Book.new
have a .label
method. But what about those "magical" dynamic methods that ActiveRecord creates like .title
, or .author
?
Since these attributes are only created at runtime, a simple static analysis of the Book
class alone can't identify them. Your editor has no idea that these attributes exist, but they're amongst the most common things that you will work with in any Rails app.
That's where this plugin for Solargraph comes in: it understands db/schema.rb and any comments from the annotate_models gem for models, and also supplies key annotations and Rails-specific context on top of what Solargraph pulls via YARD and RBS. As a result, you have access to database attributes:
... and ActiveRecord finders:
... and associations:
... and routes file syntax:
and more!
Installsolargraph
and solargraph-rails
If you add them to your Gemfile, you'll have to tell your IDE plugin to use bundler to load the right version of solargraph.
Use gem_rbs_collection to install RBS types for Rails:
rbs collection init rbs collection installAdd
solargraph-rails
to your .solargraph.yml
(if you don't have a .solargraph.yml
in your project root, you can run solargraph config
to add one)
plugins:
- solargraph-rails
In the project root, run yard gems
.
Bug reports and pull requests are welcome on GitHub at https://github.com/iftheshoefritz/solargraph_rails.
create fork and clone the repo
install gem deps bundle install
install dummy rails app deps:
cd spec/rails7 && bundle install && rbs collection init && rbs collection install && cd ../../
cd spec/rails8 && bundle install && rbs collection init && rbs collection install && cd ../../
now tests should pass locally and you can try different changes
submit PR
See DEVELOPMENT.md for more information
The gem is available as open source under the terms of the MIT License.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4