Rails::Routes::Prettier
The rails-routes-prettier
gem makes it easy to view the routes in your Rails application. It converts the routes into a clear and readable format, making it simple to understand the structure of your application's routing. Whether you're a beginner or an experienced Rails developer, this gem is a valuable tool for navigating and understanding the routes in your application
Installation
Install the gem and add to the application's Gemfile by executing:
$ bundle add rails-routes-prettier
Or add the following line to the application's Gemfile:
gem 'rails-routes-prettier', github: 'nejdetkadir/rails-routes-prettier', branch: 'main'
If bundler is not being used to manage dependencies, install the gem by executing:
gem install rails-routes-prettier
Usage
To view the routes in your application, you can use the following code:
Rails::Routes::Prettier.all
# => [#<Route name: 'root', verb: 'GET', path: '/', controller: 'SwaggerController', action: 'index' req_options: {}>, ...]
This will display all of the routes in your application in a clean and readable format. You can also search for routes by certain fields using the following methods:
-
find_by_name
: Searches for routes by name. -
find_by_verb
: Searches for routes by HTTP verb. -
find_by_path
: Searches for routes by path. -
find_by_req_options
: Searches for routes by requirements options. -
find_by_controller
: Searches for routes by controller. -
find_by_action
: Searches for routes by action.
For example, you can search for a route with the verb GET
by using the following code:
Rails::Routes::Prettier.find_by_verb('GET')
# => [#<Route name: 'root', verb: 'GET', path: '/', controller: 'SwaggerController', action: 'index' req_options: {}>, ...]
Development
After checking out the repo, run bin/setup
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.
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 the created tag, and push the .gem
file to rubygems.org.
Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/nejdetkadir/rails-routes-prettier. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
License
The gem is available as open source under the terms of the MIT License.
Code of Conduct
Everyone interacting in the Rails::Routes::Prettier project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.