tft_rails 0.6.0 → 0.6.1

data/lib/generators/chapter08_09/begin/instructions.md

@@ -7,7 +7,7 @@ Sign up
 In the adapted version of RailsTutorial that we're using
 here, the user registration and user authentication tasks
 are not implemented in the application itself, but
-instead handled by a gem called [Devise](devise) that is an
+instead handled by a gem called [Devise][devise] that is an
 industry-standard Rails authentication solution.
 
 Devise provides its own controllers, models and views that
@@ -35,7 +35,7 @@ Devise in the gem.
 Even though the controller sits in Devise, we can still run
 our own test against it. This was done here.
 
-Take a look at the [Devise instructions on github](devise)
+Take a look at the [Devise instructions on github][devise]
 to learn about how to customize views. That what we'll
 need to do. Hint: You'll need to run a Devise generator.
 
@@ -50,5 +50,9 @@ The Devise sign-in page meets our needs and doesn't need customizing.
 However, we need to work on the layout to make sure that it shows a "Sign out" link
 if a user is logged in, and a "Sign in" link only if a user is not logged in.
 
+[Devise][devise] offers the controller methods `user_signed_in?` and `current_user`
+to report on the current login status. The first method returns `true` or `false`
+depending on whether a user logged in, the second returns the actual user object,
+or `nil` if no user is logged in.
 
 [devise]: https://github.com/plataformatec/devise "Devise on github"

data/lib/generators/chapter10/begin/instructions.md

@@ -20,7 +20,7 @@ Devise offers a facility similar to what RailsTutorials implements.
 
 RailsTutorial implements an `authenticate` method, while Devise's
 version is `authenticate_user!`.  Either method redirects to the sign-in
-page if a given user isn't logged in.
+page if the user isn't logged in.
 
 Destroying users with admin privilege
 -------------------------------------
@@ -33,5 +33,15 @@ for users which, however, is only available to admin users.
 
 What are the two things we have to protect?
 
+Rails Concepts Covered
+======================
+
+* Migrations
+* Factories
+* Rake Tasks
+* `attr_accessible`
+* before_filter
+* rendering partials by collection object
+
 
 [devise]: https://github.com/plataformatec/devise "Devise on github"

data/lib/generators/chapter10/begin/templates/spec/controllers/users_controller_10_spec.rb

@@ -72,11 +72,20 @@ describe UsersController do
     end
 
     describe "as a non-admin user" do
-      it "should protect the page" do
+      before do
         sign_in(@user)
+      end
+
+      it "should protect the page" do
         delete :destroy, :id => @user
         response.should redirect_to(root_path)
       end
+
+      it 'should not destroy the user' do
+        expect {
+          delete :destroy, :id => @user
+        }.to_not change(User,:count)
+      end
     end
 
     describe "as an admin user" do

data/lib/generators/chapter11_1/begin/USAGE

@@ -0,0 +1,24 @@
+Description:
+    Begins Test-First Teaching exercises adapted from Chapter 11.1 of the RailsTutorial by Michael Hartl.
+
+    It is assumed that this generator is run after the exercises for all prior chapters have been completed, and the solutions are implemented.
+
+    Successive chapters are expected to be run sequentially. Each chapter's generators comes with a delta
+    to the next chapter, in two phase, the "begin" one will create tests, the "finish" one includes the solution files.
+    If all tests pass, the "finish" phase is optional.
+
+Example:
+    rails generate chapter11_1:begin
+
+    This copies new tests into the project, which are failing.
+    The student's task is to write code to make the test pass. The material covered by the tests is consistent
+    with Chapter 11.1 of the RailsTutorial, however adapted for Devise as authentication solution.
+
+    When you're done, and all tests pass, or you just want to skip ahead, run:
+
+    rails generate chapter11_1:solutions
+
+    This will copy solutions files into the application tree. If you already have a solution file,
+    you'll be prompted whether you want to overwrite your file, see the difference, or keep your file.
+
+

data/lib/generators/{chapter11 → chapter11_1}/begin/begin_generator.rb

@@ -1,14 +1,18 @@
-module Chapter11
+module Chapter11_1
   module Generators
     class BeginGenerator < Rails::Generators::Base
       source_root File.expand_path("../templates", __FILE__)
 
