tft_rails_dbc 0.1

data/lib/generators/chapter07/begin/templates/public/stylesheets/custom.css

@@ -0,0 +1,137 @@
+.container {
+  width: 710px;
+}
+
+body {
+  background: #cff;
+}
+
+header {
+  padding-top: 20px;
+}
+
+header img {
+  padding: 1em;
+  background: #fff;
+}
+
+section {
+  margin-top: 1em;
+  font-size: 120%;
+  padding: 20px;
+  background: #fff;
+}
+
+section h1 {
+  font-size: 200%;
+}
+
+/* Links */
+
+a {
+  color: #09c;
+  text-decoration: none;
+}
+
+a:hover {
+  color: #069;
+  text-decoration: underline;
+}
+
+a:visited {
+  color: #069;
+}
+
+/* Navigation */
+
+nav {
+  float: right;
+}
+
+nav {
+  background-color: white;
+  padding: 0 0.7em;
+  white-space: nowrap;
+}
+
+nav ul {
+  margin: 0;
+  padding: 0;
+}
+
+nav ul li {
+  list-style-type: none;
+  display: inline-block;
+  padding: 0.2em 0;
+}
+
+nav ul li a {
+  padding: 0 5px;
+  font-weight: bold;
+}
+
+nav ul li a:visited {
+  color: #09c;
+}
+
+nav ul li a:hover {
+  text-decoration: underline;
+}
+
+/* Sign up button */
+
+a.signup_button {
+  margin-left: auto;
+  margin-right: auto;
+  display: block;
+  text-align: center;
+  width: 190px;
+  color: #fff;
+  background: #006400;
+  font-size: 150%;
+  font-weight: bold;
+  padding: 20px;
+}
+
+/* Round corners */
+
+.round {
+  -moz-border-radius:    10px;
+  -webkit-border-radius: 10px;
+  border-radius:         10px;
+}
+
+footer {
+  text-align: center;
+  margin-top: 10px;
+  width: 710px;
+  margin-left: auto;
+  margin-right: auto;
+}
+
+footer nav {
+  float: none;
+}
+
+/* User show page */
+table.profile {
+    width: 100%;
+    margin-bottom: 0;
+}
+
+td.main {
+    width: 70%;
+    padding: 1em;
+}
+
+td.sidebar {
+    width: 30%;
+    padding: 1em;
+    vertical-align: top;
+    background: #ffc;
+}
+
+.profile img.gravatar {
+    border: 1px solid #999;
+    margin-bottom: -15px;
+}

data/lib/generators/chapter07/begin/templates/spec/controllers/pages_controller_07_spec.rb

@@ -0,0 +1,48 @@
+require 'spec_helper'
+
+describe PagesController do
+  render_views
+
+  before(:each) do
+    @base_title = 'Ruby on Rails Tutorial Sample App'
+  end
+
+  describe "GET 'home'" do
+    it "should be successful" do
+      get 'home'
+      response.should be_success
+    end
+    
+    it "should have the right title" do
+      get 'home'
+      response.should have_selector("title",
+                                    :content => @base_title + " | Home")
+    end
+  end
+
+  describe "GET 'contact'" do
+    it "should be successful" do
+      get 'contact'
+      response.should be_success
+    end
+
+    it "should have the right title" do
+      get 'contact'
+      response.should have_selector("title",
+                                    :content => @base_title + " | Contact")
+    end
+  end
+
+  describe "GET 'about'" do
+    it "should be successful" do
+      get 'about'
+      response.should be_success
+    end
+
+    it "should have the right title" do
+      get 'about'
+      response.should have_selector("title",
+                                    :content => @base_title + " | About")
+    end
+  end
+end

