pdf-wrapper 0.4.1 → 0.4.4

data/{specs → spec}/text_spec.rb

@@ -6,12 +6,12 @@ describe PDF::Wrapper do
 
   before(:each) { create_pdf }
 
-  specify "should be able to permanantly change the font size" do
+  it "should be able to permanantly change the font size" do
     @pdf.font_size 20
     @pdf.instance_variable_get("@default_font_size").should eql(20)
   end
 
-  specify "should be able to temporarily change the font size" do
+  it "should be able to temporarily change the font size" do
     @pdf.font_size 20
     @pdf.instance_variable_get("@default_font_size").should eql(20)
     @pdf.font_size(10) do
@@ -20,7 +20,7 @@ describe PDF::Wrapper do
     @pdf.instance_variable_get("@default_font_size").should eql(20)
   end
 
-  specify "should be able to add ascii text to the canvas" do
+  it "should be able to add ascii text to the canvas" do
     msg = "Chunky Bacon"
     @pdf.text msg
     @pdf.finish
@@ -32,7 +32,7 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should be able to add unicode text to the canvas" do
+  it "should be able to add unicode text to the canvas" do
     msg = "Alex Čihař"
     @pdf.text msg
     @pdf.finish
@@ -44,7 +44,7 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should be able to add unicode text that spans multiple pages to the canvas" do
+  it "should be able to add unicode text that spans multiple pages to the canvas" do
     msg = "James\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nHealy"
     @pdf.text msg
     @pdf.finish
@@ -57,7 +57,7 @@ describe PDF::Wrapper do
     receiver.content[1].should eql("Healy")
   end
 
-  specify "should be align text on the left when using the text method" do
+  it "should be align text on the left when using the text method" do
     msg = "Chunky Bacon"
     @pdf.text msg, :alignment => :left
     @pdf.finish
@@ -70,7 +70,7 @@ describe PDF::Wrapper do
     params[4].should eql(@pdf.margin_left)
   end
 
-  specify "should be able to align text on the left when using the text method" do
+  it "should be able to align text on the left when using the text method" do
     msg = "Chunky Bacon"
     @pdf.text msg, :alignment => :left
     @pdf.finish
@@ -83,7 +83,7 @@ describe PDF::Wrapper do
     params[4].should eql(@pdf.margin_left)
   end
 
-  specify "should be able to align text in the centre when using the text method" do
+  it "should be able to align text in the centre when using the text method" do
     msg = "Chunky Bacon"
     @pdf.text msg, :alignment => :center
     @pdf.finish
@@ -98,7 +98,7 @@ describe PDF::Wrapper do
     (params[4] > @pdf.absolute_x_middle - 100).should be_true
   end
 
-  specify "should be able to align text on the right when using the text method" do
+  it "should be able to align text on the right when using the text method" do
     msg = "Chunky Bacon"
     @pdf.text msg, :alignment => :right
     @pdf.finish
@@ -113,12 +113,12 @@ describe PDF::Wrapper do
     (params[4] < @pdf.absolute_right_margin).should be_true
   end
 
-  specify "should raise an error when an invalid alignment is specified" do
+  it "should raise an error when an invalid alignment is specified" do
     msg = "James Healy"
     lambda { @pdf.text msg, :alignment => :ponies }.should raise_error(ArgumentError)
   end
 
-  specify "should be able to add text to the canvas in a bounding box using the cell method" do
+  it "should be able to add text to the canvas in a bounding box using the cell method" do
     msg = "Alex Čihař"
     @pdf.cell msg, 100, 100, 200, 200
     @pdf.finish
@@ -130,7 +130,7 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should keep all text for a cell inside the cell boundaries" do
+  it "should keep all text for a cell inside the cell boundaries" do
     msg = "This is a text cell, added by James"
     x = y = 100
     w = h = 200
@@ -156,13 +156,13 @@ describe PDF::Wrapper do
     end
   end
 
-  specify "should be able to calculate the height of a string of text" do
+  it "should be able to calculate the height of a string of text" do
     str   = "This is a medium length string\nthat is also multi line. one two three four."
     opts = {:font_size => 16, :font => "Sans Serif", :alignment => :left, :justify => false }
     @pdf.text_height(str, @pdf.body_width, opts).should eql(49)
   end
 
