bang-bang 0.1.6

data/lib/bang-bang.rb

@@ -0,0 +1,130 @@
+dir = File.dirname(__FILE__)
+Dir[File.expand_path("#{dir}/../vendor/*/lib")].each do |path|
+  $LOAD_PATH.unshift(path)
+end
+require 'sinatra/base'
+require 'mustache'
+require 'yajl'
+require 'active_support/all'
+require 'addressable/uri'
+require "named-routes"
+require "superhash"
+require "#{dir}/bang-bang/version"
+require "#{dir}/bang-bang/env_methods"
+
+module BangBang
+  def self.included(mod)
+    mod.extend(ClassMethods)
+  end
+
+  module ClassMethods
+    attr_accessor :controller, :application_name, :named_routes, :stderr_dir, :stdout_dir, :root_dir, :views_class
+    alias_method :uris, :named_routes
+    delegate :define_routes, :to => :controller
+
+    include ::BangBang::EnvMethods
+
+    def init(params={})
+      self.controller        = params[:controller] || raise(ArgumentError, "You must provide an :controller param")
+      self.application_name   = params[:application_name] || raise(ArgumentError, "You must provide an :application_name param")
+      self.root_dir          = params[:root_dir] || raise(ArgumentError, "You must provide a :root_dir param")
+      self.named_routes       = params[:named_routes] || raise(ArgumentError, "You must provide a :named_routes param")
+      self.views_class        = params[:views_class] || raise(ArgumentError, "You must provide a :views_class param")
+      self.controller.config = self
+
+      plugins.init
+    end
+
+    def app
+      @app ||= Rack::Builder.new do
+        run controller
+      end.to_app
+    end
+
+    def register_service(path, &block)
+      unless service_dirs.include?(path)
+        service = Service.new(path)
+        services << service
+        service.init(&block)
+      end
+    end
+
+    def service_dirs
+      services.map do |service|
+        service.root_dir
+      end
+    end
+
+    def services
+      @services ||= []
+    end
+
+    def services_by_url_prefix
+      services.group_by do |service|
+        service.url_prefix
+      end
+    end
+
+    def services_by_root_dir
+      services.inject({}) do |memo, service|
+        memo[service.root_dir] = service
+        memo
+      end
+    end
+
+    def stderr_logger
+      @stderr_logger ||= Logger.new(stderr_dir)
+    end
+
+    def stdout_logger
+      @stdout_logger ||= Logger.new(stdout_dir)
+    end
+
+    def plugins
+      @plugins ||= ::BangBang::Plugins::Set.new(self)
+    end
+
+    def lib_dir
+      File.join(root_dir, "lib")
+    end
+
+    def stylesheets_dirs
+      service_subdirectory_dirs "app/stylesheets"
+    end
+
+    def vendor_dir
+      File.join(root_dir, "vendor")
+    end
+
+    def services_dir
+      File.join(root_dir, "services")
+    end
+
+    def service_subdirectory_dirs(relative_directory)
+      service_dirs.flatten.map do |service_path|
+        full_path = File.join(service_path, relative_directory)
+        full_path if File.directory?(full_path)
+      end.compact
+    end
+
+    def stderr_dir
+      "#{root_dir}/log/#{application_name}.#{rack_env}.stderr.log"
+    end
+
+    def stdout_dir
+      "#{root_dir}/log/#{application_name}.#{rack_env}.stdout.log"
+    end
+
+    def remove_generated_files
+      Dir["#{root_dir}/**/public/**/*.generated"].each do |generated_path|
+        FileUtils.rm_f(File.join(File.dirname(generated_path), File.basename(generated_path, ".generated")))
+        FileUtils.rm_f(generated_path)
+      end
+    end
+  end
+end
+
+require "#{dir}/bang-bang/controller"
+require "#{dir}/bang-bang/service"
+require "#{dir}/bang-bang/views"
+require "#{dir}/bang-bang/plugins"

data/spec/bang-bang/controller_spec.rb

