RubyGems - arbre2 - Versions diffs - 2.1.0 - Mend

arbre2 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (76) hide show

checksums.yaml +7 -0
data/.gitignore +30 -0
data/.ruby-gemset +1 -0
data/.ruby-version +1 -0
data/.travis.yml +6 -0
data/CHANGELOG.md +75 -0
data/Gemfile +2 -0
data/Gemfile.lock +93 -0
data/LICENSE +20 -0
data/README.md +92 -0
data/Rakefile +7 -0
data/arbre.gemspec +28 -0
data/lib/arbre/child_element_collection.rb +86 -0
data/lib/arbre/container.rb +20 -0
data/lib/arbre/context.rb +83 -0
data/lib/arbre/element/building.rb +151 -0
data/lib/arbre/element.rb +194 -0
data/lib/arbre/element_collection.rb +93 -0
data/lib/arbre/html/attributes.rb +91 -0
data/lib/arbre/html/class_list.rb +53 -0
data/lib/arbre/html/comment.rb +47 -0
data/lib/arbre/html/document.rb +93 -0
data/lib/arbre/html/html_tags.rb +67 -0
data/lib/arbre/html/querying.rb +256 -0
data/lib/arbre/html/tag.rb +317 -0
data/lib/arbre/rails/layouts.rb +126 -0
data/lib/arbre/rails/legacy_document.rb +29 -0
data/lib/arbre/rails/rendering.rb +76 -0
data/lib/arbre/rails/rspec/arbre_support.rb +61 -0
data/lib/arbre/rails/rspec.rb +2 -0
data/lib/arbre/rails/template_handler.rb +32 -0
data/lib/arbre/rails.rb +35 -0
data/lib/arbre/rspec/be_rendered_as_matcher.rb +103 -0
data/lib/arbre/rspec/be_scripted_as_matcher.rb +68 -0
data/lib/arbre/rspec/contain_script_matcher.rb +64 -0
data/lib/arbre/rspec.rb +3 -0
data/lib/arbre/text_node.rb +35 -0
data/lib/arbre/version.rb +3 -0
data/lib/arbre.rb +27 -0
data/spec/arbre/integration/html_document_spec.rb +90 -0
data/spec/arbre/integration/html_spec.rb +283 -0
data/spec/arbre/integration/querying_spec.rb +187 -0
data/spec/arbre/integration/rails_spec.rb +183 -0
data/spec/arbre/rails/rspec/arbre_support_spec.rb +75 -0
data/spec/arbre/rspec/be_rendered_as_matcher_spec.rb +80 -0
data/spec/arbre/rspec/be_scripted_as_matcher_spec.rb +61 -0
data/spec/arbre/rspec/contain_script_matcher_spec.rb +40 -0
data/spec/arbre/support/arbre_example_group.rb +0 -0
data/spec/arbre/unit/child_element_collection_spec.rb +146 -0
data/spec/arbre/unit/container_spec.rb +23 -0
data/spec/arbre/unit/context_spec.rb +95 -0
data/spec/arbre/unit/element/building_spec.rb +300 -0
data/spec/arbre/unit/element_collection_spec.rb +169 -0
data/spec/arbre/unit/element_spec.rb +297 -0
data/spec/arbre/unit/html/attributes_spec.rb +219 -0
data/spec/arbre/unit/html/class_list_spec.rb +109 -0
data/spec/arbre/unit/html/comment_spec.rb +42 -0
data/spec/arbre/unit/html/querying_spec.rb +32 -0
data/spec/arbre/unit/html/tag_spec.rb +300 -0
data/spec/arbre/unit/rails/layouts_spec.rb +127 -0
data/spec/arbre/unit/text_node_spec.rb +40 -0
data/spec/rails/app/controllers/example_controller.rb +18 -0
data/spec/rails/app/views/example/_arbre_partial.html.arb +7 -0
data/spec/rails/app/views/example/_erb_partial.html.erb +1 -0
data/spec/rails/app/views/example/arbre.html.arb +1 -0
data/spec/rails/app/views/example/arbre_partial_result.html.arb +3 -0
data/spec/rails/app/views/example/erb.html.erb +5 -0
data/spec/rails/app/views/example/erb_partial_result.html.arb +3 -0
data/spec/rails/app/views/example/partials.html.arb +11 -0
data/spec/rails/app/views/layouts/empty.html.arb +1 -0
data/spec/rails/app/views/layouts/with_title.html.arb +5 -0
data/spec/rails/config/routes.rb +4 -0
data/spec/rails_spec_helper.rb +13 -0
data/spec/spec_helper.rb +20 -0
data/spec/support/arbre_example_group.rb +19 -0
metadata +254 -0