-  specify "should be able to calculate the width of a string of text" do
+  it "should be able to calculate the width of a string of text" do
     str  = "James Healy"
     str2 = "James Healy is a Ruby dev that lives in Melbourne, Australia. His day job mostly involved Ruby on Rails."
     opts = {:font_size => 16, :font => "Sans Serif"}
@@ -172,12 +172,12 @@ describe PDF::Wrapper do
     (@pdf.text_width(str2, opts) <= 1107).should be_true
   end
 
-  specify "should raise an exception if build_pango_layout is passed anything other than a string" do
+  it "should raise an exception if build_pango_layout is passed anything other than a string" do
     lambda { @pdf.build_pango_layout(10) }.should raise_error(ArgumentError)
   end
 
   if RUBY_VERSION >= "1.9"
-    specify "should accept non UTF-8 strings to build_pango_layout and convert them on the fly" do
+    it "should accept non UTF-8 strings to build_pango_layout and convert them on the fly" do
 
       # all three of these files have the same content, but in different encodings
       iso2022_str  = File.open(File.dirname(__FILE__) + "/data/shift_jis.txt", "r:ISO-2022-JP") { |f| f.read }.strip!
@@ -191,10 +191,10 @@ describe PDF::Wrapper do
       #       passed in the non UTF-8 strings, then all worked fine. yuck.
     end
 
-    specify "should raise an error when a string that isn't convertable to UTF-8 is passed into build_pango_layout()"
+    it "should raise an error when a string that isn't convertable to UTF-8 is passed into build_pango_layout()"
   end
 
-  specify "should accept and render pango markup correctly" do
+  it "should accept and render pango markup correctly" do
     msg = "<b>James</b>"
     @pdf.text msg, :markup => :pango
     @pdf.finish
@@ -206,7 +206,7 @@ describe PDF::Wrapper do
     page_one.should eql("James")
   end
 
-  specify "should be able to alle to wrap text on word boundaries" do
+  it "should be able to alle to wrap text on word boundaries" do
     msg = "James Healy"
     @pdf.text msg, :wrap => :word
     @pdf.finish
@@ -218,7 +218,7 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should be able to able to wrap text on char boundaries" do
+  it "should be able to able to wrap text on char boundaries" do
     msg = "James Healy"
     @pdf.text msg, :wrap => :char
     @pdf.finish
@@ -230,7 +230,7 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should be able to wrap text on word and char boundaries" do
+  it "should be able to wrap text on word and char boundaries" do
     msg = "James Healy"
     @pdf.text msg, :wrap => :wordchar
     @pdf.finish
@@ -242,12 +242,12 @@ describe PDF::Wrapper do
     receiver.content.first.should eql(msg)
   end
 
-  specify "should raise an error when an invalid wrapping technique is specified" do
+  it "should raise an error when an invalid wrapping technique is specified" do
     msg = "James Healy"
     lambda { @pdf.text msg, :wrap => :ponies }.should raise_error(ArgumentError)
   end
 
-  specify "should determine the largest font size possible that will fit some text in a cell" do
+  it "should determine the largest font size possible that will fit some text in a cell" do
     @pdf.__send__(:best_font_size, "Hello There", 34, 50, 5..9).should eql(9)
     @pdf.__send__(:best_font_size, "<b>Hello There</b>", 34, 50, 5..9, :markup => :pango).should eql(8)
     @pdf.__send__(:best_font_size, "Hello There", 5, 50, 5..9).should eql(5)

data/{specs → spec}/wrapper_spec.rb

@@ -2,81 +2,81 @@
 
 require 'spec_helper'
 
-context "The PDF::Wrapper class" do
+describe "The PDF::Wrapper class" do
 
   before(:each) { create_pdf }
 
-  specify "should initilize with the correct default paper size and orientation" do
+  it "should initilize with the correct default paper size and orientation" do
     @pdf.page_width.should eql(PDF::Wrapper::PAGE_SIZES[:A4].first)
     @pdf.page_height.should eql(PDF::Wrapper::PAGE_SIZES[:A4].last)
   end
 