@@ -0,0 +1,36 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../spec_helper")
+
+module BangBang
+  describe Controller do
+    describe "GET /authentication/error-page" do
+      context "when there is not a rack.logger" do
+        it "responds with a 500" do
+          any_instance_of(FixtureApp::Controller) do |controller|
+            stub.proxy(controller).env do |env|
+              env.delete("rack.logger")
+              env
+            end
+          end
+          get uris.authentication_error_page
+
+          response.status.should == 500
+        end
+      end
+
+      context "when there is a rack.logger" do
+        it "responds with a 500 and logs the message" do
+          message = nil
+          any_instance_of(Logger) do |l|
+            stub(l).error(is_a(String)) do |*args|
+              message = args.first
+            end
+          end
+          get uris.authentication_error_page
+
+          response.status.should == 500
+          message.should include("An Error")
+        end
+      end
+    end
+  end
+end

data/spec/bang-bang/service_spec.rb

@@ -0,0 +1,35 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../spec_helper")
+
+module BangBang
+  describe Service do
+    describe "#get_static_file_path" do
+      context "when the service has a file matching the given url" do
+        it "returns the file path of the static file base on the Service's prefix + file path" do
+          authentication_path = "#{FixtureApp.root_dir}/services/authentication"
+          service = Service.new(authentication_path).init
+          service.url_prefix.should == "/authentication"
+          service.get_static_file_path("/authentication/javascripts/foo.js").should ==
+            File.join(authentication_path, "/public/javascripts/foo.js")
+        end
+      end
+
+      context "when the service does not have a file matching the given url" do
+        it "returns nil" do
+          authentication_path = "#{FixtureApp.root_dir}/services/authentication"
+          service = Service.new(authentication_path).init
+          service.get_static_file_path("i-dont-exist").should be_nil
+        end
+      end
+    end
+
+    describe "#templates_hash" do
+      it "returns a hash of all of the template files" do
+        authentication_path = "#{FixtureApp.root_dir}/services/authentication"
+        service = Service.new(authentication_path).init
+
+        hash = service.templates_hash
+        hash["/authentication/index.html.ms"].should == File.read(File.join(service.templates_dir, "index.html.ms"))
+      end
+    end
+  end
+end

data/spec/bang-bang/views_spec.rb

@@ -0,0 +1,46 @@
+require File.expand_path("#{File.dirname(__FILE__)}/../spec_helper")
+
+module BangBang
+  describe Views do
+    describe "#[]" do
+      it "returns an object with a render method, which invokes the given method name" do
+        view = BangBang::Views.new(Object.new)
+        mock(view, "true_car_makes")
+
+        view["true_car_makes"].render
+      end
+
+      describe "lazily created method" do
+        context "when the presenter file exists" do
+          it "evals the presenter file (which is responsible for adding the method)" do
+            authentication_path = "#{FixtureApp.root_dir}/services/authentication"
+            service = Service.new(authentication_path).init
+            app_instance = Object.new
+            stub(app_instance).services {[service]}
+            stub(app_instance).config {FixtureApp}
+            views = Class.new(BangBang::Views).new(app_instance)
+
+            html = views["/authentication/index.html.ms"].call("param1 value")
+            html.should include("param1 value")
+            doc = Nokogiri::HTML(html)
+            doc.at(".child-div").should be_present
+          end
+        end
+
+        context "when the presenter file does not exist" do
+          it "lazily creates a method that render the mustache template for the given path" do
+            app_instance = Object.new
+            app_instance.class.send(:define_method, :config) do
+              FixtureApp
+            end
+            views = Class.new(BangBang::Views).new(app_instance)
+
+            views.respond_to?("/user/pagelets/i-dont-exist").should be_false
+            views["/user/pagelets/i-dont-exist"]
+            views.respond_to?("/user/pagelets/i-dont-exist").should be_true
+          end
+        end
+      end
+    end
+  end
+end

data/spec/fixture-app/app.rb

