pdf-stamper 0.3.0

data/History.txt

@@ -0,0 +1,17 @@
+== 0.3.0 2009-02-08
+
+* Refactored the code.
+* Added JRuby support
+* Fixed some documentation
+* Fixed issue with Leopard
+* Upgraded iText version
+
+== 0.2.0 2007-11-08
+
+* Use bytearray for output
+* Added support for images
+
+== 0.1.0 2007-07-13
+
+* 1 major enhancement:
+  * Initial release

data/Manifest.txt

@@ -0,0 +1,11 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+ext/iText-2.1.4.jar
+lib/pdf/stamper.rb
+lib/pdf/stamper/jruby.rb
+lib/pdf/stamper/rjb.rb
+spec/logo.gif
+spec/pdf_stamper_spec.rb
+spec/test_template.pdf

data/README.txt

@@ -0,0 +1,52 @@
+= pdf/stamper - PDF Templates, Wow!
+  http://github.com/jaywhy/pdf-stamper/
+  by Jason Yates
+
+== DESCRIPTION:
+
+Super cool PDF templates using iText's PdfStamper.
+
+== CAVEAT:
+
+Anything super cool must have a caveat. You have to use JRuby or RJB. Plus you
+can only use Adobe LiveCycle Designer to create the templates.
+
+== EXAMPLE:
+pdf = PDF::Stamper.new("my_template.pdf")
+pdf.text :first_name, "Jason"
+pdf.text :last_name, "Yates"
+pdf.image :photo, "photo.jpg"
+pdf.save_as "my_output.pdf"
+
+== INSTALL:
+
+$ sudo gem install pdf-stamper
+
+== CODE:
+
+$ git clone http://github.com/jaywhy/pdf-stamper/
+
+== LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2007-2009 Jason Yates
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,33 @@
+$:.unshift File.join(File.dirname(__FILE__), "lib")
+require 'pdf/stamper'
+require 'spec/rake/spectask'
+
+%w[rubygems rake rake/clean fileutils newgem rubigen].each { |f| require f }
+
+$hoe = Hoe.new('pdf-stamper', PDF::Stamper::VERSION) do |p|
+  p.name = 'pdf-stamper'
+  p.author = 'Jason Yates'
+  p.email = 'jaywhy@gmail.com'
+  p.summary = "Super cool PDF templates using iText's PdfStamper."
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.extra_dev_deps = [
+    ['newgem', ">= #{::Newgem::VERSION}"]
+  ]
+
+  # p.spec_extras['platform'] = 'jruby' # JRuby gem created, e.g. pdf-stamper-X.Y.Z-jruby.gem
+  
+  p.clean_globs |= %w[**/.DS_Store tmp *.log]
+  path = (p.rubyforge_name == p.name) ? p.rubyforge_name : "\#{p.rubyforge_name}/\#{p.name}"
+  p.remote_rdoc_dir = File.join(path.gsub(/^#{p.rubyforge_name}\/?/,''), 'rdoc')
+  p.rsync_args = '-av --delete --ignore-errors'
+end
+
+require 'newgem/tasks' # load /tasks/*.rake
+Dir['tasks/**/*.rake'].each { |t| load t }
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/*_spec.rb']
+  t.warning = true
+  t.rcov = false
+end

data/lib/pdf/stamper.rb

@@ -0,0 +1,59 @@
+# = pdf/stamper.rb -- PDF template stamping.
+#
+#  Copyright (c) 2007-2009 Jason Yates
+
+require 'rbconfig'
+require 'fileutils'
+require 'tmpdir'
+
+include FileUtils
+
+module PDF
+  class Stamper
+    VERSION = "0.3.0"
+    
+    if RUBY_PLATFORM =~ /java/ # ifdef to check if your using JRuby
+      require 'pdf/stamper/jruby'
+    else
+      require 'pdf/stamper/rjb'
+    end
+    # PDF::Stamper provides an interface into iText's PdfStamper allowing for the
+    # editing of existing PDF's as templates. PDF::Stamper is not a PDF generator,
+    # it allows you to edit existing PDF's and use them as templates.
+    #
+    # == Creation of templates
+    #
+    # Templates currently can only be created using Adobe LiveCycle
+    # Designer which comes with the lastest versions of Adobe Acrobat
+    # Professional.  Using LiveCycle Designer you can create a form and
+    # add textfield's for text and button's for images.
+    #
+    # == Example
+    #
+    # pdf = PDF::Stamper.new("my_template.pdf")
+    # pdf.text :first_name, "Jason"
+    # pdf.text :last_name, "Yates"
+    # pdf.image :photo, "photo.jpg"
+    # pdf.save_as "my_output"
+    
+    # Set a textfield defined by key and text to value.
+    def text(key, value)
+      @form.setField(key.to_s, value.to_s) # Value must be a string or itext will error.
+    end
+    
+    # Saves the PDF into a file defined by path given.
+    def save_as(file)
+      f = File.new(file, "w")
+      f.syswrite to_s
+    end
+    
+    private
+
+    def fill
+      @stamp.setFormFlattening(true)
+      @stamp.close
+    end
+  end
+end
+    
+    

data/lib/pdf/stamper/jruby.rb

@@ -0,0 +1,58 @@
+# = pdf/stamper/rjb.rb -- PDF template stamping.
+#
+#  Copyright (c) 2007-2009 Jason Yates
+
+$:.unshift(File.join(File.dirname(__FILE__), '..', '..', '..', 'ext'))
+require 'java'
+require 'iText-2.1.4.jar'
+
+include_class 'java.io.FileOutputStream'
+include_class 'java.io.ByteArrayOutputStream'
+include_class 'com.lowagie.text.pdf.AcroFields'
+include_class 'com.lowagie.text.pdf.PdfReader'
+include_class 'com.lowagie.text.pdf.PdfStamper'
+include_class 'com.lowagie.text.Image'
+include_class 'com.lowagie.text.Rectangle'
+
+module PDF
+  class Stamper
+    def initialize(pdf = nil)
+      template(pdf) if ! pdf.nil?
+    end
+  
+    def template(template)
+      # NOTE I'd rather use a ByteArrayOutputStream.  However I
+      # couldn't get it working.  Patches welcome.
+      #@tmp_path = File.join(Dir::tmpdir, 'pdf-stamper-' + rand(10000).to_s + '.pdf')
+      reader = PdfReader.new(template)
+      @baos = ByteArrayOutputStream.new
+      @stamp = PdfStamper.new(reader, @baos)#FileOutputStream.new(@tmp_path))
+      @form = @stamp.getAcroFields()
+    end
+  
+    # Set a button field defined by key and replaces with an image.
+    def image(key, image_path)
+      # Idea from here http://itext.ugent.be/library/question.php?id=31 
+      # Thanks Bruno for letting me know about it.
+      img = Image.getInstance(image_path)
+      img_field = @form.getFieldPositions(key.to_s)
+
+      rect = Rectangle.new(img_field[1], img_field[2], img_field[3], img_field[4])
+      img.scaleToFit(rect.width, rect.height)
+      img.setAbsolutePosition(
+        img_field[1] + (rect.width - img.scaledWidth) / 2,
+        img_field[2] + (rect.height - img.scaledHeight) /2
+      )
+
+      cb = @stamp.getOverContent(img_field[0].to_i)
+      cb.addImage(img)
+    end
+    
+    # Takes the PDF output and sends as a string.  Basically it's sole
+    # purpose is to be used with send_data in rails.
+    def to_s
+      fill
+      String.from_java_bytes(@baos.toByteArray)
+    end
+  end
+end

data/lib/pdf/stamper/rjb.rb

@@ -0,0 +1,65 @@
+# = pdf/stamper/rjb.rb -- PDF template stamping.
+#
+#  Copyright (c) 2007-2009 Jason Yates
+
+require 'rubygems'
+require 'rjb'
+
+Rjb::load(File.join(File.dirname(__FILE__), '..', '..', '..', 'ext', 'iText-2.1.4.jar'), ['-Djava.awt.headless=true'])
+
+module PDF
+  # PDF::Stamper::RJB
+  #
+  # RJB needs the LD_LIBRARY_PATH and JAVA_HOME environment set for it
+  # to work correctly.  For example on my system:
+  #
+  # export LD_LIBRARY_PATH=/usr/java/jdk1.6.0/jre/lib/i386/:/usr/java/jdk1.6.0/jre/lib/i386/client/:./
+  # export JAVA_HOME=/usr/java/jdk1.6.0/
+  #
+  # Check the RJB documentation if you are having issues with this.
+  class Stamper
+    def initialize(pdf = nil, options = {})
+      @bytearray    = Rjb::import('java.io.ByteArrayOutputStream')
+      @filestream   = Rjb::import('java.io.FileOutputStream')
+      @acrofields   = Rjb::import('com.lowagie.text.pdf.AcroFields')
+      @pdfreader    = Rjb::import('com.lowagie.text.pdf.PdfReader')
+      @pdfstamper   = Rjb::import('com.lowagie.text.pdf.PdfStamper')
+    
+      template(pdf) if ! pdf.nil?
+    end
+  
+    def template(template)
+      reader = @pdfreader.new(template)
+      @baos = @bytearray.new
+      @stamp = @pdfstamper.new(reader, @baos)
+      @form = @stamp.getAcroFields()
+    end
+
+    # Set a button field defined by key and replaces with an image.
+    def image(key, image_path)
+      # Idea from here http://itext.ugent.be/library/question.php?id=31 
+      # Thanks Bruno for letting me know about it.
+      image = Rjb::import('com.lowagie.text.Image')
+      img = image.getInstance(image_path)
+      img_field = @form.getFieldPositions(key.to_s)
+
+      rectangle = Rjb::import('com.lowagie.text.Rectangle')
+      rect = rectangle.new(img_field[1], img_field[2], img_field[3], img_field[4])
+      img.scaleToFit(rect.width, rect.height)
+      img.setAbsolutePosition(
+        img_field[1] + (rect.width - img.getScaledWidth) / 2,
+        img_field[2] + (rect.height - img.getScaledHeight) /2
+      )
+
+      cb = @stamp.getOverContent(img_field[0].to_i)
+      cb.addImage(img)
+    end
+    
+    # Takes the PDF output and sends as a string.  Basically it's sole
+    # purpose is to be used with send_data in rails.
+    def to_s
+      fill
+      @baos.toByteArray
+    end
+  end
+end

data/spec/pdf_stamper_spec.rb

@@ -0,0 +1,21 @@
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib")
+require 'pdf/stamper'
+
+describe PDF::Stamper do
+  before(:each) do
+    @pdf = PDF::Stamper.new(File.join(File.dirname(__FILE__), "test_template.pdf"))
+    @pdf.text :text_field01, "test"
+    @pdf.text :text_field02, "test2"
+    @pdf.image :button_field01, File.join(File.dirname(__FILE__), "logo.gif")
+  end
+
+  it "should create PDF document" do
+    @pdf.to_s.should_not be_nil
+  end
+
+  it "should save PDF document" do
+    @pdf.save_as "test_output.pdf"
+    File.exist?("test_output.pdf").should be_true
+    File.delete("test_output.pdf") # Comment this out to view the output
+  end
+end

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: pdf-stamper
+version: !ruby/object:Gem::Version 
+  version: 0.3.0
+platform: ruby
+authors: 
+- Jason Yates
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-02-08 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.3
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.0
+    version: 
+description: "Super cool PDF templates using iText's PdfStamper.  == CAVEAT:  Anything super cool must have a caveat. You have to use JRuby or RJB. Plus you can only use Adobe LiveCycle Designer to create the templates.  == EXAMPLE: pdf = PDF::Stamper.new(\"my_template.pdf\") pdf.text :first_name, \"Jason\" pdf.text :last_name, \"Yates\" pdf.image :photo, \"photo.jpg\" pdf.save_as \"my_output.pdf\""
+email: jaywhy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- ext/iText-2.1.4.jar
+- lib/pdf/stamper.rb
+- lib/pdf/stamper/jruby.rb
+- lib/pdf/stamper/rjb.rb
+- spec/logo.gif
+- spec/pdf_stamper_spec.rb
+- spec/test_template.pdf
+has_rdoc: true
+homepage: "  http://github.com/jaywhy/pdf-stamper/"
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+- ext
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: pdf-stamper
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Super cool PDF templates using iText's PdfStamper.
+test_files: []
+