davebenvenuti-prawn 0.11.1.pre

data/spec/template_spec.rb

@@ -0,0 +1,165 @@
+require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
+
+describe "Document built from a template" do
+  it "should have the same page count as the source document" do
+    filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
+    @pdf = Prawn::Document.new(:template => filename)
+    page_counter = PDF::Inspector::Page.analyze(@pdf.render)
+
+    page_counter.pages.size.should == 1
+  end
+
+  it "should have start with the Y cursor at the top of the document" do
+    filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    (@pdf.y == nil).should == false
+  end
+
+  it "should respect margins set by Prawn" do
+    filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename, :margin => 0)
+    assert_equal @pdf.page.margins, { :left   => 0,
+                                      :right  => 0,
+                                      :top    => 0,
+                                      :bottom => 0 }
+
+    @pdf = Prawn::Document.new(:template => filename, :left_margin => 0)
+
+    assert_equal @pdf.page.margins, { :left   => 0,
+                                      :right  => 36,
+                                      :top    => 36,
+                                      :bottom => 36 }
+
+    @pdf.start_new_page(:right_margin => 0)
+
+    assert_equal @pdf.page.margins, { :left   => 0,
+                                      :right  => 0,
+                                      :top    => 36,
+                                      :bottom => 36 }
+
+
+ 
+  end
+
+  it "should not add an extra restore_graphics_state operator to the end of any content stream" do
+    filename = "#{Prawn::BASEDIR}/reference_pdfs/curves.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    output = StringIO.new(@pdf.render)
+    hash = PDF::Hash.new(output)
+
+    hash.each_value do |obj|
+      next unless obj.kind_of?(PDF::Reader::Stream)
+
+      data = obj.data.tr(" \n\r","")
+      data.include?("QQ").should == false
+    end
+  end
+    
+  it "should have a single page object if importing a single page template" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/hexagon.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    output = StringIO.new(@pdf.render)
+    hash = PDF::Hash.new(output)
+
+    pages = hash.values.select { |obj| obj.kind_of?(Hash) && obj[:Type] == :Page }
+
+    pages.size.should == 1
+  end
+
+  it "should have two content streams if importing a single page template" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/hexagon.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    output = StringIO.new(@pdf.render)
+    hash = PDF::Hash.new(output)
+
+    streams = hash.values.select { |obj| obj.kind_of?(PDF::Reader::Stream) }
+
+    streams.size.should == 2
+  end
+
+  it "should not die if using this PDF as a template" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/complex_template.pdf"
+
+    assert_nothing_raised do
+      @pdf = Prawn::Document.new(:template => filename)
+    end
+  end
+
+
+  it "should have balance q/Q operators on all content streams" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/hexagon.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    output = StringIO.new(@pdf.render)
+    hash = PDF::Hash.new(output)
+
+    streams = hash.values.select { |obj| obj.kind_of?(PDF::Reader::Stream) }
+
+    streams.each do |stream|
+      data = stream.unfiltered_data
+      data.scan("q").size.should == 1
+      data.scan("Q").size.should == 1
+    end
+  end
+
+  it "should allow text to be added to a single page template" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/hexagon.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+
+    @pdf.text "Adding some text"
+
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.first.should == "Adding some text"
+  end
+
+  it "should allow PDFs with page resources behind an indirect object to be used as templates" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/resources_as_indirect_object.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+
+    @pdf.text "Adding some text"
+
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    all_text = text.strings.join("")
+    all_text.include?("Adding some text").should == true
+  end
+
+  it "should copy the PDF version from the template file" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/version_1_6.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    str = @pdf.render
+    str[0,8].should == "%PDF-1.6"
+  end
+
+  it "should correctly add a TTF font to a template that has existing fonts" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/contains_ttf_font.pdf"
+    @pdf = Prawn::Document.new(:template => filename)
+    @pdf.font "#{Prawn::BASEDIR}/data/fonts/Chalkboard.ttf"
+    @pdf.move_down(40)
+    @pdf.text "Hi There"
+
+    output = StringIO.new(@pdf.render)
+    hash = PDF::Hash.new(output)
+
+    page_dict = hash.values.detect{ |obj| obj.is_a?(Hash) && obj[:Type] == :Page }
+    resources = page_dict[:Resources]
+    fonts = resources[:Font]
+    fonts.size.should == 2
+  end
+
+  it "should correctly import a template file that is missing a MediaBox entry" do
+    filename = "#{Prawn::BASEDIR}/data/pdfs/page_without_mediabox.pdf"
+
+    @pdf = Prawn::Document.new(:template => filename)
+    str = @pdf.render
+    str[0,4].should == "%PDF"
+  end
+
+end

