abc 0.0.2

data/core/spec/entities/pages/page_spec.rb

@@ -0,0 +1,19 @@
+require 'spec_helper'
+require 'abc/entities/pages/page'
+
+module Abc
+  module Entities
+    describe Page do
+      let(:title) { "Afterburner" }
+      subject { Page.new(title) }
+
+      it "has a title" do
+        subject.title.should == title
+      end
+
+      it "can be hashified" do
+        subject.to_hash.should == {:title => title}
+      end
+    end
+  end
+end

data/core/spec/entities/view/viewable_presenter_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+require 'abc/entities/view/viewable_presenter'
+
+module Abc
+  describe ViewablePresenter do
+  end
+end

data/core/spec/entities/view/viewable_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+require 'abc/entities/view/viewable'
+
+module Abc
+  describe Viewable do
+  end
+end

data/core/spec/interactors/creates_menu_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+require 'abc/interactors/creates_menu'
+
+module Abc
+  module Interactors
+    describe CreatesMenu do
+      let(:menu_entries) do
+        [{:title => "One", :children => [{ :title => "One first child"}]}]
+      end
+
+      describe ".new" do
+        it "creates new menu" do
+          menu_creator = CreatesMenu.send(:new, [])
+          expect(menu_creator.to_response).to be_kind_of(Abc::Menu)
+        end
+
+        it "adds menu entries to menu" do
+          menu_creator = CreatesMenu.send(:new, menu_entries)
+          menu_creator.menu.entries.each do |menu_entry|
+            expect(menu_entry).to be_kind_of(Abc::MenuEntry)
+          end
+        end
+      end
+
+      it "returns a menu" do
+        menu_creator = CreatesMenu.call(menu_entries)
+        expect(menu_creator).to be_kind_of(Abc::Menu)
+      end
+    end
+  end
+end

data/core/spec/interactors/pages/builds_page_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+require 'abc/interactors/pages/builds_page'
+
+module Abc
+  module Interactors
+    describe BuildsPage do
+      let(:data) {{:title => "More like Awesome-burner, amirite??"}}
+      
+      it "returns a page" do
+        builder = BuildsPage.call(data)
+        expect(builder).to be_kind_of(Abc::Entities::Page)
+      end
+    end
+  end
+end

data/core/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+$LOAD_PATH.push File.expand_path('../../', __FILE__)
+
+unless ENV['TRAVIS']
+  require 'simplecov'
+  SimpleCov.start do
+    add_filter "/spec/"
+  end
+end
+
+require 'abc-core'

data/delivery/backend/Gemfile

@@ -0,0 +1,44 @@
+source "http://rubygems.org"
+
+gemspec
+
+git 'git://github.com/rails/rails.git' do
+  gem 'railties'
+  gem 'actionpack'
+  gem 'activemodel'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'rspec-rails', :require => false
+  unless ENV['TRAVIS']
+    gem 'simplecov'
+  end
+  gem 'capybara'
+  platforms :jruby do
+    gem 'activerecord-jdbcsqlite3-adapter'
+  end
+
+  platforms :ruby do
+    gem 'sqlite3'
+  end
+end
+
+group :development, :test do
+  gem 'combustion', github: 'pat/combustion'
+  unless ENV['TRAVIS']
+    gem 'pry'
+    gem 'pry-nav'
+    gem 'guard-shell'
+    gem 'rb-fsevent', '~> 0.9', :platform => :ruby
+  end
+end
+
+group :development do
+  gem 'yard', "~> 0.8.4.1"
+  gem 'rdoc'
+  gem 'kramdown'
+end
+
+gem 'abc', :path => '../../'
+gem 'abc-core', :path => '../../core'

data/delivery/backend/Guardfile

@@ -0,0 +1,6 @@
+guard :shell do
+  watch(/\A.*\.(rb|erb|haml)\z/) do |m|
+    system "rspec spec"
+    system "date"
+  end
+end

data/delivery/backend/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/delivery/backend/abc-backend.gemspec

