forem 0.0.1

data/spec/dummy/public/javascripts/rails.js

@@ -0,0 +1,192 @@
+(function() {
+  // Technique from Juriy Zaytsev
+  // http://thinkweb2.com/projects/prototype/detecting-event-support-without-browser-sniffing/
+  function isEventSupported(eventName) {
+    var el = document.createElement('div');
+    eventName = 'on' + eventName;
+    var isSupported = (eventName in el);
+    if (!isSupported) {
+      el.setAttribute(eventName, 'return;');
+      isSupported = typeof el[eventName] == 'function';
+    }
+    el = null;
+    return isSupported;
+  }
+
+  function isForm(element) {
+    return Object.isElement(element) && element.nodeName.toUpperCase() == 'FORM';
+  }
+
+  function isInput(element) {
+    if (Object.isElement(element)) {
+      var name = element.nodeName.toUpperCase();
+      return name == 'INPUT' || name == 'SELECT' || name == 'TEXTAREA';
+    }
+    else return false;
+  }
+
+  var submitBubbles = isEventSupported('submit'),
+      changeBubbles = isEventSupported('change');
+
+  if (!submitBubbles || !changeBubbles) {
+    // augment the Event.Handler class to observe custom events when needed
+    Event.Handler.prototype.initialize = Event.Handler.prototype.initialize.wrap(
+      function(init, element, eventName, selector, callback) {
+        init(element, eventName, selector, callback);
+        // is the handler being attached to an element that doesn't support this event?
+        if ( (!submitBubbles && this.eventName == 'submit' && !isForm(this.element)) ||
+             (!changeBubbles && this.eventName == 'change' && !isInput(this.element)) ) {
+          // "submit" => "emulated:submit"
+          this.eventName = 'emulated:' + this.eventName;
+        }
+      }
+    );
+  }
+
+  if (!submitBubbles) {
+    // discover forms on the page by observing focus events which always bubble
+    document.on('focusin', 'form', function(focusEvent, form) {
+      // special handler for the real "submit" event (one-time operation)
+      if (!form.retrieve('emulated:submit')) {
+        form.on('submit', function(submitEvent) {
+          var emulated = form.fire('emulated:submit', submitEvent, true);
+          // if custom event received preventDefault, cancel the real one too
+          if (emulated.returnValue === false) submitEvent.preventDefault();
+        });
+        form.store('emulated:submit', true);
+      }
+    });
+  }
+
+  if (!changeBubbles) {
+    // discover form inputs on the page
+    document.on('focusin', 'input, select, textarea', function(focusEvent, input) {
+      // special handler for real "change" events
+      if (!input.retrieve('emulated:change')) {
+        input.on('change', function(changeEvent) {
+          input.fire('emulated:change', changeEvent, true);
+        });
+        input.store('emulated:change', true);
+      }
+    });
+  }
+
+  function handleRemote(element) {
+    var method, url, params;
+
+    var event = element.fire("ajax:before");
+    if (event.stopped) return false;
+
+    if (element.tagName.toLowerCase() === 'form') {
+      method = element.readAttribute('method') || 'post';
+      url    = element.readAttribute('action');
+      // serialize the form with respect to the submit button that was pressed
+      params = element.serialize({ submit: element.retrieve('rails:submit-button') });
+      // clear the pressed submit button information
+      element.store('rails:submit-button', null);
+    } else {
+      method = element.readAttribute('data-method') || 'get';
+      url    = element.readAttribute('href');
+      params = {};
+    }
+
+    new Ajax.Request(url, {
+      method: method,
+      parameters: params,
+      evalScripts: true,
+
+      onCreate:   function(response) { element.fire("ajax:create",   response); },
+      onComplete: function(response) { element.fire("ajax:complete", response); },
+      onSuccess:  function(response) { element.fire("ajax:success",  response); },
+      onFailure:  function(response) { element.fire("ajax:failure",  response); }
+    });
+
+    element.fire("ajax:after");
+  }
+
+  function insertHiddenField(form, name, value) {
+    form.insert(new Element('input', { type: 'hidden', name: name, value: value }));
+  }
+
+  function handleMethod(element) {
+    var method = element.readAttribute('data-method'),
+        url = element.readAttribute('href'),
+        csrf_param = $$('meta[name=csrf-param]')[0],
+        csrf_token = $$('meta[name=csrf-token]')[0];
+
+    var form = new Element('form', { method: "POST", action: url, style: "display: none;" });
+    $(element.parentNode).insert(form);
+
+    if (method !== 'post') {
+      insertHiddenField(form, '_method', method);
+    }
+
+    if (csrf_param) {
+      insertHiddenField(form, csrf_param.readAttribute('content'), csrf_token.readAttribute('content'));
+    }
+
+    form.submit();
+  }
+
+  function disableFormElements(form) {
+    form.select('input[type=submit][data-disable-with]').each(function(input) {
+      input.store('rails:original-value', input.getValue());
+      input.setValue(input.readAttribute('data-disable-with')).disable();
+    });
+  }
+  
+  function enableFormElements(form) {
+    form.select('input[type=submit][data-disable-with]').each(function(input) {
+      input.setValue(input.retrieve('rails:original-value')).enable();
+    });
+  }
+
+  function allowAction(element) {
+    var message = element.readAttribute('data-confirm');
+    return !message || confirm(message);
+  }
+
+  document.on('click', 'a[data-confirm], a[data-remote], a[data-method]', function(event, link) {
+    if (!allowAction(link)) {
+      event.stop();
+      return false;
+    }
+
+    if (link.readAttribute('data-remote')) {
+      handleRemote(link);
+      event.stop();
+    } else if (link.readAttribute('data-method')) {
+      handleMethod(link);
+      event.stop();
+    }
+  });
+
+  document.on("click", "form input[type=submit], form button[type=submit], form button:not([type])", function(event, button) {
+    // register the pressed submit button
+    event.findElement('form').store('rails:submit-button', button.name || false);
+  });
+
+  document.on("submit", function(event) {
+    var form = event.findElement();
+
+    if (!allowAction(form)) {
+      event.stop();
+      return false;
+    }
+
+    if (form.readAttribute('data-remote')) {
+      handleRemote(form);
+      event.stop();
+    } else {
+      disableFormElements(form);
+    }
+  });
+
+  document.on('ajax:create', 'form', function(event, form) {
+    if (form == event.findElement()) disableFormElements(form);
+  });
+  
+  document.on('ajax:complete', 'form', function(event, form) {
+    if (form == event.findElement()) enableFormElements(form);
+  });
+})();