@@ -0,0 +1,30 @@
+module FixtureApp
+  include ::BangBang
+
+  def self.app
+    @app ||= Rack::Builder.new do
+      use Rack::Logger
+      run ::FixtureApp::Controller
+    end.to_app
+  end
+
+  class Controller < ::BangBang::Controller
+    set :dump_errors, false
+  end
+
+  class Views < ::BangBang::Views
+  end
+
+  class Routes < NamedRoutes::Routes
+  end
+end
+
+FixtureApp.init(
+  :controller => FixtureApp::Controller,
+  :application_name => "fixture-app",
+  :root_dir => File.dirname(__FILE__),
+  :named_routes => FixtureApp::Routes,
+  :views_class => FixtureApp::Views
+)
+
+FixtureApp.register_service("#{File.dirname(__FILE__)}/services/authentication")

data/spec/fixture-app/services/authentication/app/controllers/authentication.rb

@@ -0,0 +1,6 @@
+FixtureApp::Controller.define_routes do
+  def authentication_error_page; end
+  get path(:authentication_error_page, "/authentication/error-page") do
+    raise "An Error"
+  end
+end

data/spec/fixture-app/services/authentication/app/presenters/index.html.ms.rb

@@ -0,0 +1,5 @@
+mustache "/authentication/index.html.ms" do |param1|
+  {
+    "param1" => param1
+  }
+end

data/spec/fixture-app/services/authentication/app/templates/index.html.ms

@@ -0,0 +1,4 @@
+<div class="authentication-index">
+  <div class="child-div"></div>
+  {{param1}}
+</div>

data/spec/fixture-app/services/authentication/init.rb

@@ -0,0 +1 @@
+self.url_prefix = "/authentication"

data/spec/fixture-app/services/authentication/public/javascripts/foo.js

@@ -0,0 +1,2 @@
+function Foo() {
+}

data/spec/spec_helper.rb

@@ -0,0 +1,45 @@
+require "rubygems"
+require "bundler"
+Bundler.setup
+
+dir = File.dirname(__FILE__)
+$LOAD_PATH.unshift(File.expand_path("#{dir}/../lib"))
+
+require "rack/test"
+
+require "bang-bang"
+require "#{dir}/fixture-app/app"
+require "rack/session/abstract/id"
+require "rack/test"
+require "capybara"
+require "capybara/dsl"
+require "addressable/uri"
+
+ARGV.push("-b")
+unless ARGV.include?("--format") || ARGV.include?("-f")
+  ARGV.push("--format", "nested")
+end
+
+require 'rspec'
+require 'rspec/autorun'
+require 'rr'
+require 'webmock/rspec'
+
+ENV["RACK_ENV"] = "test"
+
+Dir["#{File.dirname(__FILE__)}/spec_helpers/**/*.rb"].each do |file|
+  require file
+end
+
+RSpec.configure do |configuration|
+  configuration.mock_with :rr
+  configuration.filter_run :focus => true
+  configuration.run_all_when_everything_filtered = true
+  configuration.before do
+    Capybara.reset!
+
+    FixtureApp.views_class = FixtureApp::Views
+  end
+end
+
+Capybara.app = FixtureApp.app

data/spec/spec_helpers/example_group.rb