-  specify "should initilize with the correct custom paper size" do
+  it "should initilize with the correct custom paper size" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A0)
     pdf.page_width.should eql(PDF::Wrapper::PAGE_SIZES[:A0].first)
     pdf.page_height.should eql(PDF::Wrapper::PAGE_SIZES[:A0].last)
   end
 
-  specify "should initilize with the correct manual paper size" do
+  it "should initilize with the correct manual paper size" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => [100, 1000])
     pdf.page_width.to_i.should eql(100)
     pdf.page_height.to_i.should eql(1000)
   end
 
-  specify "should initilize with the correct custom orientation" do
+  it "should initilize with the correct custom orientation" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :orientation => :landscape)
     pdf.page_width.should eql(PDF::Wrapper::PAGE_SIZES[:A4].last)
     pdf.page_height.should eql(PDF::Wrapper::PAGE_SIZES[:A4].first)
   end
 
-  specify "should raise an exception if an invalid orientation is requested" do
+  it "should raise an exception if an invalid orientation is requested" do
     output = StringIO.new
     lambda {pdf = PDF::Wrapper.new(output, :paper => :A4, :orientation => :fake)}.should raise_error(ArgumentError)
   end
 
-  specify "should store sensible default text options" do
+  it "should store sensible default text options" do
     @pdf.default_text_options.should be_a_kind_of(Hash)
   end
 
-  specify "should initilize with the correct default margins (5% of the page)" do
+  it "should initilize with the correct default margins (5% of the page)" do
     @pdf.margin_left.should eql((PDF::Wrapper::PAGE_SIZES[:A4].first * 0.05).ceil)
     @pdf.margin_right.should eql((PDF::Wrapper::PAGE_SIZES[:A4].first * 0.05).ceil)
     @pdf.margin_top.should eql((PDF::Wrapper::PAGE_SIZES[:A4].last * 0.05).ceil)
     @pdf.margin_bottom.should eql((PDF::Wrapper::PAGE_SIZES[:A4].last * 0.05).ceil)
   end
 
-  specify "should initilize with the correct default text and colour settings" do
+  it "should initilize with the correct default text and colour settings" do
     @pdf.instance_variable_get("@default_font").should eql("Sans Serif")
     @pdf.instance_variable_get("@default_font_size").should eql(16)
   end
 
-  specify "should be able to change the default font" do
+  it "should be able to change the default font" do
     @pdf.font("Arial")
     @pdf.instance_variable_get("@default_font").should eql("Arial")
   end
 
-  specify "should be able to change the default font size" do
+  it "should be able to change the default font size" do
     @pdf.font_size(24)
     @pdf.instance_variable_get("@default_font_size").should eql(24)
   end
 
-  specify "should initialize with the cursor at the top left of the body of the page" do
+  it "should initialize with the cursor at the top left of the body of the page" do
     x,y = @pdf.current_point
     x.to_i.should eql(@pdf.margin_left)
     y.to_i.should eql(@pdf.margin_top)
   end
 
-  specify "should calculate the absolute coordinates for the margins correctly" do
+  it "should calculate the absolute coordinates for the margins correctly" do
     @pdf.absolute_left_margin.should eql(@pdf.margin_left)
     @pdf.absolute_right_margin.should eql(@pdf.page_width - @pdf.margin_right)
     @pdf.absolute_top_margin.should eql(@pdf.margin_top)
     @pdf.absolute_bottom_margin.should eql(@pdf.page_height - @pdf.margin_bottom)
   end
 
-  specify "should calculate various useful page coordinates correctly" do
+  it "should calculate various useful page coordinates correctly" do
     @pdf.absolute_x_middle.should eql(PDF::Wrapper::PAGE_SIZES[:A4].first / 2)
     @pdf.absolute_y_middle.should eql(PDF::Wrapper::PAGE_SIZES[:A4].last / 2)
     @pdf.body_width.should eql(@pdf.page_width - @pdf.margin_left - @pdf.margin_right)
@@ -87,14 +87,14 @@ context "The PDF::Wrapper class" do
     @pdf.points_to_right_margin(300).should eql(@pdf.absolute_right_margin - 300)
   end
 
