prismic.io 1.0.4 → 1.0.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f1a922f0e6ee8a7f0deabb7e1c6e9d301634b82c
-  data.tar.gz: aeba97f56cd7799118b38779eb244fd544157b66
+  metadata.gz: fd49e594dff30e85b1dce2393707441e716c88f6
+  data.tar.gz: 18838f06eb596494d16fcac5bc461cbef642a12b
 SHA512:
-  metadata.gz: c36746c2c5c6dd0238e04c1b42fc933853a60785bb64c6019c30eaa81f0a283e4b4f652163db79f810c46cc5f35a84e410f7e437fc6dd5fab6ca6a69276278d8
-  data.tar.gz: 5c16360d81add7976f534ba3a5fa479bb503be2eb49e346e90bc72160291b8d485984ac53a77a348678bdb007faea611e2de69905b6023fc9f8508469ad7b249
+  metadata.gz: c2da8f9c018d2cb305d139d4a176a3d20efcb4024a40c0da9add1d8d1c60118840e283c368b2d880b6095e54aa1437c0a1e3fdf6b928aba6374bade151f1fff9
+  data.tar.gz: a5aa83e595426ab090d6dfc97409b3d1705f2e8eb0d9a0a2854a79e2da9bbf60eca38e22ae947213cf99dbfa1ed360474e01d1a468edeaedcd1631265b7ab732

data/.gitignore

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

data/.travis.yml

@@ -18,4 +18,4 @@ deploy:
   on:
     tags: true
     all_branches: true
-    repo: prismicio/ruby-kit
+

data/Gemfile.lock

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

data/lib/prismic.rb

@@ -5,6 +5,8 @@ require 'uri'
 
 require 'json' unless defined?(JSON)
 
+require 'prismic/with_fragments'
+
 module Prismic
 
   # These exception can contains an error cause and is able to show them
@@ -306,11 +308,13 @@ module Prismic
     # @return [SearchForm] self
     def set(field_name, value)
       field = @form.fields[field_name]
-      if field && field.repeatable?
-        data[field_name] = [] unless data.include? field_name
-        data[field_name] << value.to_s
-      else
-        data[field_name] = value.to_s
+      unless value == nil
+        if field && field.repeatable?
+          data[field_name] = [] unless data.include? field_name
+          data[field_name] << value.to_s
+        else
+          data[field_name] = value.to_s
+        end
       end
       self
     end
@@ -345,8 +349,25 @@ module Prismic
     alias :repeatable? :repeatable
   end
 
+  # Paginated response to a Prismic.io query. Note that you may not get all documents in the first page,
+  # and may need to retrieve more pages or increase the page size.
   class Response
-    attr_accessor :page, :results_per_page, :results_size, :total_results_size, :total_pages, :next_page, :prev_page, :results
+    # @return [Number] current page, starting at 1
+    attr_accessor :page
+    # @return [Number]
+    attr_accessor :results_per_page
+    # @return [Number]
+    attr_accessor :results_size
+    # @return [Number]
+    attr_accessor :total_results_size
+    # @return [Number]
+    attr_accessor :total_pages
+    # @return [String] URL to the next page - nil if current page is the last page
+    attr_accessor :next_page
+    # @return [String] URL to the previous page - nil if current page is the first page
+    attr_accessor :prev_page
+    # @return [Array<Document>] Documents of the current page
+    attr_accessor :results
 
     # To be able to use Kaminari as a paginator in Rails out of the box
     alias :current_page :page
@@ -364,6 +385,7 @@ module Prismic
     end
 
     # Accessing the i-th document in the results
+    # @return [Document]
     def [](i)
       @results[i]
     end
@@ -400,62 +422,32 @@ module Prismic
     end
   end
 
-  class Document
-    attr_accessor :id, :type, :href, :tags, :slugs, :linked_documents, :fragments
+  class Document < Prismic::WithFragments
+    # @return [String]
+    attr_accessor :id
+    # @return [String]
+    attr_accessor :type
+    # @return [String]
+    attr_accessor :href
+    # @return [Array<String>]
+    attr_accessor :tags
+    # @return [Array<String>]
+    attr_accessor :slugs
+    # @return [Array<LinkedDocument>]
+    attr_accessor :linked_documents
 
     def initialize(id, type, href, tags, slugs, linked_documents, fragments)