data/lib/generators/chapter07/begin/templates/spec/controllers/users_controller_07_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe UsersController do
+  render_views
+
+  describe "GET 'show'" do
+    
+    before(:each) do
+      @user = Factory(:user)
+    end
+    
+    it "should be successful" do
+      get :show, :id => @user
+      response.should be_success
+    end
+
+    it "should find the right user" do
+      get :show, :id => @user
+      assigns(:user).should == @user
+    end
+
+    it "should have the right title" do
+      get :show, :id => @user
+      response.should have_selector("title", :content => @user.name)
+    end
+
+    it "should include the user's name" do
+      get :show, :id => @user
+      response.should have_selector("h1", :content => @user.name)
+    end
+
+    it "should have a profile image" do
+      get :show, :id => @user
+      response.should have_selector("h1>img", :class => "gravatar")
+    end
+  end
+  
+end

data/lib/generators/chapter07/begin/templates/spec/factories.rb

@@ -0,0 +1,9 @@
+# By using the symbol ':user', we get Factory Girl to simulate the User model.
+FactoryGirl.define do 
+  factory :user do
+    name                  "Michael Hartl"
+    email                 "mhartl@example.com"
+    password              "foobar"
+    password_confirmation "foobar"
+  end
+end

data/lib/generators/chapter07/begin/templates/spec/models/user_07_spec.rb

@@ -0,0 +1,38 @@
+require 'spec_helper'
+
+describe User do
+
+  it "has a name method" do
+    # Note: Ruby has a way to ask a class if it has a certain method defined,
+    # like User.respond_to?(:name) returns true or false depending on whether the
+    # class has a method called "name" defined on it
+    # RSpec's way of asserting this is with "should respond_to(:method_name)"
+
+    # Question: How does ActiveRecord know there is a name method? There is no such
+    # method explicitly defined in the class (user.rb)
+    User.should respond_to(:name)
+  end
+
+  it "can set and read back name" do
+    u = User.new
+    u.name = 'Joe Smith'
+    u.name.should == 'Joe Smith'
+  end
+
+  it "requires a name" do
+    no_name_user = User.new  # Note: no attributes set at all, i.e. name is nil
+    # Note: the errors array on a model object is populated when valid? is called
+    # RSpec's be_valid is a fancy way of saying valid?.should == true
+    # This will call valid, and populate the error array, so we can check
+    # what failure occurred
+    no_name_user.should_not be_valid
+    no_name_user.errors[:name].should == ["can't be blank"]
+  end
+
+  it "rejects names that are too long" do
+    long_name_user = User.new(:name => 'a' * 51)
+    long_name_user.should_not be_valid
+    long_name_user.errors[:name].should == ["is too long (maximum is 50 characters)"]
+  end
+
+end

data/lib/generators/chapter07/begin/templates/spec/requests/layout_links_07_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe "LayoutLinks" do
+
+  it "should have a Home page at '/'" do
+    get '/'
+    response.should have_selector('title', :content => "Home")
+  end
+
+  it "should have a Contact page at '/contact'" do
+    get '/contact'
+    response.should have_selector('title', :content => "Contact")
+  end
+
+  it "should have an About page at '/about'" do
+    get '/about'
+    response.should have_selector('title', :content => "About")
+  end
+
+  it "should have a Help page at '/help'" do
+    get '/help'
+    response.should have_selector('title', :content => "Help")
+  end
+
+  it "should have a signup page at '/signup'" do
+    get '/signup'
+    response.should be_success
+  end
+
+  it "should have the right links on the layout" do
+    visit root_path
+    click_link "About"
+    response.should have_selector('title', :content => "About")
+    click_link "Help"
+    response.should have_selector('title', :content => "Help")
+    click_link "Contact"
+    response.should have_selector('title', :content => "Contact")
+    click_link "Home"
+    response.should have_selector('title', :content => "Home")
+    click_link "Sign up now!"
+    response.should be_success
+  end
+
+end

data/lib/generators/chapter07/begin/templates/spec/spec_helper.rb