+      def copy_app_tree
+        directory(self.class.source_root, Rails.root)
+      end
+
       def generate_instructions
         require 'rdiscount'
         
         instr_md = File.expand_path('../instructions.md',self.class.source_root)
         return unless File.exists?(instr_md)
-        dest = File.join(Rails.root,'doc','chapter10.html')
+        dest = File.join(Rails.root,'doc','chapter11_1.html')
         copy_file(instr_md, dest, :force => true) do |content|
           RDiscount.new(content).to_html
         end

data/lib/generators/chapter11_1/begin/instructions.md

@@ -0,0 +1,39 @@
+RailsTutorial Chapter 11.1 Test-First Teaching Instructions
+=========================================================
+
+Chapter 11.1 covers adding a Micropost model and setting up an association between
+User and Micropost.
+
+When you first run `rake spec`, you'll get an error like below and no specs will execute.
+
+    uninitialized constant Micropost (NameError)
+
+This is because we don't have this class defined yet. So, go ahead and create it using the rails generators:
+
+    rails generate model Micropost content:string user_id:integer
+
+This will generate a migration file, a model file and a spec file for Micropost. Note that for the TFT
+exercises, a spec file is already provided, and we don't need the generated spec file. So, go ahead
+and _remove:_ `spec/models/micropost_spec.rb`
+
+Add indexes to the migration file, see [Chapter 11.1.1][chapter_11_1_1]. Indices should be added for each
+column that will be used for record lookup or ordering. For instance, if we want to sort Microposts by
+creation date, then there should be an index on the `created_at` column. (Note that the `timestamps` migration
+methods created two columns, `created_at` and `updated_at`.)
+
+Then migrate the database:
+
+    rake db:migrate
+
+
+Rails Concepts Covered
+======================
+
+* Using the model generator (for Microposts)
+* Adding indexes to the database
+* Associations, has_many (dep't destroy) and belongs_to
+* Validations for format
+* Factories with associations
+* Scopes (simple, default scope), order
+
+[chapter_11_1_1]: http://ruby.railstutorial.org/chapters/user-microposts#sec:the_basic_model "RailsTutorial Chapter 11.1.1"

data/lib/generators/chapter11_1/begin/templates/lib/tasks/same_data.rake

@@ -0,0 +1,29 @@
+namespace :db do
+  desc "Fill database with sample data"
+  task :populate => :environment do
+    Rake::Task['db:reset'].invoke
+    make_users
+  end
+end
+
+def make_users
+  admin = User.create!(:name => "Example User",
+                       :email => "example@railstutorial.org",
+                       :password => "password",
+                       :password_confirmation => "password")
+  admin.toggle!(:admin)
+  99.times do |n|
+    name = Faker::Name.name
+    email = "example-#{n+1}@railstutorial.org"
+    password = "password"
+    User.create!(:name => name,
+                 :email => email,
+                 :password => password,
+                 :password_confirmation => password)
+  end
+  User.all(:limit => 6).each do |user|
+    50.times do
+      user.microposts.create!(:content => Faker::Lorem.sentence(5))
+    end
+  end
+end

data/lib/generators/chapter11_1/begin/templates/spec/models/microposts_11_1_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe Micropost do
+
+  before(:each) do
+    @user = Factory(:user)
+    @attr = { :content => "value for content" }
+  end
+
+  it "should create a new instance given valid attributes" do
+    @user.microposts.create!(@attr)
+  end
+
+  describe "user associations" do
+    
+    before(:each) do
+      @micropost = @user.microposts.create(@attr)
+    end
+
+    it "should have a user attribute" do
+      @micropost.should respond_to(:user)
+    end
+    
+    it "should have the right associated user" do
+      @micropost.user_id.should == @user.id
+      @micropost.user.should == @user
+    end
+  end
+
+  describe "validations" do
+
+    it "should require a user id" do
+      Micropost.new(@attr).should_not be_valid
+    end
+
+    it "should require nonblank content" do
+      @user.microposts.build(:content => "  ").should_not be_valid
+    end
+
+    it "should reject long content" do
+      @user.microposts.build(:content => "a" * 141).should_not be_valid
+    end
+  end
+
+end

data/lib/generators/chapter11_1/begin/templates/spec/models/user_11_1_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe User do
+
+  describe "micropost associations" do
+
+    before(:each) do
+      @user = Factory(:user)
+      @mp1 = Factory(:micropost, :user => @user, :created_at => 1.day.ago)
+      @mp2 = Factory(:micropost, :user => @user, :created_at => 1.hour.ago)
+    end
+
+    it "should have a microposts attribute" do
+      @user.should respond_to(:microposts)
+    end
+
+    it "should have the right microposts in the right order" do
+      @user.microposts.should == [@mp2, @mp1]
+    end
+
+    it "should destroy associated microposts" do
+      @user.destroy
+      [@mp1, @mp2].each do |micropost|
+        Micropost.find_by_id(micropost.id).should be_nil
+      end
+    end
+
+  end
+
+end

data/lib/generators/chapter11_1/solutions/USAGE

@@ -0,0 +1,18 @@
+Description:
+    Wraps up Test-First Teaching exercises adapted from Chapter 11.1 of the RailsTutorial by Michael Hartl.
+
+Example:
+    rails generate chapter11:solutions
+
+    This copies the solutions and other necessary files (e.g. images, assets, helpers, etc.) into the project
+    to conclude Chapter 11.1. This should make all tests pass and bring you in sync to the application at
+    the end of Chapter 11.1.
+
+    If you already have a solution file, you'll be prompted whether you want to overwrite your file,
+    see the difference, or keep your file.
+
+    It's a good idea to commit your changes to git, prior to running finish, in case you accidentally choose to
+    overwrite files you wanted to keep. Assuming your project is already git-controlled, you can commit changes with:
+
+    git add .
+    git commit -m "comment here explaining WHY you made the changes"

data/lib/generators/chapter11_1/solutions/snippets/migration_create_microposts.rb

@@ -0,0 +1,17 @@
+class CreateMicroposts < ActiveRecord::Migration
+  def self.up
+    create_table :microposts do |t|
+      t.string :content
+      t.integer :user_id
+
+      t.timestamps
+    end
+
+    add_index :microposts, :user_id
+    add_index :microposts, :created_at
+  end
+
+  def self.down
+    drop_table :microposts
+  end
+end

data/lib/generators/chapter11_1/solutions/solutions_generator.rb

@@ -0,0 +1,25 @@
+module Chapter11_1
+  module Generators
+    class SolutionsGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      def copy_app_tree
+        directory(self.class.source_root, Rails.root)
+      end
+
+      def add_migration
+        found_candidate = Dir.glob(File.join(Rails.root,'db','migrate','*create_micropost*')).present?
+
+        if (found_candidate &&
+            yes?("We found a migration file containing the word '_admin_'. We think you have the correct migration. Do you still way to copy the solution anyway? (yes/no)", :yellow)) \
+            or !found_candidate
+
+          src  = File.expand_path("../snippets/migration_create_microposts.rb", __FILE__)
+          dest = File.join(Rails.root,'db','migrate',Time.now.strftime("%Y%m%d%H%M%S")+'_create_microposts.rb')
+          copy_file(src,dest)
+        end
+      end
+
+    end
+  end
+end

data/lib/generators/chapter11_1/solutions/templates/app/model/micropost.rb

@@ -0,0 +1,10 @@
+class Micropost < ActiveRecord::Base
+
+  belongs_to :user
+
+  default_scope order('created_at DESC')
+
+  validates :user_id, :presence => true
+  validates :content, :presence => true, :length => {:maximum => 140}
+
+end

data/lib/generators/chapter11_1/solutions/templates/app/model/user.rb

@@ -0,0 +1,14 @@
+class User < ActiveRecord::Base
+  # Include default devise modules. Others available are:
+  # :token_authenticatable, :encryptable, :confirmable, :lockable, :timeoutable and :omniauthable
+  devise :database_authenticatable, :registerable,
+         :recoverable, :rememberable, :trackable, :validatable
+
+  validates :name, :presence => true, :length => { :maximum => 50 }
+
+  # Setup accessible (or protected) attributes for your model
+  attr_accessible :name, :email, :password, :password_confirmation, :remember_me
+
+  has_many :microposts, :dependent => :destroy
+
+end

data/lib/generators/chapter11_1/solutions/templates/spec/factories.rb

@@ -0,0 +1,16 @@
+# By using the symbol ':user', we get Factory Girl to simulate the User model.
+Factory.define :user do |user|
+  user.name                  "Michael Hartl"
+  user.email                 "mhartl@example.com"
+  user.password              "foobar"
+  user.password_confirmation "foobar"
+end
+
+Factory.sequence :email do |n|
+  "person-#{n}@example.com"
+end
+
+Factory.define :micropost do |mp|
+  mp.content "This is a new post"
+  mp.association :user
+end

data/lib/generators/chapter11_2/begin/USAGE

@@ -0,0 +1,24 @@
+Description:
+    Begins Test-First Teaching exercises adapted from Chapter 11.2 of the RailsTutorial by Michael Hartl.
+
+    It is assumed that this generator is run after the exercises for all prior chapters have been completed, and the solutions are implemented.
+
+    Successive chapters are expected to be run sequentially. Each chapter's generators comes with a delta
+    to the next chapter, in two phase, the "begin" one will create tests, the "finish" one includes the solution files.
+    If all tests pass, the "finish" phase is optional.
+
+Example:
+    rails generate chapter11_2:begin
+
+    This copies new tests into the project, which are failing.
+    The student's task is to write code to make the test pass. The material covered by the tests is consistent
+    with Chapter 11.2 of the RailsTutorial, however adapted for Devise as authentication solution.
+
+    When you're done, and all tests pass, or you just want to skip ahead, run:
+
+    rails generate chapter11_2:solutions
+
+    This will copy solutions files into the application tree. If you already have a solution file,
+    you'll be prompted whether you want to overwrite your file, see the difference, or keep your file.
+
+

data/lib/generators/chapter11_2/begin/begin_generator.rb

@@ -0,0 +1,30 @@
+module Chapter11_2
+  module Generators
+    class BeginGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      def copy_app_tree
+        directory(self.class.source_root, Rails.root)
+      end
+
+      def insert_css
+        src  = File.expand_path("../snippets/custom.css", __FILE__)
+        dest = File.join(Rails.root,'public','stylesheets','custom.css')
+        insert_into_file(dest, File.binread(src), :before => /\Z/) # insert before end
+      end
+
+      def generate_instructions
+        require 'rdiscount'
+        
+        instr_md = File.expand_path('../instructions.md',self.class.source_root)
+        return unless File.exists?(instr_md)
+        dest = File.join(Rails.root,'doc','chapter11_2.html')
+        copy_file(instr_md, dest, :force => true) do |content|
+          RDiscount.new(content).to_html
+        end
+        say_status('Note',"Now open file://#{dest} in your web browser for instructions", :cyan)
+      end
+
+    end
+  end
+end

data/lib/generators/chapter11_2/begin/instructions.md

@@ -0,0 +1,35 @@
+RailsTutorial Chapter 11.2 Test-First Teaching Instructions
+===========================================================
+
+When you first run `rake spec`, you'll get an error like below and no specs will execute.
+
+    uninitialized constant MicropostsController (NameError)
+
+This is because we don't have this class defined yet. So, go ahead and create it using the rails generators:
+
+_Note_: **Microposts is in plural here** (Rails convention for controllers).
+
+    rails g controller Microposts --controller-specs=false --view-specs=false --helper-specs=false
+
+Note: The controller generatore (unlike the model generator), we can instruct to suppress
+the spec files.
+
+For the particular markup to make the micropost display look pretty,
+refer to Rails Tutorial [Chapter 11.2.1][chapter_11_2_1]
+
+Extra Credit
+------------
+
+Review how pagination for the users index page was done in Chapter 10.
+Apply the same technique to the microposts displayed on the user show page.
+
+Rails Concepts Covered
+======================
+
+* Using controller generator
+* Testing for instance variables in the controller
+* More association methods, :empty?, :count
+* Rendering partials by object collection
+* Time helper
+
+[chapter_11_2_1]: http://ruby.railstutorial.org/chapters/user-microposts#sec:augmenting_the_user_show_page "Chapter 11.2.1"

data/lib/generators/chapter11_2/begin/snippets/custom.css

@@ -0,0 +1,59 @@
+
+/************************/
+/* Through Chapter 11.2 */
+/************************/
+
+h1.micropost {
+  margin-bottom: 0.3em;
+}
+
+table.microposts {
+  margin-top: 1em;
+}
+
+table.microposts tr {
+  height: 70px;
+}
+
+table.microposts tr td.gravatar {
+  border-top: 1px solid #ccc;
+  vertical-align: top;
+  width: 50px;
+}
+
+table.microposts tr td.micropost {
+  border-top: 1px solid #ccc;
+  vertical-align: top;
+  padding-top: 10px;
+}
+
+table.microposts tr td.micropost span.timestamp {
+  display: block;
+  font-size: 85%;
+  color: #666;
+}
+
+div.user_info img {
+  padding-right: 0.1em;
+}
+
+div.user_info a {
+  text-decoration: none;
+}
+
+div.user_info span.user_name {
+  position: absolute;
+}
+
+div.user_info span.microposts {
+  font-size: 80%;
+}
+
+form.new_micropost {
+  margin-bottom: 2em;
+}
+
+form.new_micropost textarea {
+  height: 4em;
+  margin-bottom: 0;
+}

data/lib/generators/chapter11_2/begin/templates/app/views/users/show.html.erb

@@ -0,0 +1,23 @@
+<table class="profile" summary="Profile information">
+  <tr>
+    <td class="main">
+      <h1>
+        <%= gravatar_for @user %>
+        <%= @user.name %>
+      </h1>
+      <%# only if microposts exist, should the content below be rendered %>
+        <table class="microposts" summary="User microposts">
+          (The list of microposts should show up here, if there are any.)
+        </table>
+        <!--<%#= (pagination here, optional) %>-->
+      <%# end %>
+    </td>
+    <td class="sidebar round">
+      <strong>Name</strong> <%= @user.name %>
+      <br/>
+      <strong>URL</strong> <%= link_to user_path(@user.id), @user %>
+      <br/>
+      <strong>Microposts</strong> (The total count of Microposts should be here.)
+    </td>
+  </tr>
+</table>

data/lib/generators/chapter11_2/begin/templates/spec/controllers/users_controller_11_2_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+
+describe UsersController do
+
+  describe "GET 'show'" do
+
+    before(:each) do
+      @user = Factory(:user)
+      @mp1 = Factory(:micropost, :user => @user, :content => "Foo bar", :created_at => 1.day.ago)
+      @mp2 = Factory(:micropost, :user => @user, :content => "Baz quux",:created_at => 2.days.ago)
+    end
+
+    it 'should populate the @microposts instance variable' do
+      get :show, :id => @user.id
+      # Note: in a controller test, we can access instance variables
+      # of the controller by using the assigns[] function
+      assigns[:microposts].should == [@mp1,@mp2]
+    end
+
+    describe "HTML output" do
+      render_views
+
+      it "should show the user's microposts" do
+        get :show, :id => @user.id
+        response.should have_selector("span.content", :content => @mp1.content)
+        response.should have_selector("span.content", :content => @mp2.content)
+      end
+    end
+  end
+
+end

data/lib/generators/chapter11_2/solutions/USAGE

@@ -0,0 +1,18 @@
+Description:
+    Wraps up Test-First Teaching exercises adapted from Chapter 11.2 of the RailsTutorial by Michael Hartl.
+
+Example:
+    rails generate chapter11:solutions
+
+    This copies the solutions and other necessary files (e.g. images, assets, helpers, etc.) into the project
+    to conclude Chapter 11.2. This should make all tests pass and bring you in sync to the application at
+    the end of Chapter 11.2.
+
+    If you already have a solution file, you'll be prompted whether you want to overwrite your file,
+    see the difference, or keep your file.
+
+    It's a good idea to commit your changes to git, prior to running finish, in case you accidentally choose to
+    overwrite files you wanted to keep. Assuming your project is already git-controlled, you can commit changes with:
+
+    git add .
+    git commit -m "comment here explaining WHY you made the changes"

data/lib/generators/{chapter11 → chapter11_2}/solutions/solutions_generator.rb

@@ -1,4 +1,4 @@
-module Chapter11
+module Chapter11_2
   module Generators
     class SolutionsGenerator < Rails::Generators::Base
     end

data/lib/generators/chapter11_2/solutions/templates/app/controllers/users_controller.rb

@@ -0,0 +1,29 @@
+class UsersController < ApplicationController
+
+  before_filter :authenticate_user!, :only => [:index, :destroy]
+  before_filter :admin_user,         :only => :destroy
+
+  def show
+    @user = User.find(params[:id])
+    @microposts = @user.microposts.paginate(:page => params[:page])
+    @title = @user.name
+  end
+
+  def index
+    @title = "All users"
+    @users = User.paginate(:page => params[:page])
+  end
+
+  def destroy
+    User.find(params[:id]).destroy
+    flash[:notice] = "User destroyed."
+    redirect_to users_path
+  end
+
+  private
+
+  def admin_user
+    redirect_to(root_path) unless current_user.admin?
+  end
+
+end

data/lib/generators/chapter11_2/solutions/templates/app/views/microposts/_micropost.html.erb

@@ -0,0 +1,8 @@
+<tr>
+  <td class="micropost">
+    <span class="content"><%= micropost.content %></span>
+    <span class="timestamp">
+      Posted <%= time_ago_in_words(micropost.created_at) %> ago.
+    </span>
+  </td>
+</tr>

data/lib/generators/chapter11_2/solutions/templates/app/views/users/show.html.erb

@@ -0,0 +1,23 @@
+<table class="profile" summary="Profile information">
+  <tr>
+    <td class="main">
+      <h1>
+        <%= gravatar_for @user %>
+        <%= @user.name %>
+      </h1>
+      <% unless @user.microposts.empty? %>
+        <table class="microposts" summary="User microposts">
+          <%= render @microposts %>
+        </table>
+        <%= will_paginate @microposts %>
+      <% end %>
+    </td>
+    <td class="sidebar round">
+      <strong>Name</strong> <%= @user.name %>
+      <br/>
+      <strong>URL</strong> <%= link_to user_path(@user.id), @user %>
+      <br/>
+      <strong>Microposts</strong> <%= @user.microposts.count %>
+    </td>
+  </tr>
+</table>

data/lib/generators/chapter11_3/begin/begin_generator.rb

@@ -0,0 +1,24 @@
+module Chapter11_3
+  module Generators
+    class BeginGenerator < Rails::Generators::Base
+      source_root File.expand_path("../templates", __FILE__)
+
+      def copy_app_tree
+        directory(self.class.source_root, Rails.root)
+      end
+
+      def generate_instructions
+        require 'rdiscount'
+        
+        instr_md = File.expand_path('../instructions.md',self.class.source_root)
+        return unless File.exists?(instr_md)
+        dest = File.join(Rails.root,'doc','chapter11_3.html')
+        copy_file(instr_md, dest, :force => true) do |content|
+          RDiscount.new(content).to_html
+        end
+        say_status('Note',"Now open file://#{dest} in your web browser for instructions", :cyan)
+      end
+
+    end
+  end
+end

data/lib/generators/chapter11_3/begin/instructions.md

@@ -0,0 +1,80 @@
+RailsTutorial Chapter 11.3 Test-First Teaching Instructions
+===========================================================
+
+Controller
+----------
+
+In this sub-chapter we're adding controllers and views to create and delete
+microposts.
+
+When you first run `rake spec`, you'll get an error like below and no specs will execute.
+
+    uninitialized constant MicropostsController (NameError)
+
+This is because we don't have this class defined yet. So, go ahead and create it using the rails generators:
+
+_Note_: **Microposts is in plural here** (Rails convention for controllers).
+
+    rails g controller Microposts --controller-specs=false --view-specs=false --helper-specs=false
+
+Note: The controller generatore (unlike the model generator), we can instruct to suppress
+the spec files.
+
+Routing
+-------
+
+The next error will have to do with routing. Add a resource route for microposts.
+Consider which actions are needed, by checking what tests case exist and
+by carefully reading the test failure messages.
+Then use the `:only => [...]` option to restrict the routes generated.
+
+Views
+-----
+
+The tests will fail then complaining of missing view templates. Before you
+go on to create micropost view templates, view the design mock-up
+in Rails Tutorial [Chapter 11.3.2][chapter_11_3_2]. What view template
+should hold the form fields to entering a micropost? If not a micropost
+view, how can we tell the controller to render another view?
+
+For a reference on the view templates, check [Listing 11.27][listing_11_27],
+[Listing 11.28][listing_11_28] and [Listing 11.29][listing_11_29]
+
+Controller Actions
+------------------
+
+Next you'll need to implement the controller actions. For `create` there
+are two branches, one for when saving the new record succeeds, i.e.
+when validations pass, and one for when it fails.
+
+Also, review the test cases carefully and consider if any of the actions
+are supposed to be access controlled. Some test failures may look a bit
+obscure when access control is not implemented.
+
+The `destroy` action needs to make sure that only the use who created
+the post can also delete it. Consider using the association methods
+to constrain the seach for microposts to the currently signed-in user.
+
+Display
+-------
+
+Take a moment to think about how you could show the user's posts
+on the home page. There is no test for this, take a stab at it with
+the tools and knowledge you now have.
+
+Rails Concepts Covered
+======================
+
+* Using controller generator
+* Resource routes
+* Controller render method
+* Difference render & redirect, also redirect_to :back
+* Access control
+* Accessing records through an association (Association Proxy Methods)
+* Controller create/update action pattern: success/failure branches
+* find_by_id vs. find
+
+[chapter_11_3_2]: http://ruby.railstutorial.org/chapters/user-microposts#sec:creating_microposts "Chapter 11.3.2"
+[listing_11_27]: http://ruby.railstutorial.org/chapters/user-microposts#code:microposts_home_page "Listing 11.27"
+[listing_11_28]: http://ruby.railstutorial.org/chapters/user-microposts#code:micropost_form "Listing 11.28"
+[listing_11_29]: http://ruby.railstutorial.org/chapters/user-microposts#code:user_info "Listing 11.29"

data/lib/generators/chapter11_3/begin/templates/spec/controllers/microposts_controllers_11_3_spec.rb

@@ -0,0 +1,102 @@
+require 'spec_helper'
+
+describe MicropostsController do
+  render_views
+
+  describe "access control" do
+
+    it "should deny access to 'create'" do
+      post :create
+      response.should redirect_to(new_user_session_path)
+    end
+
+    it "should deny access to 'destroy'" do
+      delete :destroy, :id => 1
+      response.should redirect_to(new_user_session_path)
+    end
+  end
+
+  describe "POST 'create'" do
+
+    before(:each) do
+      @user = Factory(:user)
+      sign_in(@user)
+    end
+
+    describe "failure" do
+
+      before(:each) do
+        @attr = { :content => "" }
+      end
+
+      it "should not create a micropost" do
+        lambda do
+          post :create, :micropost => @attr
+        end.should_not change(Micropost, :count)
+      end
+
+      it "should render the home page" do
+        post :create, :micropost => @attr
+        response.should render_template('pages/home')
+      end
+    end
+
+    describe "success" do
+
+      before(:each) do
+        @attr = { :content => "Lorem ipsum" }
+      end
+
+      it "should create a micropost" do
+        lambda do
+          post :create, :micropost => @attr
+        end.should change(Micropost, :count).by(1)
+      end
+
+      it "should redirect to the home page" do
+        post :create, :micropost => @attr
+        response.should redirect_to(root_path)
+      end
+
+      it "should have a flash message" do
+        post :create, :micropost => @attr
+        flash[:success].should =~ /micropost created/i
+      end
+    end
+  end
+
+  describe "DELETE 'destroy'" do
+
+    describe "for an unauthorized user" do
+
+      before(:each) do
+        @user = Factory(:user)
+        wrong_user = Factory(:user, :email => Factory.next(:email))
+        sign_in(wrong_user)
+        @micropost = Factory(:micropost, :user => @user)
+      end
+
+      it "should deny access" do
+        delete :destroy, :id => @micropost
+        response.should redirect_to(root_path)
+      end
+    end
+
+    describe "for an authorized user" do
+
+      before(:each) do
+        @user = Factory(:user)
+        sign_in(@user)
+        @micropost = Factory(:micropost, :user => @user)
+        request.env["HTTP_REFERER"] = user_path(@user) # for redirect_to :back
+      end
+
+      it "should destroy the micropost" do
+        lambda do
+          delete :destroy, :id => @micropost
+        end.should change(Micropost, :count).by(-1)
+      end
+    end
+  end
+
+end

data/lib/generators/chapter11_3/begin/templates/spec/controllers/pages_controller_11_3_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe PagesController do
+
+  before do
+    @user = Factory(:user)
+    sign_in @user
+  end
+
+  it 'home page should instantiate a new micropost instance' do
+    get :home
+    assigns[:micropost].should_not be_nil
+  end
+end

data/lib/generators/chapter11_3/solutions/solutions_generator.rb

@@ -0,0 +1,8 @@
+module Chapter11_3
+  module Generators
+    class SolutionsGenerator < Rails::Generators::Base
+
+
+    end
+  end
+end

metadata

@@ -2,7 +2,7 @@
 name: tft_rails
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors: 
 - Wolfram Arnold
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-21 00:00:00 Z
+date: 2011-07-22 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rdiscount
@@ -33,6 +33,13 @@ extra_rdoc_files: []
 
 files: 
 - lib/tft_rails.rb
+- lib/generators/chapter11_3/begin/USAGE
+- lib/generators/chapter11_3/begin/begin_generator.rb
+- lib/generators/chapter11_3/begin/instructions.md
+- lib/generators/chapter11_3/begin/templates/spec/controllers/pages_controller_11_3_spec.rb
+- lib/generators/chapter11_3/begin/templates/spec/controllers/microposts_controllers_11_3_spec.rb
+- lib/generators/chapter11_3/solutions/USAGE
+- lib/generators/chapter11_3/solutions/solutions_generator.rb
 - lib/generators/chapter07/begin/USAGE
 - lib/generators/chapter07/begin/begin_generator.rb
 - lib/generators/chapter07/begin/instructions.md
@@ -104,6 +111,17 @@ files:
 - lib/generators/chapter07/solutions/templates/app/views/layouts/_header.html.erb
 - lib/generators/chapter07/solutions/templates/app/views/layouts/_footer.html.erb
 - lib/generators/chapter07/solutions/templates/app/views/users/show.html.erb
+- lib/generators/chapter11_2/begin/USAGE
+- lib/generators/chapter11_2/begin/begin_generator.rb
+- lib/generators/chapter11_2/begin/instructions.md
+- lib/generators/chapter11_2/begin/snippets/custom.css
+- lib/generators/chapter11_2/begin/templates/spec/controllers/users_controller_11_2_spec.rb
+- lib/generators/chapter11_2/begin/templates/app/views/users/show.html.erb
+- lib/generators/chapter11_2/solutions/USAGE
+- lib/generators/chapter11_2/solutions/solutions_generator.rb
+- lib/generators/chapter11_2/solutions/templates/app/controllers/users_controller.rb
+- lib/generators/chapter11_2/solutions/templates/app/views/microposts/_micropost.html.erb
+- lib/generators/chapter11_2/solutions/templates/app/views/users/show.html.erb
 - lib/generators/chapter10/begin/USAGE
 - lib/generators/chapter10/begin/begin_generator.rb
 - lib/generators/chapter10/begin/instructions.md
@@ -138,11 +156,18 @@ files:
 - lib/generators/chapter08_09/solutions/templates/app/views/devise/passwords/new.html.erb
 - lib/generators/chapter08_09/solutions/templates/app/views/devise/passwords/edit.html.erb
 - lib/generators/chapter08_09/solutions/templates/app/views/devise/sessions/new.html.erb
-- lib/generators/chapter11/begin/USAGE
-- lib/generators/chapter11/begin/begin_generator.rb
-- lib/generators/chapter11/begin/instructions.md
-- lib/generators/chapter11/solutions/USAGE
-- lib/generators/chapter11/solutions/solutions_generator.rb
+- lib/generators/chapter11_1/begin/USAGE
+- lib/generators/chapter11_1/begin/begin_generator.rb
+- lib/generators/chapter11_1/begin/instructions.md
+- lib/generators/chapter11_1/begin/templates/lib/tasks/same_data.rake
+- lib/generators/chapter11_1/begin/templates/spec/models/user_11_1_spec.rb
+- lib/generators/chapter11_1/begin/templates/spec/models/microposts_11_1_spec.rb
+- lib/generators/chapter11_1/solutions/USAGE
+- lib/generators/chapter11_1/solutions/solutions_generator.rb
+- lib/generators/chapter11_1/solutions/snippets/migration_create_microposts.rb
+- lib/generators/chapter11_1/solutions/templates/spec/factories.rb
+- lib/generators/chapter11_1/solutions/templates/app/model/user.rb
+- lib/generators/chapter11_1/solutions/templates/app/model/micropost.rb
 - LICENSE
 - Rakefile
 - Gemfile

data/lib/generators/chapter11/begin/instructions.md

@@ -1,2 +0,0 @@
-RailsTutorial Chapter 11 Test-First Teaching Instructions
-=========================================================