+      super(fragments)
       @id = id
       @type = type
       @href = href
       @tags = tags
       @slugs = slugs
       @linked_documents = linked_documents
-      @fragments = (fragments.is_a? Hash) ? parse_fragments(fragments) : fragments
-    end
-
-    # Returns the document's slug
-    #
-    # @return [String]
-    def slug
-      slugs.empty? ? '-' : slugs.first
-    end
-
-    # Generate an HTML representation of the entire document
-    #
-    # @param link_resolver [LinkResolver] The LinkResolver used to build
-    #     application's specific URL
-    #
-    # @return [String] the HTML representation
-    def as_html(link_resolver)
-      fragments.map { |field, fragment|
-        %(<section data-field="#{field}">#{fragment.as_html(link_resolver)}</section>)
-      }.join("\n")
-    end
-
-    # Finds the first highest title in a document (if any)
-    #
-    # @return [String]
-    def first_title
-      # It is impossible to reuse the StructuredText.first_title method, since
-      # we need to test the highest title across the whole document
-      title = false
-      max_level = 6 # any title with a higher level kicks the current one out
-      @fragments.each do |_, fragment|
-        if fragment.is_a? Prismic::Fragments::StructuredText
-          fragment.blocks.each do |block|
-            if block.is_a?(Prismic::Fragments::StructuredText::Block::Heading)
-              if block.level < max_level
-                title = block.text
-                max_level = block.level # new maximum
-              end
-            end
-          end
-        end
-      end
-      title
     end
 
     # Get a document's field
+    # @return [Fragments::Fragment]
     def [](field)
       array = field.split('.')
       if array.length != 2
@@ -466,65 +458,13 @@ module Prismic
     end
     alias :get :[]
 
-    def get_text(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Text
-      fragment
-    end
-
-    def get_number(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Number
-      fragment
-    end
-
-    def get_date(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Date
-      fragment
-    end
-
-    def get_timestamp(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Timestamp
-      fragment
-    end
-
-    def get_group(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Group
-      fragment
-    end
-
-    def get_link(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Link
-      fragment
-    end
-
-    def get_embed(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Embed
-      fragment
-    end
-
-    def get_color(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::Color
-      fragment
-    end
-
-    def get_geopoint(field)
-      fragment = self[field]
-      return nil unless fragment.is_a? Prismic::Fragments::GeoPoint
-      fragment
+    # Returns the document's slug
+    #
+    # @return [String]
+    def slug
+      slugs.empty? ? '-' : slugs.first
     end
 
-    private
-
-    def parse_fragments(fragments)
-      fragments
-    end
   end
 
 
@@ -573,6 +513,8 @@ module Prismic
 
   # The LinkResolver will help to build URL specific to an application, based
   # on a generic prismic.io's {Fragments::DocumentLink Document link}.
+  #
+  # The {Prismic.link_resolver} function is the recommended way to create a LinkResolver.
   class LinkResolver
     attr_reader :ref
 
@@ -592,6 +534,9 @@ module Prismic
     end
   end
 
+  # A class to override the default was to serialize HTML. Only needed if you want to override the default HTML serialization.
+  #
+  # The {Prismic.html_serializer} function is the recommended way to create an HtmlSerializer.
   class HtmlSerializer
     def initialize(&blk)
       @blk = blk

data/lib/prismic/api.rb

@@ -6,8 +6,19 @@ module Prismic
     @@warned_create_search_form = false
     @@warned_oauth_initiate_url = false
     @@warned_oauth_check_token = false
-    attr_reader :json, :access_token, :http_client
-    attr_accessor :refs, :bookmarks, :forms, :tags, :types, :experiments, :oauth, :cache
+    attr_reader :json
+    # @return [String]
+    attr_reader :access_token
+    attr_reader :http_client
+    # @return [Hash{String => Ref}] list of references, as label -> reference
+    attr_accessor :refs
+    # @return [Hash{String => String}] list of bookmarks, as name -> documentId
+    attr_accessor :bookmarks
+    # @return [Hash{String => SearchForm}] list of bookmarks, as name -> documentId
+    attr_accessor :forms
+    attr_accessor :tags, :types, :oauth, :cache
+    # @return [Experiments] list of all experiments from Prismic
+    attr_accessor :experiments
 
     # Is the cache enabled on this API object?
     #
@@ -47,9 +58,9 @@ module Prismic
 
     # Get a bookmark by its name
     # @api
-    # @param  name [String] The bookmark's name
+    # @param name [String] The bookmark's name
     #
-    # @return [Hash] The bookmark
+    # @return [String] The bookmark document id
     def bookmark(name)
       bookmarks[name]
     end
@@ -63,7 +74,7 @@ module Prismic
       refs[name.downcase]
     end
 
-    # Returns a {Prismic::SearchForm search form} by its name
+    # Returns a {Prismic::SearchForm search form} by its name. This is where you start to query a repository.
     # @api
     # @param  name [String] The name of the form
     # @param  data [Hash] Default values
@@ -77,7 +88,7 @@ module Prismic
 
     # @deprecated Use {#form} instead.
     def create_search_form(name, data={}, ref={})
-      if !@@warned_create_search_form
+      unless @@warned_create_search_form
         warn "[DEPRECATION] `create_search_form` is deprecated.  Please use `form` instead."
         @@warned_create_search_form = true
       end
@@ -88,10 +99,11 @@ module Prismic
       @json
     end
 
+    # Fetch the API information from the Prismic.io server
     def self.get(url, access_token=nil, http_client=Prismic::DefaultHTTPClient, api_cache=Prismic::DefaultApiCache)
       data = {}
-      data["access_token"] = access_token if access_token
-      cache_key = url + (access_token ? ("#" + access_token) : "")
+      data['access_token'] = access_token if access_token
+      cache_key = url + (access_token ? ('#' + access_token) : '')
       api_cache.get_or_set(cache_key, nil, 5) {
         res = http_client.get(url, data, 'Accept' => 'application/json')
         case res.code
@@ -221,11 +233,11 @@ module Prismic
         @token = token
       end
       def initiate_url(opts)
-        initiate + "?" + {
-          "client_id" => opts.fetch(:client_id),
-          "redirect_uri" => opts.fetch(:redirect_uri),
-          "scope" => opts.fetch(:scope),
-        }.map{|kv| kv.map{|e| CGI.escape(e) }.join("=") }.join("&")
+        initiate + '?' + {
+          'client_id' => opts.fetch(:client_id),
+          'redirect_uri' => opts.fetch(:redirect_uri),
+          'scope' => opts.fetch(:scope),
+        }.map{|kv| kv.map{|e| CGI.escape(e) }.join('=') }.join('&')
       end
       def check_token(params)
         res = http_client.post(token, params)

data/lib/prismic/experiments.rb

@@ -2,7 +2,10 @@
 module Prismic
 
   class Experiments
-    attr_reader :draft, :running
+    # @return [Array<Experiment>] list of all experiments from Prismic
+    attr_reader :draft
+    # @return [Array<Experiments>] list of all experiments from Prismic
+    attr_reader :running
 
     def initialize(draft, running)
       @draft = draft
@@ -31,6 +34,7 @@ module Prismic
       nil
     end
 
+    # @return [Experiments]
     def self.parse(data)
       draft = []
       running = []
@@ -48,7 +52,14 @@ module Prismic
   end
 
   class Experiment
-    attr_reader :id, :google_id, :name, :variations
+    # @return [String]
+    attr_reader :id
+    # @return [String]
+    attr_reader :google_id
+    # @return [String]
+    attr_reader :name
+    # @return [Array<Variation>]
+    attr_reader :variations
 
     def initialize(id, google_id, name, variations)
       @id = id
@@ -57,6 +68,7 @@ module Prismic
       @variations = variations
     end
 
+    # @return [Experiment]
     def self.parse(data)
       new(data['id'], data['googleId'], data['name'], data['variations'].map { |variation|
         Variation.parse(variation)
@@ -65,7 +77,12 @@ module Prismic
   end
 
   class Variation
-    attr_reader :id, :ref, :label
+    # @return [String]
+    attr_reader :id
+    # @return [String]
+    attr_reader :ref
+    # @return [String]
+    attr_reader :label
 
     def initialize(id, ref, label)
       @id = id
@@ -73,6 +90,7 @@ module Prismic
       @label = label
     end
 
+    # @return [Variation]
     def self.parse(data)
       new(data['id'], data['ref'], data['label'])
     end

data/lib/prismic/fragments/group.rb

@@ -10,27 +10,28 @@ module Prismic
     # the first image will look like this: `group[0]['image']`.
     class Group < Fragment
 
-      # The array of the fragment lists
-      attr_accessor :fragment_list_array
+      # The array of group documents
+      attr_accessor :group_documents
 
-      def initialize(fragment_list_array)
-        @fragment_list_array = fragment_list_array
+      def initialize(group_documents)
+        @group_documents = group_documents
       end
 
-      # Accessing the i-th item (fragment list) of the group: `group[i]`
-      def [](i)
-        @fragment_list_array[i]
+      # Get the group document corresponding to index
+      # @return [Prismic::WithFragments]
+      def [](index)
+        @group_documents[index]
       end
-      alias :get :[]
 
-      # @yieldparam fragment [Fragment]
+      alias :get :[]
+      # @yieldparam group_doc [WithFragment]
       def each(&blk)
-        @fragment_list_array.each(&blk)
+        @group_documents.each(&blk)
       end
       include Enumerable  # adds map, select, etc
 
       def length
-        @fragment_list_array.length
+        @group_documents.length
       end
       alias :size :length
 
@@ -41,64 +42,16 @@ module Prismic
       #
       # @return [String] the HTML representation
       def as_html(link_resolver = nil)
-        @fragment_list_array.map { |fl| fl.as_html(link_resolver) }.join("\n")
+        @group_documents.map { |doc| doc.as_html(link_resolver) }.join("\n")
       end
 
       # Generate an text representation of the group
       #
       # @return [String] the text representation
       def as_text
-        @fragment_list_array.map { |fl| fl.as_text }.join("\n")
+        @group_documents.map { |doc| doc.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
-        alias :get :[]
-
-        # @yieldparam name [String]
-        # @yieldparam fragment [Fragment]
-        def each(&blk)
-          @fragments.each(&blk)
-        end
-        include Enumerable  # adds map, select, etc
-
-        # @return [Fixum]
-        def length
-          @fragments.length
-        end
-        alias :size :length
-
-        # Generate an HTML representation of the fragments
-        #
-        # @param link_resolver [LinkResolver] The LinkResolver used to build
-        #     application's specific URL
-        #
-        # @return [String] the HTML representation
-        def as_html(link_resolver = nil)
-          @fragments.map { |name, fragment|
-            %(<section data-field="#{name}">#{fragment.as_html(link_resolver)}</section>)
-          }.join("\n")
-        end
-
-        # Generate a text representation of the fragment
-        #
-        # @return [String] the text representation
-        def as_text
-          @fragments.values.map { |fragment| fragment.as_text }.join("\n")
-        end
-      end
     end
   end
 end

data/lib/prismic/fragments/structured_text.rb

@@ -31,6 +31,10 @@ 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).
+      # @param link_resolver [LinkResolver]
+      # @param html_serializer [HtmlSerializer]
+      # @return [String] the resulting html snippet
+
       def as_html(link_resolver, html_serializer=nil)
         # Defining blocks that deserve grouping, assigning them "group kind" names
         block_group = ->(block){
@@ -91,7 +95,10 @@ module Prismic
       end
 
       class Span
-        attr_accessor :start, :end
+        # @return [Number]
+        attr_accessor :start
+        # @return [Number]
+        attr_accessor :end
 
         def initialize(start, finish)
           @start = start
@@ -99,6 +106,7 @@ module Prismic
         end
 
         class Label < Span
+          # @return [String]
           attr_accessor :label
           def initialize(start, finish, label)
             super(start, finish)
@@ -149,7 +157,12 @@ module Prismic
         end
 
         class Text
-          attr_accessor :text, :spans, :label
+          # @return [String]
+          attr_accessor :text
+          # @return [Array<Span>]
+          attr_accessor :spans
+          # @return [String] may be nil
+          attr_accessor :label
 
           def initialize(text, spans, label = nil)
             @text = text

data/lib/prismic/json_parsers.rb

@@ -192,7 +192,7 @@ module Prismic
         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)
+          fragment_list_array << Prismic::WithFragments.new(fragments)
         end
         Prismic::Fragments::Group.new(fragment_list_array)
       end

data/lib/prismic/version.rb

@@ -1,6 +1,6 @@
 # encoding: utf-8
 module Prismic
 
-  VERSION = '1.0.4'
+  VERSION = '1.0.5'
 
 end

data/lib/prismic/with_fragments.rb

@@ -0,0 +1,140 @@
+# encoding: utf-8
+module Prismic
+
+  # A document with Fragments: usually a Prismic.io Document, or a Document within a Group
+  class WithFragments
+    # @return [Hash{String => Fragment}]
+    attr_accessor :fragments
+
+    def initialize(fragments)
+      @fragments = fragments
+    end
+
+    # Generate an HTML representation of the entire document
+    #
+    # @param link_resolver [LinkResolver] The LinkResolver used to build
+    #     application's specific URL
+    #
+    # @return [String] the HTML representation
+    def as_html(link_resolver)
+      fragments.map { |field, fragment|
+        %(<section data-field="#{field}">#{fragment.as_html(link_resolver)}</section>)
+      }.join("\n")
+    end
+
+    # Finds the first highest title in a document (if any)
+    #
+    # @return [String]
+    def first_title
+      # It is impossible to reuse the StructuredText.first_title method, since
+      # we need to test the highest title across the whole document
+      title = false
+      max_level = 6 # any title with a higher level kicks the current one out
+      @fragments.each do |_, fragment|
+        if fragment.is_a? Prismic::Fragments::StructuredText
+          fragment.blocks.each do |block|
+            if block.is_a?(Prismic::Fragments::StructuredText::Block::Heading)
+              if block.level < max_level
+                title = block.text
+                max_level = block.level # new maximum
+              end
+            end
+          end
+        end
+      end
+      title
+    end
+
+    # Get a document's field
+    # @return [Fragments::Fragment]
+    def [](field)
+      @fragments[field]
+    end
+    alias :get :[]
+
+    # @yieldparam name [String]
+    # @yieldparam fragment [Fragment]
+    def each(&blk)
+      @fragments.each(&blk)
+    end
+    include Enumerable  # adds map, select, etc
+
+    # @return [Fixum]
+    def length
+      @fragments.length
+    end
+    alias :size :length
+
+    # @return [Fragments::Text]
+    def get_text(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Text
+      fragment
+    end
+
+    # @return [Fragments::Number]
+    def get_number(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Number
+      fragment
+    end
+
+    # @return [Fragments::Image]
+    def get_image(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Image
+      fragment
+    end
+
+    # @return [Fragments::Date]
+    def get_date(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Date
+      fragment
+    end
+
+    # @return [Fragments::Timestamp]
+    def get_timestamp(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Timestamp
+      fragment
+    end
+
+    # @return [Fragments::Group]
+    def get_group(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Group
+      fragment
+    end
+
+    # @return [Fragments::Link]
+    def get_link(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Link
+      fragment
+    end
+
+    # @return [Fragments::Embed]
+    def get_embed(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Embed
+      fragment
+    end
+
+    # @return [Fragments::Color]
+    def get_color(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::Color
+      fragment
+    end
+
+    # @return [Fragments::GeoPoint]
+    def get_geopoint(field)
+      fragment = self[field]
+      return nil unless fragment.is_a? Prismic::Fragments::GeoPoint
+      fragment
+    end
+
+  end
+
+end

data/spec/doc_spec.rb

@@ -140,6 +140,22 @@ describe 'Documentation' do
       price.should == 2.5
     end
 
+    it 'images' do
+      api = Prismic::api('https://lesbonneschoses.prismic.io/api')
+      response = api.form('everything')
+        .query(Predicates::at('document.id', 'UlfoxUnM0wkXYXbO'))
+        .ref(api.master_ref)
+        .submit
+      doc = response[0]
+      # startgist:825fa25b66355ce758fe:prismic-images.rb
+      # Accessing image fields
+      image = doc.get_image('product.image')
+      # Most of the time you will be using the "main" view
+      url = image.main.url
+      # endgist
+      url.should == 'https://prismic-io.s3.amazonaws.com/lesbonneschoses/f606ad513fcc2a73b909817119b84d6fd0d61a6d.png'
+    end
+
     it 'date and timestamp' do
       api = Prismic::api('https://lesbonneschoses.prismic.io/api')
       response = api.form('everything')

data/spec/lesbonneschoses_spec.rb

@@ -3,20 +3,20 @@ require 'spec_helper'
 
 describe 'LesBonnesChoses' do
   before do
-    @api = Prismic.api("https://lesbonneschoses.prismic.io/api", nil)
+    @api = Prismic.api('https://lesbonneschoses.prismic.io/api', nil)
     @master_ref = @api.master_ref
   end
 
   describe '/api' do
-    it "API works" do
+    it 'API works' do
       @api.should_not be_nil
     end
   end
 
   describe 'query' do
-    it "queries everything and returns 20 documents" do
-      @api.form("everything").submit(@master_ref).size.should == 20
-      @api.form("everything").submit(@master_ref).results.size.should == 20
+    it 'queries everything and returns 20 documents' do
+      @api.form('everything').submit(@master_ref).size.should == 20
+      @api.form('everything').submit(@master_ref).results.size.should == 20
     end
 
     it "queries macarons (using a predicate) and returns 7 documents" do
@@ -54,6 +54,16 @@ describe 'LesBonnesChoses' do
       documents.next_page.should == "https://lesbonneschoses.prismic.io/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20"
       documents.prev_page.should == nil
     end
+    it "works when passing nil" do
+      documents = @api.form("everything").page(nil).submit(@master_ref)
+      documents.page.should == 1
+      documents.results_per_page.should == 20
+      documents.results_size.should == 20
+      documents.total_results_size.should == 40
+      documents.total_pages.should == 2
+      documents.next_page.should == "https://lesbonneschoses.prismic.io/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20"
+      documents.prev_page.should == nil
+    end
     it "works on page 2" do
       documents = @api.form("everything").page("2").submit(@master_ref)
       documents.page.should == 2
@@ -74,6 +84,16 @@ describe 'LesBonnesChoses' do
       documents.next_page.should == "https://lesbonneschoses.prismic.io/api/documents/search?ref=UlfoxUnM08QWYXdl&page=3&pageSize=10"
       documents.prev_page.should == "https://lesbonneschoses.prismic.io/api/documents/search?ref=UlfoxUnM08QWYXdl&page=1&pageSize=10"
     end
+    it "works when passing nil" do
+      documents = @api.form("everything").page(nil).submit(@master_ref)
+      documents.page.should == 1
+      documents.results_per_page.should == 20
+      documents.results_size.should == 20
+      documents.total_results_size.should == 40
+      documents.total_pages.should == 2
+      documents.next_page.should == "https://lesbonneschoses.prismic.io/api/documents/search?ref=UlfoxUnM08QWYXdl&page=2&pageSize=20"
+      documents.prev_page.should == nil
+    end
   end
 
   describe 'API::Document' do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: prismic.io
 version: !ruby/object:Gem::Version
-  version: 1.0.4
+  version: 1.0.5
 platform: ruby
 authors:
 - Étienne Vallette d'Osia
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-28 00:00:00.000000000 Z
+date: 2014-10-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -109,6 +109,7 @@ files:
 - lib/prismic/json_parsers.rb
 - lib/prismic/predicates.rb
 - lib/prismic/version.rb
+- lib/prismic/with_fragments.rb
 - package.json
 - prismic.gemspec
 - spec/cache_spec.rb