prismic.io 1.0.0.rc10 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4ea682bc3f2afcc4da972445dda3adb15eff1549
-  data.tar.gz: c47ad3c077959de4f29a90a52249163f69d784ce
+  metadata.gz: 8622f78a1a654d406af4edf4471810ab14e0a4a2
+  data.tar.gz: 3861bfec9717d19b0e047d86f4e28375b6f801d6
 SHA512:
-  metadata.gz: 7067ccbd2b56755280c0fdc734adc14dee3c0a1ca9abe6e5462e0eeffef26dfb38f8fe32091a8de5e46b032a2c46d4037d93f48fd76fb82a9c81b942a3a1d7ea
-  data.tar.gz: a7436d00a195ebd14ce978e11b65c52b0bd43b60ab77637d20bd88ccecaa78871faccb49539c4bfb5db0d4b9ee36e898ebf13568121551cb3c2a6c3afadcff55
+  metadata.gz: 962b52cb0b6fa39f30058653bbbc99e44d33be0516a30afd6a8ba3c7cae6ff1ef1643da2818e8eaa1cde8e751f532b4c881f83e75f0e929a6846a36da2e0c2f2
+  data.tar.gz: 004429336746943544191ae573d28fddd03dc8147292020ca4a7836fddc6d47f2748384f86004070463f8ab15b331bae88561792f8577a279121120395532da0

data/.gitignore

