prawn 0.12.0 → 0.13.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ad2fdbe5f0c7d9075d0a6467217a996304aa4983
+  data.tar.gz: 6db5219bdb341f2c8d36c3cc0aca48720adbdccc
+SHA512:
+  metadata.gz: c2795eaa023f044fdf99b91f79a4e56f181c8dcb13fd73112dcf181156234230117e17221521634c728e60c92a7f05a607f16cec47cd72eff9a77995e91f750f
+  data.tar.gz: cdf2c886e7bea9946289a11fa1f33c4574884ca65d2eebbaec6967016bc31aee008a9048fccecb73756a4950a6b4e686c838ddbf5e3c3c258bd1dd2ed6fea379

data/COPYING

@@ -1,2 +1,2 @@
-Prawn may be used under Matz's terms for Ruby, or GPLv2 or GPLv3. See LICENSE
-for Matz's terms, or GPLv2 and GPLv3 files.
+Prawn may be used under Matz's original licensing terms for Ruby, or GPLv2 or GPLv3. 
+See LICENSE for Matz's terms, or GPLv2 and GPLv3 files.

data/Gemfile

@@ -0,0 +1,18 @@
+source "https://rubygems.org"
+
+gem "ttfunk", "~>1.0.3"
+gem "pdf-reader", "~> 1.2"
+gem "ruby-rc4"
+gem "afm"
+
+group :development do
+  gem "coderay", "~> 1.0.7"
+  gem "rdoc"
+end
+
+group :test do
+  gem "pdf-inspector", "~> 1.1.0", :require => "pdf/inspector"
+  gem "rspec"
+  gem "mocha", :require => false
+  gem "rake"
+end

data/LICENSE

@@ -1,7 +1,7 @@
 Prawn is copyrighted free software produced by Gregory Brown along with 
 community contributions.  See git log for authorship information.
 
-Licensing terms follow (License of Ruby):
+Licensing terms follow:
 
 You can redistribute Prawn and/or modify it under either the terms of the GPLv2
 or GPLv3 (see GPLv2 and GPLv3 files), or the conditions below:

data/README.md

@@ -1,5 +1,7 @@
 # Prawn: Fast, Nimble PDF Generation For Ruby
 
