arbre2 2.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e3f1ac910f763cbfdb4e8eb7d0c5a85ed3b51339
+  data.tar.gz: eb1d640364da931397040de5742e175b9be1f18d
+SHA512:
+  metadata.gz: 8f9fa5ca0ffa00691b8ad49fe6ab47cea7cecd4d318e4e9241cac16a70e8925b42d5ab6dee9db9716a5597b0f0ec100ca22fc02d6f093d283e7a76609551161a
+  data.tar.gz: 45ae2671b9ae6f1d549ccbe2bf068af665fc0ba3a3297843ed3a1dd9ca7fa759f66531a40c78a0b35118fbb7e227d73179a14eea40cf5318fdaedd7a97739789

data/.gitignore

@@ -0,0 +1,30 @@
+# See http://help.github.com/ignore-files/ for more about ignoring files.
+#
+# If you find yourself ignoring temporary files generated by your text editor
+# or operating system, you probably want to add a global ignore instead:
+#   git config --global core.excludesfile ~/.gitignore_global
+
+# Ignore .DS_Store
+.DS_Store
+
+# Ignore the output files.
+/pkg
+
+# Ignore bundler and database config and precompiled assets
+/.bundle
+/.env
+
+# Ignore all logfiles and tempfiles.
+/tmp
+
+# Ignore TextMate projects
+*.tmproj
+*.sublime-project
+*.sublime-workspace
+
+# Documentation files and other stuff
+.yardoc
+/doc
+/nbproject
+/coverage
+/spec/rails/log

data/.ruby-gemset

@@ -0,0 +1 @@
+flux

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/.travis.yml

@@ -0,0 +1,6 @@
+script: bundle exec rake
+rvm:
+  - 2.0.0
+branches:
+  only:
+    - master

data/CHANGELOG.md

