tft_rails_dbc 0.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_2/solutions/solutions_generator.rb

@@ -0,0 +1,12 @@
+module Chapter11_2
+  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
+
+    end
+  end
+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/USAGE

@@ -0,0 +1,24 @@
+Description:
+    Begins Test-First Teaching exercises adapted from Chapter 11 of the RailsTutorial by Michael Hartl.
+
+    It is assumed that this generator is run after the exercises for Chapter 10 and all prior ones 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: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 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 chapter10: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_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/app/views/pages/home.html.erb

@@ -0,0 +1,24 @@
+<% if signed_in? %>
+  <table class="front" summary="For signed-in users">
+    <tr>
+      <td class="main">
+        <h1 class="micropost">What's up?</h1>
+        <%#= micropost form %>
+        <%#= feed of microposts %>
+      </td>
+      <td class="sidebar round">
+        <%#= sidebar with user info (name, image link) %>
+      </td>
+    </tr>
+  </table>
+<% else %>
+  <h1>Sample App</h1>
+
+  <p>
+    This is the home page for the
+    <a href="http://railstutorial.org/">Ruby on Rails Tutorial</a>
+    sample application.
+  </p>
+
+  <%= link_to "Sign up now!", signup_path, :class => "signup_button round" %>
+<% end %>

data/lib/generators/chapter11_3/begin/templates/app/views/shared/_feed.html.erb

@@ -0,0 +1,6 @@
+<%# if there are feed items %>
+  <table class="microposts" summary="User microposts">
+    <%#= display feed items here %>
+  </table>
+  <%#= pagination ? %>
+<%# end %>

data/lib/generators/chapter11_3/begin/templates/app/views/shared/_feed_item.html.erb

@@ -0,0 +1,14 @@
+<tr>
+  <td class="gravatar">
+    <%# image %>
+  </td>
+  <td class="micropost">
+    <span class="user">
+      <%#= link to user %>
+    </span>
+    <span class="content"><%#= content of feed entry (i.e. a micropost) %></span>
+    <span class="timestamp">
+      Posted <%#= posting time of micropost %> ago.
+    </span>
+  </td>
+</tr>

data/lib/generators/chapter11_3/begin/templates/app/views/shared/_micropost_form.html.erb

@@ -0,0 +1,9 @@
+<%#= form helper  %>
+  <%#=  error display %>
+  <div class="field">
+    <%#= content form field  %>
+  </div>
+  <div class="actions">
+    <%#= submit button %>
+  </div>
+<%# end %>

data/lib/generators/chapter11_3/begin/templates/app/views/shared/_user_info.html.erb

@@ -0,0 +1,11 @@
+<div class="user_info">
+  <a href="<%#= link to user %>">
+    <%#= user's image %>
+    <span class="user_name">
+      <%#= user's name %>
+    </span>
+    <span class="microposts">
+      <%# number of user's microposts %>
+    </span>
+  </a>
+</div>

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

@@ -0,0 +1,103 @@
+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)
+        request.env["HTTP_REFERER"] = root_path
+      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/begin/templates/spec/models/user_11_3_spec.rb

@@ -0,0 +1,31 @@
+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
+
+    describe "status feed" do
+
+      it "should have a feed" do
+        @user.should respond_to(:feed)
+      end
+
+      it "should include the user's microposts" do
+        @user.feed.include?(@mp1).should be_true
+        @user.feed.include?(@mp2).should be_true
+      end
+
+      it "should not include a different user's microposts" do
+        mp3 = Factory(:micropost,
+                      :user => Factory(:user, :email => Factory.next(:email)))
+        @user.feed.include?(mp3).should be_false
+      end
+    end
+  end
+end

data/lib/generators/chapter11_3/begin/templates/spec/requests/micropost_11_3_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+describe "Microposts" do
+
+  before(:each) do
+    user = Factory(:user)
+    visit signin_path
+    fill_in :email,    :with => user.email
+    fill_in :password, :with => user.password
+    click_button
+  end
+
+  describe "creation" do
+
+    describe "failure" do
+
+      it "should not make a new micropost" do
+        lambda do
+          visit root_path
+          fill_in :micropost_content, :with => ""
+          click_button
+          response.should render_template('pages/home')
+          response.should have_selector("div#error_explanation")
+        end.should_not change(Micropost, :count)
+      end
+    end
+
+    describe "success" do
+
+      it "should make a new micropost" do
+        content = "Lorem ipsum dolor sit amet"
+        lambda do
+          visit root_path
+          fill_in :micropost_content, :with => content
+          click_button
+          response.should have_selector("span.content", :content => content)
+        end.should change(Micropost, :count).by(1)
+      end
+    end
+  end
+end

data/lib/generators/chapter11_3/solutions/USAGE

@@ -0,0 +1,18 @@
+Description:
+    Wraps up Test-First Teaching exercises adapted from Chapter 10 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. This should make all tests pass and bring you in sync to the application at
+    the end of Chapter 11.
+
+    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_3/solutions/solutions_generator.rb

@@ -0,0 +1,30 @@
+module Chapter11_3
+  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_microposts_resource
+        dest = File.join(Rails.root,'config','routes.rb')
+        insert_into_file(dest, :after => %r{resources\s+:users.*$}) do
+          "\n  resources :microposts, :only => [:create, :destroy]"
+        end
+      end
+
+      def add_feed_method_to_user
+        dest = File.join(Rails.root, 'app', 'models', 'user.rb')
+        insert_into_file(dest, :before => /end\s*\Z/) do # insert before end
+          <<-CODE.gsub(/^\s+\|/,'  ')
+            |def feed
+            |  microposts
+            |end
+          CODE
+        end
+      end
+
+    end
+  end
+end

data/lib/generators/chapter11_3/solutions/templates/app/controllers/microposts_controller.rb

@@ -0,0 +1,20 @@
+class MicropostsController < ApplicationController
+  before_filter :authenticate_user!
+
+  def create
+    @micropost  = current_user.microposts.build(params[:micropost])
+    if @micropost.save
+      flash[:success] = "Micropost created!"
+      redirect_to root_path
+    else
+      render 'pages/home'
+    end
+  end
+
+ def destroy
+   # .try will call the method given, unless the caller is nil
+   current_user.microposts.find_by_id(params[:id]).try(:destroy)
+   redirect_to :back
+ end
+
+end