prismic.io 1.0.0.preview.7 → 1.0.0.preview.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9978093a5e4f4f3529a05df62cbead5aa3bbb31c
-  data.tar.gz: 9f89d25cd5a8affedcc997e4fefe1d62908df492
+  metadata.gz: 22c9fa81f67d2c7120d3d0aeaa476257392d324b
+  data.tar.gz: ec3215425959d51198428fa75827b3b69ca14d5b
 SHA512:
-  metadata.gz: 078f0e8b7fa42fd89fbaa6e8af7a16639a5e707194d1815004f540b39efec152e9c7bba3507065f5991a2cfff1e9cf1127a11b56461a2304ae1eda4f54a73a5b
-  data.tar.gz: b34a4a54f34c285ee46ca0bd570dd4c7e8f66b6712372eda66b760a02cf484c3156bdf21724ba61873fc0ab8d6c1a5804199b336586edb3567a503e1b892f2c9
+  metadata.gz: 608f58c15fab9a73a487f01b69301679e8ffcc54e4dcbae98bdda8c57d6b69191216d48c63ed5b1e208e5a53b13a0ff498101136d0f3db5ce30011bde8f6573e
+  data.tar.gz: c41729c800aeac6d103569cbbee76d4679854e9bc55d0f8956645815f5e5f3e81a58b03da82a5406cc2fcaf0311d2aa17a9179f54397350a6e3090c02bd91419

data/Gemfile.lock

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

data/README.md