data/spec/arbre/integration/html_document_spec.rb ADDED Viewed

@@ -0,0 +1,90 @@
+require 'spec_helper'
+include Arbre::Html
+describe Document do
+  it "should by default be rendered as an empty document" do
+    arbre.append Document
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        </head>
+        <body>
+        </body>
+      </html>
+    HTML
+  end
+  it "should allow content to be appended to the head using the #head method" do
+    arbre do
+      append Document do |doc|
+        doc.head { title "My Title" }
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+          <title>My Title</title>
+        </head>
+        <body>
+        </body>
+      </html>
+    HTML
+  end
+  it "should allow content to be appended to the body using the #body method" do
+    arbre do
+      append Document do |doc|
+        doc.body { div 'Content Area' }
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <!DOCTYPE html>
+      <html>
+        <head>
+          <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+        </head>
+        <body>
+          <div>Content Area</div>
+        </body>
+      </html>
+    HTML
+  end
+  it "should allow setting the title through a property" do
+    arbre do
+      append Document do |doc|
+        doc.title = 'My Title'
+      end
+    end
+    expect(arbre.find('head')).to be_rendered_as(<<-HTML)
+      <head>
+        <title>My Title</title>
+        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
+      </head>
+    HTML
+  end
+  it "should allow getting the title through an attribute" do
+    arbre do
+      append Document do |doc|
+        doc.head { title "My Title" }
+      end
+    end
+    document = arbre.children[0]
+    expect(document.title).to eql('My Title')
+  end
+end

data/spec/arbre/integration/html_spec.rb ADDED Viewed

