learn_rails 0.0.0 → 0.0.1

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,19 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+.idea/
+.rvmrc

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 2.0.0
+  - 1.9.3
+
+notifications:
+  email:
+    on_failure: always

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in learn_rails.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Peter-Jan Celis
+
+MIT License
+
+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,143 @@
+# Learn Rails
+[![Build Status](https://secure.travis-ci.org/pjc/learn_rails.png?branch=master)][travis]
+[![Dependency Status](https://gemnasium.com/pjc/learn_rails.png)][gemnasium]
+[![Code Climate](https://codeclimate.com/github/pjc/learn_rails.png)][codeclimate]
+[![Coverage Status](https://coveralls.io/repos/pjc/learn_rails/badge.png?branch=master)][coveralls]
+
+[travis]: https://travis-ci.org/pjc/learn_rails
+[codeclimate]: https://codeclimate.com/github/pjc/learn_rails
+[gemnasium]: https://gemnasium.com/pjc/learn_rails
+[coveralls]: https://coveralls.io/r/pjc/learn_rails
+
+Learn Ruby on Rails by seeing all the ruby code behind the rails (and ruby) magic you use.
+
+Currently works for:
+- accessors (`attr_reader`, `attr_writer`, `attr_accessor`)
+- associations (`belongs_to` and `has_one` only so far)
+
+Also note that for associations, the only options that work so far are `class_name`, `readonly`, `primary_key` and `foreign_key`.
+
+Coming soon:
+- All rails magic / helpers
+- Annotate your rails app with a single command (e.g. associations code shown in each model)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'learn_rails'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install learn_rails
+
+## Usage
+
+This gem installs an executable called `learn` and a general purpose command called `rails`, so all you need to do is go to the terminal and type:
+
+    $ learn rails the_rails_magic_I_want_to_learn_about
+
+Say you want to know what the `attr_accessor :color, :size` line in one of the models in your code really does. Type the following terminal command:
+
+    $ learn rails attr_accessor :color, :size
+
+The gem will now print the following ruby code in your terminal output:
+
+    # def color
+    #  @color
+    # end
+    #
+    # def color=(value)
+    #  @color = value
+    # end
+    #
+    # def size
+    #  @size
+    # end
+    #
+    # def size=(value)
+    #  @size = value
+    # end
+
+Sweet!
+
+Maybe you also want to know a bit more about the association `has_one :task, class_name: "ToDo"` in your `user.rb` model. You would now type:
+
+    $ learn rails user has_one :task, class_name: "ToDo"
+
+(Note that we included the model name in the command, because our gem needs it to generate the ruby code!)
+
+This is the terminal output you'll see:
+
+    # def task(force_reload = false)
+    #   @task = nil if force_reload
+    #   @task ||= ToDo.find_by_user_id(self.id)
+    # end
+    #
+    # def task=(task)
+    #   task.user_id = self.id
+    #   task.save
+    # end
+    #
+    # def build_task(attributes = {})
+    #   attributes[:user_id] = self.id
+    #   ToDo.new(attributes)
+    # end
+    #
+    # def create_task(attributes = {})
+    #   attributes[:user_id] = self.id
+    #   ToDo.create(attributes)
+    # end
+    #
+    # def create_task!(attributes = {})
+    #   attributes[:user_id] = self.id
+    #   ToDo.create!(attributes)
+    # end
+
+Happy learning!
+
+## 2 rules to remember
+
+1. Always use the new ruby hash syntax for the options you specify. So type `class_name: "ToDo"` and not `class_name => "ToDo"`.
+
+2. Don't forget to prepend your associations with the ruby model they are defined in (see example above).
+
+Don't worry too much about rule 2 though: If you forget to give the model name when we need it, we'll ask for it. And when you give it when we don't need it, we'll ignore it.
+
+## List of available commands
+
+Accessors:
+
+    $ learn rails attr_reader :as, :many, :attributes, :as, :you, :want
+
+    $ learn rails attr_writer :as, :many, :attributes, :as, :you, :want
+
+    $ learn rails attr_accessor :as, :many, :attributes, :as, :you, :want
+
+Associations:
+
+    $ learn rails mymodelname belongs_to :associate
+
+    $ learn rails mymodelname has_one :associate
+
+Options for each association: `class_name: "Whatever"`, `foreign_key: "foreign_id"`, `primary_id: "primary_id"`, `readonly: true`
+
+## Changelog
+
+This gem has yet to be published at Rubygems. Coming soon!
+
+## Feedback
+
+Comments and feedback are very welcome on [our github issues page](https://github.com/pjc/learn_rails/issues?state=open).
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,16 @@
+require "bundler/gem_tasks"
+require 'cucumber/rake/task'
+require 'rspec/core/rake_task'
+require 'coveralls/rake/task'
+
+Cucumber::Rake::Task.new(:features) do |t|
+  t.cucumber_opts = "features --format pretty"
+end
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--color --format documentation"
+end
+
+Coveralls::RakeTask.new
+
+task :default => [:spec, :features, 'coveralls:push']

data/bin/learn

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+
+require 'learn_rails/cli'
+LearnRails::CLI.start

data/features/accessors.feature

@@ -0,0 +1,122 @@
+Feature: Accessors
+  In order to understand rails accessors
+  As a learn_rails gem user
+  I want to see the right ruby code in the terminal
+
+  Scenario: attr_reader
+    When I run `learn rails attr_reader :whatever`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      """
+
+  Scenario: attr_writer
+    When I run `learn rails attr_writer :whatever`
+    Then the output should contain:
+      """
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      """
+
+  Scenario: attr_accessor
+    When I run `learn rails attr_accessor :whatever`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      #
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      """
+
+  Scenario: attr_reader with anymodelname
+    When I run `learn rails anymodelname attr_reader :whatever`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      """
+
+  Scenario: attr_writer with anymodelname
+    When I run `learn rails anymodelname attr_writer :whatever`
+    Then the output should contain:
+      """
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      """
+
+  Scenario: attr_accessor with anymodelname
+    When I run `learn rails anymodelname attr_accessor :whatever`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      #
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      """
+
+  Scenario: attr_reader with multiple attributes
+    When I run `learn rails attr_reader :whatever, :another`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      #
+      # def another
+      #  @another
+      # end
+      """
+
+  Scenario: attr_writer with multiple attrributes
+    When I run `learn rails attr_writer :whatever, :another`
+    Then the output should contain:
+      """
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      #
+      # def another=(value)
+      #  @another = value
+      # end
+      """
+
+  Scenario: attr_accessor with multiple attributes
+    When I run `learn rails attr_accessor :whatever, :another`
+    Then the output should contain:
+      """
+      # def whatever
+      #  @whatever
+      # end
+      #
+      # def whatever=(value)
+      #  @whatever = value
+      # end
+      #
+      # def another
+      #  @another
+      # end
+      #
+      # def another=(value)
+      #  @another = value
+      # end
+      """
+
+  Scenario: valid statement but with comma right after
+    When I run `learn rails attr_reader :whatever,`
+    Then the output should not contain ","
+
+  Scenario: valid statement but with standalone comma after it
+    When I run `learn rails attr_reader :whatever ,`
+    Then the output should not contain ","
+    And  the output should not contain "@ "

data/features/associations.feature

@@ -0,0 +1,506 @@
+Feature: Associations
+  In order to understand rails associations
+  As a learn_rails gem user
+  I want to see the right ruby code in the terminal
+
+  Scenario: belongs_to association
+    When I run `learn rails task belongs_to :user`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= User.find_by_id(self.user_id)
+      # end
+      #
+      # def user=(user)
+      #   self.user_id = user.id
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = User.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = User.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = User.create!(attributes)
+      # end
+      """
+
+  Scenario: belongs_to association without the model name
+    When I run `learn rails belongs_to :user`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= User.find_by_id(self.user_id)
+      # end
+      #
+      # def user=(user)
+      #   self.user_id = user.id
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = User.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = User.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = User.create!(attributes)
+      # end
+      """
+
+  Scenario: belongs_to association with multi-word model
+    When I run `learn rails manual belongs_to :car_part`
+    Then the output should contain:
+      """
+      # def car_part(force_reload = false)
+      #   @car_part = nil if force_reload
+      #   @car_part ||= CarPart.find_by_id(self.car_part_id)
+      # end
+      #
+      # def car_part=(car_part)
+      #   self.car_part_id = car_part.id
+      # end
+      #
+      # def build_car_part(attributes = {})
+      #   self.car_part = CarPart.new(attributes)
+      # end
+      #
+      # def create_car_part(attributes = {})
+      #   self.car_part = CarPart.create(attributes)
+      # end
+      #
+      # def create_car_part!(attributes = {})
+      #   self.car_part = CarPart.create!(attributes)
+      # end
+      """
+    And the output should not contain "carpart"
+    And the output should not contain "Car_Part"
+
+  Scenario: belongs_to association with :class_name option
+    When I run `learn rails task belongs_to :user, class_name: "Person"`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= Person.find_by_id(self.user_id)
+      # end
+      #
+      # def user=(user)
+      #   self.user_id = user.id
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = Person.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = Person.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = Person.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @user ||= User.find_by_id(self.user_id)"
+    And the output should not contain "#   self.user = User.new(attributes)"
+    And the output should not contain "#   self.user = User.create(attributes)"
+    And the output should not contain "#   self.user = User.create!(attributes)"
+
+  Scenario: belongs_to association with :foreign_key option
+    When I run `learn rails task belongs_to :user, foreign_key: "person_id"`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= User.find_by_id(self.person_id)
+      # end
+      #
+      # def user=(user)
+      #   self.person_id = user.id
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = User.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = User.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = User.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @user ||= User.find_by_id(self.user_id)"
+    And the output should not contain "#   self.user_id = user.id"
+
+  Scenario: belongs_to association with :primary_key option
+    When I run `learn rails task belongs_to :user, primary_key: "todo_id"`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= User.find_by_id(self.user_id)
+      # end
+      #
+      # def user=(user)
+      #   self.user_id = user.todo_id
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = User.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = User.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = User.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   self.user_id = user.id"
+
+  Scenario: belongs_to association with :readonly option
+    When I run `learn rails task belongs_to :user, readonly: true`
+    Then the output should contain:
+      """
+      # def user(force_reload = false)
+      #   @user = nil if force_reload
+      #   @user ||= User.find_by_id(self.user_id)
+      # end
+      #
+      # def build_user(attributes = {})
+      #   self.user = User.new(attributes)
+      # end
+      #
+      # def create_user(attributes = {})
+      #   self.user = User.create(attributes)
+      # end
+      #
+      # def create_user!(attributes = {})
+      #   self.user = User.create!(attributes)
+      # end
+      """
+    And the output should not contain "# def user=(user)"
+    And the output should not contain "#   self.user_id = user.id"
+
+  Scenario: belongs_to association with :conditions option
+    When I run `learn rails task belongs_to :user, conditions: { status: "active"}`
+    And  the output should contain "# def user(force_reload = false)"
+    And  the output should contain:
+      """
+      #   @user ||= User.first(:conditions => {:id => self.user_id, :status => "active"})
+      """
+
+  Scenario: has_one association
+    When I run `learn rails user has_one :task`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= Task.find_by_user_id(self.id)
+      # end
+      #
+      # def task=(task)
+      #   task.user_id = self.id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create!(attributes)
+      # end
+      """
+
+  Scenario: has_one association without the model name
+    Given PENDING: Aruba process keeps hanging, need to test for terminal question
+    When I run `learn rails has_one :task`
+    Then the output should contain "What is the model name for this association?"
+
+  Scenario: has_one association with model name given when prompted
+    Given PENDING: Aruba process keeps hanging, need to test for terminal question
+    When I run `learn rails has_one :task`
+    And I type `user`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= Task.find_by_user_id(self.id)
+      # end
+      #
+      # def task=(task)
+      #   task.user_id = self.id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create!(attributes)
+      # end
+      """
+
+  Scenario: has_one association with multi-word model
+    When I run `learn rails user has_one :voodoo_pop`
+    Then the output should contain:
+      """
+      # def voodoo_pop(force_reload = false)
+      #   @voodoo_pop = nil if force_reload
+      #   @voodoo_pop ||= VoodooPop.find_by_user_id(self.id)
+      # end
+      #
+      # def voodoo_pop=(voodoo_pop)
+      #   voodoo_pop.user_id = self.id
+      #   voodoo_pop.save
+      # end
+      #
+      # def build_voodoo_pop(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   VoodooPop.new(attributes)
+      # end
+      #
+      # def create_voodoo_pop(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   VoodooPop.create(attributes)
+      # end
+      #
+      # def create_voodoo_pop!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   VoodooPop.create!(attributes)
+      # end
+      """
+    And the output should not contain "voodoopop"
+    And the output should not contain "Voodoo_Pop"
+
+  Scenario: has_one association with :class_name option using the old hash syntax
+    When I run `learn rails user has_one :task, :class_name => "ToDo"`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= ToDo.find_by_user_id(self.id)
+      # end
+      #
+      # def task=(task)
+      #   task.user_id = self.id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @task ||= Task.find_by_user_id(self.id)"
+    And the output should not contain "#   Task.new(attributes)"
+    And the output should not contain "#   Task.create(attributes)"
+    And the output should not contain "#   Task.create!(attributes)"
+
+  Scenario: has_one association with :class_name option using the new hash syntax
+    When I run `learn rails user has_one :task, class_name: "ToDo"`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= ToDo.find_by_user_id(self.id)
+      # end
+      #
+      # def task=(task)
+      #   task.user_id = self.id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   ToDo.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @task ||= Task.find_by_user_id(self.id)"
+    And the output should not contain "#   Task.new(attributes)"
+    And the output should not contain "#   Task.create(attributes)"
+    And the output should not contain "#   Task.create!(attributes)"
+
+  Scenario: has_one association with :foreign_key option
+    When I run `learn rails user has_one :task, foreign_key: "employee_id"`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= Task.find_by_employee_id(self.id)
+      # end
+      #
+      # def task=(task)
+      #   task.employee_id = self.id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:employee_id] = self.id
+      #   Task.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:employee_id] = self.id
+      #   Task.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:employee_id] = self.id
+      #   Task.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @task ||= Task.find_by_user_id(self.id)"
+    And the output should not contain "#   task.user_id = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+
+  Scenario: has_one association with :primary_key option
+    When I run `learn rails user has_one :task, primary_key: "primary_id"`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= Task.find_by_user_id(self.primary_id)
+      # end
+      #
+      # def task=(task)
+      #   task.user_id = self.primary_id
+      #   task.save
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.primary_id
+      #   Task.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.primary_id
+      #   Task.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.primary_id
+      #   Task.create!(attributes)
+      # end
+      """
+    And the output should not contain "#   @task ||= Task.find_by_user_id(self.id)"
+    And the output should not contain "#   task.user_id = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+    And the output should not contain "#   attributes[:user_id] = self.id"
+
+  Scenario: has_one association with :readonly option
+    When I run `learn rails user has_one :task, readonly: true`
+    Then the output should contain:
+      """
+      # def task(force_reload = false)
+      #   @task = nil if force_reload
+      #   @task ||= Task.find_by_user_id(self.id)
+      # end
+      #
+      # def build_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.new(attributes)
+      # end
+      #
+      # def create_task(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create(attributes)
+      # end
+      #
+      # def create_task!(attributes = {})
+      #   attributes[:user_id] = self.id
+      #   Task.create!(attributes)
+      # end
+      """
+    And the output should not contain "# def task="
+    And the output should not contain "#   task.user_id = self.id"
+
+  Scenario: has_many association
+    When I run `learn rails user has_many :tasks`
+    Then the output should contain:
+      """
+      # def tasks
+      #   Task.where(user_id: self.id)
+      # end
+      """
+
+  Scenario: has_many association without the model name
+    Given PENDING: Aruba process keeps hanging, need to test for terminal question
+    When I run `learn rails has_many :tasks`
+    Then the output should contain "What is the model name for this association?"
+
+  Scenario: has_many association with model name given when prompted
+    Given PENDING: Aruba process keeps hanging, need to test for terminal question
+    When I run `learn rails has_many :tasks`
+    And I type `user`
+    Then the output should contain:
+      """
+      # def tasks
+      #   Task.where(user_id: self.id)
+      # end
+      """
+
+  Scenario: has_many association with multi-word model
+    When I run `learn rails user has_many :car_parts`
+    Then the output should contain:
+      """
+      # def car_parts
+      #   CarPart.where(user_id: self.id)
+      # end
+      """
+    And the output should not contain "carpart"
+    And the output should not contain "Car_Part"
+
+  Scenario: non valid rails magic
+   When I run `learn rails random gibberish`
+   Then the output should contain "No ruby code available."
+   And  the output should contain "See http://www.github.com/pjc/learn_rails for list of valid instructions."