@@ -0,0 +1,26 @@
+require File.expand_path('../../lib/abc/package', File.dirname(__FILE__))
+
+# Describe your gem and declare its dependencies:
+Gem::Specification.new do |s|
+  s.name        = "abc-backend"
+  s.version     = Abc::VERSION
+  s.authors     = Abc::AUTHORS
+  s.email       = Abc::EMAILS
+  s.homepage    = Abc::HOMEPAGE
+  s.summary     = Abc::SUMMARY
+  s.description = Abc::DESCRIPTION
+
+  s.require_paths = ["lib"]
+
+  s.files = Dir['app/**/*', 'lib/**/*', 'config/**/*', 'spec/**/*']
+  s.test_files = s.files.grep(%r{^(spec)/})
+
+  s.required_ruby_version = '>= 1.9.3' # that's right.
+
+  s.add_dependency 'railties',      Abc::RAILS_VERSION
+  s.add_dependency 'activesupport', Abc::RAILS_VERSION
+  s.add_dependency 'actionpack',    Abc::RAILS_VERSION
+  s.add_dependency 'activemodel',   Abc::RAILS_VERSION
+  s.add_dependency 'abc',           Abc::VERSION
+  s.add_dependency 'abc-core',      Abc::VERSION
+end

data/delivery/backend/app/controllers/abc/application_controller.rb

@@ -0,0 +1,6 @@
+require 'action_controller'
+
+module Abc
+  class ApplicationController < ActionController::Base
+  end
+end

data/delivery/backend/app/controllers/abc/backend/base_controller.rb

@@ -0,0 +1,8 @@
+module Abc
+  module Backend
+    class BaseController < ApplicationController
+      def index
+      end
+    end
+  end
+end

data/delivery/backend/app/presenters/abc/html/menu_entry_presenter.rb

@@ -0,0 +1,87 @@
+require 'action_view'
+
+module Abc
+  module Html
+    class MenuEntryPresenter
+      include ActionView::Helpers::TagHelper
+      include ActionView::Context # Nested content_tags
+
+      attr_accessor :menu_entry, :list_element_pair
+
+      def initialize(menu_entry, options = {})
+        options = {:list_element_pair => [:ul, :li]}.merge(options)
+        self.menu_entry = menu_entry
+        self.list_element_pair = options[:list_element_pair]
+      end
+
+      # Renders a menu item in HTML format, and, if it has children, renders those too.
+      #
+      # **A note on HTML safety:**
+      #
+      # It is up to each menu item presenter to check that it is rendering itself safely.
+      # By default, most of the menu has to be declared safe, or else its
+      # constituent tags won't render properly. So we declare vast swaths of the
+      # menu HTML safe, and in truth these parts are. The parts that
+      # need to be especially watched are any spots where you render user input.
+      # By design, that surface is constrained to the `render_as_html` method.
+      # You must, however, return a string marked with html_safe from that method
+      # or else the menu will raise `ActiveSupport::SafeBuffer::SafeConcatError`.
+      #
+      # (This doesn't meant that the entire string must be unsanitized; just that
+      # you must make assurances that your content is appropriately escaped. By
+      # default, ABC uses `ERB::Util#h` to sanitize the user-interpreted parts, but
+      # your derivative classes may have to implement this on their own.)
+      #
+      # @return [SafeBuffer] A safe string containing the MenuEntry and its children.
+      def to_html
+        content = render_as_html
+        raise ActiveSupport::SafeBuffer::SafeConcatError unless content.html_safe?
+
+        content_tag(list_element_tag) do
+          if menu_entry_children.present?
+            render_with_children_as_html content
+          else
+            content
+          end
+        end.html_safe
+      end
+
+      protected
+
+      # Renders this menu item and its children with the assumption it has children.
+      #
+      # @param content [SafeBuffer] A safe string to use as the content of this, the parent {MenuEntry.
+      # @return [SafeBuffer] A safe string to be rendered by the parent {Menu} or {MenuEntry}.
+      def render_with_children_as_html(content)
+        content.safe_concat(
+          content_tag(list_container_tag) do
+            menu_entry_children.reduce(::ActiveSupport::SafeBuffer.new) do |buffer, child|
+              child_presenter = self.class.new(child, :list_element_pair => list_element_pair)
+              buffer.safe_concat child_presenter.to_html
+            end
+          end.html_safe
+        )
+      end
+
+      def list_container_tag
+        list_element_pair.first
+      end
+
+      def list_element_tag
+        list_element_pair.last
+      end
+
+      # Render this {MenuItem} without children.
+      #
+      # **NB**: ERB::Util#h will mark a string as safe.
+      #
+      # @returns [SafeBuffer] A safe string to be rendered or appended with children.
+      def render_as_html
+        ERB::Util.h menu_entry_title
+      end
+
+      delegate :children, :to => :menu_entry, :allow_nil => true, :prefix => true
+      delegate :title, :to => :menu_entry, :prefix => true
+    end
+  end
+end