@@ -0,0 +1,283 @@
+require 'spec_helper'
+describe Arbre do
+  let(:helpers) { double(:helpers) }
+  let(:assigns) { {} }
+  it "should render a single element" do
+    arbre { span "Hello World" }
+    expect(arbre).to be_rendered_as("<span>Hello World</span>")
+  end
+  it "should access assigns through instance variables" do
+    assigns[:my_var] = 'Hello World'
+    arbre { span @my_var }
+    expect(arbre).to be_rendered_as("<span>Hello World</span>")
+  end
+  it "should allow access to helper methods" do
+    expect(helpers).to receive(:my_helper).and_return('Hello World')
+    arbre { span my_helper }
+    expect(arbre).to be_rendered_as("<span>Hello World</span>")
+  end
+  it "should render a child element" do
+    arbre do
+      span do
+        span "Hello World"
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <span>
+        <span>Hello World</span>
+      </span>
+    HTML
+  end
+  it "should render an unordered list" do
+    arbre do
+      ul do
+        li "First"
+        li "Second"
+        li "Third"
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <ul>
+        <li>First</li>
+        <li>Second</li>
+        <li>Third</li>
+      </ul>
+    HTML
+  end
+  it "should allow local variables inside the tags" do
+    arbre do
+      first = "First"
+      second = "Second"
+      ul do
+        li first
+        li second
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <ul>
+        <li>First</li>
+        <li>Second</li>
+      </ul>
+    HTML
+  end
+  it "should add children and nested" do
+    arbre do
+      div do
+        ul
+        li do
+          li
+        end
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div>
+        <ul></ul>
+        <li>
+          <li></li>
+        </li>
+      </div>
+    HTML
+  end
+  it "should allow flow" do
+    arbre do
+      div do
+        span2 = span('Span 2')
+        span1 = prepend { span 'Span 1' }
+        span4 = after(span2) { span 'Span 4' }
+        before(span4) { span 'Span 3' }
+        span 'Span 5'
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div>
+        <span>Span 1</span>
+        <span>Span 2</span>
+        <span>Span 3</span>
+        <span>Span 4</span>
+        <span>Span 5</span>
+      </div>
+    HTML
+  end
+  it "should allow adding elements relative to others using queries" do
+    arbre do
+      div1 = div(:class => 'div1')
+      within('.div1') { span 'Span 1.1', :id => 'my-span' }
+      after('.div1 > #my-span') { span 'Span 1.2' }
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div class="div1">
+        <span id="my-span">Span 1.1</span>
+        <span>Span 1.2</span>
+      </div>
+    HTML
+  end
+  it "should pass the element in to the block if asked for" do
+    arbre do
+      div do |d|
+        d.ul do
+          li
+        end
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div>
+        <ul>
+          <li></li>
+        </ul>
+      </div>
+    HTML
+  end
+  it "should move content tags between parents" do
+    arbre do
+      div do
+        span(ul(li))
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div>
+        <span>
+          <ul>
+            <li></li>
+          </ul>
+        </span>
+      </div>
+    HTML
+  end
+  it "should add content to the parent if the element is passed into block" do
+    arbre do
+      div do |d|
+        d.id = "my-tag"
+        ul do
+          li
+        end
+      end
+    end
+    expect(arbre).to be_rendered_as(<<-HTML)
+      <div id="my-tag">
+        <ul>
+          <li></li>
+        </ul>
+      </div>
+    HTML
+  end
+  it "should have the parent set on it" do
+    item = nil
+    list = nil
+    arbre do
+      list = ul do
+        li "Hello"
+        item = li("World")
+      end
+    end
+    expect(item.parent).to be(list)
+  end
+  describe "html safe" do
+    it "should escape the contents" do
+      arbre do
+        span("<br />")
+      end
+      expect(arbre).to be_rendered_as(<<-HTML)
+        <span>&lt;br /&gt;</span>
+      HTML
+    end
+    it "should return html safe strings" do
+      arbre do
+        span("<br />")
+      end
+      expect(arbre.to_s).to be_html_safe
+    end
+    it "should not escape html passed in" do
+      arbre do
+        span(span("<br />"))
+      end
+      expect(arbre).to be_rendered_as(<<-HTML)
+        <span>
+          <span>&lt;br /&gt;</span>
+        </span>
+      HTML
+    end
+    it "should escape the contents of attributes" do
+      arbre do
+        span(:class => "<br />")
+      end
+      expect(arbre).to be_rendered_as(<<-HTML)
+        <span class="&lt;br /&gt;"></span>
+      HTML
+    end
+  end
+  describe 'indentation' do
+    # All specs in this file use the be_rendered_as matcher, which ignores whitespace. These specs are explicitly
+    # designed to exemplify the indentation pattern.
+    it "should use proper indentation" do
+      arbre { div(span('Test')) }
+      expect(arbre.to_s).to eql(<<-HTML.gsub(/^ {8}/, '').chomp)
+        <div>
+          <span>Test</span>
+        </div>
+      HTML
+    end
+    it "should not indent containers" do
+      arbre do
+        div do
+          append Arbre::Container do
+            span 'One'
+            span 'Two'
+          end
+        end
+      end
+      expect(arbre.to_s).to eql(<<-HTML.gsub(/^ {8}/, '').chomp)
+        <div>
+          <span>One</span>
+          <span>Two</span>
+        </div>
+      HTML
+    end
+  end
+end

data/spec/arbre/integration/querying_spec.rb ADDED Viewed