@@ -1,3 +1,5 @@
 coverage/
 pkg/*.gem
 .bundle/
+.idea/
+

data/Changelog.md

@@ -0,0 +1,7 @@
+### 1.0.0.rc10 (2014-09-10)
+
+Features:
+
+  - Support for links in images
+  - Support for Timestamp fragments
+  - Support for Geopoint fragments

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    prismic.io (1.0.0.rc10)
+    prismic.io (1.0.1)
 
 GEM
   remote: https://rubygems.org/

data/lib/prismic/cache/basic.rb

@@ -6,7 +6,7 @@ module Prismic
     attr_reader :expired_in
     attr_reader :data
 
-    def initialize(data, expired_in = 0)
+    def initialize(data, expired_in)
       @data = data
       @expired_in = expired_in
     end
@@ -26,9 +26,9 @@ module Prismic
       include?(key) ? @cache[key].data : nil
     end
 
-    def set(key, value = nil, expired_in = 0)
+    def set(key, value = nil, expired_in = nil)
       data = block_given? ? yield : value
-      expired_in = (expired_in == 0) ? 0 : Time.now.getutc.to_i + expired_in
+      expired_in = expired_in && Time.now.getutc.to_i + expired_in
       entry = BasicCacheEntry.new(data, expired_in)
       @cache[key] = entry
       entry.data
@@ -38,7 +38,7 @@ module Prismic
       @cache.keys.include?(key)
     end
 
-    def get_or_set(key, value = nil, expired_in = 0)
+    def get_or_set(key, value = nil, expired_in = nil)
       return get(key) if include?(key) && !expired?(key)
       set(key, block_given? ? yield : value, expired_in)
     end
@@ -51,7 +51,7 @@ module Prismic
     def expired?(key)
       if include?(key)
         expired_in = @cache[key].expired_in
-        (expired_in != 0) && expired_in < Time.now.getutc.to_i
+        expired_in && expired_in < Time.now.getutc.to_i
       else
         false
       end

data/lib/prismic/fragments/embed.rb

@@ -18,7 +18,7 @@ module Prismic
       #     application's specific URL
       #
       # @return [String] the HTML representation
-      def as_html(link_resolver=nil)
+      def as_html(link_resolver=nil, html_serializer=nil)
         <<-HTML
         <div data-oembed="#@url"
             data-oembed-type="#{@embed_type.downcase}"

data/lib/prismic/fragments/structured_text.rb

@@ -31,7 +31,7 @@ module Prismic
       # it is not advised to override this method if you want to change the HTML output, you should
       # override the as_html method at the block level (like {Heading.as_html}, or {Preformatted.as_html},
       # for instance).
-      def as_html(link_resolver)
+      def as_html(link_resolver, html_serializer=nil)
         # Defining blocks that deserve grouping, assigning them "group kind" names
         block_group = ->(block){
           case block
@@ -52,7 +52,9 @@ module Prismic
         # HTML-serializing the groups object (delegating the serialization of Block objects),
         # without forgetting to frame the BlockGroup objects right if needed
         groups.map{|group|
-          html = group.blocks.map{|b| b.as_html(link_resolver) }.join
+          html = group.blocks.map { |b|
+            b.as_html(link_resolver, html_serializer)
+          }.join
           case group.kind
           when "ol"
             %(<ol>#{html}</ol>)
@@ -96,21 +98,26 @@ module Prismic
           @end = finish
         end
 
-        class Em < Span
-          def start_html(link_resolver=nil)
-            "<em>"
+        class Label < Span
+          attr_accessor :label
+          def initialize(start, finish, label)
+            super(start, finish)
+            @label = label
           end
-          def end_html
-            "</em>"
+          def serialize(text, link_resolver = nil)
+            "<span class=\"#{@label}\">#{text}</span>"
           end
         end
 
-        class Strong < Span
-          def start_html(link_resolver=nil)
-            "<strong>"
+        class Em < Span
+          def serialize(text, link_resolver = nil)
+            "<em>#{text}</em>"
           end
-          def end_html
-            "</strong>"
+        end
+
+        class Strong < Span
+          def serialize(text, link_resolver = nil)
+            "<strong>#{text}</strong>"
           end
         end
 
@@ -120,13 +127,15 @@ module Prismic
             super(start, finish)
             @link = link
           end
-          def start_html(link_resolver = nil)
-            link.start_html(link_resolver)
-          end
-          def end_html
-            link.end_html
+          def serialize(text, link_resolver = nil)
+            if link.is_a? Prismic::Fragments::DocumentLink and link.broken
+              "<span>#{text}</span>"
+            else
+              %(<a href="#{link.url(link_resolver)}">#{text}</a>)
+            end
           end
         end
+
       end
 
       class Block
@@ -140,45 +149,55 @@ module Prismic
         end
 
         class Text
-          attr_accessor :text, :spans
+          attr_accessor :text, :spans, :label
 
-          def initialize(text, spans)
+          def initialize(text, spans, label = nil)
             @text = text
             @spans = spans.select{|span| span.start < span.end}
+            @label = label
           end
 
-          def as_html(link_resolver=nil)
+          def class_code
+            (@label && %( class="#{label}")) || ''
+          end
+
+          def as_html(link_resolver=nil, html_serializer=nil)
+            html = ''
             # Getting Hashes of spanning tags to insert, sorted by starting position, and by ending position
             start_spans, end_spans = prepare_spans
-            # All the positions in which we'll have to insert an opening or closing tag
-            all_cuts = (start_spans.keys | end_spans.keys).sort
-
-            # Initializing the browsing of the string
-            output = []
-            cursor = 0
-            tags = []  # the seen tags
-
-            # Taking each text cut and inserting the closing tags and the opening tags if needed
-            all_cuts.each do |cut|
-              output << CGI::escapeHTML(text[cursor, cut-cursor])
-              end_tags = end_spans[cut]
-              # reorder endings tags using creating order
-              split = tags.group_by {|t| end_tags.include?(t) }
-              end_tags, tags = split[true]||[], split[false]||[]
-              output += end_tags.map{|span| span.end_html }
-              # store created tags (in the right order)
-              start_tags = start_spans[cut].sort_by{|s| s.end }.reverse
-              tags += start_tags.reverse
-              output += start_tags.map{|span| span.start_html(link_resolver) }
-              cursor = cut # cursor is now where the cut was
+            # Open tags
+            stack = Array.new
+            (text.length + 1).times do |pos| # Looping to length + 1 to catch closing tags
+              end_spans[pos].each do |t|
+                # Close a tag
+                tag = stack.pop
+                inner_html = serialize(tag[:span], tag[:html], link_resolver, html_serializer)
+                if stack.empty?
+                  # The tag was top-level
+                  html += inner_html
+                else
+                  # Add the content to the parent tag
+                  stack[-1][:html] += inner_html
+                end
+              end
+              start_spans[pos].each do |tag|
+                # Open a tag
+                stack.push({
+                    :span => tag,
+                    :html => ''
+                })
+              end
+              if pos < text.length
+                if stack.empty?
+                  # Top level text
+                  html += CGI::escapeHTML(text[pos])
+                else
+                  # Inner text of a span
+                  stack[-1][:html] += CGI::escapeHTML(text[pos])
+                end
+              end
             end
-
-            # Inserting what's left of the string, if there is something
-            output << text[cursor..-1]
-
-            # Making the array into a string
-            output.join
-
+            html
           end
 
           # Building two span Hashes:
@@ -192,7 +211,8 @@ module Prismic
                 start_spans[span.start] << span
                 end_spans[span.end] << span
               }
-              @start_spans = start_spans
+              # Make sure the spans are sorted bigger first to respect the hierarchy
+              @start_spans = start_spans.each { |_, spans| spans.sort! { |a, b| b.end - b.start <=> a.end - a.start } }
               @end_spans = end_spans
             end
             [@start_spans, @end_spans]
@@ -204,30 +224,56 @@ module Prismic
           def as_text
             @text
           end
+
+          def serialize(elt, text, link_resolver, html_serializer)
+            custom_html = html_serializer && html_serializer.serialize(elt, text)
+            if custom_html.nil?
+              elt.serialize(text, link_resolver)
+            else
+              custom_html
+            end
+          end
+
+          private :class_code
         end
 
         class Heading < Text
           attr_accessor :level
 
-          def initialize(text, spans, level)
+          def initialize(text, spans, level, label = nil)
             super(text, spans)
             @level = level
           end
 
-          def as_html(link_resolver=nil)
-            %(<h#{level}>#{super}</h#{level}>)
+          def as_html(link_resolver=nil, html_serializer=nil)
+            custom_html = html_serializer && html_serializer.serialize(self, super)
+            if custom_html.nil?
+              %(<h#{level}#{class_code}>#{super}</h#{level}>)
+            else
+              custom_html
+            end
           end
         end
 
         class Paragraph < Text
-          def as_html(link_resolver=nil)
-            %(<p>#{super}</p>)
+          def as_html(link_resolver=nil, html_serializer=nil)
+            custom_html = html_serializer && html_serializer.serialize(self, super)
+            if custom_html.nil?
+              %(<p#{class_code}>#{super}</p>)
+            else
+              custom_html
+            end
           end
         end
 
         class Preformatted < Text
-          def as_html(link_resolver=nil)
-            %(<pre>#{super}</pre>)
+          def as_html(link_resolver=nil, html_serializer=nil)
+            custom_html = html_serializer && html_serializer.serialize(self, super)
+            if custom_html.nil?
+              %(<pre#{class_code}>#{super}</pre>)
+            else
+              custom_html
+            end
           end
         end
 
@@ -235,21 +281,27 @@ module Prismic
           attr_accessor :ordered
           alias :ordered? :ordered
 
-          def initialize(text, spans, ordered)
+          def initialize(text, spans, ordered, label = nil)
             super(text, spans)
             @ordered = ordered
           end
 
-          def as_html(link_resolver)
-            %(<li>#{super}</li>)
+          def as_html(link_resolver, html_serializer=nil)
+            custom_html = html_serializer && html_serializer.serialize(self, super)
+            if custom_html.nil?
+              %(<li#{class_code}>#{super}</li>)
+            else
+              custom_html
+            end
           end
         end
 
         class Image < Block
-          attr_accessor :view
+          attr_accessor :view, :label
 
-          def initialize(view)
+          def initialize(view, label = nil)
             @view = view
+            @label = label
           end
 
           def url
@@ -276,19 +328,41 @@ module Prismic
             @view.link_to
           end
 
-          def as_html(link_resolver)
-            view.as_html(link_resolver)
+          def as_html(link_resolver, html_serializer = nil)
+            custom = nil
+            unless html_serializer.nil?
+              custom = html_serializer.serialize(self, '')
+            end
+            if custom.nil?
+              classes = ['block-img']
+              unless @label.nil?
+                classes.push(@label)
+              end
+              %(<p class="#{classes.join(' ')}">#{view.as_html(link_resolver)}</p>)
+            else
+              custom
+            end
           end
         end
 
         class Embed < Block
+          attr_accessor :label
 
-          def initialize(embed)
-            @embed
+          def initialize(embed, label)
+            @embed = embed
+            @label = label
           end
 
-          def as_html(link_resolver)
-            embed.as_html(link_resolver)
+          def as_html(link_resolver, html_serializer = nil)
+            custom = nil
+            unless html_serializer.nil?
+              custom = html_serializer.serialize(self, '')
+            end
+            if custom.nil?
+              embed.as_html(link_resolver)
+            else
+              custom
+            end
           end
 
         end

data/lib/prismic/json_parsers.rb

@@ -117,7 +117,8 @@ module Prismic
           when 'hyperlink'
             Prismic::Fragments::StructuredText::Span::Hyperlink.new(span['start'], span['end'], link_parser(span['data']))
           else
-            puts "Unknown span_parser type: #{span['type']}"
+            label = span['data'] && span['data']['label']
+            Prismic::Fragments::StructuredText::Span::Label.new(span['start'], span['end'], label)
           end
         end
 
@@ -125,31 +126,34 @@ module Prismic
           case block['type']
           when 'paragraph'
             spans = block['spans'].map {|span| span_parser(span) }
-            Prismic::Fragments::StructuredText::Block::Paragraph.new(block['text'], spans)
+            Prismic::Fragments::StructuredText::Block::Paragraph.new(block['text'], spans, block['label'])
           when 'preformatted'
             spans = block['spans'].map {|span| span_parser(span) }
-            Prismic::Fragments::StructuredText::Block::Preformatted.new(block['text'], spans)
+            Prismic::Fragments::StructuredText::Block::Preformatted.new(block['text'], spans, block['label'])
           when /^heading(\d+)$/
             heading = $1
             spans = block['spans'].map {|span| span_parser(span) }
             Prismic::Fragments::StructuredText::Block::Heading.new(
               block['text'],
               spans,
-              heading.to_i
+              heading.to_i,
+              block['label']
             )
           when 'o-list-item'
             spans = block['spans'].map {|span| span_parser(span) }
             Prismic::Fragments::StructuredText::Block::ListItem.new(
               block['text'],
               spans,
-              true  # ordered
+              true,  # ordered
+              block['label']
             )
           when 'list-item'
             spans = block['spans'].map {|span| span_parser(span) }
             Prismic::Fragments::StructuredText::Block::ListItem.new(
               block['text'],
               spans,
-              false  # unordered
+              false,  # unordered
+              block['label']
             )
           when 'image'
             view = Prismic::Fragments::Image::View.new(
@@ -160,7 +164,7 @@ module Prismic
               block['copyright'],
               block['linkTo'] ? link_parser(block['linkTo']) : nil
             )
-            Prismic::Fragments::StructuredText::Block::Image.new(view)
+            Prismic::Fragments::StructuredText::Block::Image.new(view, block['label'])
           when 'embed'
             boembed = block['oembed']
             Prismic::Fragments::Embed.new(

data/lib/prismic/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Prismic
 
-  VERSION = "1.0.0.rc10"
+  VERSION = '1.0.1'
 
 end

data/lib/prismic.rb

@@ -520,6 +520,16 @@ module Prismic
     end
   end
 
+  class HtmlSerializer
+    def initialize(&blk)
+      @blk = blk
+    end
+
+    def serialize(element, content)
+      @blk.call(element, content)
+    end
+  end
+
   # Default HTTP client implementation, using the standard Net::HTTP library.
   module DefaultHTTPClient
     class << self
@@ -586,6 +596,10 @@ module Prismic
     LinkResolver.new(ref, &blk)
   end
 
+  def self.html_serializer(&blk)
+    HtmlSerializer.new(&blk)
+  end
+
 end
 
 require 'prismic/api'

data/prismic.gemspec

@@ -6,7 +6,7 @@ require 'prismic/version'
 Gem::Specification.new do |spec|
   spec.name          = "prismic.io"
   spec.version       = Prismic::VERSION
-  spec.authors       = ["Étienne Vallette d'Osia", "Samy Dindane", "Rudy Rigot"]
+  spec.authors       = ["Étienne Vallette d'Osia", "Erwan Loisant", "Samy Dindane", "Rudy Rigot"]
   spec.email         = ["evo@zenexity.com"]
   spec.description   = %q{The standard Prismic.io's API library.}
   spec.summary       = %q{Prismic.io development kit}

data/spec/cache_spec.rb

@@ -95,17 +95,17 @@ describe "Basic Cache's" do
 
   it 'set with expiration value & get value' do
 	cache = Prismic::BasicCache.new
-	cache.set('key', 'value', 2)
-	sleep(3)
+	cache.set('key', 'value', 1)
+	sleep(2)
 	cache.get('key').should == nil
   end
 
   it 'set with expiration and a block' do
     cache = Prismic::BasicCache.new
-    cache.get_or_set('key', nil, 2){ 'value' }
-    cache.get_or_set('key', nil, 2){ 'othervalue' }.should == 'value'
-    sleep(3)
-    cache.get_or_set('key', nil, 2){ 'othervalue' }.should == 'othervalue'
+    cache.get_or_set('key', nil, 1){ 'value' }
+    cache.get_or_set('key', nil, 1){ 'othervalue' }.should == 'value'
+    sleep(2)
+    cache.get_or_set('key', nil, 1){ 'othervalue' }.should == 'othervalue'
   end
 
   it 'set & test value' do

data/spec/fragments_spec.rb

@@ -93,7 +93,7 @@ describe 'ImageLink' do
 
   describe 'url' do
     before do
-      @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+      @link_resolver = Prismic.link_resolver('master'){|doc_link| "http://localhost/#{doc_link.id}" }
     end
     it 'works in a unified way' do
       @image_link.url(@link_resolver).should == 'my_url'
@@ -109,7 +109,10 @@ describe 'FileLink' do
       @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
     end
     it 'serializes well into HTML' do
-      @structured_text.as_html(nil).should == "<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.report.pdf\">2012 Annual Report</a></p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.budget.pdf\">2012 Annual Budget</a></p>\n\n<p><a href=\"https://prismic-io.s3.amazonaws.com/vision.strategic.plan_.sm_.pdf\">2015 Vision &amp; Strategic Plan</a></p>"
+      @structured_text.as_html(nil).should ==
+          "<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.report.pdf\">2012 Annual Report</a></p>\n\n"\
+          "<p><a href=\"https://prismic-io.s3.amazonaws.com/annual.budget.pdf\">2012 Annual Budget</a></p>\n\n"\
+          "<p><a href=\"https://prismic-io.s3.amazonaws.com/vision.strategic.plan_.sm_.pdf\">2015 Vision &amp; Strategic Plan</a></p>"
     end
   end
 end
@@ -122,7 +125,10 @@ describe 'Span' do
       @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
     end
     it 'serializes well into HTML' do
-      @structured_text.as_html(nil).should == "<h3><strong>Powering Through 2013 </strong></h3>\n\n<h3><strong>Online Resources:</strong></h3>\n\n<ul><li>Hear more from our executive team as they reflect on 2013 and share their vision for 2014 on our blog <a href=\"http://prismic.io\">here</a></li></ul>"
+      @structured_text.as_html(nil).should ==
+          "<h3><strong>Powering Through 2013 </strong></h3>\n\n"\
+          "<h3><strong>Online Resources:</strong></h3>\n\n"\
+          "<ul><li>Hear more from our executive team as they reflect on 2013 and share their vision for 2014 on our blog <a href=\"http://prismic.io\">here</a></li></ul>"
     end
   end
   describe 'in structured texts when multiple spans' do
@@ -132,7 +138,9 @@ describe 'Span' do
       @structured_text = Prismic::JsonParser.structured_text_parser(@json_structured_text)
     end
     it 'serializes well into HTML' do
-      @structured_text.as_html(nil).should == "<p>Experience <a href=\"http://prismic.io\">the</a> ultimate vanilla experience. Our vanilla Macarons are made with our very own (in-house) <em>pure extract of Madagascar vanilla</em>, and subtly dusted with <strong>our own vanilla sugar</strong> (which we make from real vanilla beans).</p>"
+      @structured_text.as_html(nil).should ==
+          '<p class="vanilla">Experience <a href="http://prismic.io">the</a> ultimate vanilla experience. '\
+          'Our vanilla Macarons are made with our very own (in-house) <em>pure extract of Madagascar vanilla</em>, and subtly dusted with <strong>our own vanilla sugar</strong> (which we make from real vanilla beans).</p>'
     end
   end
 end
@@ -507,17 +515,17 @@ end
 
 describe 'StructuredText::Heading' do
   before do
-    @text = "This is a simple test."
+    @text = 'This is a simple test.'
     @spans = [em(5, 7), strong(8, 9)]
   end
   let :block do Prismic::Fragments::StructuredText::Block::Heading.new(@text, @spans, @heading) end
   it 'generates valid h1 html' do
     @heading = 1
-    block.as_html(nil).should == "<h1>This <em>is</em> <strong>a</strong> simple test.</h1>"
+    block.as_html(nil).should == '<h1>This <em>is</em> <strong>a</strong> simple test.</h1>'
   end
   it 'generates valid h2 html' do
     @heading = 2
-    block.as_html(nil).should == "<h2>This <em>is</em> <strong>a</strong> simple test.</h2>"
+    block.as_html(nil).should == '<h2>This <em>is</em> <strong>a</strong> simple test.</h2>'
   end
 end
 
@@ -546,7 +554,7 @@ describe 'StructuredText::Paragraph' do
   it "espaces HTML content (2 spans on the same text)" do
     @text  = 'abcdefghijklmnopqrstuvwxyz'
     @spans = [em(2, 4), strong(2, 4)]
-    block.as_html(nil).should =~ %r{^<[^>]+>ab<strong><em>cd</em></strong>efghijklmnopqrstuvwxyz<[^>]+>$}
+    block.as_html(nil).should =~ %r{^<[^>]+>ab<em><strong>cd</strong></em>efghijklmnopqrstuvwxyz<[^>]+>$}
   end
   it "espaces HTML content (2 spans on the same text - one bigger 1)" do
     @text  = 'abcdefghijklmnopqrstuvwxyz'
@@ -626,14 +634,14 @@ describe 'StructuredText::Hyperlink' do
 
   describe 'as_html' do
     it "can generate valid link" do
-      @hyperlink.start_html(@link_resolver).should == '<a href="http://localhost/UdUjvt_mqVNObPeO">'
+      @hyperlink.serialize('', @link_resolver).should == '<a href="http://localhost/UdUjvt_mqVNObPeO"></a>'
     end
     it "raises an error when no link_resolver provided" do
-      expect { @hyperlink.start_html(nil) }.to raise_error
+      expect { @hyperlink.serialize('', nil) }.to raise_error
     end
     it "can generate valid html for broken link" do
       @link.broken = true
-      @hyperlink.start_html(@link_resolver).should == "<span>"
+      @hyperlink.serialize('', @link_resolver).should == '<span></span>'
     end
   end
 end

data/spec/json_parsers_spec.rb

@@ -221,13 +221,13 @@ describe 'image_parser in StructuredText' do
 
 <p>The following image is linked.</p>
 
-<a href="http://google.com/"><img src="http://fpoimg.com/129x260" alt="" width="260" height="129" /></a>
+<p class="block-img"><a href="http://google.com/"><img src="http://fpoimg.com/129x260" alt="" width="260" height="129" /></a></p>
 
 <p><strong>More important stuff</strong></p>
 
 <p>One more image, this one is not linked:</p>
 
-<img src="http://fpoimg.com/199x300" alt="" width="300" height="199" />
+<p class="block-img"><img src="http://fpoimg.com/199x300" alt="" width="300" height="199" /></p>
 expected
     expected.chomp!
     link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
@@ -442,8 +442,39 @@ describe 'unknown_parser' do
     @json = JSON.load(@raw_json)
   end
 
-  it "raises the proper error" do
+  it 'raises the proper error' do
     Prismic::JsonParser.should_receive(:warn).with("Type blabla is unknown, fragment was skipped; perhaps you should update your prismic.io gem?")
     Prismic::JsonParser.document_parser(@json).fragments.size.should == 2
   end
 end
+
+describe 'structured_text_label_parser' do
+  before do
+    raw_json = File.read("#{File.dirname(__FILE__)}/responses_mocks/structured_text_with_labels.json")
+    json = JSON.load(raw_json)
+    @structured_text = Prismic::JsonParser.structured_text_parser(json)
+  end
+
+  it 'outputs correctly as HTML' do
+    link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+    @structured_text.as_html(link_resolver).should ==
+        "<h1>Tips to dress a pastry</h1>\n\n" +
+            "<p class=\"block-img\"><img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses-vcerzcwaaohojzo/381f3a78dfe952b229fb49ceaa9926f7009ae20a.jpg\" alt=\"\" width=\"640\" height=\"666\" /></p>\n\n" +
+            "<p>Our Pastry Dressers (yes, it is <a href=\"http://localhost/UlfoxUnM0wkXYXbh\">a full-time job</a> in <em>Les Bonnes Choses</em>!) have it somewhat different from our other pastry artists: while the others keep their main focus on the taste, smell, and potentially touch of your pastries, the Pastry Dressers are mainly focused on their looks.</p>\n\n" +
+            "<p>It sometimes makes them feem like they&#39;re doing a job that is reasonably different from plain old pastry, and to make the most of your pastry dressings, perhaps so should you!</p>\n\n" +
+            "<h2>Step by step</h2>\n\n" +
+            "<p>From bottom to top, the steps towards a great dressing are pretty clear, and change rarely.</p>\n\n" +
+            "<h3>Pastry Dresser, or speleologist?</h3>\n\n" +
+            "<p>One of the first handy phases of dressing your pastry will be about carving to get to a desired shape and size to build upon. This is very precise work, as you will need to <span class=\"author\">clean</span> the object without breaking it, to remove pieces of it while keeping intact the meaningful bits. Now you&#39;re ready to iterate upon it!</p>\n\n" +
+            "<h3>Pastry Dresser, or clay sculptor?</h3>\n\n<p>" +
+            "Then, you will need to shape your piece of art <span class=\"author\"><strong>into</strong></span> the design you have in mind, by adding the right materials to just the right places. Ganache is your friend in such moments, such as any shape-free material. You&#39;ll have to master them, so they obey to the shapes you have in mind.</p>\n\n" +
+            "<h3>Pastry Dresser, or hairdresser?</h3>\n\n" +
+            "<p>The top of the pastry is a priority zone for finalization. This is where your &quot;last touch&quot; goes, and it&#39;s tremendously important, as it gives the pastry most of its character. You will have to play with the details, to keep the top of your piece on the... top of your priorities!</p>\n\n<h2>Before starting</h2>\n\n<p>" +
+            "Finishing by the beginning: what did we have to consider, before running towards the aforementioned steps?</p>\n\n" +
+            "<p class=\"block-img\"><img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses-vcerzcwaaohojzo/502ebb427b5eb45693800816fc778316c04935f5.jpg\" alt=\"\" width=\"640\" height=\"427\" /></p>\n\n" +
+            "<h3>Pastry Dresser, or illustrator?</h3>\n\n" +
+            "<p>We didn&#39;t mention color, but it&#39;s a very important component of the piece. Just like an illustrator will pick colors that add to the shape in a matching way to keep a perfect meaning, the colors must be perfect to be consistent with the taste of the piece (do not use green-colored sugar for a strawberry-flavored pastry, if you don&#39;t want to gross people out!)</p>\n\n" +
+            "<h3>Pastry Dresser, or designer?</h3>\n\n<p>And even before the illustration and colors, you really need to take the time to think about your destination, to make sure it&#39;s nothing short of perfect. This may imply taking the time to sit down for a few minutes with a paper and a pen. The first skill of an imaginative Pastry Dresser is a drawing skill, just like a fashion stylist.</p>"
+  end
+
+end

data/spec/lesbonneschoses_spec.rb

@@ -121,17 +121,68 @@ describe 'LesBonnesChoses' do
   describe 'Fragments' do
     before do
       @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
+      @html_serializer = Prismic.html_serializer do |element, html|
+        if element.is_a?(Prismic::Fragments::StructuredText::Block::Image)
+          %(<img src="#{element.url}" alt="#{element.alt}" width="#{element.width}" height="#{element.height}" />)
+        else
+          nil
+        end
+      end
     end
     describe 'API::Fragments::StructuredText' do
       it "returns a correct as_html on a StructuredText with list, span, embed and image" do
         @api.form("everything")
           .query(%([[:d = at(document.id, "UlfoxUnM0wkXYXbX")]]))
-          .submit(@master_ref)[0]['blog-post.body'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h1>Get the right approach to ganache</h1>\n\n<p>A lot of people touch base with us to know about one of our key ingredients, and the essential role it plays in our creations: ganache.</p>\n\n<p>Indeed, ganache is the macaron's softener, or else, macarons would be but tough biscuits; it is the cupcake's wrapper, or else, cupcakes would be but plain old cake. We even sometimes use ganache within our cupcakes, to soften the cake itself, or as a support to our pies' content.</p>\n\n<h2>How to approach ganache</h2>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/ee7b984b98db4516aba2eabd54ab498293913c6c.jpg\" alt=\"\" width=\"640\" height=\"425\" />\n\n<p>Apart from the taste balance, which is always a challenge when it comes to pastry, the tough part about ganache is about thickness. It is even harder to predict through all the phases the ganache gets to meet (how long will it get melted? how long will it remain in the fridge?). Things get a hell of a lot easier to get once you consider that there are two main ways to get the perfect ganache:</p>\n\n<ul><li><strong>working from the top down</strong>: start with a thick, almost hard material, and soften it by manipulating it, or by mixing it with a more liquid ingredient (like milk)</li><li><strong>working from the bottom up</strong>: start from a liquid-ish state, and harden it by miwing it with thicker ingredients, or by leaving it in the fridge longer.</li></ul>\n\n<p>We do hope this advice will empower you in your ganache-making skills. Let us know how you did with it!</p>\n\n<h2>Ganache at <em>Les Bonnes Choses</em></h2>\n\n<p>We have a saying at Les Bonnes Choses: \"Once you can make ganache, you can make anything.\"</p>\n\n<p>As you may know, we like to give our workshop artists the ability to master their art to the top; that is why our Preparation Experts always start off as being Ganache Specialists for Les Bonnes Choses. That way, they're given an opportunity to focus on one exercise before moving on. Once they master their ganache, and are able to provide the most optimal delight to our customers, we consider they'll thrive as they work on other kinds of preparations.</p>\n\n<h2>About the chocolate in our ganache</h2>\n\n<p>Now, we've also had a lot of questions about how our chocolate gets made. It's true, as you might know, that we make it ourselves, from Columbian cocoa and French cow milk, with a process that much resembles the one in the following Discovery Channel documentary.</p>\n\n        <div data-oembed=\"http://www.youtube.com/\"\n            data-oembed-type=\"video\"\n            data-oembed-provider=\"youtube\"><iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/Ye78F3-CuXY?feature=oembed\" frameborder=\"0\" allowfullscreen></iframe></div>\n"
+          .submit(@master_ref)[0]['blog-post.body'].as_html(@link_resolver).gsub("&#39;", "'").should ==
+            "<h1>Get the right approach to ganache</h1>\n\n"\
+            "<p>A lot of people touch base with us to know about one of our key ingredients, and the essential role it plays in our creations: ganache.</p>\n\n"\
+            "<p>Indeed, ganache is the macaron's softener, or else, macarons would be but tough biscuits; it is the cupcake's wrapper, or else, cupcakes would be but plain old cake. We even sometimes use ganache within our cupcakes, to soften the cake itself, or as a support to our pies' content.</p>\n\n"\
+            "<h2>How to approach ganache</h2>\n\n"\
+            "<p class=\"block-img\"><img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/ee7b984b98db4516aba2eabd54ab498293913c6c.jpg\" alt=\"\" width=\"640\" height=\"425\" /></p>\n\n"\
+            "<p>Apart from the taste balance, which is always a challenge when it comes to pastry, the tough part about ganache is about thickness. It is even harder to predict through all the phases the ganache gets to meet (how long will it get melted? how long will it remain in the fridge?). "\
+            "Things get a hell of a lot easier to get once you consider that there are two main ways to get the perfect ganache:</p>\n\n"\
+            "<ul><li><strong>working from the top down</strong>: start with a thick, almost hard material, and soften it by manipulating it, or by mixing it with a more liquid ingredient (like milk)</li>"\
+            "<li><strong>working from the bottom up</strong>: start from a liquid-ish state, and harden it by miwing it with thicker ingredients, or by leaving it in the fridge longer.</li></ul>\n\n"\
+            "<p>We do hope this advice will empower you in your ganache-making skills. Let us know how you did with it!</p>\n\n"\
+            "<h2>Ganache at <em>Les Bonnes Choses</em></h2>\n\n"\
+            "<p>We have a saying at Les Bonnes Choses: &quot;Once you can make ganache, you can make anything.&quot;</p>\n\n"\
+            "<p>As you may know, we like to give our workshop artists the ability to master their art to the top; that is why our Preparation Experts always start off as being Ganache Specialists for Les Bonnes Choses. That way, they're given an opportunity to focus on one exercise before moving on. "\
+            "Once they master their ganache, and are able to provide the most optimal delight to our customers, we consider they'll thrive as they work on other kinds of preparations.</p>\n\n"\
+            "<h2>About the chocolate in our ganache</h2>\n\n"\
+            "<p>Now, we've also had a lot of questions about how our chocolate gets made. It's true, as you might know, that we make it ourselves, from Columbian cocoa and French cow milk, with a process that much resembles the one in the following Discovery Channel documentary.</p>\n\n        "\
+            "<div data-oembed=\"http://www.youtube.com/\"\n            data-oembed-type=\"video\"\n            data-oembed-provider=\"youtube\"><iframe width=\"459\" height=\"344\" src=\"http://www.youtube.com/embed/Ye78F3-CuXY?feature=oembed\" frameborder=\"0\" allowfullscreen></iframe></div>\n"
+      end
+      it "returns a correct as_html on a StructuredText with custom HTML serializer" do
+        @api.form("everything")
+          .query(%([[:d = at(document.id, "#{@api.bookmark('about')}")]]))
+          .submit(@master_ref)[0]['article.content'].as_html(@link_resolver, @html_serializer).gsub("&#39;", "'").should ==
+              "<h2>A tale of pastry and passion</h2>\n\n"\
+              "<p>As a child, Jean-Michel Pastranova learned the art of fine cuisine from his grand-father, Jacques Pastranova, who was the creator of the &quot;taste-design&quot; art current, and still today an unmissable reference of forward-thinking in cuisine. At first an assistant in his grand-father's kitchen, Jean-Michel soon found himself fascinated by sweet flavors and the tougher art of pastry, drawing his own path in the ever-changing cuisine world.</p>\n\n"\
+              "<p>In 1992, the first Les Bonnes Choses store opened on rue Saint-Lazare, in Paris (<a href=\"http://localhost/UlfoxUnM0wkXYXbb\">we're still there!</a>), much to everyone's surprise; indeed, back then, it was very surprising for a highly promising young man with a preordained career as a restaurant chef, to open a pastry shop instead. But soon enough, contemporary chefs understood that Jean-Michel had the drive to redefine a new nobility to pastry, the same way many other kinds of cuisine were being qualified as &quot;fine&quot;.</p>\n\n"\
+              "<p>In 1996, meeting an overwhelming demand, Jean-Michel Pastranova opened <a href=\"http://localhost/UlfoxUnM0wkXYXbP\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UlfoxUnM0wkXYXbr\">a third one in London</a>, the same week! Eventually, Les Bonnes Choses gained an international reputation as &quot;a perfection so familiar and new at the same time, that it will feel like a taste travel&quot; (New York Gazette), &quot;the finest balance between surprise and comfort, enveloped in sweetness&quot; (The Tokyo Tribune), &quot;a renewal of the pastry genre (...), the kind that changed the way pastry is approached globally&quot; (The San Francisco Gourmet News). Therefore, it was only a matter of time before Les Bonnes Choses opened shops in <a href=\"http://localhost/UlfoxUnM0wkXYXbc\">New York</a> (2000) and <a href=\"http://localhost/UlfoxUnM0wkXYXbU\">Tokyo</a> (2004).</p>\n\n"\
+              "<p>In 2013, Jean-Michel Pastranova stepped down as the CEO and Director of Workshops, remaining a senior advisor to the board and to the workshop artists; he passed the light on to Selena, his daugther, who initially learned the art of pastry from him. Passion for great food runs in the Pastranova family...</p>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" />\n\n"\
+              "<h2>Our main value: our customers' delight</h2>\n\n"\
+              "<p>Our every action is driven by the firm belief that there is art in pastry, and that this art is one of the dearest pleasures one can experience.</p>\n\n"\
+              "<p>At Les Bonnes Choses, people preparing your macarons are not simply &quot;pastry chefs&quot;: they are &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXba\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbQ\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbn\">oven instrumentalists</a>&quot;. They are the best people out there to perform the tasks they perform to create your pastry, giving it the greatest value. And they just love to make their specialized pastry skill better and better until perfection.</p>\n\n"\
+              "<p>Of course, there is a workshop in each <em>Les Bonnes Choses</em> store, and every pastry you buy was made today, by the best pastry specialists in your country.</p>\n\n"\
+              "<p>However, the very difficult art of creating new concepts, juggling with tastes and creating brand new, powerful experiences, is performed every few months, during our &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbl\">Pastry Art Brainstorms</a>&quot;. During the event, the best pastry artists in the world (some working for <em>Les Bonnes Choses</em>, some not) gather in Paris, and showcase the experiments they've been working on; then, the other present artists comment on the piece, and iterate on it together, in order to make it the best possible masterchief!</p>\n\n"\
+              "<p>The session is presided by Jean-Michel Pastranova, who then selects the most delightful experiences, to add it to <em>Les Bonnes Choses</em>'s catalogue.</p>"
       end
       it "returns a correct as_html on a StructuredText with links" do
         @api.form("everything")
           .query(%([[:d = at(document.id, "#{@api.bookmark('about')}")]]))
-          .submit(@master_ref)[0]['article.content'].as_html(@link_resolver).gsub("&#39;", "'").should == "<h2>A tale of pastry and passion</h2>\n\n<p>As a child, Jean-Michel Pastranova learned the art of fine cuisine from his grand-father, Jacques Pastranova, who was the creator of the \"taste-design\" art current, and still today an unmissable reference of forward-thinking in cuisine. At first an assistant in his grand-father's kitchen, Jean-Michel soon found himself fascinated by sweet flavors and the tougher art of pastry, drawing his own path in the ever-changing cuisine world.</p>\n\n<p>In 1992, the first Les Bonnes Choses store opened on rue Saint-Lazare, in Paris (<a href=\"http://localhost/UlfoxUnM0wkXYXbb\">we're still there!</a>), much to everyone's surprise; indeed, back then, it was very surprising for a highly promising young man with a preordained career as a restaurant chef, to open a pastry shop instead. But soon enough, contemporary chefs understood that Jean-Michel had the drive to redefine a new nobility to pastry, the same way many other kinds of cuisine were being qualified as \"fine\".</p>\n\n<p>In 1996, meeting an overwhelming demand, Jean-Michel Pastranova opened <a href=\"http://localhost/UlfoxUnM0wkXYXbP\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UlfoxUnM0wkXYXbr\">a third one in London</a>, the same week! Eventually, Les Bonnes Choses gained an international reputation as &quot;a perfection so familiar and new at the same time, that it will feel like a taste travel&quot; (New York Gazette), &quot;the finest balance between surprise and comfort, enveloped in sweetness&quot; (The Tokyo Tribune), &quot;a renewal of the pastry genre (...), the kind that changed the way pastry is approached globally&quot; (The San Francisco Gourmet News). Therefore, it was only a matter of time before Les Bonnes Choses opened shops in <a href=\"http://localhost/UlfoxUnM0wkXYXbc\">New York</a> (2000) and <a href=\"http://localhost/UlfoxUnM0wkXYXbU\">Tokyo</a> (2004).</p>\n\n<p>In 2013, Jean-Michel Pastranova stepped down as the CEO and Director of Workshops, remaining a senior advisor to the board and to the workshop artists; he passed the light on to Selena, his daugther, who initially learned the art of pastry from him. Passion for great food runs in the Pastranova family...</p>\n\n<img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" />\n\n<h2>Our main value: our customers' delight</h2>\n\n<p>Our every action is driven by the firm belief that there is art in pastry, and that this art is one of the dearest pleasures one can experience.</p>\n\n<p>At Les Bonnes Choses, people preparing your macarons are not simply &quot;pastry chefs&quot;: they are &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXba\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbQ\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbn\">oven instrumentalists</a>\". They are the best people out there to perform the tasks they perform to create your pastry, giving it the greatest value. And they just love to make their specialized pastry skill better and better until perfection.</p>\n\n<p>Of course, there is a workshop in each <em>Les Bonnes Choses</em> store, and every pastry you buy was made today, by the best pastry specialists in your country.</p>\n\n<p>However, the very difficult art of creating new concepts, juggling with tastes and creating brand new, powerful experiences, is performed every few months, during our &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbl\">Pastry Art Brainstorms</a>&quot;. During the event, the best pastry artists in the world (some working for <em>Les Bonnes Choses</em>, some not) gather in Paris, and showcase the experiments they've been working on; then, the other present artists comment on the piece, and iterate on it together, in order to make it the best possible masterchief!</p>\n\n<p>The session is presided by Jean-Michel Pastranova, who then selects the most delightful experiences, to add it to <em>Les Bonnes Choses</em>'s catalogue.</p>"
+          .submit(@master_ref)[0]['article.content'].as_html(@link_resolver).gsub("&#39;", "'").should ==
+              "<h2>A tale of pastry and passion</h2>\n\n"\
+              "<p>As a child, Jean-Michel Pastranova learned the art of fine cuisine from his grand-father, Jacques Pastranova, who was the creator of the &quot;taste-design&quot; art current, and still today an unmissable reference of forward-thinking in cuisine. At first an assistant in his grand-father's kitchen, Jean-Michel soon found himself fascinated by sweet flavors and the tougher art of pastry, drawing his own path in the ever-changing cuisine world.</p>\n\n"\
+              "<p>In 1992, the first Les Bonnes Choses store opened on rue Saint-Lazare, in Paris (<a href=\"http://localhost/UlfoxUnM0wkXYXbb\">we're still there!</a>), much to everyone's surprise; indeed, back then, it was very surprising for a highly promising young man with a preordained career as a restaurant chef, to open a pastry shop instead. But soon enough, contemporary chefs understood that Jean-Michel had the drive to redefine a new nobility to pastry, the same way many other kinds of cuisine were being qualified as &quot;fine&quot;.</p>\n\n"\
+              "<p>In 1996, meeting an overwhelming demand, Jean-Michel Pastranova opened <a href=\"http://localhost/UlfoxUnM0wkXYXbP\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UlfoxUnM0wkXYXbr\">a third one in London</a>, the same week! Eventually, Les Bonnes Choses gained an international reputation as &quot;a perfection so familiar and new at the same time, that it will feel like a taste travel&quot; (New York Gazette), &quot;the finest balance between surprise and comfort, enveloped in sweetness&quot; (The Tokyo Tribune), &quot;a renewal of the pastry genre (...), the kind that changed the way pastry is approached globally&quot; (The San Francisco Gourmet News). Therefore, it was only a matter of time before Les Bonnes Choses opened shops in <a href=\"http://localhost/UlfoxUnM0wkXYXbc\">New York</a> (2000) and <a href=\"http://localhost/UlfoxUnM0wkXYXbU\">Tokyo</a> (2004).</p>\n\n"\
+              "<p>In 2013, Jean-Michel Pastranova stepped down as the CEO and Director of Workshops, remaining a senior advisor to the board and to the workshop artists; he passed the light on to Selena, his daugther, who initially learned the art of pastry from him. Passion for great food runs in the Pastranova family...</p>\n\n<p class=\"block-img\"><img src=\"https://prismic-io.s3.amazonaws.com/lesbonneschoses/df6c1d87258a5bfadf3479b163fd85c829a5c0b8.jpg\" alt=\"\" width=\"800\" height=\"533\" /></p>\n\n"\
+              "<h2>Our main value: our customers' delight</h2>\n\n"\
+              "<p>Our every action is driven by the firm belief that there is art in pastry, and that this art is one of the dearest pleasures one can experience.</p>\n\n"\
+              "<p>At Les Bonnes Choses, people preparing your macarons are not simply &quot;pastry chefs&quot;: they are &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXba\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbQ\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbn\">oven instrumentalists</a>&quot;. They are the best people out there to perform the tasks they perform to create your pastry, giving it the greatest value. And they just love to make their specialized pastry skill better and better until perfection.</p>\n\n"\
+              "<p>Of course, there is a workshop in each <em>Les Bonnes Choses</em> store, and every pastry you buy was made today, by the best pastry specialists in your country.</p>\n\n"\
+              "<p>However, the very difficult art of creating new concepts, juggling with tastes and creating brand new, powerful experiences, is performed every few months, during our &quot;<a href=\"http://localhost/UlfoxUnM0wkXYXbl\">Pastry Art Brainstorms</a>&quot;. During the event, the best pastry artists in the world (some working for <em>Les Bonnes Choses</em>, some not) gather in Paris, and showcase the experiments they've been working on; then, the other present artists comment on the piece, and iterate on it together, in order to make it the best possible masterchief!</p>\n\n"\
+              "<p>The session is presided by Jean-Michel Pastranova, who then selects the most delightful experiences, to add it to <em>Les Bonnes Choses</em>'s catalogue.</p>"
       end
       it "returns a correct as_text on a StructuredText" do
         @api.form("everything")

data/spec/prismic_spec.rb

@@ -521,7 +521,8 @@ describe 'SearchForm' do
           "license":"All Rights Reserved"
         }
       DATA
-      @api.form("everything").page_size('1').submit_raw(@master_ref).should == data
+      rx = Regexp.escape(data).sub(/"version":"[^"]+"/, '"version":"[^"]+"')
+      @api.form("everything").page_size('1').submit_raw(@master_ref).should =~ /#{rx}/
     end
   end
 end

data/spec/responses_mocks/structured_text_paragraph.json

@@ -1,30 +1,31 @@
 {
-  "type": "StructuredText",
-  "value": [{
-    "type": "paragraph",
-    "text": "Experience the ultimate vanilla experience. Our vanilla Macarons are made with our very own (in-house) pure extract of Madagascar vanilla, and subtly dusted with our own vanilla sugar (which we make from real vanilla beans).",
-    "spans": [
-      {
-      "start": 103,
-      "end": 137,
-      "type": "em"
-    },
-    {
-      "start": 11,
-      "end": 14,
-      "type": "hyperlink",
-      "data": {
-        "type": "Link.web",
-        "value": {
-          "url": "http://prismic.io"
-        }
-      }
-    },
-    {
-      "start": 162,
-      "end": 183,
-      "type": "strong"
-    }
-    ]}
-  ]
+    "type": "StructuredText",
+    "value": [{
+        "type": "paragraph",
+        "label": "vanilla",
+        "text": "Experience the ultimate vanilla experience. Our vanilla Macarons are made with our very own (in-house) pure extract of Madagascar vanilla, and subtly dusted with our own vanilla sugar (which we make from real vanilla beans).",
+        "spans": [
+            {
+                "start": 103,
+                "end": 137,
+                "type": "em"
+            },
+            {
+                "start": 11,
+                "end": 14,
+                "type": "hyperlink",
+                "data": {
+                    "type": "Link.web",
+                    "value": {
+                        "url": "http://prismic.io"
+                    }
+                }
+            },
+            {
+                "start": 162,
+                "end": 183,
+                "type": "strong"
+            }
+        ]
+    }]
 }

data/spec/responses_mocks/structured_text_with_labels.json

@@ -0,0 +1,156 @@
+{
+    "type":"StructuredText",
+    "value":[
+        {
+            "type":"heading1",
+            "text":"Tips to dress a pastry",
+            "spans":[]
+        },
+        {
+            "type":"image",
+            "url":"https://prismic-io.s3.amazonaws.com/lesbonneschoses-vcerzcwaaohojzo/381f3a78dfe952b229fb49ceaa9926f7009ae20a.jpg",
+            "alt":"",
+            "copyright":"",
+            "dimensions":{
+                "width":640,
+                "height":666
+            }
+        },
+        {
+            "type":"paragraph",
+            "text":"Our Pastry Dressers (yes, it is a full-time job in Les Bonnes Choses!) have it somewhat different from our other pastry artists: while the others keep their main focus on the taste, smell, and potentially touch of your pastries, the Pastry Dressers are mainly focused on their looks.",
+            "spans":[
+                {
+                    "start":32,
+                    "end":47,
+                    "type":"hyperlink",
+                    "data":{
+                        "type":"Link.document",
+                        "value":{
+                            "document":{
+                                "id":"UlfoxUnM0wkXYXbh",
+                                "type":"job-offer",
+                                "tags":[],
+                                "slug":"pastry-dresser"
+                            },
+                            "isBroken":false
+                        }
+                    }
+                },
+                {
+                    "start":51,
+                    "end":68,
+                    "type":"em"
+                }
+            ]
+        },
+        {
+            "type":"paragraph",
+            "text":"It sometimes makes them feem like they're doing a job that is reasonably different from plain old pastry, and to make the most of your pastry dressings, perhaps so should you!",
+            "spans":[]
+        },
+        {
+            "type":"heading2",
+            "text":"Step by step",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"From bottom to top, the steps towards a great dressing are pretty clear, and change rarely.",
+            "spans":[]
+        },
+        {
+            "type":"heading3",
+            "text":"Pastry Dresser, or speleologist?",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"One of the first handy phases of dressing your pastry will be about carving to get to a desired shape and size to build upon. This is very precise work, as you will need to clean the object without breaking it, to remove pieces of it while keeping intact the meaningful bits. Now you're ready to iterate upon it!",
+            "spans":[
+                {
+                    "start":173,
+                    "end":178,
+                    "type":"label",
+                    "data":{
+                        "label":"author"
+                    }
+                }
+            ]
+        },
+        {
+            "type":"heading3",
+            "text":"Pastry Dresser, or clay sculptor?",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"Then, you will need to shape your piece of art into the design you have in mind, by adding the right materials to just the right places. Ganache is your friend in such moments, such as any shape-free material. You'll have to master them, so they obey to the shapes you have in mind.",
+            "spans":[
+                {
+                    "start":47,
+                    "end":51,
+                    "type":"label",
+                    "data":{
+                        "label":"author"
+                    }
+                },
+                {
+                    "start":47,
+                    "end":51,
+                    "type":"strong"
+                }
+            ]
+        },
+        {
+            "type":"heading3",
+            "text":"Pastry Dresser, or hairdresser?",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"The top of the pastry is a priority zone for finalization. This is where your \"last touch\" goes, and it's tremendously important, as it gives the pastry most of its character. You will have to play with the details, to keep the top of your piece on the... top of your priorities!",
+            "spans":[]
+        },
+        {
+            "type":"heading2",
+            "text":"Before starting",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"Finishing by the beginning: what did we have to consider, before running towards the aforementioned steps?",
+            "spans":[]
+        },
+        {
+            "type":"image",
+            "url":"https://prismic-io.s3.amazonaws.com/lesbonneschoses-vcerzcwaaohojzo/502ebb427b5eb45693800816fc778316c04935f5.jpg",
+            "alt":"",
+            "copyright":"",
+            "dimensions":{
+                "width":640,
+                "height":427
+            }
+        },
+        {
+            "type":"heading3",
+            "text":"Pastry Dresser, or illustrator?",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"We didn't mention color, but it's a very important component of the piece. Just like an illustrator will pick colors that add to the shape in a matching way to keep a perfect meaning, the colors must be perfect to be consistent with the taste of the piece (do not use green-colored sugar for a strawberry-flavored pastry, if you don't want to gross people out!)",
+            "spans":[]
+        },
+        {
+            "type":"heading3",
+            "text":"Pastry Dresser, or designer?",
+            "spans":[]
+        },
+        {
+            "type":"paragraph",
+            "text":"And even before the illustration and colors, you really need to take the time to think about your destination, to make sure it's nothing short of perfect. This may imply taking the time to sit down for a few minutes with a paper and a pen. The first skill of an imaginative Pastry Dresser is a drawing skill, just like a fashion stylist.",
+            "spans":[]
+        }
+    ]
+}

data/spec/spec_helper.rb

@@ -8,6 +8,11 @@ rescue LoadError
 end
 require 'simplecov'
 
+RSpec.configure do |c|
+  # Stop after the first failure
+  c.fail_fast = true
+end
+
 SimpleCov.start
 
 $LOAD_PATH << File.join(File.dirname(__FILE__), '..', 'lib')

metadata

@@ -1,71 +1,72 @@
 --- !ruby/object:Gem::Specification
 name: prismic.io
 version: !ruby/object:Gem::Version
-  version: 1.0.0.rc10
+  version: 1.0.1
 platform: ruby
 authors:
-- "Étienne Vallette d'Osia"
+- Étienne Vallette d'Osia
+- Erwan Loisant
 - Samy Dindane
 - Rudy Rigot
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-10 00:00:00.000000000 Z
+date: 2014-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '2.14'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '2.14'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '0.7'
 description: The standard Prismic.io's API library.
@@ -75,9 +76,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
-- ".travis.yml"
-- ".yardopts"
+- .gitignore
+- .travis.yml
+- .yardopts
+- Changelog.md
 - Gemfile
 - Gemfile.lock
 - README.md
@@ -119,6 +121,7 @@ files:
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_linkfile.json
 - spec/responses_mocks/structured_text_paragraph.json
+- spec/responses_mocks/structured_text_with_labels.json
 - spec/responses_mocks/structured_text_with_tricky_spans.json
 - spec/spec_helper.rb
 homepage: http://prismic.io
@@ -131,14 +134,14 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
 rubygems_version: 2.2.2
@@ -160,5 +163,6 @@ test_files:
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_linkfile.json
 - spec/responses_mocks/structured_text_paragraph.json
+- spec/responses_mocks/structured_text_with_labels.json
 - spec/responses_mocks/structured_text_with_tricky_spans.json
 - spec/spec_helper.rb