Back-and-forths from your editor and your rails console is a thing of the past!
Inspired by the Go playground and SQL Server Management Studio (SSMS) Query Editor, rails-playground
is a rails engine that eases experiments with your application domain.
The gem also comes with a script management tool to help share useful scripts with your teammates. Shared scripts stay close to the code and become more maintainable while personal scripts are git ignored and don't pollute the git history.
There are three ways to run ruby code in the console:
- Select your code in the editor and press cmd+Enter
- Put your cursor on any line (no selection) and press cmd+Enter
- Type your code straight in the terminal box just like in a rails console
Any files under lib/playground
folder will appear in the sidebar. You can filter them by name from the search input.
See Ignoring personal scripts to share scripts with your team while ignoring personal scripts.
Playground is built on top of web-console
gem. Just like web-console
, it's only meant to be used in development. Every web-console
information still holds for rails-playground
. Check web-console
repository for more information
Add this line to your application's Gemfile under the development group:
group :development do
gem "rails-playground", require: "playground"
end
Naming issue: The gem was originally called playground
but it already exists in RubyGems... Thus the gem is now called rails-playground
but the functionality remains under the playground
namespace for now.
And then execute:
$ bundle
Finally, mount the engine in your routes file and access the web playground at /playground
on your localhost.
Rails.application.routes.draw do
mount Playground::Engine => "/playground" if Rails.env.development?
# ...
end
Nothing stops you from choosing any relative path. For example, you could switch from /playground
to /rails/play
.
Any changes made to ignored scripts won't be recorded in your git history.
Adding a folder from lib/playground in .gitignore
will, however, still show in the sidebar.
Decide on a convention with your teammates and commit the path to your .gitignore
.
Example
Here is an example of file structure
- scripts version controlled
- lib/playground/shared_script_a.rb
- lib/playground/shared_script_b.rb
- lib/playground/namespace/shared_script_c.rb
- scripts ignored
- lib/playground/my_scripts/my_script_a.rb
- lib/playground/my_scripts/my_script_b.rb
.gitignore
/lib/playground/my_scripts/
my_app/
├─ app/
├─ bin/
├─ config/
├─ db/
├─ lib/
│ ├─ playground/
│ │ ├─ namespace/
│ │ │ ├─ shared_script_c.rb
│ │ ├─ my_scripts/
│ │ │ ├─ my_script_a.rb
│ │ │ ├─ my_script_b.rb
│ │ ├─ shared_script_a.rb
│ │ ├─ shared_script_b.rb
├─ .gitignore
Example:
Session e96248aec85b3006488c276b9468a4d8 is no longer available in memory.
If you happen to run on a multi-process server (like Unicorn or Puma) the process
this request hit doesn't store e96248aec85b3006488c276b9468a4d8 in memory. Consider turning the number of
processes/workers to one (1) or using a different server in development.
This is a known web-console
error that happens when you run a multi-threaded server locally.
To solve this problem make sure to set the number of processes/worker to 1 on your local server.
The gem is available as open source under the terms of the MIT License.