-  specify "should be able to move the cursor to any arbitary point on the canvas" do
+  it "should be able to move the cursor to any arbitary point on the canvas" do
     @pdf.move_to(100,100)
     x,y = @pdf.current_point
     x.to_i.should eql(100)
     y.to_i.should eql(100)
   end
 
-  specify "should be able to shift the y position of the cursor using pad" do
+  it "should be able to shift the y position of the cursor using pad" do
     @pdf.move_to(100,100)
     newy = @pdf.pad(25)
     x,y = @pdf.current_point
@@ -103,7 +103,7 @@ context "The PDF::Wrapper class" do
     newy.should eql(125.0)
   end
 
-  specify "should add additional pages at the users request" do
+  it "should add additional pages at the users request" do
     @pdf.move_to(100,100)
     @pdf.start_new_page
     x,y = @pdf.current_point
@@ -118,7 +118,7 @@ context "The PDF::Wrapper class" do
   end
 
 
-  specify "should leave the cursor in the bottom left of a layout when new text is added" do
+  it "should leave the cursor in the bottom left of a layout when new text is added" do
     x, y = @pdf.current_point
     str = "Chunky Bacon!!"
     opts = {:font_size => 16, :font => "Sans Serif", :alignment => :left, :justify => false }
@@ -131,7 +131,7 @@ context "The PDF::Wrapper class" do
     newy.should eql(y + height)
   end
 
-  specify "should be able to render to a file" do
+  it "should be able to render to a file" do
     # generate a PDF
     msg = "Chunky Bacon"
 
@@ -152,7 +152,7 @@ context "The PDF::Wrapper class" do
     tmp.unlink
   end
 
-  specify "should be able to determine if a requested colour is valid or not" do
+  it "should be able to determine if a requested colour is valid or not" do
     @pdf.validate_color(:black).should be_true
     @pdf.validate_color([1,0,0]).should be_true
     @pdf.validate_color([1,0,0,0.5]).should be_true
@@ -161,7 +161,7 @@ context "The PDF::Wrapper class" do
     lambda { @pdf.validate_color([1000, 255, 0])}.should raise_error(ArgumentError)
   end
 
-  specify "should be able to add repeating elements to :all pages" do
+  it "should be able to add repeating elements to :all pages" do
     test_str = "repeating"
 
     @pdf.repeating_element(:all) { |page| page.text test_str }
@@ -181,7 +181,7 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql(test_str)
   end
 
-  specify "should be able to add repeating elements to :odd pages" do
+  it "should be able to add repeating elements to :odd pages" do
     test_str = "repeating"
 
     @pdf.repeating_element(:odd) { |page| page.text test_str }
@@ -201,7 +201,7 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql("")
   end
 
-  specify "should be able to add repeating elements to :even pages" do
+  it "should be able to add repeating elements to :even pages" do
     test_str = "repeating"
 
     @pdf.repeating_element(:even) { |page| page.text test_str }
@@ -221,7 +221,7 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql(test_str)
   end
 
-  specify "should be able to add repeating elements to a range of pages" do
+  it "should be able to add repeating elements to a range of pages" do
     test_str = "repeating"
 
     @pdf.repeating_element((2..3)) { |page| page.text test_str }
@@ -241,7 +241,7 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql("")
   end
 
-  specify "should be able to add repeating elements to a single page" do
+  it "should be able to add repeating elements to a single page" do
     test_str = "repeating"
 
     @pdf.repeating_element(2) { |page| page.text test_str }
@@ -261,7 +261,7 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql("")
   end
 
-  specify "should be able to add repeating elements to an array of pages" do
+  it "should be able to add repeating elements to an array of pages" do
     test_str = "repeating"
 
     @pdf.repeating_element([1,3,4]) { |page| page.text test_str }
@@ -281,9 +281,9 @@ context "The PDF::Wrapper class" do
     receiver.content[3].should eql(test_str)
   end
 
-  specify "should not change the state of the cairo canvas or PDF::Writer defaults (fonts, colors, etc) when adding repeating elements"
+  it "should not change the state of the cairo canvas or PDF::Writer defaults (fonts, colors, etc) when adding repeating elements"
   