@@ -0,0 +1,39 @@
+# This file is copied to spec/ when you run 'rails generate rspec:install'
+ENV["RAILS_ENV"] ||= 'test'
+require File.expand_path("../../config/environment", __FILE__)
+require 'rspec/rails'
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[Rails.root.join("spec/support/**/*.rb")].each {|f| require f}
+
+Webrat.configure do |config|
+  config.mode = :rack
+end
+
+module Webrat::Logging
+  def logger
+    Rails.logger  # log to test.log, rather than webrat.log
+  end
+end
+
+RSpec.configure do |config|
+  # == Mock Framework
+  #
+  # If you prefer to use mocha, flexmock or RR, uncomment the appropriate line:
+  #
+  # config.mock_with :mocha
+  # config.mock_with :flexmock
+  # config.mock_with :rr
+  config.mock_with :rspec
+
+  # Remove this line if you're not using ActiveRecord or ActiveRecord fixtures
+  config.fixture_path = "#{::Rails.root}/spec/fixtures"
+
+  # If you're not using ActiveRecord, or you'd prefer not to run each of your
+  # examples within a transaction, remove the following line or assign false
+  # instead of true.
+  config.use_transactional_fixtures = true
+
+  config.include Devise::TestHelpers, :type => :controller
+end

data/lib/generators/chapter07/solutions/USAGE

@@ -0,0 +1,21 @@
+Description:
+    Wraps up Test-First Teaching exercises adapted from Chapter 07 of the RailsTutorial by Michael Hartl.
+
+Example:
+    rails generate chapter07:solutions
+
+    This copies the solutions and other necessary files (e.g. images, assets, helpers, etc.) into the project
+    to conclude chapter 07. This should make all tests pass and bring you in sync to the application at
+    the end of chapter 07.
+
+    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/chapter07/solutions/solutions_generator.rb