@@ -37,16 +37,15 @@ On our [prismic.io developer's portal](https://developers.prismic.io/), on top o
 
 #### Kit documentation
 
-To get a detailed documentation of the Ruby kit's variables and methods, please check out the [prismic.io Ruby kit's documentation](http://prismicio.github.io/ruby-kit/) (click on the "Class list" tab at the top-right)
+To get a detailed documentation of the Ruby kit's variables and methods, please check out the [prismic.io Ruby kit's documentation](http://rubydoc.info/github/prismicio/ruby-kit/master/frames)
 
 Need to see what changed, or to upgrade your kit? Check out [this kit's changelog](changelog.md).
 
 ##### Ruby kit's specificities
 
 This Ruby kit contains some mild differences and syntastic sugar over [the "Kits and helpers" section of our API documentation](https://developers.prismic.io/documentation/UjBe8bGIJ3EKtgBZ/api-documentation#kits-and-helpers) (which you should read first). They are listed here:
- * From the api object, getting a form is done through the `create_search_form` method; a basic querying therefore looks like this: `api.create_search_form("everything").ref(@ref).submit()`.
- * When calling the API, a faster way to pass the `ref`: directly as a parameter of the `submit` method (no need to use the `ref` method then): `api.create_search_form("everything").submit(@ref)`.
- * Accessing type-dependent fields from a `document` is done through the `[]` operator (rather than a `get()` method). Printing the HTML version of a field therefore looks like `document["title_user_friendly"].as_html(link_resolver(@ref)).html_safe`.
+ * When calling the API, a faster way to pass the `ref`: directly as a parameter of the `submit` method (no need to use the `ref` method then): `api.form("everything").submit(@ref)`.
+ * Accessing type-dependent fields from a `document` is done through the `[]` operator (rather than a `get()` method). Printing the HTML version of a field therefore looks like `document["title_user_friendly"].as_html(link_resolver(@ref))`.
  * Two of the fields in the `DocumentLink` object (the one used to write your `link_resolver` method, for instance) were renamed to fit Ruby's best practice: `doc.type` is in fact `doc.link_type`, and `doc.isBroken` is in fact `doc.broken?`.
 
 #### Use it

data/changelog.md

@@ -1,19 +1,27 @@
 ## Changelog for prismic.io Ruby development kit
 
+### prismic.io.1.0.0.preview.8
+
+#### New features
+ * Support for group fragments.
+ * Support for unknown fragments (instead of crashing, ignores the fragment with a warning advising to update the kit).
+
+#### Syntactic sugar
+ * `Prismic::API#create_search_form` is now `Prismic::API#form` (the former issues a deprecation warning, and will be removed in a later release); the online cross-tech doc was adapted to reflect that possibility.
 
 ### prismic.io.1.0.0.preview.7
 
 #### Potentially breaking changes
- * Boldness in `Prismic::Fragments::StructuredText#as_html` was represented as `<b>` tags, now as `<strong>` tags (262b5da9219cb990773a5b307f270f899b067ee5)
+ * Boldness in `Prismic::Fragments::StructuredText#as_html` was represented as `<b>` tags, now as `<strong>` tags.
 
 #### New features
- * You had to call `Prismic::Link_resolver#link_to` on a `Prismic::Fragments::DocumentLink` object, but sometimes, you actually have the full `Prismic::Document`; you can now call it on both types of objects (b1a53141e1a962762e00bd904a68d6fcd5c3a6bc).
- * You had to call `api.master_ref` to get the master ref; now you can call it `api.master`, just like in the other dev kits; both methods do the same thing (a9e11bbb735601734512a8cefca72ed29a6bdc81).
- * New method: `Prismic::Fragments::StructuredText#as_text`, renders zero formatting, and ignores images and embeds (d4c8c751a28afef4ef2c2e0d943cf8066ef3c039).
- * `Prismic::SearchForm` only had the `query` method to set the `q` parameter of the API call. Now those methods are dynamically created from the RESTful form found in the `/api` document, so it's now possible to use those methods too: `orderings`, `page`, `pageSize`, as well as all the future non-yet-existing ones (fcb4e3a92dbda1b6901a1065dcf0ef4144871fdd)
+ * You had to call `Prismic::Link_resolver#link_to` on a `Prismic::Fragments::DocumentLink` object, but sometimes, you actually have the full `Prismic::Document`; you can now call it on both types of objects.
+ * You had to call `api.master_ref` to get the master ref; now you can call it `api.master`, just like in the other dev kits; both methods do the same thing.
+ * New method: `Prismic::Fragments::StructuredText#as_text`, renders zero formatting, and ignores images and embeds.
+ * `Prismic::SearchForm` only had the `query` method to set the `q` parameter of the API call. Now those methods are dynamically created from the RESTful form found in the `/api` document, so it's now possible to use those methods too: `orderings`, `page`, `pageSize`, as well as all the future non-yet-existing ones.
 
 
 ### prismic.io.1.0.0.preview.6
 
 #### Potentially breaking changes
- * From an image, you had to call the view with its index, like this `image_object[0]`; now they're stored in a Hash, you have to call them with their proper name: `image_object['large']` (e6312b8d4486c8eacb1de7214563d45c61b5653c).
+ * From an image, you had to call the view with its index, like this `image_object[0]`; now they're stored in a Hash, you have to call them with their proper name: `image_object['large']`.

data/lib/prismic/api.rb

@@ -1,6 +1,7 @@
 # encoding: utf-8
 module Prismic
   class API
+    @@warned_create_search_form = false
     attr_reader :json, :access_token, :http_client
     attr_accessor :refs, :bookmarks, :forms, :tags, :types, :oauth
 
@@ -38,10 +39,6 @@ module Prismic
       refs[name.downcase]
     end
 
-    def form(name)
-      forms[name]
-    end
-
     # Returns a {Prismic::SearchForm search form} by its name
     # @api
     # @param  name [String] The name of the form
@@ -49,11 +46,20 @@ module Prismic
     # @param  ref [type] Default {Ref reference}
     #
     # @return [SearchForm] The search form
-    def create_search_form(name, data={}, ref={})
-      form = self.form(name)
+    def form(name, data={}, ref={})
+      form = self.forms[name]
       form and form.create_search_form(data, ref)
     end
 
+    # @deprecated Use {#form} instead.
+    def create_search_form(name, data={}, ref={})
+      if !@@warned_create_search_form
+        warn "[DEPRECATION] `create_search_form` is deprecated.  Please use `form` instead."
+        @@warned_create_search_form = true
+      end
+      form(name, data, ref)
+    end
+
     def as_json
       @json
     end

data/lib/prismic/fragments/group.rb

@@ -0,0 +1,57 @@
+module Prismic
+	module Fragments
+
+		# A fragment of type Group, which contains an array of FragmentList (which itself is a Hash of fragments).
+		#
+		# For instance, imagining this group is defined with two possible fragments :
+		# an image fragment "image", and a text fragment "caption";
+		# then accessing the first image will look like this: group[0]['image'].
+		class Group < Fragment
+			
+			# The array of the fragment lists
+			attr_accessor :fragment_list_array
+
+			def initialize(fragment_list_array)
+				@fragment_list_array = fragment_list_array
+			end
+
+			# Accessing the i-th item (fragment list) of the group: group[i]
+			def [](i)
+				@fragment_list_array[i]
+			end
+
+			def as_html(link_resolver = nil)
+				@fragment_list_array.map { |fl| fl.as_html(link_resolver) }.join("\n")
+			end
+
+			def as_text
+				@fragment_list_array.map { |fl| fl.as_text }.join("\n")
+			end
+
+			class FragmentMapping
+
+				# a hash containing all the fragments in the fragment list
+				attr_accessor :fragments
+
+				def initialize(fragments)
+					@fragments = fragments
+				end
+
+				# Accessing the right fragment of the fragment list: fl['caption']
+				def [](name)
+					@fragments[name]
+				end
+
+				def as_html(link_resolver = nil)
+					@fragments.map { |name, fragment|
+						%(<section data-field="#{name}">#{fragment.as_html(link_resolver)}</section>)
+					}.join("\n")
+				end
+
+				def as_text
+					@fragments.values.map { |fragment| fragment.as_text }.join("\n")
+				end
+			end
+		end
+	end
+end

data/lib/prismic/fragments/link.rb

@@ -2,8 +2,17 @@
 module Prismic
   module Fragments
     class Link < Fragment
+
+      def start_html(link_resolver = nil)
+        %(<a href="#@url">)
+      end
+
+      def end_html(link_resolver = nil)
+        %(</a>)
+      end
+
       def as_html(link_resolver=nil)
-        %(<a href="#@url">#@url</a>)
+        %(#{start_html(link_resolver)}#@url#{end_html(link_resolver)})
       end
     end
 
@@ -34,12 +43,17 @@ module Prismic
         @broken = broken
       end
 
-      def as_html(link_resolver)
-        if broken?
-          %(<span>#{slug}</span>)
-        else
-          %(<a href="#{link_resolver.link_to(self)}">#{slug}</a>)
-        end
+      def start_html(link_resolver)
+        raise "A link_resolver method is needed to serialize document links into a correct URL on your website. If you're using a starter kit, a trivial one is provided out-of-the-box, that you can update later." if link_resolver == nil
+        broken? ? %(<span>) : %(<a href="#{link_resolver.link_to(self)}">)
+      end
+
+      def end_html(link_resolver = nil)
+        broken? ? %(</span>) : %(</a>)
+      end
+
+      def as_html(link_resolver=nil)
+        %(#{start_html(link_resolver)}#{slug}#{end_html(link_resolver)})
       end
 
       alias :broken? :broken

data/lib/prismic/fragments/structured_text.rb

@@ -2,7 +2,12 @@
 module Prismic
   module Fragments
     class StructuredText < Fragment
-      class Group
+
+      # Used during the call of {StructuredText#as_html} : blocks are first gathered by groups,
+      # so that list items of the same list are placed within the same group, allowing to frame
+      # their serialization with <ul>...</ul> or <ol>...</ol>.
+      # Images, paragraphs, headings, embed, ... are then placed alone in their own BlockGroup.
+      class BlockGroup
         attr_reader :kind, :blocks
         def initialize(kind)
           @kind = kind
@@ -18,7 +23,16 @@ module Prismic
         @blocks = blocks
       end
 
+      # Serializes the current StructuredText fragment into a fully usable HTML code.
+      # You need to pass a proper link_resolver so that internal links are turned into the proper URL in
+      # your website. If you use a starter kit, one is provided, that you can still update later.
+      #
+      # This method simply executes the as_html methods on blocks;
+      # 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)
+        # Defining blocks that deserve grouping, assigning them "group kind" names
         block_group = ->(block){
           case block
           when Block::ListItem
@@ -27,13 +41,16 @@ module Prismic
             nil
           end
         }
+        # Initializing groups, which is an array of BlockGroup objects
         groups, last = [], nil
         blocks.each {|block|
           group = block_group.(block)
-          groups << Group.new(group) if !last || group != last
+          groups << BlockGroup.new(group) if !last || group != last
           groups.last << block
           last = group
         }
+        # 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
           case group.kind
@@ -96,19 +113,18 @@ module Prismic
             "</strong>"
           end
         end
-
+        
         class Hyperlink < Span
           attr_accessor :link
           def initialize(start, finish, link)
             super(start, finish)
             @link = link
           end
-          def start_html(link_resolver)
-            # Quick-and-dirty way to generate the right <a> tag
-            link.as_html(link_resolver).sub(/(<[^>]+>).*/, '\1')
+          def start_html(link_resolver = nil)
+            link.start_html(link_resolver)
           end
           def end_html(link_resolver=nil)
-            "</a>"
+            link.end_html(link_resolver)
           end
         end
       end

data/lib/prismic/fragments.rb

@@ -1,9 +1,9 @@
 # encoding: utf-8
 require 'prismic/fragments/fragment'
-require 'prismic/fragments/block'
 require 'prismic/fragments/color'
 require 'prismic/fragments/date'
 require 'prismic/fragments/embed'
+require 'prismic/fragments/group'
 require 'prismic/fragments/image'
 require 'prismic/fragments/link'
 require 'prismic/fragments/multiple'

data/lib/prismic/json_parsers.rb

@@ -2,6 +2,7 @@
 module Prismic
   module JsonParser
     class << self
+      @@warned_unknown_type = []
       def parsers
         @parsers ||= {
           'Link.document'  => method(:document_link_parser),
@@ -15,6 +16,7 @@ module Prismic
           'StructuredText' => method(:structured_text_parser),
           'Select'         => method(:select_parser),
           'Multiple'       => method(:multiple_parser),
+          'Group'          => method(:group_parser)
         }
       end
 
@@ -158,8 +160,28 @@ module Prismic
         Prismic::Fragments::Multiple.new(fragments)
       end
 
+      def group_parser(json)
+        fragment_list_array = []
+        json['value'].each do |group|
+          fragments = Hash[ group.map {|name, fragment| [name, parsers[fragment['type']].call(fragment)] }]
+          fragment_list_array << Prismic::Fragments::Group::FragmentMapping.new(fragments)
+        end
+        Prismic::Fragments::Group.new(fragment_list_array)
+      end
+
       def document_parser(json)
         data_json = json['data'].values.first  # {"doc_type": data}
+
+        # Removing the unknown types + sending a warning, once
+        data_json.select!{ |_, fragment|
+          known_type = fragment.is_a?(Array) || parsers.include?(fragment['type'])
+          if !known_type && !@@warned_unknown_type.include?(fragment['type'])
+            warn "Type #{fragment['type']} is unknown, fragment was skipped; perhaps you should update your prismic.io gem?"
+            @@warned_unknown_type << fragment['type']
+          end
+          known_type
+        }
+
         fragments = Hash[data_json.map { |name, fragment|
           if fragment.is_a? Array
             [name, multiple_parser(fragment)]

data/lib/prismic/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Prismic
 
-  VERSION = "1.0.0.preview.7"
+  VERSION = "1.0.0.preview.8"
 
 end

data/lib/prismic.rb

@@ -62,22 +62,23 @@ module Prismic
 
   # A SearchForm represent a Form returned by the prismic.io API.
   #
-  # These forms depend on the prismic.io repository, and can be fill and send
-  # in the same way than regular HTML forms.
+  # These forms depend on the prismic.io repository, and can be filled and sent
+  # as regular HTML forms.
   #
-  # Get SearchForm instance through the {API#create_search_form} method.
+  # You may get a SearchForm instance through the {API#form} method.
   #
   # The SearchForm instance contains helper methods for each predefined form's fields.
-  # Note that these methods are not be created if they risk to add confusion:
+  # Note that these methods are not created if they risk to add confusion:
   # - only letters, underscore and digits are authorized in the name
   # - name starting with a digit or an underscore are forbidden
   # - generated method can't override existing methods
   #
   # @example
-  #   search_form = api.create_search_form('everything')
+  #   search_form = api.form('everything')
   #   search_form.page(3)  # specify the field 'page'
   #   search_form.page_size("20")  # specify the 'page_size' field
   #   results = search_form.submit(master_ref)  # submit the search form
+  #   results = api.form('everything').page(3).page_size("20").submit(master_ref) # methods can be chained
   class SearchForm
     attr_accessor :api, :form, :data, :ref
 

data/spec/fragments_spec.rb

@@ -544,6 +544,9 @@ describe 'StructuredText::Hyperlink' do
     it "can generate valid link" do
       @hyperlink.start_html(@link_resolver).should == '<a href="http://localhost/UdUjvt_mqVNObPeO">'
     end
+    it "raises an error when no link_resolver provided" do
+      expect { @hyperlink.start_html(nil) }.to raise_error
+    end
     it "can generate valid html for broken link" do
       @link.broken = true
       @hyperlink.start_html(@link_resolver).should == "<span>"
@@ -565,3 +568,21 @@ describe 'Multiple' do
     end
   end
 end
+
+describe 'Group' do
+  before do
+    @micro_api = Prismic.api("https://micro.prismic.io/api", nil)
+    @master_ref = @micro_api.master_ref
+    @docchapter = @micro_api.form("everything").query(%([[:d = at(document.type, "docchapter")]])).orderings('[my.docchapter.priority]').submit(@master_ref)[0]
+    @link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.link_type}/#{doc_link.id}" }
+  end
+
+  it 'accesses fields the proper way' do
+    @docchapter['docchapter.docs'][0]['linktodoc'].link_type.should == 'doc'
+  end
+
+  it 'serializes towards HTML as expected' do
+    @docchapter['docchapter.docs'].as_html(@link_resolver).should == "<section data-field=\"linktodoc\"><a href=\"http://localhost/doc/UrDofwEAALAdpbNH\">with-jquery</a></section>\n<section data-field=\"linktodoc\"><a href=\"http://localhost/doc/UrDp8AEAAPUdpbNL\">with-bootstrap</a></section>"
+  end
+
+end

data/spec/json_parsers_spec.rb

@@ -1,4 +1,6 @@
 # encoding: utf-8
+require 'spec_helper'
+
 describe 'document_link_parser' do
   before do
     raw_json = <<json
@@ -326,3 +328,15 @@ json
     multiple[0].class.should == Prismic::Fragments::Text
   end
 end
+
+describe 'unknown_parser' do
+  before do
+    @raw_json = File.read("#{File.dirname(__FILE__)}/responses_mocks/document_with_unknown_fragment.json")
+    @json = JSON.parse(@raw_json)
+  end
+
+  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

data/spec/lesbonneschoses_spec.rb

@@ -15,21 +15,21 @@ describe 'LesBonnesChoses' do
 
 	describe 'query' do
 		it "queries everything and returns 20 documents" do
-			@api.create_search_form("everything").submit(@master_ref).size.should == 20
+			@api.form("everything").submit(@master_ref).size.should == 20
 		end
 
 		it "queries macarons (using a predicate) and returns 7 documents" do
-			@api.create_search_form("everything")
+			@api.form("everything")
 				.query(%([[:d = any(document.tags, ["Macaron"])]]))
 				.submit(@master_ref).size.should == 7
 		end
 
 		it "queries macarons (using a form) and returns 7 documents" do
-			@api.create_search_form("macarons").submit(@master_ref).size.should == 7
+			@api.form("macarons").submit(@master_ref).size.should == 7
 		end
 
 		it "queries macarons or cupcakes (using a form + a predicate) and returns 11 documents" do
-			@api.create_search_form("products")
+			@api.form("products")
 				.query(%([[:d = any(document.tags, ["Cupcake", "Macaron"])]]))
 				.submit(@master_ref).size.should == 11
 		end		
@@ -37,7 +37,7 @@ describe 'LesBonnesChoses' do
 
 	describe 'API::Document' do
 		before do
-			@document = @api.create_search_form('everything').query(%([[:d = at(document.id, "UkL0gMuvzYUANCpf")]])).submit(@master_ref)[0]
+			@document = @api.form('everything').query(%([[:d = at(document.id, "UkL0gMuvzYUANCpf")]])).submit(@master_ref)[0]
 		end
 
 		it 'Operator [] works on document' do
@@ -55,17 +55,32 @@ describe 'LesBonnesChoses' do
 		end
 	end
 
-	describe 'fragments' do
-		it "returns a correct as_text on a StructuredText" do
-			@api.create_search_form("everything")
-				.query(%([[:d = at(document.id, "UkL0gMuvzYUANCps")]]))
-				.submit(@master_ref)[0].fragments['body'].as_text.should == "The end of a chapter the beginning of a new one Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
+	describe 'Fragments' do
+		before do
+			@link_resolver = Prismic.link_resolver("master"){|doc_link| "http://localhost/#{doc_link.id}" }
 		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, "UkL0gMuvzYUANCpr")]]))
+					.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</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 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 &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/UkL0gMuvzYUANCpa\">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/UkL0gMuvzYUANCpX\">a second shop on Paris's Champs-Élysées</a>, and <a href=\"http://localhost/UkL0gMuvzYUANCpY\">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/UkL0gMuvzYUANCpW\">New York</a> (2000) and <a href=\"http://localhost/UkL0gMuvzYUANCpZ\">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/UkL0gMuvzYUANCpe\">ganache specialists</a>&quot;, &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpc\">fruit experts</a>&quot;, or &quot;<a href=\"http://localhost/UkL0gMuvzYUANCpb\">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/UkL0gMuvzYUANCpo\">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")
+					.query(%([[:d = at(document.id, "UkL0gMuvzYUANCps")]]))
+					.submit(@master_ref)[0]['blog-post.body'].as_text.should == "The end of a chapter the beginning of a new one Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
+			end
 
-		it "returns a correct as_text on a StructuredText with a separator" do
-			@api.create_search_form("everything")
-				.query(%([[:d = at(document.id, "UkL0gMuvzYUANCps")]]))
-				.submit(@master_ref)[0].fragments['body'].as_text(' #### ').should == "The end of a chapter the beginning of a new one #### Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. #### \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" #### He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. #### \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
+			it "returns a correct as_text on a StructuredText with a separator" do
+				@api.form("everything")
+					.query(%([[:d = at(document.id, "UkL0gMuvzYUANCps")]]))
+					.submit(@master_ref)[0]['blog-post.body'].as_text(' #### ').should == "The end of a chapter the beginning of a new one #### Jean-Michel Pastranova, the founder of Les Bonnes Choses, and creator of the whole concept of modern fine pastry, has decided to step down as the CEO and the Director of Workshops of Les Bonnes Choses, to focus on other projects, among which his now best-selling pastry cook books, but also to take on a primary role in a culinary television show to be announced later this year. #### \"I believe I've taken the Les Bonnes Choses concept as far as it can go. Les Bonnes Choses is already an entity that is driven by its people, thanks to a strong internal culture, so I don't feel like they need me as much as they used to. I'm sure they are greater ways to come, to innovate in pastry, and I'm sure Les Bonnes Choses's coming innovation will be even more mind-blowing than if I had stayed longer.\" #### He will remain as a senior advisor to the board, and to the workshop artists, as his daughter Selena, who has been working with him for several years, will fulfill the CEO role from now on. #### \"My father was able not only to create a revolutionary concept, but also a company culture that puts everyone in charge of driving the company's innovation and quality. That gives us years, maybe decades of revolutionary ideas to come, and there's still a long, wonderful path to walk in the fine pastry world.\""
+			end
 		end
 	end
 end

data/spec/prismic_spec.rb

@@ -58,14 +58,30 @@ describe 'Api' do
     end
   end
 
-  describe 'form' do
+  describe 'forms' do
     it "return the right Form" do
-      @api.form('form2').name.should == 'form2'
+      @api.forms['form2'].name.should == 'form2'
     end
   end
 
   describe 'create_search_form' do
     it "create a new search form for the right form" do
+      @form = @api.form('form2')
+      @form.form.name.should == 'form2'
+    end
+    it "store default value as simple value when the field is not repeatable" do
+      @form = @api.form('form2')
+      @form.data['param1'].should == 'value1'
+    end
+    it "store default value as array when the field is repeatable" do
+      @form = @api.form('form2')
+      @form.data['q'].should == ['[[any(document.type, [\"product\"])]]']
+    end
+  end
+
+  describe 'deprecated create_search_form' do
+    it "create a new search form for the right form" do
+      @api.should_receive(:warn).with("[DEPRECATION] `create_search_form` is deprecated.  Please use `form` instead.")
       @form = @api.create_search_form('form2')
       @form.form.name.should == 'form2'
     end

data/spec/responses_mocks/document_with_unknown_fragment.json

@@ -0,0 +1,37 @@
+{
+  "id": "UdUkXt_mqZBObPeS",
+  "type": "product",
+  "href": "doc-url",
+  "tags": [
+    "Macaron"
+  ],
+  "slugs": [
+    "vanilla-macaron"
+  ],
+  "data": {
+    "product": {
+      "name": {
+        "type": "StructuredText",
+        "value": [
+          {
+          "type": "heading1",
+          "text": "Vanilla Macaron",
+          "spans": []
+        }
+        ]
+      },
+      "short_lede": {
+        "type": "blabla",
+        "value": "foo"
+      },
+      "short_lede2": {
+        "type": "blabla",
+        "value": "foo"
+      },
+      "allergens": {
+        "type": "Text",
+        "value": "Contains almonds, eggs, milk"
+      }
+    }
+  }
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prismic.io
 version: !ruby/object:Gem::Version
-  version: 1.0.0.preview.7
+  version: 1.0.0.preview.8
 platform: ruby
 authors:
 - Étienne Vallette d'Osia
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-16 00:00:00.000000000 Z
+date: 2013-12-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -85,11 +85,11 @@ files:
 - lib/prismic/api.rb
 - lib/prismic/form.rb
 - lib/prismic/fragments.rb
-- lib/prismic/fragments/block.rb
 - lib/prismic/fragments/color.rb
 - lib/prismic/fragments/date.rb
 - lib/prismic/fragments/embed.rb
 - lib/prismic/fragments/fragment.rb
+- lib/prismic/fragments/group.rb
 - lib/prismic/fragments/image.rb
 - lib/prismic/fragments/link.rb
 - lib/prismic/fragments/multiple.rb
@@ -106,6 +106,7 @@ files:
 - spec/prismic_spec.rb
 - spec/responses_mocks/api.json
 - spec/responses_mocks/document.json
+- spec/responses_mocks/document_with_unknown_fragment.json
 - spec/responses_mocks/fragments.json
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_paragraph.json
@@ -141,7 +142,9 @@ test_files:
 - spec/prismic_spec.rb
 - spec/responses_mocks/api.json
 - spec/responses_mocks/document.json
+- spec/responses_mocks/document_with_unknown_fragment.json
 - spec/responses_mocks/fragments.json
 - spec/responses_mocks/structured_text_heading.json
 - spec/responses_mocks/structured_text_paragraph.json
 - spec/spec_helper.rb
+has_rdoc: 

data/lib/prismic/fragments/block.rb

@@ -1,5 +0,0 @@
-# encoding: utf-8
-module Prismic
-  module Fragments
-  end
-end