@@ -0,0 +1,187 @@
+require 'spec_helper'
+include Arbre
+describe Arbre::Html::Querying do
+  let(:arbre) do
+    Arbre::Context.new do
+      div :id => 'one'
+      div :id => 'two' do
+        a 'Link 1', :href => '/', :class => 'one two'
+        input :type => :checkbox, 'data-attribute' => 'some_value'
+        input :type => 'file'
+        insert Container do
+          span :id => 'in_container'
+          a 'Link 2', :href => '/blah', :class => 'external two', :target => '_blank'
+        end
+      end
+      div :id => 'three' do
+        a 'Link 3', :class => 'three'
+        div do
+          a 'Link 4', :class => 'four'
+        end
+      end
+    end
+  end
+  describe Arbre::Html::Query do
+    it "should find all descendants using the '*' selector" do
+      elements = "[<div#one>, <div#two>, <a.one.two>, <input[type=checkbox]>, <input[type=file]>, <span#in_container>, <a.external.two>, <div#three>, <a.three>, <div>, <a.four>]"
+      expect(arbre.find('*').to_a.inspect).to eql(elements)
+    end
+    it "should find all links using 'a'" do
+      result = arbre.find('a')
+      expect(result.to_a.inspect).to eql('[<a.one.two>, <a.external.two>, <a.three>, <a.four>]')
+    end
+    it "should find all external links using 'a.external'" do
+      result = arbre.find('a.external')
+      expect(result.to_a.inspect).to eql('[<a.external.two>]')
+    end
+    it "should find only direct children using a direct child operator" do
+      result = arbre.find('div#two > a.external')
+      expect(result.to_a.inspect).to eql('[<a.external.two>]')
+    end
+    it "should match all given classes" do
+      result = arbre.find('a.one.two')
+      expect(result.to_a.inspect).to eql('[<a.one.two>]')
+    end
+    it "should match multiple selectors" do
+      result = arbre.find('div#one, a')
+      expect(result.to_a.inspect).to eql('[<div#one>, <a.one.two>, <a.external.two>, <a.three>, <a.four>]')
+    end
+    describe 'pseudo selectors' do
+      it "should accept the :first pseudo selector" do
+        result = arbre.find('a:first')
+        expect(result.to_a.inspect).to eql('[<a.one.two>]')
+      end
+      it "should accept the :last pseudo selector" do
+        result = arbre.find('a:last')
+        expect(result.to_a.inspect).to eql('[<a.four>]')
+      end
+      it "should accept the :first-child pseudo selector" do
+        result = arbre.find('a:first-child')
+        expect(result.to_a.inspect).to eql('[<a.one.two>, <a.three>, <a.four>]')
+      end
+      it "should accept the :last-child pseudo selector" do
+        result = arbre.find('a:last-child')
+        expect(result.to_a.inspect).to eql('[<a.external.two>, <a.four>]')
+      end
+      it "should accept multiple pseudo selectors" do
+        result = arbre.find('a:first-child:last-child')
+        expect(result.to_a.inspect).to eql('[<a.four>]')
+      end
+    end
+    describe 'attribute selectors' do
+      it "should accept an attribute selector without a value" do
+        result = arbre.find('a[href]')
+        expect(result.to_a.inspect).to eql('[<a.one.two>, <a.external.two>]')
+      end
+      it "should accept an attribute selector with a value" do
+        result = arbre.find('input[type=checkbox]')
+        expect(result.to_a.inspect).to eql('[<input[type=checkbox]>]')
+      end
+      it "should accept an attribute selector with a dash and a quoted value" do
+        result = arbre.find('input[data-attribute="some_value"]')
+        expect(result.to_a.inspect).to eql('[<input[type=checkbox]>]')
+      end
+      it "should accept multiple attribute selectors" do
+        result = arbre.find('a[href="/blah"][target]')
+        expect(result.to_a.inspect).to eql('[<a.external.two>]')
+      end
+    end
+    it "should allow various selector properties to be combined" do
+      result = arbre.find('a.two:last')
+      expect(result.to_a.inspect).to eql('[<a.external.two>]')
+    end
+    it "should allow a descendant selector" do
+      result = arbre.find('#three a')
+      expect(result.to_a.inspect).to eql('[<a.three>, <a.four>]')
+    end
+    it "should allow a child selector" do
+      result = arbre.find('#three > a')
+      expect(result.to_a.inspect).to eql('[<a.three>]')
+    end
+    it "should find something inside a container" do
+      result = arbre.find('#in_container')
+      expect(result.to_a.inspect).to eql('[<span#in_container>]')
+    end
+    it "should find something 'through' a container" do
+      result = arbre.find('#two > #in_container')
+      expect(result.to_a.inspect).to eql('[<span#in_container>]')
+    end
+  end
+  describe '#descendant_tags' do
+    it "should find all descendant tags" do
+      elements = "[<div#one>, <div#two>, <a.one.two>, <input[type=checkbox]>, <input[type=file]>, <span#in_container>, <a.external.two>, <div#three>, <a.three>, <div>, <a.four>]"
+      expect(arbre.descendant_tags.to_a.inspect).to eql(elements)
+    end
+  end
+  describe '#child_tags' do
+    it "should find all child tags of an element" do
+      result = arbre.find_first('#two').child_tags
+      expect(result.to_a.inspect).to eql('[<a.one.two>, <input[type=checkbox]>, <input[type=file]>, <span#in_container>, <a.external.two>]')
+    end
+  end
+  describe '#find_by_id' do
+    it "should find the first descendant tag with the given ID" do
+      result = arbre.find_by_id('two')
+      expect(result.inspect).to eql('<div#two>')
+    end
+  end
+  describe '#find_by_tag' do
+    it "should find the first descendant tag with the given tag name" do
+      result = arbre.find_by_tag('span')
+      expect(result.to_a.inspect).to eql('[<span#in_container>]')
+    end
+  end
+  describe '#find_by_classes' do
+    it "should find the first descendant tag with the given tag name" do
+      result = arbre.find_by_classes(['one', 'two'])
+      expect(result.to_a.inspect).to eql('[<a.one.two>]')
+    end
+  end
+end