@@ -0,0 +1,23 @@
+module Chapter07
+  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_help_route
+
+        dest = File.join(Rails.root,'config','routes.rb')
+        insert_into_file(dest, :after => %r{/about.*:to.*pages#about.*$}) do
+          "\n  match '/help',    :to => 'pages#help'"
+        end
+      end
+
+      def remove_static_index_html_file
+        remove_file(File.join(Rails.root, 'public', 'index.html'))
+      end
+    end
+  end
+end

data/lib/generators/chapter07/solutions/templates/app/controllers/pages_controller.rb

@@ -0,0 +1,18 @@
+class PagesController < ApplicationController
+  def home
+    @title = 'Home'
+  end
+
+  def contact
+    @title = 'Contact'
+  end
+
+  def about
+    @title = 'About'
+  end
+
+  def help
+    @title = 'Help'
+  end
+
+end

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

@@ -0,0 +1,8 @@
+class UsersController < ApplicationController
+
+  def show
+    @user = User.find(params[:id])
+    @title = @user.name
+  end
+
+end

data/lib/generators/chapter07/solutions/templates/app/models/user.rb

@@ -0,0 +1,11 @@
+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
+end

data/lib/generators/chapter07/solutions/templates/app/views/layouts/_footer.html.erb

@@ -0,0 +1,10 @@
+<footer>
+  <nav class="round">
+    <ul>
+      <li><%= link_to "About", about_path %></li>
+      <li><%= link_to "Contact", contact_path %></li>
+      <li><a href="http://news.railstutorial.org/">News</a></li>
+      <li><a href="http://www.railstutorial.org/">Rails Tutorial</a></li>
+    </ul>
+  </nav>
+</footer>

data/lib/generators/chapter07/solutions/templates/app/views/layouts/_header.html.erb

@@ -0,0 +1,11 @@
+<header>
+  <% logo = image_tag("logo.png", :alt => "Sample App", :class => "round") %>
+  <%= link_to logo, root_path %>
+  <nav class="round">
+    <ul>
+      <li><%= link_to "Home", root_path %></li>
+      <li><%= link_to "Help", help_path %></li>
+      <li><%= link_to "Sign in", '#' %></li>
+    </ul>
+  </nav>
+</header>

data/lib/generators/chapter07/solutions/templates/app/views/pages/help.html.erb

@@ -0,0 +1,4 @@
+<h1>Help Page</h1>
+<p>
+  Welcome here. Hope you find some answers...
+</p>

data/lib/generators/chapter07/solutions/templates/app/views/pages/home.html.erb

@@ -0,0 +1,7 @@
+<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" %>

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

@@ -0,0 +1,15 @@
+<table class="profile" summary="Profile information">
+  <tr>
+    <td class="main">
+      <h1>
+        <%= gravatar_for @user %>
+        <%= @user.name %>
+      </h1>
+    </td>
+    <td class="sidebar round">
+      <strong>Name</strong> <%= @user.name %>
+      <br/>
+      <strong>URL</strong> <%= link_to user_path(@user.id), @user %>
+    </td>
+  </tr>
+</table>

data/lib/generators/chapter08_09/begin/USAGE

@@ -0,0 +1,24 @@
+Description:
+    Begins Test-First Teaching exercises adapted from Chapters 08, 09 of the RailsTutorial by Michael Hartl.
+
+    It is assumed that this generator is run after the exercises for Chapter 07 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 chapter08_09: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 Chapters 08, 09 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 chapter08_09: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/chapter08_09/begin/begin_generator.rb

@@ -0,0 +1,29 @@
+module Chapter08_09
+  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)
+        dest = File.join(Rails.root,'doc','chapter08_09.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/chapter08_09/begin/instructions.md

@@ -0,0 +1,65 @@
+RailsTutorial Chapters 08, 09 Test-First Teaching Instructions
+=========================================================
+
+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
+industry-standard Rails authentication solution.
+
+Devise provides its own controllers, models and views that
+are seamlessly loaded into the running appliction.
+
+Devise's native views, however, do not quite conform to our needs.
+Many tests pass out of the box, but the few that aren't give
+important clues as to how we need to customize Devise's default
+view templates.
+
+Run the server:
+
+    rails server
+
+and then browse to <http://localhost:3000/signup>. Try signing
+up. What problem do you see? What is going wrong here?
+
+This issue is replicated in the new test file for Chapter 08,
+`specs/controllers/devise/registrations_controller_08_spec.rb`.
+
+Notice how the test refers to `Devise::RegistrationsController`
+which is the controller handling registration provided by
+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]
+to learn about how to customize views. That what we'll
+need to do. Hint: You'll need to run a Devise generator.
+
+Sign in
+-------
+
+Chapter 09 of RailsTutorial covers sign-in, but we cover it together with sign-up,
+because Devise provides both in one fell swoop.
+
+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 `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.
+
+(Note that Devise supports multiple sign-in scopes, e.g. for regular users and
+for admins. The method `signed_in?` checks that any scope is signed in. To
+check for a specific scope, the method `user_signed_in?` is available. For the
+purpose of RailsTutorial with Devise, this distinction is not important since
+we only have one type of user. Admin privileges are implemented differently,
+with the admin flag)
+
+[devise]: https://github.com/plataformatec/devise "Devise on github"

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

@@ -0,0 +1,49 @@
+
+/**********************/
+/* Through Chapter 08 */
+/**********************/
+
+div.field, div.actions {
+  margin-bottom: 10px;
+}
+
+.field_with_errors {
+  margin-top: 10px;
+  padding: 2px;
+  background-color: red;
+  display: table;
+}
+
+.field_with_errors label {
+  color: #fff;
+}
+
+#error_explanation {
+  width: 400px;
+  border: 2px solid red;
+  padding: 7px;
+  padding-bottom: 12px;
+  margin-bottom: 20px;
+  background-color: #f0f0f0;
+}
+
+#error_explanation h2 {
+  text-align: left;
+  font-weight: bold;
+  padding: 5px 5px 5px 15px;
+  font-size: 12px;
+  margin: -7px;
+  background-color: #c00;
+  color: #fff;
+}
+
+#error_explanation p {
+  color: #333;
+  margin-bottom: 0;
+  padding: 5px;
+}
+
+#error_explanation ul li {
+  font-size: 12px;
+  list-style: square;
+}