data/delivery/backend/app/presenters/abc/html/menu_presenter.rb

@@ -0,0 +1,68 @@
+require 'action_view'
+require 'active_support/core_ext/string'
+
+module Abc
+  module Html
+    class MenuPresenter
+      include ActionView::Helpers::TagHelper
+      include ActionView::Context
+
+      attr_accessor :menu, :menu_element, :list_element_pair, :menu_entry_presenter_class
+
+      def initialize(menu, options = {})
+        options = default_initialize_options.merge(options)
+
+        self.menu = menu
+        self.menu_element = options[:menu_element]
+        self.list_element_pair = options[:list_element_pair]
+        self.menu_entry_presenter_class = options[:menu_entry_presenter_class]
+      end
+
+      # Outputs the menu in HTML format.
+      #
+      # @return An HTML-safe string containing the markup of the menu in question.
+      def to_html
+        content_tag(menu_element) do
+          content_tag(list_container_tag) do
+            # Reduce will concat into a first SafeBuffer here, so if the first
+            # node is html_safe, this will produce expected outcome. And of course,
+            # MenuEntries are expected to be html_safe.
+            menu_entries.reduce(::ActiveSupport::SafeBuffer.new) do |buffer, child|
+              menu_entry_presenter = menu_entry_presenter_class.new(
+                child, :list_element_pair => list_element_pair
+              )
+              buffer.safe_concat menu_entry_presenter.to_html
+            end
+          end
+        end.html_safe
+      end
+
+      # Set the elements that are used to determine what contains a series of
+      # children and the actual children itself. Defaults to [:ul, :li].
+      # We sometimes refer to the pair as the container and the enumerator.
+      #
+      # @param pair [Array] A pair of HTML element names
+      def list_element_pair=(pair)
+        raise "List element pair must be an array" unless pair.is_a?(Array)
+        raise "List element pair must specify two element types" unless pair.count == 2
+        raise "List element pair should be symbols" unless pair.all? {|e| e.is_a?(Symbol)}
+        @list_element_pair = pair
+      end
+
+      private
+      def default_initialize_options
+        {
+          :menu_element => :nav,
+          :list_element_pair => [:ul, :li],
+          :menu_entry_presenter_class => MenuEntryPresenter
+        }.freeze
+      end
+
+      def list_container_tag
+        list_element_pair.first
+      end
+
+      delegate :entries, :to => :menu, :prefix => true
+    end
+  end
+end

data/delivery/backend/app/views/abc/backend/base/index.html.erb

@@ -0,0 +1 @@
+Welcome to Afterburner CMS

data/delivery/backend/config.ru

@@ -0,0 +1,6 @@
+require 'bundler'
+
+Bundler.require :default, :development
+
+Combustion.initialize! :action_view, :active_model, :action_controller
+run Combustion::Application

data/delivery/backend/config/routes.rb

@@ -0,0 +1,3 @@
+Abc::Backend::Engine.routes.draw do
+  root to: 'base#index'
+end

data/delivery/backend/lib/abc-backend.rb