+[![Build Status](https://secure.travis-ci.org/prawnpdf/prawn.png)](http://travis-ci.org/prawnpdf/prawn)
+
 Prawn is a pure Ruby PDF generation library that provides a lot of great functionality while trying to remain simple and reasonably performant. Here are some of the important features we provide:
 
 * Vector drawing support, including lines, polygons, curves, ellipses, etc.
@@ -23,7 +25,7 @@ One thing Prawn is not, and will never be, is an HTML to PDF generator. For thos
 
 ## Supported Ruby Versions and Implementations
 
-Because Prawn is pure Ruby and virtually all of its dependencies are maintained by our core team, it should run pretty much anywhere, including Rubinius, JRuby, MacRuby, etc. While we officially support MRI 1.8.7 and 1.9.2 only, we will accept patches to fix problems on other Ruby platforms if they aren't too invasive.
+Because Prawn is pure Ruby and virtually all of its dependencies are maintained by our core team, it should run pretty much anywhere, including Rubinius, JRuby, MacRuby, etc. We officially support MRI {1.9.3 and 2.0.0} and jruby 1.7.x in 1.9 mode, however we will accept patches to fix problems on other Ruby platforms if they aren't too invasive.
 
 ## Installing Prawn
 
@@ -33,7 +35,7 @@ You can also install from git if you'd like, the _master_ branch contains the la
 
 ## Release Policies
 
-We may introduce backwards incompatible changes each time our minor version number is bumped, but that any tiny version number bump should be bug fixes and internal changes only. Be sure to read the release notes each time we cut a new release and lock your gems accordingly. You can find the project CHANGELOG at: https://github.com/sandal/prawn/wiki/CHANGELOG
+We may introduce backwards incompatible changes each time our minor version number is bumped, but that any tiny version number bump should be bug fixes and internal changes only. Be sure to read the release notes each time we cut a new release and lock your gems accordingly. You can find the project CHANGELOG at: https://github.com/prawnpdf/prawn/wiki/CHANGELOG
 
 ## Hello World!
 
@@ -73,12 +75,23 @@ Please make your posts to the list as specific as possible, including code sampl
 
 If you've found a bug, want to submit a patch, or have a feature request, please enter a ticket into our github tracker:
 
-<http://github.com/sandal/prawn/issues>
+<http://github.com/prawnpdf/prawn/issues>
 
 We strongly encourage bug reports to come with failing tests or at least a reduced example that demonstrates the problem. Similarly, patches should include tests, API documentation, and an update to the manual where relevant. Feel free to send a pull request early though, if you just want some feedback or a code review before preparing your code to be merged.
 
 If you are unsure about whether or not you've found a bug, or want to check to see whether we'd be interested in the feature you want to add before you start working on it, feel free to post to our mailing list.
 
+You can run our test suite in a few different ways:
+
+1. Running `rake` will run the entire test suite excluding any unresolved issues
+2. Running `rspec` will run the entire test suite including unresolved issues
+3. Running `rspec -t unresolved` will run *only* unresolved issues
+4. Running `rspec -t issue:NUMBER` will run the tests for a specific issue
+
+These filters make it possible for us to add failing test cases for bugs that
+are currently being researched or worked on, without breaking the typical
+full suite run.
+
 ## Authorship
 
 Prawn was originally developed by Gregory Brown, under the auspices of the Ruby Mendicant Project, a grassroots initiative in which the Ruby community collectively provided funding so that Gregory could take several months off of work to focus on this project.
@@ -87,7 +100,7 @@ Over the last several years, we've received code contributions from over 50 peop
 
 While he was only with us for a short time before moving on to other things, we'd also like to thank Prawn core team emeritus Jamis Buck for his contributions. He was responsible for introducing font subsetting as well as the first implementation of our inline formatting support.
 
-You can find the full list of folks who have at least one patch accepted to Prawn on github at https://github.com/sandal/prawn/contributors
+You can find the full list of folks who have at least one patch accepted to Prawn on github at https://github.com/prawnpdf/prawn/contributors
 
 ## License
 

data/Rakefile

@@ -1,37 +1,33 @@
-require "rubygems"
 require "bundler"
 Bundler.setup
 
 require 'rake'
-require 'rake/testtask'
-require "rake/rdoctask"
-require "rake/gempackagetask"  
+require 'rspec/core/rake_task'
+require 'rdoc/task'
+require 'rubygems/package_task'
 
-task :default => [:test]
-       
-desc "Run all tests, test-spec, mocha, and pdf-reader required"
-Rake::TestTask.new do |test|
-  # test.ruby_opts  << "-w"  # .should == true triggers a lot of warnings
-  test.libs       << "spec"
-  test.test_files =  Dir[ "spec/*_spec.rb" ]
-  test.verbose    =  true
+task :default => [:spec]
+
+desc "Run all rspec files"
+RSpec::Core::RakeTask.new("spec") do |c|
+  c.rspec_opts = "-t ~unresolved"
 end
 
 desc "Show library's code statistics"
 task :stats do
-	require 'code_statistics'
-  CodeStatistics::TEST_TYPES << "Specs"	
-	CodeStatistics.new( ["Prawn", "lib"], 
-	                    ["Specs", "spec"] ).to_s
+  require 'code_statistics'
+  CodeStatistics::TEST_TYPES << "Specs"
+  CodeStatistics.new( ["Prawn", "lib"],
+                      ["Specs", "spec"] ).to_s
 end
 
 desc "genrates documentation"
-Rake::RDocTask.new do |rdoc|
-  rdoc.rdoc_files.include( "README",
+RDoc::Task.new do |rdoc|
+  rdoc.rdoc_files.include( "README.md",
                            "COPYING",
-                           "LICENSE", 
-                           "HACKING", "lib/" )
-  rdoc.main     = "README"
+                           "LICENSE",
+                           "lib/" )
+  rdoc.main     = "README.md"
   rdoc.rdoc_dir = "doc/html"
   rdoc.title    = "Prawn Documentation"
 end
@@ -45,7 +41,7 @@ task :manual do
 end
 
 spec = Gem::Specification.load "prawn.gemspec"
-Rake::GemPackageTask.new(spec) do |pkg|
+Gem::PackageTask.new(spec) do |pkg|
   pkg.need_zip = true
   pkg.need_tar = true
 end

data/data/pdfs/nested_pages.pdf

@@ -49,7 +49,7 @@ endobj
 >>
 /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
 >>
-/Parent 4 0 R
+/Parent 3 0 R
 >>
 endobj
 7 0 obj
@@ -85,7 +85,7 @@ endobj
 >>
 /ProcSet [/PDF /Text /ImageB /ImageC /ImageI]
 >>
-/Parent 4 0 R
+/Parent 3 0 R
 >>
 endobj
 10 0 obj
@@ -97,17 +97,17 @@ endobj
 endobj
 xref
 0 11
-0000000000 65535 f 
-0000000015 00000 n 
-0000000071 00000 n 
-0000000120 00000 n 
-0000000183 00000 n 
-0000000240 00000 n 
-0000000494 00000 n 
-0000000672 00000 n 
-0000000769 00000 n 
-0000000994 00000 n 
-0000001173 00000 n 
+0000000000 65535 f
+0000000015 00000 n
+0000000071 00000 n
+0000000120 00000 n
+0000000183 00000 n
+0000000240 00000 n
+0000000494 00000 n
+0000000672 00000 n
+0000000769 00000 n
+0000000994 00000 n
+0000001173 00000 n
 trailer
 << /Root 2 0 R
 /Size 11

data/lib/pdf/core.rb

@@ -0,0 +1,35 @@
+require_relative "core/pdf_object"
+require_relative "core/annotations"
+require_relative "core/byte_string"
+require_relative "core/destinations"
+require_relative "core/filters"
+require_relative "core/stream"
+require_relative "core/reference"
+require_relative "core/literal_string"
+require_relative "core/filter_list"
+require_relative "core/page"
+require_relative "core/object_store"
+require_relative "core/document_state"
+require_relative "core/name_tree"
+require_relative "core/graphics_state"
+require_relative "core/page_geometry"
+require_relative "core/outline"
+
+module PDF
+  module Core
+    module Errors
+      # This error is raised when PdfObject() fails
+      FailedObjectConversion = Class.new(StandardError)
+
+      # This error is raised when object store fails to load a template file
+      TemplateError = Class.new(StandardError)
+
+      # This error is raise when trying to restore a graphic state that
+      EmptyGraphicStateStack = Class.new(StandardError)
+
+      # This error is raised when Document#page_layout is set to anything
+      # other than :portrait or :landscape
+      InvalidPageLayout = Class.new(StandardError)
+    end
+  end
+end

data/lib/{prawn → pdf}/core/annotations.rb

@@ -6,13 +6,12 @@
 #
 # This is free software. Please see the LICENSE and COPYING files for details.
 #
-module Prawn
-  module Core 
-    
-    # Provides very low-level support for annotations. 
+module PDF
+  module Core
+    # Provides very low-level support for annotations.
     #
     module Annotations #:nodoc:
-      
+
       # Adds a new annotation (section 8.4 in PDF spec) to the current page.
       # +options+ must be a Hash describing the annotation.
       #
@@ -50,12 +49,12 @@ module Prawn
         options = options.merge(:Type => :Annot)
 
         if options[:Dest].is_a?(String)
-          options[:Dest] = Prawn::Core::LiteralString.new(options[:Dest])
+          options[:Dest] = PDF::Core::LiteralString.new(options[:Dest])
         end
 
         options
       end
-      
+
     end
   end
 end

data/lib/{prawn → pdf}/core/byte_string.rb

@@ -1,5 +1,5 @@
 # encoding: utf-8
-module Prawn
+module PDF 
   module Core
     # This is used to differentiate strings that must be encoded as
     # a byte string, such as binary data from encrypted strings.

data/lib/{prawn → pdf}/core/destinations.rb

@@ -1,89 +1,89 @@
 # encoding: utf-8
 
-# prawn/core/destinations.rb : Implements destination support for PDF
+# Implements destination support for PDF
 #
 # Copyright November 2008, Jamis Buck. All Rights Reserved.
 #
 # This is free software. Please see the LICENSE and COPYING files for details.
 
-module Prawn
+module PDF
   module Core
     module Destinations #:nodoc:
-      
+
       # The maximum number of children to fit into a single node in the Dests tree.
       NAME_TREE_CHILDREN_LIMIT = 20 #:nodoc:
-      
+
       # The Dests name tree in the Name dictionary (see Prawn::Document::Internal#names).
       # This name tree is used to store named destinations (PDF spec 8.2.1).
       # (For more on name trees, see section 3.8.4 in the PDF spec.)
       #
       def dests
-        names.data[:Dests] ||= ref!(Prawn::Core::NameTree::Node.new(self, NAME_TREE_CHILDREN_LIMIT))
+        names.data[:Dests] ||= ref!(PDF::Core::NameTree::Node.new(self, NAME_TREE_CHILDREN_LIMIT))
       end
 
       # Adds a new destination to the dests name tree (see #dests). The
-      # +reference+ parameter will be converted into a Prawn::Reference if
+      # +reference+ parameter will be converted into a PDF::Core::Reference if
       # it is not already one.
       #
       def add_dest(name, reference)
-        reference = ref!(reference) unless reference.is_a?(Prawn::Core::Reference)
+        reference = ref!(reference) unless reference.is_a?(PDF::Core::Reference)
         dests.data.add(name, reference)
       end
 
       # Return a Dest specification for a specific location (and optional zoom
       # level).
       #
-      def dest_xyz(left, top, zoom=nil, page=current_page)
-        [page, :XYZ, left, top, zoom]
+      def dest_xyz(left, top, zoom=nil, dest_page=page)
+        [dest_page.dictionary, :XYZ, left, top, zoom]
       end
 
       # Return a Dest specification that will fit the given page into the
       # viewport.
       #
-      def dest_fit(page=current_page)
-        [page, :Fit]
+      def dest_fit(dest_page=page)
+        [dest_page.dictionary, :Fit]
       end
 
       # Return a Dest specification that will fit the given page horizontally
       # into the viewport, aligned vertically at the given top coordinate.
       #
-      def dest_fit_horizontally(top, page=current_page)
-        [page, :FitH, top]
+      def dest_fit_horizontally(top, dest_page=page)
+        [dest_page.dictionary, :FitH, top]
       end
 
       # Return a Dest specification that will fit the given page vertically
       # into the viewport, aligned horizontally at the given left coordinate.
       #
-      def dest_fit_vertically(left, page=current_page)
-        [page, :FitV, left]
+      def dest_fit_vertically(left, dest_page=page)
+        [dest_page.dictionary, :FitV, left]
       end
 
       # Return a Dest specification that will fit the given rectangle into the
       # viewport, for the given page.
       #
-      def dest_fit_rect(left, bottom, right, top, page=current_page)
-        [page, :FitR, left, bottom, right, top]
+      def dest_fit_rect(left, bottom, right, top, dest_page=page)
+        [dest_page.dictionary, :FitR, left, bottom, right, top]
       end
 
       # Return a Dest specfication that will fit the given page's bounding box
       # into the viewport.
       #
-      def dest_fit_bounds(page=current_page)
-        [page, :FitB]
+      def dest_fit_bounds(dest_page=page)
+        [dest_page.dictionary, :FitB]
       end
 
       # Same as #dest_fit_horizontally, but works on the page's bounding box
       # instead of the entire page.
       #
-      def dest_fit_bounds_horizontally(top, page=current_page)
-        [page, :FitBH, top]
+      def dest_fit_bounds_horizontally(top, dest_page=page)
+        [dest_page.dictionary, :FitBH, top]
       end
 
       # Same as #dest_fit_vertically, but works on the page's bounding box
       # instead of the entire page.
       #
-      def dest_fit_bounds_vertically(left, page=current_page)
-        [page, :FitBV, left]
+      def dest_fit_bounds_vertically(left, dest_page=page)
+        [dest_page.dictionary, :FitBV, left]
       end
     end
   end

data/lib/{prawn → pdf}/core/document_state.rb

@@ -1,13 +1,14 @@
-module Prawn
+module PDF
   module Core
     class DocumentState #:nodoc:
       def initialize(options)
         normalize_metadata(options)
 
         if options[:template]
-          @store = Prawn::Core::ObjectStore.new(:template => options[:template])
+          @store = PDF::Core::ObjectStore.new(:template => options[:template])
+          @store.info.data.merge!(options[:info]) if options[:info]
         else
-          @store = Prawn::Core::ObjectStore.new(:info => options[:info])
+          @store = PDF::Core::ObjectStore.new(:info => options[:info])
         end
 
         @version                 = 1.3
@@ -33,7 +34,7 @@ module Prawn
         count = (1..@store.page_count)
         @pages = count.map do |index|
           orig_dict_id = @store.object_id_for_page(index)
-          Prawn::Core::Page.new(document, :object_id => orig_dict_id)
+          PDF::Core::Page.new(document, :object_id => orig_dict_id)
         end
 
       end
@@ -41,9 +42,9 @@ module Prawn
       def normalize_metadata(options)
         options[:info] ||= {}
         options[:info][:Creator] ||= "Prawn"
-        options[:info][:Producer] = "Prawn"
+        options[:info][:Producer] ||= "Prawn"
 
-        info = options[:info]
+        options[:info]
       end
 
       def insert_page(page, page_number)
@@ -68,11 +69,10 @@ module Prawn
         store.compact if optimize_objects
         store.each do |ref|
           ref.offset = output.size
-          output << (@encrypt ? ref.encrypted_object(@encryption_key) : 
+          output << (@encrypt ? ref.encrypted_object(@encryption_key) :
                                 ref.object)
         end
       end
-
     end
   end
 end