active_component 0.1.2

data/.document

@@ -0,0 +1,4 @@
+lib/**/*.rb
+bin/*
+-
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--color

data/Gemfile

@@ -0,0 +1,10 @@
+source "http://rubygems.org"
+
+gem 'activesupport'
+gem 'haml'
+
+group :development do
+  gem "rspec", "~> 2.3.0"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.5.2"
+end

data/Gemfile.lock

@@ -0,0 +1,30 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (3.0.3)
+    diff-lcs (1.1.2)
+    git (1.2.5)
+    haml (3.0.25)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+    rake (0.8.7)
+    rspec (2.3.0)
+      rspec-core (~> 2.3.0)
+      rspec-expectations (~> 2.3.0)
+      rspec-mocks (~> 2.3.0)
+    rspec-core (2.3.1)
+    rspec-expectations (2.3.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.3.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activesupport
+  bundler (~> 1.0.0)
+  haml
+  jeweler (~> 1.5.2)
+  rspec (~> 2.3.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Christian Peters
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,65 @@
+Active Component
+================
+
+Active Component introduces components into your Rails presentation layer.
+The use of components improves consistency and development speed through reuse and a new way of view code organization.
+Components are plain Ruby classes that are able to render themselves using a to_html method.
+Active Component provides several means that make it easy to write and use components.
+
+
+Example
+=======
+
+**Active Component Template:**
+
+div 'kpi-report', :content => [
+
+  heading_with_label("in #{ Time.now.year }", "Group", 'group'),
+
+  report_table(@coreprocesses,
+    :headers  => ["Core Processes"] + @companies.collect {|company| company.name},
+    :cols     => [:name] + @companies.collect {|company| 
+      proc {|cp| progress_chart(cp, :reporting_company_id => company.id, :chart_type => :boxes)}
+    }
+  )
+  
+]
+
+Each method represents a component.
+
+
+**Comparision: Same Template in ERB:**
+
+<div class="kpi_report">
+  <h1 class="content_header">
+    <span class="content_header_text">
+      <span class="label group_label">Group</span> 
+      <%= title("Umsetzungsstand der Ziele") %> 
+      in <%= Time.now.year %> <%= help_text %></span>
+  </h1>
+  <div class="content">
+    <div class="sub_content">
+      <table cellspacing="0">
+        <thead>
+          <tr>
+            <td width="80%">Core Processes</td>
+            <% @companies.each do |t| %>
+              <td><%= t.name %></td>
+            <% end %>
+          </tr>
+        </thead>
+        <% @coreprocesses.each do |cp| %>
+        <tr class="line">
+          <td class="small_name_column"><%= cp.name %></td>
+          <% @companies.each do |t| %>
+            <td class="small_indicator_column"><%= scale_helper(cp, true, t.id, Time.now.year, groupwide) %></td>
+          <% end %>
+        </tr>
+        <% end %>
+      </table>
+    </div>
+  </div>
+</div>
+
+
+Copyright (c) 2010 Christian Peters, released under the MIT license

data/Rakefile

@@ -0,0 +1,52 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "active_component"
+  gem.homepage = "http://github.com/ChristianPeters/activecomponent"
+  gem.license = "MIT"
+  gem.summary = "Build your views by assembling self-rendering components"
+  gem.description = %Q{Active Component introduces components into your Rails presentation layer.
+The use of components improves consistency and development speed through reuse and a new way of view code organization.
+Components are plain Ruby classes that are able to render themselves using a to_html method.
+Active Component provides several means that make it easy to write and use components.}
+  gem.email = "christian.peters@zweitag.de"
+  gem.authors = ["Christian Peters"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+  gem.add_dependency 'haml'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "ac_tmp #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.2

data/active_component.gemspec

@@ -0,0 +1,104 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{active_component}
+  s.version = "0.1.2"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Christian Peters"]
+  s.date = %q{2011-01-03}
+  s.description = %q{Active Component introduces components into your Rails presentation layer.
+The use of components improves consistency and development speed through reuse and a new way of view code organization.
+Components are plain Ruby classes that are able to render themselves using a to_html method.
+Active Component provides several means that make it easy to write and use components.}
+  s.email = %q{christian.peters@zweitag.de}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "active_component.gemspec",
+    "init.rb",
+    "lib/active_component.rb",
+    "lib/active_component/base.rb",
+    "lib/active_component/components/block.rb",
+    "lib/active_component/components/empty_tag.rb",
+    "lib/active_component/components/heading.rb",
+    "lib/active_component/components/inline_tag.rb",
+    "lib/active_component/components/section.rb",
+    "lib/active_component/components/table.rb",
+    "lib/active_component/config.rb",
+    "lib/active_component/core_extensions.rb",
+    "lib/active_component/template_handler.rb",
+    "pkg/active_component-0.1.2.gem",
+    "spec/active_component_spec.rb",
+    "spec/active_component_spec_helper.rb",
+    "spec/base_spec.rb",
+    "spec/components/block_spec.rb",
+    "spec/components/heading_spec.rb",
+    "spec/components/section_spec.rb",
+    "spec/components/table_spec.rb",
+    "spec/core_extensions_spec.rb",
+    "spec/factories.rb",
+    "spec/rcov.opts",
+    "spec/spec.opts",
+    "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/ChristianPeters/activecomponent}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.7}
+  s.summary = %q{Build your views by assembling self-rendering components}
+  s.test_files = [
+    "spec/active_component_spec.rb",
+    "spec/active_component_spec_helper.rb",
+    "spec/base_spec.rb",
+    "spec/components/block_spec.rb",
+    "spec/components/heading_spec.rb",
+    "spec/components/section_spec.rb",
+    "spec/components/table_spec.rb",
+    "spec/core_extensions_spec.rb",
+    "spec/factories.rb",
+    "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 0"])
+      s.add_runtime_dependency(%q<haml>, [">= 0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_runtime_dependency(%q<haml>, [">= 0"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 0"])
+      s.add_dependency(%q<haml>, [">= 0"])
+      s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+      s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+      s.add_dependency(%q<haml>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 0"])
+    s.add_dependency(%q<haml>, [">= 0"])
+    s.add_dependency(%q<rspec>, ["~> 2.3.0"])
+    s.add_dependency(%q<bundler>, ["~> 1.0.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.5.2"])
+    s.add_dependency(%q<haml>, [">= 0"])
+  end
+end
+

data/init.rb

@@ -0,0 +1 @@
+require File.join(File.dirname(__FILE__), 'lib', 'active_component')

data/lib/active_component.rb

@@ -0,0 +1,196 @@
+# encoding: utf-8
+
+require 'active_support'
+require 'action_view'
+require 'haml'
+require 'haml/helpers/xss_mods'
+
+module ActiveComponent
+
+  if defined? Rails::Railtie
+    class Railtie < Rails::Railtie
+      initializer "active_component.load_config" do
+        require 'active_component/config'
+      end
+      initializer "active_component.template_handler_registration" do
+        ActionView::Template.register_template_handler :act, TemplateHandler
+      end
+    end
+  else
+    require 'active_component/config'
+  end
+
+  HTML5_ELEMENTS = {
+    :meta             => [:base, :command, :link, :meta, :noscript, :script, :style, :title],
+    :flow             => [:a, :abbr, :address, :article, :aside, :audio, :b, :bdo, :blockquote, :br, :button, :canvas, :cite, :code, :command, :datalist, :del, :details, :dfn, :div, :dl, :em, :embed, :fieldset, :figure, :footer, :form, :h1, :h2, :h3, :h4, :h5, :h6, :header, :hgroup, :hr, :i, :iframe, :img, :input, :ins, :kbd, :keygen, :label, :map, :mark, :math, :menu, :meter, :nav, :noscript, :object, :ol, :output, :p, :pre, :progress, :q, :ruby, :samp, :script, :section, :select, :small, :span, :strong, :sub, :sup, :svg, :table, :textarea, :time, :ul, :var, :video, :wbr],
+    :sectioning       => [:article, :aside, :nav, :section],
+    :heading          => [:h1, :h2, :h3, :h4, :h5, :h6, :hgroup],
+    :phrasing         => [:abbr, :audio, :b, :bdo, :br, :button, :canvas, :cite, :code, :command, :datalist, :dfn, :em, :embed, :i, :iframe, :img, :input, :kbd, :keygen, :label, :mark, :math, :meter, :noscript, :object, :output, :progress, :q, :ruby, :samp, :script, :select, :small, :span, :strong, :sub, :sup, :svg, :textarea, :time, :var, :video, :wbr],
+    :embedded         => [:audio, :canvas, :embed, :iframe, :img, :math, :object, :svg, :video],
+    :interactive      => [:a, :button, :details, :embed, :iframe, :keygen, :label, :select, :textarea],
+    :sectioning_roots => [:blockquote, :body, :details, :fieldset, :figure, :td],
+    :form_associated  => [:button, :fieldset, :input, :keygen, :label, :meter, :object, :output, :progress, :select, :textarea],
+    :block_candidates => [:section, :nav, :article, :aside, :h1, :h2, :h3, :h4, :h5, :h6, :hgroup, :header, :footer, :address, :p, :pre, :blockquote, :div],
+    :uncategorized    => [:col, :colgroup, :dd, :dt, :figcaption, :head, :html, :legend, :li, :optgroup, :option, :param, :rp, :rt, :source, :summary, :tbody, :tfoot, :th, :thead, :tr]
+  }
+
+  EMPTY_ELEMENTS      = [:area, :base, :br, :col, :command, :embed, :hr, :img, :input, :keygen, :link, :meta, :param, :source, :wbr]
+  PHRASING_ELEMENTS   = HTML5_ELEMENTS[:phrasing] - HTML5_ELEMENTS[:interactive] - HTML5_ELEMENTS[:embedded] - EMPTY_ELEMENTS - [:noscript, :time] + [:ins, :del]
+  BLOCK_ELEMENTS      = HTML5_ELEMENTS[:block_candidates] - HTML5_ELEMENTS[:sectioning] - HTML5_ELEMENTS[:sectioning_roots] - HTML5_ELEMENTS[:heading] - [:p, :pre] + [:head, :html, :hgroup]
+  SECTION_ELEMENTS    = HTML5_ELEMENTS[:sectioning] + HTML5_ELEMENTS[:sectioning_roots] - HTML5_ELEMENTS[:form_associated]
+  HEADING_ELEMENTS    = HTML5_ELEMENTS[:heading] - [:hgroup]
+
+  # Embed
+  # Table
+  # List
+  # p, pre
+  # figure
+  # title
+
+  class ActiveComponentError < StandardError; end
+  class InvalidHtmlError < ActiveComponentError; end
+
+  # Generates a collection of tags wrapping content that is optionally printed using method(s)
+  def print_contents(tag, content_or_contents, method_or_methods = nil, *flags_and_attributes)
+    flags       = []
+    attributes  = {}
+    # Collect all flags (non-Hash) and attributes (by merging all Hashs)
+    for arg in flags_and_attributes
+      arg.is_a?(Hash) ? attributes.merge!(arg) : flags << arg
+    end
+
+    # Create a callable printing procedure for the case
+    # that its whole output should be wrapped with a tag
+    printing_procedure = Proc.new do
+      unless method_or_methods.present?
+        # Print content(s) without using methods
+        content_or_contents.transmogrify do |content|
+          if flags.include? :wrap_whole_content
+            # Write printed object to buffer (without tag)
+            write_to_buffer print_object(content)
+          else
+            # Wrap printed object with a tag and write result to buffer
+            tag_to_buffer(tag, print_object(content), attributes)
+          end
+        end
+      else
+        unless flags.include? :couple_methods_with_contents
+          # Print content(s) using (fixed set of) method(s)
+          content_or_contents.transmogrify do |content|
+            method_or_methods.transmogrify do |method|
+              if flags.include? :wrap_whole_content
+                # Write printed object to buffer (without tag)
+                write_to_buffer print_object(content, method)
+              else
+                # Wrap printed object with a tag and write result to buffer
+                tag_to_buffer(tag, print_object(content, method), attributes)
+              end
+            end
+          end
+        else
+          # Print contents using individually paired methods
+          content_or_contents.transmogrify_with_index do |content, index|
+            method = method_or_methods[index]
+            if flags.include? :wrap_whole_content
+              # Write printed object to buffer (without tag)
+              write_to_buffer print_object(content, method)
+            else
+              # Wrap printed objects with a tag and write result to buffer
+              tag_to_buffer(tag, print_object(content, method), attributes)
+            end
+          end
+        end
+      end
+    end
+
+    if flags.include? :wrap_whole_content
+      # Wrap output of printing procedure with tag and write result to buffer
+      tag_to_buffer(tag, attributes, &printing_procedure)
+    else
+      # Call printing procedure and write result to buffer
+      printing_procedure.call
+    end
+
+    # Return buffer content
+    buffer
+  end
+
+  # Wraps content(s) into a single tag, optionally using a method
+  def wrap_contents(tag, content_or_contents, method_or_methods = nil, *flags_and_attributes)
+    print_contents(tag, content_or_contents, method_or_methods, :wrap_whole_content, *flags_and_attributes)
+  end
+
+  # Wraps haml_tag and directly captures the output buffer product.
+  # This should only be used if a single +haml_tag+ should be captured.
+  # Note that capturing buffer content should be done as rare as possible for performance reasons.
+  # For non-trivial content you might want to use `print_buffer { tag_to_buffer(:ul) { tag_to_buffer(:li, content) } }` instead.
+  #
+  # @param name [#to_s] The name of the tag
+  # @param flags [Array<Symbol>] Haml end-of-tag flags
+  # @param attributes [Hash] Hash of Haml (HTML) attributes
+  #
+  # @overload print_tag(name, *flags, attributes = {})
+  # @overload print_tag(name, text, *flags, attributes = {})
+  #   @param text [#to_s] The text within the tag
+  def print_tag(name, *rest)
+    puts "warning: print_tag does not except blocks. Use print_buffer { tag_to_buffer(:ul) { tag_to_buffer(:li, content) } } instead" if block_given?
+    print_buffer { tag(name, *rest) }
+  end
+
+  # Prints a single object, optionally using a method
+  def print_object(object, method = nil)
+    #logger = RAILS_DEFAULT_LOGGER
+    #logger.info "\"print_object speaking. I am about to print Object: " + object.inspect + " Method: " + method.inspect + ". Over.\""
+    unless method.present?
+      if object.respond_to? :call
+        begin
+          object.call.to_s
+        # Haml buffers may be provided in callable form, but have to be captured
+        rescue Haml::Error
+          # Rescue is only successful if buffer available in current scope
+          print_buffer { object.call }
+        end
+      else
+        object.to_s   # Each object responds to :to_s
+      end
+    else
+      # If the given method can be invoked on the object, the result is returned
+      if method.respond_to?(:to_sym) && object.respond_to?(method)
+        object.send(method.to_sym).to_s
+      # If the given method can be alled with the object, the result is returned
+      elsif method.respond_to? :call
+        # Call method with object if it takes at most 1 required parameter
+        # Arity returns -n-1 if n > 0 optional parameters exist
+        if method.arity == 1 || method.arity == -1 || method.arity == -2
+          method.call(object).to_s
+        else
+          raise ArgumentError, "Content is not printable. Too many (or no) parameters expected in the following method: " + method.inspect
+        end
+      else
+        raise ArgumentError, "Content is not printable. Provide a Proc/Method that can be called with object or a method name that can be invoked on the object. Alternatively, do not provide a method argument so that the object's :to_html, :call, or :to_s method is called. Parameters given: Object: " + object.inspect + " Method: " + method.inspect
+      end
+    end
+  end
+
+end
+
+$LOAD_PATH << File.expand_path(File.dirname(__FILE__))
+
+require 'active_component/core_extensions'
+require 'active_component/base'
+
+# Load components
+require 'active_component/components/block'
+require 'active_component/components/empty_tag'
+require 'active_component/components/heading'
+require 'active_component/components/inline_tag'
+require 'active_component/components/section'
+require 'active_component/components/table'
+
+# Register Active Component template handler in Rails 2 app
+if defined? ActionView::TemplateHandlers
+  extend ActionView::TemplateHandlers
+
+  require 'active_component/template_handler'
+  register_template_handler :act, ActiveComponent::TemplateHandler
+end