@@ -0,0 +1,75 @@
+## 2.1.0
+
+* Added AJAX-rendering to `Arbre::Rails::LegacyDocument`
+* Bug fix: classes specified in the class definition are not overwritten anymore by those passed to the
+  `build!` method.
+* When using the `build!` method, any attributes that have a corresponding `<attribute>=` method on the
+  element class will cause this method to be invoked rather than the attributes array being updated.
+* Bug fix: querying using multiple selectors now works (tag.find('a, button')).
+* Bug fix using `render`: all child elements are now copied into the caller's element.
+* Added public RSpec API.
+
+## 2.0.1
+
+* Added `app/views/arbre` as autoload path when using Rails
+* Added DSL methods `Arbre::Html::Tag.tag`, `Arbre::Html::Tag.tag_id` and `Arbre::Html::Tag.tag_classes`
+
+## 2.0.0
+
+* Increased RSpec coverage to 100%
+* Clear of specs failing when integrating into Flux framework
+
+## 2.0.0.rc2
+
+* Support for symbolic classes
+* Various fixes & spec upgrades after integration into Flux framework
+
+### Breaking changes
+
+* Renaming `build` to `build!`
+* Renaming `build_tag`/`build_element` to `build`
+* Renaming `insert_tag`/`insert_element` to `insert`
+
+## 2.0.0.rc1
+
+* Rails: added content-layout structure
+* Rails: optimized template output handling, removed need for String masquerading
+* Added querying
+* Increased RSpec coverage to near 100%
+
+### Breaking changes
+
+* Removal of `:for`-feature in tags
+* Renamed `current_arbre_element` to `current_element`
+* Renamed `Arbre::HTML` into `Arbre::Html`
+
+  *Joost Lubach*
+
+## 1.0.1
+
+* Template handler converts to string to satisfy Rack::Lint (@jpmckinney, #6)
+* Fix to `Tag#add_class` when passing a string of classes to Tag build method
+  (@gregbell, #7)
+* Not longer uses the default separator (@LTe, #4)
+
+## 1.0.0
+
+* Added support for the use of `:for` with non Active Model objects
+
+## 1.0.0.rc4
+
+* Fix issue where user could call `symbolize_keys!` on a
+  HashWithIndifferentAccess which doesn't implement the method
+
+## 1.0.0.rc3
+
+* Implemented `Arbre::Html::Tag#default_id_for_prefix`
+
+## 1.0.0.rc2
+
+* Fixed bug where Component's build methods were being rendered within the
+  parent context.
+
+## 1.0.0.rc1
+
+* Initial release and extraction from Active Admin

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,93 @@
+PATH
+  remote: .
+  specs:
+    arbre2 (2.1.0)
+      activesupport (~> 3.2)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    actionpack (3.2.14)
+      activemodel (= 3.2.14)
+      activesupport (= 3.2.14)
+      builder (~> 3.0.0)
+      erubis (~> 2.7.0)
+      journey (~> 1.0.4)
+      rack (~> 1.4.5)
+      rack-cache (~> 1.2)
+      rack-test (~> 0.6.1)
+      sprockets (~> 2.2.1)
+    activemodel (3.2.14)
+      activesupport (= 3.2.14)
+      builder (~> 3.0.0)
+    activesupport (3.2.14)
+      i18n (~> 0.6, >= 0.6.4)
+      multi_json (~> 1.0)
+    atomic (1.1.14)
+    builder (3.0.4)
+    combustion (0.5.1)
+      activesupport (>= 3.0.0)
+      railties (>= 3.0.0)
+      thor (>= 0.14.6)
+    diff-lcs (1.2.5)
+    erubis (2.7.0)
+    hike (1.2.3)
+    i18n (0.6.9)
+    journey (1.0.4)
+    json (1.8.1)
+    multi_json (1.8.2)
+    rack (1.4.5)
+    rack-cache (1.2)
+      rack (>= 0.4)
+    rack-ssl (1.3.3)
+      rack
+    rack-test (0.6.2)
+      rack (>= 1.0)
+    railties (3.2.14)
+      actionpack (= 3.2.14)
+      activesupport (= 3.2.14)
+      rack-ssl (~> 1.3.2)
+      rake (>= 0.8.7)
+      rdoc (~> 3.4)
+      thor (>= 0.14.6, < 2.0)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    rspec-rails (2.14.0)
+      actionpack (>= 3.0)
+      activesupport (>= 3.0)
+      railties (>= 3.0)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    sprockets (2.2.2)
+      hike (~> 1.2)
+      multi_json (~> 1.0)
+      rack (~> 1.0)
+      tilt (~> 1.1, != 1.3.0)
+    thor (0.18.1)
+    thread_safe (0.1.3)
+      atomic
+    tilt (1.4.1)
+    tzinfo (1.1.0)
+      thread_safe (~> 0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  arbre2!
+  bundler (~> 1.3)
+  combustion (~> 0.5)
+  rake
+  rspec-rails (~> 2.14)
+  simplecov
+  tzinfo

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2013 Greg Bell
+
+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.md

@@ -0,0 +1,92 @@
+# Arbre - Ruby Object Oriented HTML Views
+
+Arbre is the DOM implemented in Ruby. This project is primarily used as
+the object oriented view layer in Active Admin.
+
+[<img src="https://secure.travis-ci.org/yoazt/arbre.png?branch=master" alt="Build Status" />](http://travis-ci.org/yoazt/arbre)
+
+## Simple Usage
+
+A simple example of setting up an Arbre context and creating some html
+
+    html = Arbre::Context.new do
+      h2 "Why Arbre is awesome?"
+
+      ul do
+        li "The DOM is implemented in ruby"
+        li "You can create object oriented views"
+        li "Templates suck"
+      end
+    end
+
+    puts html.to_s #=> <h2>Why</h2><ul><li></li></ul>
+
+
+## The DOM in Ruby
+
+The purpose of Arbre is to leave the view as ruby objects as long
+as possible. This allows OO Design to be used to implement the view layer.
+
+
+    html = Arbre::Context.new do
+      h2 "Why Arbre is awesome?"
+    end
+
+    html.children.size #=> 1
+    html.children.first #=> #<Arbre::Html::H2>
+
+It is easy to extend your DOM tree as well.
+
+    arbre = Arbre::Context.new do
+      h2 "Why Arbre is awesome?"
+
+      ul do
+        li "The DOM is implemented in ruby"
+        li "You can create object oriented views"
+      end
+
+      within 'ul' do
+        li "Templates suck"
+      end
+      before 'li:last' do
+        li "I forgot:"
+      end
+    end
+
+## Custom elements
+
+The purpose of Arbre is to be able to create shareable and extendable HTML
+elements. To do this, you create a subclass of any Arbre HTML element:
+
+For example:
+
+    class Panel < Arbre::Html::Section
+      builder_method :panel
+
+      def build!(title, attributes = {})
+        super attributes
+
+        h3 title, class: "panel-title"
+      end
+    end
+
+The `builder_method` defines the method that will be called to build this component
+when using the DSL. The arguments passed into the `builder_method` will be passed
+into the `#build!` method for you.
+
+You can now use this panel in any Arbre context:
+
+    html = Arbre::Context.new do
+      panel "Hello World", id: "my-panel" do
+        span "Inside the panel"
+
+        after('h3') { sub "This is inserted after the title." }
+      end
+    end
+
+    html.to_s #=>
+      # <div class='panel' id="my-panel">
+      #   <h3 class='panel-title'>Hello World</h3>
+      #   <sub>This is inserted after the title.</sub>
+      #   <span>Inside the panel</span>
+      # </div>

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/arbre.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "arbre/version"
+
+Gem::Specification.new do |s|
+  s.name        = "arbre2"
+  s.version     = Arbre::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Greg Bell", "Joost Lubach"]
+  s.email       = ["gregdbell@gmail.com", "joostlubach@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{An Object Oriented DOM Tree in Ruby}
+  s.description = %q{An Object Oriented DOM Tree in Ruby}
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency "activesupport", "~> 3.2"
+
+  s.add_development_dependency "bundler", "~> 1.3"
+  s.add_development_dependency "rake"
+  s.add_development_dependency "tzinfo"
+  s.add_development_dependency "combustion", "~> 0.5"
+  s.add_development_dependency "rspec-rails", "~> 2.14"
+  s.add_development_dependency "simplecov"
+end

data/lib/arbre/child_element_collection.rb

@@ -0,0 +1,86 @@
+module Arbre
+
+  # An element collection used to hold some other element's children. Adds functionality to
+  # update a child's parent when it is added, and supports inserting at specific positions
+  # in the collection.
+  class ChildElementCollection < ElementCollection
+
+    ######
+    # Initialization
+
+      def initialize(parent)
+        super([])
+        @parent = parent
+      end
+
+      attr_reader :parent
+
+    ######
+    # Equality
+
+      def eql?(other)
+        super && parent == other.parent
+      end
+
+    ######
+    # Adding and removing
+
+      def add(element)
+        insert_at length, element
+      end
+
+      def remove(element)
+        return unless include?(element)
+
+        element.parent = nil
+        @elements.delete element
+      end
+
+      def clear
+        @elements.each { |element| element.parent = nil }
+        super
+      end
+
+    ######
+    # Inserting
+
+      def insert_at(index, element)
+        if include?(element)
+          index -= 1 if @elements.index(element) <= index
+          @elements.delete element
+        else
+          assign_to_parent element
+        end
+        @elements.insert index, element
+        self
+      end
+
+      def insert_after(existing, element)
+        index = @elements.index(existing) or
+          raise ArgumentError, "existing element #{existing} not found"
+
+        insert_at index+1, element
+      end
+
+      def insert_before(existing, element)
+        index = @elements.index(existing) or
+          raise ArgumentError, "existing element #{existing} not found"
+
+        insert_at index, element
+      end
+
+    ######
+    # Parent
+
+      private
+
+      # Assigns the element to the parent of this collection, and removes it from the
+      # children of its current parent.
+      def assign_to_parent(element)
+        element.remove!
+        element.parent = parent
+      end
+
+  end
+
+end

data/lib/arbre/container.rb

@@ -0,0 +1,20 @@
+module Arbre
+
+  # This element is a simple container for children. When rendered, it will
+  # simply render the children, making this element 'invisible'. Use this
+  # class as a placeholder.
+  class Container < Element
+    def to_s
+      content
+    end
+
+    def indent_level
+      if parent
+        parent.indent_level
+      else
+        0
+      end
+    end
+  end
+
+end

data/lib/arbre/context.rb

@@ -0,0 +1,83 @@
+require 'arbre/element'
+require 'active_support/core_ext/hash/keys'
+
+module Arbre
+
+  # Root of any Arbre construct. Each elements in any Arbre construct will have a reference
+  # to this context, which provides information like what the current arbre element is.
+  class Context < Container
+
+    ######
+    # Initialization
+
+      # Initialize a new Arbre::Context. Any passed block will be instance-exec'd.
+      #
+      # @param [Hash] assigns
+      #   A hash of objects which will be made available as instance variables in the context,
+      #   and in some Arbre elements.
+      #
+      # @param [Object] helpers
+      #   An object that has methods on it which will become instance methods within the context.
+      #   In a Rails set up, this is typically the +ActionView::Base+ instance used to render the
+      #   view.
+      def initialize(assigns = nil, helpers = nil, &block)
+        @_assigns = (assigns || {}).symbolize_keys
+        @_helpers = helpers
+        @_element_stack = [ self ]
+        @_flow_stack = [ :append ]
+
+        # Pass ourselves as the arbre context to the element.
+        super self
+
+        instance_exec &block if block_given?
+      end
+
+    ######
+    # Attributes
+
+      def assigns
+        @_assigns
+      end
+
+      def helpers
+        @_helpers
+      end
+
+      def parent=(*)
+        raise NotImplementedError, "Arbre::Context cannot have a parent"
+      end
+
+      def indent_level
+        -1
+      end
+
+    ######
+    # Element & flow stack
+
+      def current_element
+        @_element_stack.last
+      end
+
+      def current_flow
+        @_flow_stack.last
+      end
+
+      def with_current(element: nil, flow: :append)
+        raise ArgumentError, "can't be in the context of nil" unless element
+
+        @_element_stack.push element
+        @_flow_stack.push flow
+        yield if block_given?
+      ensure
+        @_flow_stack.pop
+        @_element_stack.pop
+      end
+
+      # Replaces the current flow. For internal usie!
+      def replace_current_flow(flow)
+        @_flow_stack.pop
+        @_flow_stack.push flow
+      end
+
+  end
+end