data/spec/dummy/script/rails

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# This command will automatically be run when you run "rails" with Rails 3 gems installed from the root of your application.
+
+APP_PATH = File.expand_path('../../config/application',  __FILE__)
+require File.expand_path('../../config/boot',  __FILE__)
+require 'rails/commands'

data/spec/integration/forums_spec.rb

@@ -0,0 +1,22 @@
+require 'spec_helper'
+
+describe "forums" do
+  before do
+    @forum = Forem::Forum.create!(:title => "Welcome to Forem!",
+                                 :description => "A placeholder forum.")
+  end
+
+  it "listing all" do
+    visit forums_path
+    page.should have_content("Welcome to Forem!")
+    page.should have_content("A placeholder forum.")
+
+  end
+
+  it "visiting one" do
+    visit forum_path(@forum.id)
+    within("#forum h2") do
+      page.should have_content("Welcome to Forem!")
+    end
+  end
+end

data/spec/integration/posts_spec.rb

@@ -0,0 +1,36 @@
+require 'spec_helper'
+
+describe "posts" do
+  # TODO: FG'ize
+  let(:forum) { create_forum! }
+  let(:topic) { create_topic! }
+  
+  context "not signed in users " do
+    it "cannot begin to post a reply" do
+      visit new_topic_post_path(topic)
+      flash_error!("You must sign in first.")
+    end
+  end
+
+  context "signed in users" do
+    before do
+      sign_in!
+      visit forum_topic_path(forum, topic)
+      within(selector_for(:first_post)) do
+        click_link("Reply")
+      end
+    end
+
+    it "can post a reply to a topic" do
+      fill_in "Text", :with => "Witty and insightful commentary."
+      click_button "Post Reply"
+      flash_notice!("Your reply has been posted.")
+      assert_seen("In reply to #{topic.posts.first.user}", :within => :second_post)
+    end
+    
+    it "cannot post a reply to a topic with blank text" do
+      click_button "Post Reply"
+      flash_error!("Your reply could not be posted.")
+    end
+  end
+end

