nestive 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+.rvmrc
+doc
+.yardoc
+pkg

data/.yardopts

@@ -0,0 +1,8 @@
+--no-private
+--markup markdown
+--title "Nestive — Nested Layouts Plugin for Rails"
+--main "README.md"
+--files MIT-LICENSE
+--no-highlight
+app/**/*.rb 
+lib/**/*.rb

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify dependencies in nestive.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,78 @@
+PATH
+  remote: .
+  specs:
+    nestive (0.0.1.pre)
+      rails (~> 3.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    actionmailer (3.0.7)
+      actionpack (= 3.0.7)
+      mail (~> 2.2.15)
+    actionpack (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-mount (~> 0.6.14)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+    activesupport (3.0.7)
+    arel (2.0.10)
+    builder (2.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    i18n (0.5.0)
+    mail (2.2.19)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    polyglot (0.3.1)
+    rack (1.2.3)
+    rack-mount (0.6.14)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rails (3.0.7)
+      actionmailer (= 3.0.7)
+      actionpack (= 3.0.7)
+      activerecord (= 3.0.7)
+      activeresource (= 3.0.7)
+      activesupport (= 3.0.7)
+      bundler (~> 1.0)
+      railties (= 3.0.7)
+    railties (3.0.7)
+      actionpack (= 3.0.7)
+      activesupport (= 3.0.7)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+    rake (0.9.0)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.27)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  nestive!
+  rails (~> 3.0)

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Justin French
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,199 @@
+# Nestive, A Nested Inheritable Layouts Plugin for Rails
+
+**Note: This is ridiculously alpha proof-of-concept seeking feedback. Things will change.**
+
+Nestive adds powerful layout and view helpers to your Rails app. It's similar to the nested layout technique [already documented in the Rails guides](http://guides.rubyonrails.org/layouts_and_rendering.html#using-nested-layouts) and found in many other nested layout plugins (a technique using `content_for` and rendering the parent layout at the end of the child layout). There's a bunch of problems with this technique, including:
+
+* you can only *append* content to the content buffer with `content_for` (you can't prepend to content, you can't replace it)
+* when combined with this nested layout technique, `content_for` actually *prepends* new content to the buffer, because each parent layout is rendered *after* it's child
+
+Nestive is *better* because it addresses these problems.
+
+## Just five methods (so far) – `area`, `extend`, `append`, `prepend`, `replace`.
+
+### Declaring an area of content in your parent layout with `area`:
+
+The `area` helper is a lot like Rails' own `<%= yield :foo %>`, and is used in layouts to define and render a chunk of content in your layout:
+
+    <%= area :sidebar %>
+    
+Unlike `yield`, `area` will allow your parent layouts to add content to the area at the same time using either a String or a block:
+
+    <%= area :sidebar, "Some Content Here" %>
+
+    <%= area :sidebar do %>
+      Some Content Here
+    <% end %>
+    
+It's important to note that this isn't *default* content, it *is* the content (unless a child changes it).
+
+### Extending a layout in a child layout (or view):
+
+Any layout (or view) can declare that it wants to inherit from and extend a parent layout, in this case we're extending `app/views/layouts/application.html.erb`:
+
+    <%= extends :application do %>
+       ...
+    <% end %>
+    
+You can nest many levels deep:
+
+    # app/views/posts/index.html.erb
+    <%= extends :blog do %>
+       ...
+    <% end %>
+    
+    # app/views/layouts/blog.html.erb
+    <%= extends :public do %>
+       ...
+    <% end %>
+    
+    # app/views/layouts/public.html.erb
+    <%= extends :application do %>
+       ...
+    <% end %>
+
+### Appending content to an area:
+
+The implementation details are quite different, but the `append` helper works much like Rails' built-in `content_for`. It will work with either a String or block, adding the new content onto the end of any content previously provided by parent layouts:
+
+    <%= extends :application do %>
+      <%= append :sidebar, "More content." %>
+      <%= append :sidebar do %>
+        More content.
+      <% end %>
+    <% end %>
+
+### Prepending content to an area:
+
+Exactly what you think it is. The reverse of `append` (duh), adding the new content at the start of any content previously provided by parent layouts:
+
+    <%= extends :application do %>
+      <%= prepend :sidebar, "Content." %>
+      <%= prepend :sidebar do %>
+        Content.
+      <% end %>
+    <% end %>
+
+### Replacing content
+
+You can also replace any content provided by parent layouts:
+
+    <%= extends :application do %>
+      <%= replace :sidebar, "New content." %>
+      <%= replace :sidebar do %>
+        New content.
+      <% end %>
+    <% end %>
+
+
+## The token blog example
+
+Set-up a global layout defining some content areas. Note that there is no `<% yield %>` here.
+    
+    # app/views/layouts/application.html.erb
+    <!DOCTYPE html>
+    <html>
+    <head>
+      <meta charset="utf-8">
+      <title><%= area :title %> JustinFrench.com</title>
+      <meta name="description" content="<%= area :description, "This is my website." %>">
+      <meta name="keywords" content="<%= area :keywords, "justin, french, ruby, design" %>">
+    </head>
+    <body>
+      <div id="wrapper">
+        <div id="content">
+          <%= area :content do %>
+            <p>Default content goes here.</p>
+          <% end %>
+        </div>
+        <div id="sidebar">
+          <%= area :sidebar do %>
+            <h2>About Me</h2>
+            <p>...</p>
+          <% end %>
+        </div>
+      </div>
+    </body>
+    </html>
+    
+Next, we set-up a `blog` layout that extends `application`, replacing, appending & prepending content to the areas we defined earlier.
+    
+    # app/views/layouts/blog.html.erb
+    <%= extends :application do %>
+      <% replace :title, "My Blog – " %>
+      <% replace :description, "Justin French blogs here on Ruby, Rails, Design, Formtastic, etc" %>
+      <% prepend :keywords, "blog, weblog, design links, ruby links, formtastic release notes, " %>
+    <% end %>
+
+Now our blog index view can extend `blog` and fill in the areas with content specific to the index action.
+    
+    # app/views/posts/index.html.erb
+    <%= extends :blog do %>
+      <% replace :content do %>
+        <h1>My Blog</h1>
+        <% render @articles %>
+      <% end %>
+    
+      <% append :content do %>
+        <h2>Blog Roll</h2>
+        <% render @links %>
+      <% end %>
+    <% end %>
+    
+We also need to instruct the `PostsController` not to wrap the view in a layout of it's own (default Rails behavior), which can be done on an individual action:
+
+    # app/controllers/posts_controller.rb
+    class PostsController < ApplicationController
+      def index
+        render :layout => nil
+      end
+    end
+
+Or for an entire controller:
+
+    # app/controllers/posts_controller.rb
+    class PostsController < ApplicationController
+      layout nil
+    end
+    
+Or for every controller:
+
+    # app/controllers/application_controller.rb
+    class ApplicationController < ActionController::Base
+      layout nil
+    end
+
+We'll find a way to make this easier or a bit more obvious in a future version.
+
+
+## Installation
+
+* add `gem 'nestive', '~> 0.1'` to your gemfile
+* run `bundle`
+* add `layout nil` to ApplicationController or the specific controllers you want to use Nestive on (see above)
+
+
+## TODO
+
+* Figure out how to test it
+* Actually use it in an app
+* You know, everything!
+
+
+## Compatibility
+
+Only testing it with Rails 3.1 RCs right now, but it should work with Rails 2 & 3. The dependency is set to ~> 3.0 right now, will change to 2.x when someone can test it works.
+
+*Nestive doesn't monkey patch or fiddle with any default behaviors in Rails.* Use it when you want to, don't when you don't.
+
+## You can help with...
+
+* feedback
+* reporting issues
+* fixing issues with pull requests
+* performance testing
+
+## Twitter
+
+* [@nestivegem](http://twitter.com/nestivegem)
+* [@justinfrench](http://twitter.com/justinfrench)

data/Rakefile

@@ -0,0 +1,27 @@
+#!/usr/bin/env rake
+require 'rake/testtask'
+require 'rdoc/task'
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the nestive plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the nestive plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Nestive'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/app/helpers/nestive/layout_helper.rb

@@ -0,0 +1,232 @@
+module Nestive
+  
+  # The Nestive LayoutHelper provides a handful of helper methods for use in your layouts and views.
+  #
+  # See the documentation for each individual method for detailed information, but at a high level, 
+  # your parent layouts define `area`s of content. You can define an area and optionally add content 
+  # to it at the same time using either a String, or a block:
+  #
+  #     # app/views/layouts/global.html.erb
+  #     <html>
+  #       <head>
+  #         <title><%= area :title, "MySite.com" %></title>
+  #       </head>
+  #       <body>
+  #         <div id="content">
+  #           <%= area :content %>
+  #         </div>
+  #         <div id="sidebar">
+  #           <%= area :sidebar do %>
+  #             <h2>About MySite.com</h2>
+  #             <p>...</p>
+  #           <% end %>
+  #         </div>
+  #       </body>
+  #     </html>
+  #
+  # Your child layouts (or views) inherit and modify the parent by wrapping in an `extend` block 
+  # helper. You can then either `append`, `prepend` or `replace` the content that has previously 
+  # been assigned to each area by parent layouts.
+  #
+  # The `append`, `prepend` or `replace` helpers are *similar* to Rails' own `content_for`, which 
+  # accepts content for the named area with either a String or with a block). They're different to
+  # `content_for` because they're only used modify the content assigned to the area, not retrieve it:
+  #
+  #     # app/views/layouts/admin.html.erb
+  #     <%= extends :global do %>
+  #       <% prepend :title, "Admin :: " %>
+  #       <% replace :sidebar do %>
+  #         <h2>Quick Links</h2>
+  #         <ul>
+  #           <li>...</li>
+  #         </ul>
+  #       <% end %>
+  #     <% end %>
+  #
+  #     # app/views/admin/posts/index.html.erb
+  #     <%= extends :admin do %>
+  #       <% prepend :title, "Posts ::" %>
+  #       <% replace :content do %>
+  #         Normal view stuff goes here.
+  #       <% end %>
+  #     <% end %>
+  module LayoutHelper
+    
+    # Declares that the current layour (or view) is inheriting from and extending another layout.
+    #
+    # @param [Symbol] name
+    #   The base name of the file in `layouts/` that you wish to extend (eg `:application` for `layouts/application.html.erb`)
+    #
+    # @example Extending the `application` layout to create an `admin` layout
+    #
+    #     # app/views/layouts/admin.html.erb
+    #     <%= extends :application do %>
+    #       ...
+    #     <% end %>
+    #
+    # @example Extending the `admin` layout in a view (you'll need to render the view with `:layout => nil`)
+    #
+    #     # app/controllers/admin/posts_controller.rb
+    #     class Admin::PostsController < ApplicationController
+    #       # You can disable Rails' layout rendering for all actions
+    #       layout nil
+    #       
+    #       # Or disable Rails' layout rendering per-controller
+    #       def index
+    #         render :layout => nil 
+    #       end
+    #     end
+    #
+    #     # app/views/admin/posts/index.html.erb
+    #     <%= extends :admin do %>
+    #       ...
+    #     <% end %>
+    def extends(name, &block)
+      capture(&block)
+      render(:file => "layouts/#{name}")
+    end
+    
+    # Defines an area of content in your layout that can be modified or replaced by child layouts 
+    # that extend it. You can optionally add content to an area using either a String, or a block.
+    #
+    # Areas are declared in a parent layout and modified by a child layout, but since Nestive
+    # allows for multiple levels of inheritance, a child layout can also declare an area for it's
+    # children to modify.
+    #
+    # @example Define an area without adding content to it:
+    #     <%= area :sidebar %>
+    #
+    # @example Define an area and add a String of content to it:
+    #     <%= area :sidebar, "Some content." %>
+    #
+    # @example Define an area and add content to it with a block:
+    #     <%= area :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @example Define an area in a child layout:
+    #     <%= extends :global do %>
+    #       <%= area :sidebar do %>
+    #         Some content.
+    #       <% end %>
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A unique name to identify this area of content.
+    #
+    # @param [String] content
+    #   An optional String of content to add to the area as you declare it.
+    def area(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      append(name, content)
+      render_area(name)
+    end
+    
+    def block(name, content=nil, &block)
+      ActiveSupport::Deprecation.warn("block() is deprecated and will be removed very soon, please use area() instead")
+      area(name, content, &block)
+    end
+    
+    # Appends content to an area previously defined or modified in parent layout(s). You can provide 
+    # the content using either a String, or a block.
+    #
+    # @example Appending content with a String
+    #     <% append :sidebar, "Some content." %>
+    #
+    # @example Appending content with a block:
+    #     <% append :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to append to
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def append(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area(name, :push, content)
+    end
+
+    # Prepends content to an area previously declared or modified in parent layout(s). You can 
+    # provide the content using either a String, or a block.
+    #
+    # @example Prepending content with a String
+    #     <% prepend :sidebar, "Some content." %>
+    #
+    # @example Prepending content with a block:
+    #     <% prepend :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to prepend to
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def prepend(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area(name, :unshift, content)
+    end
+    
+    # Replaces the content of an area previously declared or modified in parent layout(s). You can 
+    # provide the content using either a String, or a block.
+    #
+    # @example Prepending content with a String
+    #     <% replace :sidebar, "New content." %>
+    #
+    # @example Prepending content with a block:
+    #     <% replace :sidebar do %>
+    #       New content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to replace
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def replace(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area(name, :replace, [content])
+    end
+    
+    private
+    
+    # We record the instructions (declaring, appending, prepending and replacing) for an area of
+    # content into an array that we can later retrieve and replay. Instructions are stored in an
+    # instance variable Hash `@_area_for`, with each key representing an area name, and each value 
+    # an Array of instructions. Each instruction is a two element array containing a instruction 
+    # method (eg `:push`, `:unshift`, `:replace`) and a value (content String).
+    #
+    #     @_area_for[:sidebar] # => [ [:push,"World"], [:unshift,"Hello"] ]
+    #
+    # Due to the way we extend layouts (render the parent layout after the child), the instructions
+    # are captured in reverse order. `render_area` reversed them and plays them back at rendering 
+    # time.
+    #
+    # @example
+    #   add_instruction_to_area(:sidebar, :push, "More content.")
+    def add_instruction_to_area(name, instruction, value)
+      @_area_for ||= {}
+      @_area_for[name] ||= []
+      @_area_for[name] << [instruction, value]
+    end
+    
+    # Take the instructions we've gathered for the area and replay them one after the other on
+    # an empty array. These instructions will push, unshift or replace items into our output array,
+    # which we then join and mark as html_safe.
+    #
+    # These instructions are reversed and replayed when we render the block (rather than as they 
+    # happen) due to the way they are gathered by the layout extension process (in reverse).
+    #
+    # @todo is `html_safe` "safe" here?
+    def render_area(name)
+      output = []
+      (@_area_for[name] || []).reverse.each do |i|
+        output.send(i.first, i.last)
+      end
+      output.join.html_safe
+    end
+
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+# Include hook code here

data/install.rb

@@ -0,0 +1 @@
+# Install hook code here

data/lib/nestive.rb

@@ -0,0 +1,4 @@
+require 'nestive/engine'
+
+module Nestive
+end

data/lib/nestive/engine.rb

@@ -0,0 +1,6 @@
+if defined?(Rails) && Rails.version.to_i >= 3
+  module Nestive
+    class Engine < Rails::Engine
+    end
+  end
+end

data/lib/nestive/railtie.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module Nestive
+  class Railtie < Rails::Railtie
+    initializer 'nestive.initialize' do
+      ActiveSupport.on_load(:action_view) do
+        include Nestive::LayoutHelper
+      end
+    end
+  end
+end

data/lib/nestive/version.rb

@@ -0,0 +1,3 @@
+module Nestive
+  VERSION = "0.1.0"
+end

data/nestive.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nestive/version"
+
+Gem::Specification.new do |s|
+  s.name        = "nestive"
+  s.version     = Nestive::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Justin French"]
+  s.email       = ["justin@indent.com.au"]
+  s.homepage    = ""
+  s.summary     = %q{A Rails plugin/gem for awesome nested templates and layouts}
+  s.description = %q{A Rails plugin/gem for awesome nested templates and layouts}
+
+  s.rubyforge_project = "nestive"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  
+  s.add_dependency(%q<rails>, ["~> 3.0"])
+end

data/test/nestive_test.rb

@@ -0,0 +1,8 @@
+require 'test_helper'
+
+class NestiveTest < ActiveSupport::TestCase
+  # Replace this with your real tests.
+  test "the truth" do
+    assert true
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'test/unit'
+require 'active_support'

data/uninstall.rb

@@ -0,0 +1 @@
+# Uninstall hook code here

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification 
+name: nestive
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Justin French
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-30 00:00:00 +10:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rails
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        version: "3.0"
+  type: :runtime
+  version_requirements: *id001
+description: A Rails plugin/gem for awesome nested templates and layouts
+email: 
+- justin@indent.com.au
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .yardopts
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.md
+- Rakefile
+- app/helpers/nestive/layout_helper.rb
+- init.rb
+- install.rb
+- lib/nestive.rb
+- lib/nestive/engine.rb
+- lib/nestive/railtie.rb
+- lib/nestive/version.rb
+- nestive.gemspec
+- test/nestive_test.rb
+- test/test_helper.rb
+- uninstall.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: nestive
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A Rails plugin/gem for awesome nested templates and layouts
+test_files: 
+- test/nestive_test.rb
+- test/test_helper.rb