@@ -0,0 +1,47 @@
+RSpec::Core::ExampleGroup.class_eval do
+  include Capybara
+
+  def app
+    FixtureApp::Controller
+  end
+
+  def uris
+    @uris ||= FixtureApp::Routes.instance
+  end
+  alias_method :named_routes, :uris
+
+  def views
+    @views ||= begin
+      app_instance = Capybara.app.allocate
+      app_instance.send(:initialize)
+      app_instance.session_data = session_data
+      ::FixtureApp::Views.new(app_instance)
+    end
+  end
+
+  [
+    :request, :last_request, :response, :last_response, :follow_redirect!,
+    :rack_mock_session
+  ].each do |method_name|
+    class_eval((<<-RUBY), __FILE__, __LINE__+1)
+    def #{method_name}(*args, &block)
+      page.driver.#{method_name}(*args, &block)
+    end
+    RUBY
+  end
+
+  [:get, :put, :post, :delete].each do |method_name|
+    class_eval((<<-RUBY), __FILE__, __LINE__+1)
+    def #{method_name}(*args, &block)
+      (res = page.driver.#{method_name}(*args, &block)).tap do
+        puts res.errors if res.status == 500
+      end
+    end
+    RUBY
+  end
+
+  def current_path
+    Addressable::URI.parse(current_url).path
+  end
+
+end

data/spec/spec_suite.rb

@@ -0,0 +1,3 @@
+Dir["#{File.dirname(__FILE__)}/**/*_spec.rb"].each do |file|
+  require file
+end

data/vendor/superhash/InstalledFiles

@@ -0,0 +1 @@
+/home/honk/.rvm/rubies/ruby-1.9.2-p0/lib/ruby/site_ruby/1.9.1//superhash.rb

data/vendor/superhash/README

@@ -0,0 +1,5 @@
+To install:
+
+  ruby install.rb config
+  ruby install.rb setup
+  ruby install.rb install

data/vendor/superhash/RELEASE-NOTES

@@ -0,0 +1,9 @@
+superhash 0.3
+  - Fixed broken #index.
+  - Updated for ruby-1.8 and ruby-1.9.
+
+superhash 0.2
+  - Updated for ruby-1.7.3.
+
+superhash 0.1
+  - First public release.

data/vendor/superhash/config.save

@@ -0,0 +1,12 @@
+prefix=/home/honk/.rvm/rubies/ruby-1.9.2-p0
+std-ruby=$prefix/lib/ruby/1.9.1
+site-ruby-common=$prefix/lib/ruby/site_ruby
+site-ruby=$prefix/lib/ruby/site_ruby/1.9.1
+bin-dir=$prefix/bin
+rb-dir=$site-ruby
+so-dir=$prefix/lib/ruby/site_ruby/1.9.1/x86_64-linux
+data-dir=$prefix/share
+ruby-path=/home/honk/.rvm/rubies/ruby-1.9.2-p0/bin/ruby
+ruby-prog=/home/honk/.rvm/rubies/ruby-1.9.2-p0/bin/ruby
+make-prog=make
+without-ext=no

data/vendor/superhash/examples/attributed-node.rb

@@ -0,0 +1,83 @@
+require 'superhash'
+
+# Example of using SuperHashes inside regular objects (not classes).
+# This example was distilled from the SuperML project.
+
+class AttributedNode
+
+  attr_reader :attributes, :parents, :children
+
+  # creates a node and gives it a first parent
+  def initialize(parent = nil)
+    @attributes = SuperHash.new(parent && parent.attributes)
+    @parents = parent ? [parent] : []
+    @children = []
+  end
+
+  # adds more parents, which will also contribute attributes
+  def add_parent(parent)
+    unless @parents.include? parent
+      @parents << parent
+      @attributes.parents << parent.attributes
+    end
+    self
+  end
+  protected :add_parent
+
+  def add_child(child)
+    @children << child
+    child.add_parent(self)
+    self
+  end
+
+end
+
+# This might be the description of a window using some (imaginary)
+# GUI construction library.
+
+root = AttributedNode.new
+  root.attributes[:type]        = :top_window
+  root.attributes[:name]        = "Feature request window"
+  root.attributes[:bg_color]    = "gray"
+  root.attributes[:font_face]   = "Courier"
+  root.attributes[:font_size]   = 10
+
+user_field = AttributedNode.new
+  root.add_child(user_field)
+  user_field.attributes[:type]      = :text_box
+  user_field.attributes[:name]      = "Username box"
+  user_field.attributes[:label]     = "Name:"
+
+feature_field = AttributedNode.new
+  root.add_child(feature_field)
+  feature_field.attributes[:type]      = :text_box
+  feature_field.attributes[:name]      = "Feature description box"
+  feature_field.attributes[:bg_color]  = "white"
+  feature_field.attributes[:label]     = "Please enter your request below:"
+  feature_field.attributes[:font_face] = "Times"
+  feature_field.attributes[:font_size] = 12
+
+
+# So then we have:
+
+p user_field.attributes[:bg_color]      # ==> "gray"
+p feature_field.attributes[:bg_color]   # ==> "white"
+
+p user_field.attributes[:font_size]     # ==> 10
+p feature_field.attributes[:font_size]  # ==> 12
+
+
+# You could even manage another set of attributes of the same objects using
+# multiple inheritance, such as attributes pertaining to form entry content:
+
+form_entry = AttributedNode.new
+  form_entry.attributes[:default_contents]    = "enter text here"
+  form_entry.attributes[:reject_condition]    = /[^\w,.;:?!]/
+
+  form_entry.add_child(user_field)
+  user_field.attributes[:default_contents]    = "fred"
+
+  form_entry.add_child(feature_field)
+  feature_field.attributes[:reject_condition] = /more like Microsoft/
+
+p feature_field.attributes[:default_contents] # ==> "enter text here"

data/vendor/superhash/examples/class-superhash.rb

@@ -0,0 +1,26 @@
+require 'superhash'
+
+class A
+  class_superhash :options
+  
+  options[:foo] = "A foo"
+  options[:bar] = "A bar"
+  
+  def options; self.class.options; end
+end
+
+class B < A
+  options[:foo] = "B foo"
+end
+
+p A.options
+p B.options.to_hash
+p B.new.options.to_hash
+
+__END__
+
+output:
+
+{:foo=>"A foo", :bar=>"A bar"}
+{:foo=>"B foo", :bar=>"A bar"}
+{:foo=>"B foo", :bar=>"A bar"}

data/vendor/superhash/examples/state-object.rb

@@ -0,0 +1,95 @@
+require 'superhash'
+
+# Example of using SuperHashes in class instance variables to extend Ruby's
+# inheritance mechanism. This can be expressed automatically using the
+# Class#class_superhash methods defined in superhash.rb.
+#
+# This example is vaguely derived from the RedShift project. Subclasses
+# of StateObject have a set of states that their instances may be in. Each
+# state is mapped to a state action. Subclasses inherit the mapping, and may
+# add to it and override it.
+
+class StateObject
+
+  # class vars and class methods
+
+  @state_actions = {}
+    # root hash for child class's superhash that maps state => action
+
+  class << self
+    def state_actions
+      @state_actions ||= SuperHash.new(superclass.state_actions)
+    end
+
+    def define_state_action(state, &action)
+      state_actions[state] = action
+    end
+    alias in_state define_state_action
+  end
+
+  define_state_action :no_op    # all subclasses inherit this state
+
+  # instance methods
+
+  def state_actions
+    self.class.state_actions
+  end
+
+  def states
+    state_actions.keys
+  end
+
+  attr_reader :cur_state
+
+  def cur_state=(target_state)
+    unless states.include? target_state
+      raise "No way, dude. That's not a cool state for " +
+            "me to be in right now."
+    end
+    @cur_state = target_state
+    @cur_action = state_actions[target_state]
+  end
+
+  def run
+    @cur_action.call if @cur_action
+  end
+
+  def initialize(start_state = :no_op)
+    self.cur_state = start_state
+  end
+end
+
+class Computer < StateObject
+  in_state :off do
+    puts "Power off."
+  end
+
+  in_state :on do
+    puts "Power on."
+  end
+  
+  in_state :boot do
+    puts "Can't boot -- no OS."
+  end
+end
+
+class WindowsNTBox < Computer
+  # Add a new state, and its action.
+  in_state :crashed do
+    puts "Blue screen!"
+  end
+  
+  # Override an inherited state.
+  in_state :boot do
+    puts "Booting Windows NT."
+  end
+end
+
+pc = WindowsNTBox.new
+
+seq = [:off, :on, :boot, :crashed, :off]
+
+for state in seq
+  pc.cur_state = state
+  pc.run
+end