data/spec/text_at_spec.rb

@@ -0,0 +1,125 @@
+# encoding: utf-8
+
+require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
+
+describe "#draw_text" do
+  before(:each) { create_pdf }
+
+  it "should raise ArgumentError if :at option omitted" do
+    lambda { @pdf.draw_text("hai", { }) }.should.raise(ArgumentError)
+  end
+
+  it "should raise ArgumentError if :align option included" do
+    lambda { @pdf.draw_text("hai", :at => [0, 0], :align => :center) }.should.raise(ArgumentError)
+  end
+
+  it "should allow drawing empty strings to the page" do
+    @pdf.draw_text(" ", :at => [100,100])
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.first.should == " "
+  end
+
+  it "should default to 12 point helvetica" do
+    @pdf.draw_text("Blah", :at => [100,100])
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:name].should == :Helvetica
+    text.font_settings[0][:size].should == 12
+    text.strings.first.should == "Blah"
+  end
+
+  it "should allow setting font size" do
+    @pdf.draw_text("Blah", :at => [100,100], :size => 16)
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:size].should == 16
+  end
+
+  it "should allow setting a default font size" do
+    @pdf.font_size = 16
+    @pdf.draw_text("Blah", :at => [0, 0])
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:size].should == 16
+  end
+
+  it "should allow overriding default font for a single instance" do
+    @pdf.font_size = 16
+
+    @pdf.draw_text("Blah", :size => 11, :at => [0, 0])
+    @pdf.draw_text("Blaz", :at => [0, 0])
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:size].should == 11
+    text.font_settings[1][:size].should == 16
+  end
+
+  it "should allow setting a font size transaction with a block" do
+    @pdf.font_size 16 do
+      @pdf.draw_text('Blah', :at => [0, 0])
+    end
+
+    @pdf.draw_text('blah', :at => [0, 0])
+
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:size].should == 16
+    text.font_settings[1][:size].should == 12
+  end
+
+  it "should allow manual setting the font size " +
+    "when in a font size block" do
+    @pdf.font_size(16) do
+      @pdf.draw_text('Foo', :at => [0, 0])
+      @pdf.draw_text('Blah', :size => 11, :at => [0, 0])
+      @pdf.draw_text('Blaz', :at => [0, 0])
+    end
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:size].should == 16
+    text.font_settings[1][:size].should == 11
+    text.font_settings[2][:size].should == 16
+  end
+
+  it "should allow registering of built-in font_settings on the fly" do
+    @pdf.font "Times-Roman"
+    @pdf.draw_text("Blah", :at => [100,100], :at => [0, 0])
+    @pdf.font "Courier"
+    @pdf.draw_text("Blaz", :at => [150,150], :at => [0, 0])
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.font_settings[0][:name].should == :"Times-Roman"
+    text.font_settings[1][:name].should == :Courier
+  end
+
+  it "should raise an exception when an unknown font is used" do
+    lambda { @pdf.font "Pao bu" }.should.raise(Prawn::Errors::UnknownFont)
+  end
+
+  it "should correctly render a utf-8 string when using a built-in font" do
+    str = "©" # copyright symbol
+    @pdf.draw_text(str, :at => [0, 0])
+
+    # grab the text from the rendered PDF and ensure it matches
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.first.should == str
+  end
+
+  if "spec".respond_to?(:encode!)
+    # Handle non utf-8 string encodings in a sane way on M17N aware VMs
+    it "should raise an exception when a utf-8 incompatible string is rendered" do
+      str = "Blah \xDD"
+      str.force_encoding("ASCII-8BIT")
+      lambda { @pdf.draw_text(str, :at => [0, 0]) }.should.raise(ArgumentError)
+    end
+    it "should not raise an exception when a shift-jis string is rendered" do
+      datafile = "#{Prawn::BASEDIR}/data/shift_jis_text.txt"
+      sjis_str = File.open(datafile, "r:shift_jis") { |f| f.gets }
+      @pdf.font("#{Prawn::BASEDIR}/data/fonts/gkai00mp.ttf")
+      lambda { @pdf.draw_text(sjis_str, :at => [0, 0]) }.should.not.raise(ArgumentError)
+    end
+  else
+    # Handle non utf-8 string encodings in a sane way on non-M17N aware VMs
+    it "should raise an exception when a corrupt utf-8 string is rendered" do
+      str = "Blah \xDD"
+      lambda { @pdf.draw_text(str, :at => [0, 0]) }.should.raise(ArgumentError)
+    end
+    it "should raise an exception when a shift-jis string is rendered" do
+      sjis_str = File.read("#{Prawn::BASEDIR}/data/shift_jis_text.txt")
+      lambda { @pdf.draw_text(sjis_str, :at => [0, 0]) }.should.raise(ArgumentError)
+    end
+  end
+end

