RubyGems - arbre2 - Versions diffs - 2.1.0 - Mend

arbre2 2.1.0

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