-  specify "should not allow a new page to be started while adding repeating elements" do
+  it "should not allow a new page to be started while adding repeating elements" do
     test_str = "repeating"
 
     lambda do
@@ -295,7 +295,7 @@ context "The PDF::Wrapper class" do
 
   end
 
-  specify "should leave the cursor on the bottom left corner of an object when using functions with optional positioning [func(data, opts)]" do
+  it "should leave the cursor on the bottom left corner of an object when using functions with optional positioning [func(data, opts)]" do
     origx, origy = @pdf.current_point
 
     # text()
@@ -332,7 +332,7 @@ context "The PDF::Wrapper class" do
     y.should eql(origy + 100)
   end
 
-  specify "should leave the cursor unmodified when using functions with compulsory positioning [func(data, x, y, w, h, opts)]" do
+  it "should leave the cursor unmodified when using functions with compulsory positioning [func(data, x, y, w, h, opts)]" do
     origx, origy = @pdf.current_point
 
     # cell()
@@ -360,7 +360,7 @@ context "The PDF::Wrapper class" do
     y.should eql(origy)
   end
 
-  specify "should maintain an internal counter of pages" do
+  it "should maintain an internal counter of pages" do
     @pdf.page.should eql(1)
     @pdf.start_new_page
     @pdf.page.should eql(2)
@@ -368,7 +368,7 @@ context "The PDF::Wrapper class" do
     @pdf.page.should eql(50)
   end
 
-  specify "should raise an ArgumentError when a function that accepts an options hash is passed an unrecognised option" do
+  it "should raise an ArgumentError when a function that accepts an options hash is passed an unrecognised option" do
     output = StringIO.new
     lambda { PDF::Wrapper.new(output, :ponies => true)}.should raise_error(ArgumentError)
     lambda { @pdf.cell("test",100,100,100,100, :ponies => true)}.should raise_error(ArgumentError)
@@ -383,7 +383,7 @@ context "The PDF::Wrapper class" do
     lambda { @pdf.image(File.dirname(__FILE__) + "/data/orc.svg", :ponies => true)}.should raise_error(ArgumentError)
   end
 
-  specify "should allow an existing file to be used as a template for page 1" do
+  it "should allow an existing file to be used as a template for page 1" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :template => File.dirname(__FILE__) + "/data/orc.svg")
     pdf.start_new_page
@@ -396,7 +396,7 @@ context "The PDF::Wrapper class" do
     receiver.pages[1].should eql([0, 0, 595.28, 841.89])
   end
 
-  specify "should allow an existing file to be used as a template for page 2" do
+  it "should allow an existing file to be used as a template for page 2" do
     @pdf.start_new_page(:template => File.dirname(__FILE__) + "/data/orc.svg")
     @pdf.finish
 
@@ -407,7 +407,7 @@ context "The PDF::Wrapper class" do
     receiver.pages[1].should eql([0, 0, 734, 772])
   end
 
-  specify "should correctly convert a user x co-ordinate to device" do
+  it "should correctly convert a user x co-ordinate to device" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :margin_left => 40)
 
@@ -420,7 +420,7 @@ context "The PDF::Wrapper class" do
     end
   end
 
-  specify "should correctly convert a user y co-ordinate to device" do
+  it "should correctly convert a user y co-ordinate to device" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :margin_top => 40)
 
@@ -433,7 +433,7 @@ context "The PDF::Wrapper class" do
     end
   end
 
-  specify "should correctly convert a device x co-ordinate to user" do
+  it "should correctly convert a device x co-ordinate to user" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :margin_left => 40)
 
@@ -445,7 +445,7 @@ context "The PDF::Wrapper class" do
     end
   end
 
-  specify "should correctly convert a device y co-ordinate to user" do
+  it "should correctly convert a device y co-ordinate to user" do
     output = StringIO.new
     pdf = PDF::Wrapper.new(output, :paper => :A4, :margin_top => 40)
 
@@ -457,7 +457,7 @@ context "The PDF::Wrapper class" do
     end
   end
 
-  specify "should be aware of when the underlying PDFSurface has been finished" do
+  it "should be aware of when the underlying PDFSurface has been finished" do
     @pdf.text "Hi!"
     @pdf.finished?.should be_false
     @pdf.finish