pdf-reader 0.9.3 → 0.10.0

data/CHANGELOG

@@ -1,3 +1,7 @@
+v0.9.4 (XXX)
+- support multiple receivers within a single pass over a source file
+  - massive time saving when dealing with multiple receivers
+
 v0.9.3 (2nd July 2011)
 - add PDF::Reader::Reference#hash method
   - improves behaviour of Reference objects when tehy're used as Hash keys

data/lib/pdf/reader.rb

@@ -73,21 +73,32 @@ module PDF
   #   :pages
   #   :raw_text
   #
+  # = Processing with multiple receivers
+  #
+  # If you wish to parse a PDF file with multiple simultaneous receivers, just
+  # pass an array of receivers as the second argument:
+  #
+  #   pdf = PDF::Reader.new
+  #   pdf.parse(File.new("somefile.pdf"), [receiver_one, receiever_two])
+  #
+  # This saves a significant amount of time by limiting the work to a single pass
+  # over the source file.
+  #
   class Reader
 
     # Parse the file with the given name, sending events to the given receiver.
     #
-    def self.file(name, receiver, opts = {})
+    def self.file(name, receivers, opts = {})
       File.open(name,"rb") do |f|
-        new.parse(f, receiver, opts)
+        new.parse(f, receivers, opts)
       end
     end
 
     # Parse the given string, sending events to the given receiver.
     #
-    def self.string(str, receiver, opts = {})
+    def self.string(str, receivers, opts = {})
       StringIO.open(str) do |s|
-        new.parse(s, receiver, opts)
+        new.parse(s, receivers, opts)
       end
     end
 
@@ -111,7 +122,7 @@ module PDF
 
     # Given an IO object that contains PDF data, parse it.
     #
-    def parse(io, receiver, opts = {})
+    def parse(io, receivers, opts = {})
       ohash    = ObjectHash.new(io)
 
       if ohash.trailer[:Encrypt]
@@ -122,7 +133,7 @@ module PDF
       options.merge!(opts)
 
       strategies.each do |s|
-        s.new(ohash, receiver, options).process
+        s.new(ohash, receivers, options).process
       end
 
       self

data/lib/pdf/reader/abstract_strategy.rb

@@ -4,8 +4,13 @@ class PDF::Reader
 
   class AbstractStrategy # :nodoc:
 
-    def initialize(ohash, receiver, options = {})
-      @ohash, @receiver, @options = ohash, receiver, options
+    def initialize(ohash, receivers, options = {})
+      @ohash, @options = ohash, options
+      if receivers.is_a?(Array)
+        @receivers = receivers
+      else
+        @receivers = [receivers]
+      end
     end
 
     private
@@ -17,7 +22,9 @@ class PDF::Reader
     # calls the name callback method on the receiver class with params as the arguments
     #
     def callback (name, params=[])
-      receiver.send(name, *params) if receiver.respond_to?(name)
+      @receivers.each do |receiver|
+        receiver.send(name, *params) if receiver.respond_to?(name)
+      end
     end
 
     # strings outside of page content should be in either PDFDocEncoding or UTF-16.
@@ -56,10 +63,6 @@ class PDF::Reader
       pages ? true : false
     end
 
-    def receiver
-      @receiver
-    end
-
     def root
       ohash.object(trailer[:Root])
     end
@@ -74,4 +77,3 @@ class PDF::Reader
 
   end
 end
-

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 9
-  - 3
-  version: 0.9.3
+  - 10
+  - 0
+  version: 0.10.0
 platform: ruby
 authors: 
 - James Healy
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-02 00:00:00 +10:00
+date: 2011-07-06 00:00:00 +10:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -63,12 +63,13 @@ dependencies:
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ">="
+    - - ~>
       - !ruby/object:Gem::Version 
         segments: 
+        - 1
+        - 0
         - 0
-        - 9
-        version: "0.9"
+        version: 1.0.0
   type: :runtime
   version_requirements: *id004
 description: The PDF::Reader library implements a PDF parser conforming as much as possible to the PDF specification from Adobe