data/spec/text_box_spec.rb

@@ -0,0 +1,777 @@
+# encoding: utf-8
+
+require File.join(File.expand_path(File.dirname(__FILE__)), "spec_helper")
+
+describe "Text::Box" do
+
+  it "should be able to set leading document wide" do
+    create_pdf
+    @pdf.default_leading(7)
+    @pdf.default_leading = 7
+    text_box = Prawn::Text::Box.new("hello world",
+                                    :document => @pdf)
+    text_box.leading.should == 7
+  end
+
+  it "option should be able to override document wide leading" do
+    create_pdf
+    @pdf.default_leading = 7
+    text_box = Prawn::Text::Box.new("hello world",
+                                    :document => @pdf,
+                                    :leading => 20)
+    text_box.leading.should == 20
+  end
+  it "should default to document-wide leading if no" +
+    "leading option is provided" do
+    
+  end
+end
+
+describe "Text::Box#extensions" do
+  it "should be able to override default line wrapping" do
+    create_pdf
+    Prawn::Text::Box.extensions << TestWrapOverride
+    @pdf.text_box("hello world", {})
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings[0].should == "all your base are belong to us"
+    Prawn::Text::Box.extensions.delete(TestWrapOverride)
+  end
+end
+
+describe "Text::Box#render with :align => :justify" do
+  it "should draw the word spacing to the document" do
+    create_pdf
+    string = "hello world " * 10
+    options = { :document => @pdf, :align => :justify }
+    text_box = Prawn::Text::Box.new(string, options)
+    text_box.render
+    contents = PDF::Inspector::Text.analyze(@pdf.render)
+    contents.word_spacing[0].should.be > 0
+  end
+end
+
+describe "Text::Box#height without leading" do
+  it "should equal the sum of the height of each line" do
+    create_pdf
+    text = "Oh hai text rect.\nOh hai text rect."
+    options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(text, options)
+    text_box.render
+    text_box.height.should == @pdf.font.height * 2
+  end
+end
+
+describe "Text::Box#height with leading" do
+  it "should equal the sum of the height of each line" do
+    create_pdf
+    text = "Oh hai text rect.\nOh hai text rect."
+    leading = 12
+    options = { :document => @pdf, :leading => leading }
+    text_box = Prawn::Text::Box.new(text, options)
+    text_box.render
+    text_box.height.should == @pdf.font.height * 2 + leading
+  end
+end
+
+describe "Text::Box#valid_options" do
+  it "should return an array" do
+    create_pdf
+    text_box = Prawn::Text::Box.new("", :document => @pdf)
+    text_box.valid_options.should.be.kind_of(Array)
+  end
+end
+
+describe "Text::Box#render" do
+  it "should not fail if height is smaller than 1 line" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = {
+      :height => @pdf.font.height * 0.5,
+      :document => @pdf
+    }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text_box.text.should == ""
+  end
+  it "should draw content to the page" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.should.not.be.empty
+  end
+  it "should not draw a transformation matrix" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+    matrices.matrices.length.should == 0
+  end
+end
+
+describe "Text::Box#render(:single_line => true)" do
+  it "should draw only one line to the page" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = { :document => @pdf,
+                 :single_line => true }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.length.should == 1
+  end
+end
+
+describe "Text::Box#render(:dry_run => true)" do
+  it "should not draw any content to the page" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render(:dry_run => true)
+    text = PDF::Inspector::Text.analyze(@pdf.render)
+    text.strings.should.be.empty
+  end
+  it "subsequent calls to render should not raise an ArgumentError exception" do
+    create_pdf
+    @text = "™©"
+    @options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render(:dry_run => true)
+    lambda { text_box.render }.should.not.raise(ArgumentError)
+  end
+end
+
+describe "Text::Box#render with :rotate option of 30)" do
+  before(:each) do
+    create_pdf
+    rotate = 30
+    @x = 300
+    @y = 70
+    @width = 100
+    @height = 50
+    @cos = Math.cos(rotate * Math::PI / 180)
+    @sin = Math.sin(rotate * Math::PI / 180)
+    @text = "Oh hai text rect. " * 10
+    @options = { :document => @pdf,
+                 :rotate => rotate,
+                 :at => [@x, @y],
+                 :width => @width,
+                 :height => @height }
+  end
+  context ":rotate_around option of :center" do
+    it "should draw content to the page rotated about the center of the text" do
+      @options[:rotate_around] = :center
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x + @width / 2
+      y = @y - @height / 2
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+  context ":rotate_around option of :upper_left" do
+    it "should draw content to the page rotated about the upper left corner of the text" do
+      @options[:rotate_around] = :upper_left
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x
+      y = @y
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+  context "default :rotate_around" do
+    it "should draw content to the page rotated about the upper left corner of the text" do
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x
+      y = @y
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+  context ":rotate_around option of :upper_right" do
+    it "should draw content to the page rotated about the upper right corner of the text" do
+      @options[:rotate_around] = :upper_right
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x + @width
+      y = @y
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+  context ":rotate_around option of :lower_right" do
+    it "should draw content to the page rotated about the lower right corner of the text" do
+      @options[:rotate_around] = :lower_right
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x + @width
+      y = @y - @height
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+  context ":rotate_around option of :lower_left" do
+    it "should draw content to the page rotated about the lower left corner of the text" do
+      @options[:rotate_around] = :lower_left
+      text_box = Prawn::Text::Box.new(@text, @options)
+      text_box.render
+
+      matrices = PDF::Inspector::Graphics::Matrix.analyze(@pdf.render)
+      x = @x
+      y = @y - @height
+      x_prime = x * @cos - y * @sin
+      y_prime = x * @sin + y * @cos
+      matrices.matrices[0].should == [1, 0, 0, 1,
+                                      reduce_precision(x - x_prime),
+                                      reduce_precision(y - y_prime)]
+      matrices.matrices[1].should == [reduce_precision(@cos),
+                                      reduce_precision(@sin),
+                                      reduce_precision(-@sin),
+                                      reduce_precision(@cos), 0, 0]
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.strings.should.not.be.empty
+    end
+  end
+end
+
+describe "Text::Box default height" do
+  before(:each) { create_pdf }
+
+  it "should be the height from the bottom bound to document.y" do
+    target_height = @pdf.y - @pdf.bounds.bottom
+    @text = "Oh hai\n" * 60
+    text_box = Prawn::Text::Box.new(@text, :document => @pdf)
+    text_box.render
+    text_box.height.should.be.close(target_height, @pdf.font.height)
+  end
+
+  it "should use the margin-box bottom if only in a stretchy bbox" do
+    @pdf.bounding_box([0, @pdf.cursor], :width => @pdf.bounds.width) do
+      target_height = @pdf.y - @pdf.bounds.bottom
+      @text = "Oh hai\n" * 60
+      text_box = Prawn::Text::Box.new(@text, :document => @pdf)
+      text_box.render
+      text_box.height.should.be.close(target_height, @pdf.font.height)
+    end
+  end
+
+  it "should use the parent-box bottom if in a stretchy bbox and " +
+    "overflow is :expand, even with an explicit height"do
+    @pdf.bounding_box([0, @pdf.cursor], :width => @pdf.bounds.width) do
+      target_height = @pdf.y - @pdf.bounds.bottom
+      @text = "Oh hai\n" * 60
+      text_box = Prawn::Text::Box.new(@text, :document => @pdf,
+        :height => 100, :overflow => :expand)
+      text_box.render
+      text_box.height.should.be.close(target_height, @pdf.font.height)
+    end
+  end
+
+  it "should use the innermost non-stretchy bbox, not the margin box" do
+    @pdf.bounding_box([0, @pdf.cursor], :width => @pdf.bounds.width,
+                      :height => 200) do
+      @pdf.bounding_box([0, @pdf.cursor], :width => @pdf.bounds.width) do
+        @text = "Oh hai\n" * 60
+        text_box = Prawn::Text::Box.new(@text, :document => @pdf)
+        text_box.render
+        text_box.height.should.be.close(200, @pdf.font.height)
+      end
+    end
+  end
+
+end
+
+describe "Text::Box default at" do
+  it "should be the left corner of the bounds, and the current document.y" do
+    create_pdf
+    target_at = [@pdf.bounds.left, @pdf.y]
+    @text = "Oh hai text rect. " * 100
+    @options = { :document => @pdf }
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text_box.at.should == target_at
+  end
+end
+
+describe "Text::Box with text than can fit in the box" do
+  before(:each) do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = {
+      :width => 162.0,
+      :height => 162.0,
+      :document => @pdf
+    }
+  end
+  
+  it "printed text should match requested text, except for trailing or leading white space and that spaces may be replaced by newlines" do
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text_box.text.gsub("\n", " ").should == @text.strip
+  end
+  
+  it "render should return an empty string because no text remains unprinted" do
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render.should == ""
+  end
+
+  it "should be truncated when the leading is set high enough to prevent all the lines from being printed" do
+    @options[:leading] = 40
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text_box.text.gsub("\n", " ").should.not == @text.strip
+  end
+end
+
+describe "Text::Box with text than can fit in the box with :ellipses overflow and :valign => :bottom" do
+  it "should not print ellipses" do
+    create_pdf
+    @text = "Oh hai text rect. " * 10
+    @options = {
+      :width => 162.0,
+      :height => 162.0,
+      :overflow => :ellipses,
+      :valign => :bottom,
+      :document => @pdf
+    }
+    @text_box = Prawn::Text::Box.new(@text, @options)
+    @text_box.render
+    @text_box.text.should.not =~ /\.\.\./
+  end
+end
+
+
+
+describe "Text::Box printing UTF-8 string with higher bit characters" do
+  before(:each) do
+    create_pdf    
+    @text = "©"
+    # not enough height to print any text, so we can directly compare against
+    # the input string
+    bounding_height = 1.0
+    options = {
+      :height => bounding_height,
+      :document => @pdf
+    }
+    file = "#{Prawn::BASEDIR}/data/fonts/Action Man.dfont"
+    @pdf.font_families["Action Man"] = {
+      :normal      => { :file => file, :font => "ActionMan" },
+      :italic      => { :file => file, :font => "ActionMan-Italic" },
+      :bold        => { :file => file, :font => "ActionMan-Bold" },
+      :bold_italic => { :file => file, :font => "ActionMan-BoldItalic" }
+    }
+    @text_box = Prawn::Text::Box.new(@text, options)
+  end
+  describe "when using a TTF font" do
+    it "unprinted text should be in UTF-8 encoding" do
+      @pdf.font("Action Man")
+      remaining_text = @text_box.render
+      remaining_text.should == @text
+    end
+    it "subsequent calls to Text::Box need not include the" +
+       " :skip_encoding => true option" do
+      @pdf.font("Action Man")
+      remaining_text = @text_box.render
+      lambda {
+        @pdf.text_box(remaining_text, :document => @pdf)
+      }.should.not.raise(ArgumentError)
+    end
+  end
+  describe "when using an AFM font" do
+    it "unprinted text should be in WinAnsi encoding" do
+      remaining_text = @text_box.render
+      remaining_text.should == @pdf.font.normalize_encoding(@text)
+    end
+    it "subsequent calls to Text::Box must include the" +
+       " :skip_encoding => true option" do
+      remaining_text = @text_box.render
+      lambda {
+        @pdf.text_box(remaining_text, :document => @pdf)
+      }.should.raise(ArgumentError)
+      lambda {
+        @pdf.text_box(remaining_text, :skip_encoding => true,
+                                      :document => @pdf)
+      }.should.not.raise(ArgumentError)
+    end
+  end
+end
+          
+
+describe "Text::Box with more text than can fit in the box" do
+  before(:each) do
+    create_pdf    
+    @text = "Oh hai text rect. " * 30
+    @bounding_height = 162.0
+    @options = {
+      :width => 162.0,
+      :height => @bounding_height,
+      :document => @pdf
+    }
+  end
+  
+  context "truncated overflow" do
+    before(:each) do
+      @options[:overflow] = :truncate
+      @text_box = Prawn::Text::Box.new(@text, @options)
+    end
+    it "should not display ellipses" do
+      @text_box.render
+      @text_box.text.should.not =~ /\.\.\./
+    end
+    it "should be truncated" do
+      @text_box.render
+      @text_box.text.gsub("\n", " ").should.not == @text.strip
+    end
+    it "render should not return an empty string because some text remains unprinted" do
+      @text_box.render.should.not == ""
+    end
+    it "#height should be no taller than the specified height" do
+      @text_box.render
+      @text_box.height.should.be <= @bounding_height
+    end
+    it "#height should be within one font height of the specified height" do
+      @text_box.render
+      @bounding_height.should.be.close(@text_box.height, @pdf.font.height)
+    end
+    context "with :rotate option" do
+      it "unrendered text should be the same as when not rotated" do
+        remaining_text = @text_box.render
+
+        rotate = 30
+        x = 300
+        y = 70
+        width = @options[:width]
+        height = @options[:height]
+        @options[:document] = @pdf
+        @options[:rotate] = rotate
+        @options[:at] = [x, y]
+        rotated_text_box = Prawn::Text::Box.new(@text, @options)
+        rotated_text_box.render.should == remaining_text
+      end
+    end
+  end
+  
+  context "ellipses overflow" do
+    before(:each) do
+      @options[:overflow] = :ellipses
+      @text_box = Prawn::Text::Box.new(@text, @options)
+    end
+    it "should display ellipses" do
+      @text_box.render
+      @text_box.text.should =~ /\.\.\./
+    end
+    it "render should not return an empty string because some text remains unprinted" do
+      @text_box.render.should.not == ""
+    end
+  end
+
+  context "expand overflow" do
+    before(:each) do
+      @options[:overflow] = :expand
+      @text_box = Prawn::Text::Box.new(@text, @options)
+    end
+    it "height should expand to encompass all the text (but not exceed the height of the page)" do
+      @text_box.render
+      @text_box.height.should > @bounding_height
+    end
+    it "should display the entire string (as long as there was space remaining on the page to print all the text)" do
+      @text_box.render
+      @text_box.text.gsub("\n", " ").should == @text.strip
+    end
+    it "render should return an empty string because no text remains unprinted(as long as there was space remaining on the page to print all the text)" do
+      @text_box.render.should == ""
+    end
+  end
+
+  context "shrink_to_fit overflow" do
+    before(:each) do
+      @options[:overflow] = :shrink_to_fit
+      @options[:min_font_size] = 2
+      @text_box = Prawn::Text::Box.new(@text, @options)
+    end
+    it "should display the entire text" do
+      @text_box.render
+      @text_box.text.gsub("\n", " ").should == @text.strip
+    end
+    it "render should return an empty string because no text remains unprinted" do
+      @text_box.render.should == ""
+    end
+  end
+end
+
+describe "Text::Box with a solid block of Chinese characters" do
+  it "printed text should match requested text, except for newlines" do
+    create_pdf
+    @text = "写中国字" * 10
+    @options = {
+      :width => 162.0,
+      :height => 162.0,
+      :document => @pdf
+    }
+    @pdf.font "#{Prawn::BASEDIR}/data/fonts/gkai00mp.ttf"
+    @options[:overflow] = :truncate
+    text_box = Prawn::Text::Box.new(@text, @options)
+    text_box.render
+    text_box.text.gsub("\n", "").should == @text.strip
+  end
+end
+
+
+describe "drawing bounding boxes" do    
+  
+  before(:each) { create_pdf }   
+
+  it "should restore the margin box when bounding box exits" do
+    margin_box = @pdf.bounds
+
+    @pdf.text_box "Oh hai text box. " * 11, :height => @pdf.font.height * 10
+
+    @pdf.bounds.should == margin_box
+
+  end
+  
+end
+
+
+describe "Text::Box#render with :character_spacing option" do
+  it "should draw the character spacing to the document" do
+    create_pdf
+    string = "hello world"
+    options = { :document => @pdf, :character_spacing => 10 }
+    text_box = Prawn::Text::Box.new(string, options)
+    text_box.render
+    contents = PDF::Inspector::Text.analyze(@pdf.render)
+    contents.character_spacing[0].should == 10
+  end
+  it "should take character spacing into account when wrapping" do
+    create_pdf
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new("hello world",
+                                    :width    => 100,
+                                    :overflow => :expand,
+                                    :character_spacing => 10,
+                                    :document => @pdf)
+    text_box.render
+    text_box.text.should == "hello\nworld"
+  end
+end
+  
+describe "Text::Box wrapping" do
+  before(:each) do
+    create_pdf
+  end
+
+  it "should wrap text" do
+    text = "Please wrap this text about HERE. More text that should be wrapped"
+    expect = "Please wrap this text about\nHERE. More text that should be\nwrapped"
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                    :width    => 220,
+                                    :overflow => :expand,
+                                    :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  # white space was being stripped after the entire line was generated, meaning
+  # that leading white space characters reduced the amount of space on the line
+  # for other characters, so wrapping "hello hello" resulted in
+  # "hello\n\nhello", rather than "hello\nhello"
+  #
+  it "white space at beginning of line should not be taken into account when" +
+    " computing line width" do
+    text = "hello hello"
+    expect = "hello\nhello"
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                    :width    => 40,
+                                    :overflow => :expand,
+                                    :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should respect end of line when wrapping text" do
+    text = "Please wrap only before\nTHIS word. Don't wrap this"
+    expect = text
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                          :width    => 220,
+                                          :overflow => :expand,
+                                          :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should respect multiple newlines when wrapping text" do
+    text = "Please wrap only before THIS\n\nword. Don't wrap this"
+    expect= "Please wrap only before\nTHIS\n\nword. Don't wrap this"
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                          :width    => 200,
+                                          :overflow => :expand,
+                                          :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should respect multiple newlines when wrapping text when those newlines coincide with a line break" do
+    text = "Please wrap only before\n\nTHIS word. Don't wrap this"
+    expect = text
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                          :width    => 220,
+                                          :overflow => :expand,
+                                          :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should respect initial newlines" do
+    text = "\nThis should be on line 2"
+    expect = text
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                          :width    => 220,
+                                          :overflow => :expand,
+                                          :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should wrap lines comprised of a single word of the bounds when wrapping text" do
+    text = "You_can_wrap_this_text_HERE"
+    expect = "You_can_wrap_this_text_HE\nRE"
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text,
+                                          :width    => 180,
+                                          :overflow => :expand,
+                                          :document => @pdf)
+    text_box.render
+    text_box.text.should == expect
+  end
+
+  it "should wrap lines comprised of a single word of the bounds when wrapping text" do
+    text = "©" * 30
+
+    @pdf.font "Courier"
+    text_box = Prawn::Text::Box.new(text, :width => 180,
+                                           :overflow => :expand,
+                                           :document => @pdf)
+
+    text_box.render
+
+    expected = "©" * 25 + "\n" + "©" * 5
+    @pdf.font.normalize_encoding!(expected)
+
+    text_box.text.should == expected
+  end
+
+  it "should wrap non-unicode strings using single-byte word-wrapping" do
+    text = "continúa esforzandote " * 5
+    text_box = Prawn::Text::Box.new(text, :width => 180,
+                                     :document => @pdf)
+    text_box.render
+    results_with_accent = text_box.text
+
+    text = "continua esforzandote " * 5
+    text_box = Prawn::Text::Box.new(text, :width => 180,
+                                     :document => @pdf)
+    text_box.render
+    results_without_accent = text_box.text
+
+    results_with_accent.first_line.length.should == results_without_accent.first_line.length
+  end
+  
+end
+
+def reduce_precision(float)
+  ("%.5f" % float).to_f
+end
+
+module TestWrapOverride
+  def wrap(string)
+    @text = nil
+    @line_height = @document.font.height
+    @descender   = @document.font.descender
+    @ascender    = @document.font.ascender
+    @baseline_y  = -@ascender
+    draw_line("all your base are belong to us")
+    ""
+  end
+end