@@ -0,0 +1,2 @@
+require 'rails'
+require 'abc/backend/engine'

data/delivery/backend/lib/abc/backend/engine.rb

@@ -0,0 +1,7 @@
+module Abc
+  module Backend
+    class Engine < Rails::Engine
+      isolate_namespace Abc::Backend
+    end
+  end
+end

data/delivery/backend/spec/integration/backend_spec.rb

@@ -0,0 +1,10 @@
+require 'spec_helper'
+
+describe "Backend" do
+  describe "GET /backend" do
+    it "shows a welcome message" do
+      visit abc_backend.root_path
+      page.should have_content("Welcome to Afterburner CMS")
+    end
+  end
+end

data/delivery/backend/spec/integration/menu_spec.rb

@@ -0,0 +1,18 @@
+require 'tiny_spec_helper'
+require 'interactors/creates_menu'
+
+describe "Menu" do
+  describe "when using an HTML presenter" do
+    let(:children_for_one) {
+      [{:title => "One first child"}, {:title => "One second child"}]
+    }
+    let(:menu_entries) { [{:title => "One", :children => children_for_one}] }
+
+    let(:menu) { Abc::Interactors::CreatesMenu.call(menu_entries) }
+    let(:present) { Abc::Html::MenuPresenter.new(menu).to_html }
+
+    it "renders properly" do
+      present.should == "<nav><ul><li>One<ul><li>One first child</li><li>One second child</li></ul></li></ul></nav>"
+    end
+  end
+end

data/delivery/backend/spec/internal/config/database.yml

@@ -0,0 +1,3 @@
+test:
+  adapter:  sqlite3
+  database: db/combustion_test.sqlite

data/delivery/backend/spec/internal/config/routes.rb

@@ -0,0 +1,5 @@
+require 'abc/backend/engine'
+
+Rails.application.routes.draw do
+  mount Abc::Backend::Engine => '/'
+end

data/delivery/backend/spec/internal/db/schema.rb

@@ -0,0 +1,3 @@
+ActiveRecord::Schema.define do
+  #
+end

data/delivery/backend/spec/internal/log/.gitignore

@@ -0,0 +1 @@
+*.log

data/delivery/backend/spec/presenters/html/menu_entry_presenter_spec.rb

@@ -0,0 +1,49 @@
+require 'tiny_spec_helper'
+require 'presenters/abc/html/menu_entry_presenter'
+
+class MockMenuEntry
+  attr_accessor :children, :title
+  def initialize(opts = {}); @children = opts[:children] || []; @title = opts[:title]; end
+  def list_element_pair=(_); @list_element_pair = _; end
+end
+
+module Abc
+  module Html
+    describe MenuEntryPresenter do
+      let(:menu_item) { MockMenuEntry.new(:title => "Root") }
+      let(:child) { MockMenuEntry.new(:title => "Child") }
+      subject { MenuEntryPresenter.new(menu_item) }
+
+      it "renders itself" do
+        subject.to_html.should == "<li>Root</li>"
+      end
+
+      it "renders with the list enumerator of list_element_pair" do
+        subject.list_element_pair = [:nav, :div]
+        subject.to_html.should == "<div>Root</div>"
+      end
+
+      it "raises an error if its content is not marked html_safe" do
+        subject.stub!(:render_as_html).and_return("unsafe string")
+        expect { subject.to_html }.to raise_error(::ActiveSupport::SafeBuffer::SafeConcatError)
+      end
+
+      context "with children" do
+        before(:each) { menu_item.children = [child] }
+        # TODO: Remove this diagnostic spec.
+        it "child count should be one" do
+          subject.menu_entry.children.count.should == 1
+        end
+
+        it "renders its children" do
+          subject.to_html.should == "<li>Root<ul><li>Child</li></ul></li>"
+        end
+
+        it "wraps children in the passed list element" do
+          subject.list_element_pair = [:nav, :div]
+          subject.to_html.should == "<div>Root<nav><div>Child</div></nav></div>"
+        end
+      end
+    end
+  end
+end