data/spec/integration/topics_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+
+describe "topics" do
+  let(:forum) { Forem::Forum.create!(:title => "Welcome to forem!",
+                                     :description => "FIRST FORUM") }
+  # When FG is implemented
+  # let(:forum) { Factory(:forum) }
+  # let(:topic) { Factory(:topic) }
+
+  context "not signed in" do
+    before do
+      sign_out!
+    end
+    it "cannot create a new topic" do
+      visit new_forum_topic_path(forum)
+      flash_error!("You must sign in first.")
+    end
+  end
+
+  context "signed in" do
+    before do
+      sign_in!
+      visit new_forum_topic_path(forum)
+    end
+
+    context "creating a topic" do
+
+      it "is valid with subject and post text" do
+        fill_in "Subject", :with => "FIRST TOPIC"
+        fill_in "Text", :with => "omgomgomgomg"
+        click_button 'Create Topic'
+
+        flash_notice!("This topic has been created.")
+        assert_seen("FIRST TOPIC", :within => :topic_header)
+        assert_seen("omgomgomgomg", :within => :post_text)
+        assert_seen("forem_user", :within => :post_user)
+
+      end
+
+      it "is invalid without subject but with post text" do
+        click_button 'Create Topic'
+
+        flash_error!("This topic could not be created.")
+        find_field("topic_subject").value.should eql("")
+        find_field("topic_posts_attributes_0_text").value.should eql("")
+      end
+    end
+  end
+
+  context "viewing a topic" do
+    # Todo: Factory'ize
+    let(:topic) do
+      attributes = { :subject => "FIRST TOPIC",
+        :posts_attributes => {
+          "0" => {
+            :text => "omgomgomg",
+            :user => User.first
+          }
+        }
+      }
+
+      forum.topics.create(attributes)
+    end
+
+    it "is free for all" do
+      visit forum_topic_path(forum, topic)
+      assert_seen("FIRST TOPIC", :within => :topic_header)
+      assert_seen("omgomgomg", :within => :post_text)
+    end
+  end
+end

data/spec/models/post_spec.rb

@@ -0,0 +1,16 @@
+require 'spec_helper'
+
+describe Forem::Post do
+  let(:post) { create_post! }
+  let(:reply) { create_post!(:reply_to => post) }
+  
+  context "upon deletion" do
+
+    it "clears the reply_to_id for all replies" do
+      reply.reply_to.should eql(post)
+      post.destroy
+      reply.reload
+      reply.reply_to.should be_nil
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# Configure Rails Envinronment
+ENV["RAILS_ENV"] = "test"
+require File.expand_path("../dummy/config/environment.rb",  __FILE__)
+
+require 'rspec/rails'
+
+ENGINE_RAILS_ROOT=File.join(File.dirname(__FILE__), '../')
+
+# Requires supporting ruby files with custom matchers and macros, etc,
+# in spec/support/ and its subdirectories.
+Dir[File.join(ENGINE_RAILS_ROOT, "spec/support/**/*.rb")].each {|f| require f }
+
+RSpec.configure do |config|
+  config.use_transactional_fixtures = true
+end

data/spec/support/capybara.rb

@@ -0,0 +1,6 @@
+require 'capybara/rails'
+require 'capybara/dsl'
+
+RSpec.configure do |c|
+  c.include Capybara, :example_group => { :file_path => /\bspec\/integration\// }
+end

data/spec/support/capybara_ext.rb

@@ -0,0 +1,47 @@
+module CapybaraExt
+  # Just a shorter way of writing it.
+  def assert_seen(text, opts={})
+    if opts[:within]
+      within(selector_for(opts[:within])) do
+        page.should have_content(text)
+      end
+    else
+      page.should have_content(text)
+    end
+  end
+  
+  def flash_error!(text)
+    within("#flash_error") do
+      assert_seen(text)
+    end
+  end
+  
+  def flash_notice!(text)
+    within("#flash_notice") do
+      assert_seen(text)
+    end
+  end
+  
+  def selector_for(identifier)
+    case identifier
+    when :topic_header
+      "#topic h2"
+    when :post_text
+      "#posts .post .text"
+    when :post_user
+      "#posts .post .user"
+    when :first_post
+      "#posts #post_1"
+    when :second_post
+      "#posts #post_2"
+    when :post_actions
+      "#{selector_for(:first_post)} .actions"
+    else
+      pending "No selector defined for #{identifier}. Please define one in spec/support/capybara_ext.rb"
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include CapybaraExt
+end

data/spec/support/dummy_login.rb

@@ -0,0 +1,33 @@
+# "Borrowed" from the context engine
+# We fake the login process in the engine, as we don't know how the actual
+# application would have it set up. Guessing is best, currently.
+
+# TODO: Consider moving to something like https://github.com/quickleft/abstract_auth
+#       to make this easier to test.
+
+def sign_out!
+  Forem::ApplicationController.class_eval <<-STRING
+    def current_user
+      nil
+    end
+
+    helper_method :current_user
+  STRING
+end
+
+def sign_in!(options={})
+  # Fake user, provided by our fake "model".
+  # HACK HACK HACK.
+  # This is done so we can use the options to define how the current_user method is defined.
+  # Better ideas?
+  Forem::ApplicationController.class_eval <<-STRING
+    def current_user
+      attributes = { :login => "forem_user" }
+      #{"attributes.merge!(:context_admin => true)" if options[:admin]}
+
+      User.new(attributes)
+    end
+
+    helper_method :current_user
+  STRING
+end