Added #link into text.rb + tests

lib/prawn/text.rb

@@ -149,7 +149,7 @@ module Text
     #
     # Raises <tt>ArgumentError</tt> if <tt>:at</tt> option included
     #
-    # Raises <tt>Prawn::Errrors::CannotFit</tt> if not wide enough to print
+    # Raises <tt>Prawn::Errors::CannotFit</tt> if not wide enough to print
     # any text
     #
     def text(string, options={})
@@ -223,6 +223,29 @@ def formatted_text(array, options={})
       end
     end
 
+    # Draws a link into a page.
+    # With this helper you can add a link to a page without having to use the tag format
+    #
+    # == Example
+    #
+    #   link('Go to the wiki',
+    #           'https://github.com/prawnpdf/prawn/wiki',
+    #           :size => 24,
+    #           :styles => [:bold, :italic])
+    #
+    # == Options
+    #
+    # Accepts the same options as #text
+    #
+    # == Exceptions
+    #
+    # Same as for #text
+    #
+    def link(title, url, options={})
+      return false unless title && url
+      formatted_text([{ :text => title, :link => url }], options)
+    end
+
     # Draws text on the page, beginning at the point specified by the :at option
     # the string is assumed to be pre-formatted to properly fit the page.
     #

spec/text_spec.rb

@@ -340,6 +340,42 @@
     pages[1][:strings].should == ["World"]
   end
 
+  describe "#link" do
+    it 'should generate a clickable link' do
+      link = 'http://example.com'
+      @pdf.link 'Example', link
+      @pdf.render.should =~ /^(\/URI \(#{link}\).*?)/
+    end
+
+    it 'should allow fonts' do
+      link = 'http://example.com'
+      @pdf.fallback_fonts ["Helvetica"]
+
+      @pdf.font "Times-Roman", :style => :italic do
+        @pdf.link 'Example', link
+      end
+
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      fonts_used = text.font_settings.map { |e| e[:name] }
+      fonts_used.length.should == 1
+      fonts_used[0].should == :"Times-Italic"
+      text.strings[0].should == "Example"
+    end
+
+    it 'should accept #text options' do
+      link = 'http://example.com'
+      @pdf.link 'Example', link, :size => 16
+      text = PDF::Inspector::Text.analyze(@pdf.render)
+      text.font_settings[0][:size].should == 16
+    end
+
+    it 'should return false without text or url' do
+      link = 'http://example.com'
+      @pdf.link(nil, link).should == false
+      @pdf.link('Example', nil).should == false
+    end
+  end
+
   describe "with :indent_paragraphs option" do
     it "should indent the paragraphs" do
       hello = "hello " * 50