pdftoimage 0.1.1

data/.bundle/config

@@ -0,0 +1,2 @@
+--- 
+BUNDLE_DISABLE_SHARED_GEMS: "1"

data/.document

@@ -0,0 +1,3 @@
+- 
+ChangeLog.*
+LICENSE.txt

data/.rspec

@@ -0,0 +1 @@
+--colour --format documentation

data/.yardopts

@@ -0,0 +1 @@
+--markup rdoc --title "pdftoimage Documentation" --protected

data/ChangeLog.rdoc

@@ -0,0 +1,4 @@
+=== 0.1.0 / 2010-11-08
+
+* Initial release:
+

data/Gemfile

@@ -0,0 +1,10 @@
+source :rubygems
+
+gemspec
+
+group :development do
+  gem 'rake',     '~> 0.8.7'
+  gem 'ore-core',  '~> 0.1.0'
+  gem 'rspec', '~> 2.0.0'
+  gem 'yard', '~> 0.6.0'
+end

data/Gemfile.lock

@@ -0,0 +1,33 @@
+PATH
+  remote: .
+  specs:
+    pdftoimage (0.1.1)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.2)
+    ore-core (0.1.0)
+    rake (0.8.7)
+    rspec (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+      rspec-mocks (~> 2.0.1)
+    rspec-core (2.0.1)
+    rspec-expectations (2.0.1)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+    yard (0.6.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  ore-core (~> 0.1.0)
+  pdftoimage!
+  rake (~> 0.8.7)
+  rspec (~> 2.0.0)
+  yard (~> 0.6.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2010 Rob Flynn
+
+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/README.rdoc

@@ -0,0 +1,38 @@
+= pdftoimage
+
+* {Homepage}[http://rubygems.org/gems/pdftoimage]
+
+== Description
+
+PDFToImage is a ruby gem which allows for conversion of a PDF document into 
+images. It uses poppler_utils to first convert the document to PNG and then
+allows usage of ImageMagick to convert the image into other formats.
+
+The reasoning behind using poppler_utils is due to the fact that ghostscript
+occasionally has trouble with certain PDF documents which poppler_utils seems
+to be able to parse without error.
+
+== Examples
+
+  require 'pdftoimage'
+  images = PDFToImage.open('somefile.pdf')
+  images.each do |img|
+    img.resize('50%').save("output/page-#{img.page}.jpg")
+  end
+
+== Requirements
+
+poppler_utils
+
+ImageMagick
+
+
+== Install
+
+  $ gem install pdftoimage
+
+== Copyright
+
+Copyright (c) 2010 Rob Flynn
+
+See LICENSE.txt for details.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'rubygems'
+
+begin
+  require 'bundler'
+rescue LoadError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `gem install bundler` to install Bundler."
+  exit e.status_code
+end
+
+begin
+  Bundler.setup(:development)
+rescue Bundler::BundlerError => e
+  STDERR.puts e.message
+  STDERR.puts "Run `bundle install` to install missing gems."
+  exit e.status_code
+end
+
+require 'rake'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new
+task :default => :spec
+
+require 'yard'
+YARD::Rake::YardocTask.new  

data/gemspec.yml

@@ -0,0 +1,12 @@
+name: pdftoimage
+summary: "A ruby gem for converting PDF documents into a series of images."
+description: "A ruby gem for converting PDF documents into a series of images. This module is based off poppler_utils and ImageMagick."
+license: MIT
+authors: Rob Flynn
+homepage: http://rubygems.org/gems/pdftoimage
+email: rob@thingerly.com
+has_yard: true
+
+development_dependencies:
+  bundler: ~> 1.0.0
+  yard: ~> 0.6.0

data/lib/pdftoimage.rb

@@ -0,0 +1,74 @@
+require 'tmpdir'
+require 'pdftoimage/version'
+require 'pdftoimage/image'
+
+module PDFToImage
+  class PDFError < RuntimeError; end
+end
+
+module PDFToImage
+  # A class variable for storing the location of our temp folder
+  @@pdf_temp_dir = File.join(Dir.tmpdir())
+
+  begin
+    tmp = `pdftoppm -v 2>&1`
+    raise(PDFToImage::PDFError, "poppler_utils not installed") unless tmp.index('Poppler')
+  rescue Errno::ENOENT
+    raise PDFToImage::PDFError, "poppler_utils not installed"
+  end
+
+  begin
+    tmp = `identify -version 2>&1`
+    raise(PDFToImage::PDFError, "ImageMagick not installed") unless tmp.index('ImageMagick')
+  rescue Errno::ENOENT
+    raise PDFToImage::PDFError, "ImageMagick not installed"
+  end
+
+  class << self
+
+    # Opens a PDF document and prepares it for splitting into images.
+    #
+    # @param [filename] The filename of the PDF to open
+    # @return [Array] An array of images
+    def open(filename)
+      target_path = random_filename
+
+      if not File.exists?(filename)
+        raise PDFError, "File '#{filename}' not found."
+      end
+
+      cmd = "pdftoppm -png #{filename} #{target_path}"
+
+      `#{cmd}`
+      if $? != 0
+        raise PDFError, "Error reading PDF."
+      end
+
+      pngs = Dir.glob("#{target_path}*.png")
+
+      images = []
+
+      pngs.each do |png|
+        image = Image.new(png)
+        images << image
+      end
+
+      return images.sort!
+    end
+
+    private
+
+    # Generate a random file name in the system's tmp folder
+    def random_filename
+      File.join(@@pdf_temp_dir, random_name)
+    end
+
+    # Generate a random name of {#length} characters.
+    def random_name(length = 15)
+      @@chars ||= ("a".."z").to_a + ("A".."Z").to_a + ("1".."9").to_a
+      return 'pdftoimage-' + Array.new(length, '').collect{@@chars[rand(@@chars.size)]}.join
+    end
+
+  end
+
+end

data/lib/pdftoimage/image.rb

@@ -0,0 +1,97 @@
+module PDFToImage
+
+  class Image
+    attr_reader :filename
+    attr_reader :width
+    attr_reader :height
+    attr_reader :format
+    attr_reader :page
+    attr_reader :args
+
+    # We currently only support resizing, as that's all I need at the moment
+    # selfish, but I need to return to the main project
+    CUSTOM_IMAGE_METHODS = [
+      "resize"
+    ]
+
+    CUSTOM_IMAGE_METHODS.each do |method|
+      define_method(method.to_sym) do |*args|
+        @args << "-#{method} #{args.join(' ')}"
+
+        self
+      end
+    end
+
+    # Image constructor
+    #
+    # @param [filename] The name of the image file to open
+    def initialize(filename)
+      @args = []
+
+      @filename = filename
+
+      info = identify()
+
+      @width = info[:width]
+      @height = info[:height]
+      @format = info[:format]
+
+      tmp_base = File.basename(filename, File.extname(filename))
+      pieces = tmp_base.split('-')
+      @page = pieces[-1].to_i
+    end
+
+    # Saves the converted image to the specified location
+    #
+    # @param [outname] The output filename of the image
+    #
+    def save(outname)
+      cmd = "convert "
+
+      if not @args.empty?
+        cmd += "#{@args.join(' ')} "
+      end
+      
+      cmd += "#{@filename} #{outname}"
+
+      `#{cmd}`
+      if $? != 0
+        raise PDFError, "Error converting file: #{cmd}"
+      end
+
+      return true
+    end
+
+    def <=>(img)
+      if @page == img.page
+        return 0
+      elsif @page < img.page
+        return -1
+      else
+        return 1
+      end
+    end
+
+    private 
+
+    def identify
+      cmd = "identify #{@filename}"
+
+      result = `#{cmd}`
+      unless $?.success?
+        raise PDFToImage::PDFError, "Error executing #{cmd}"
+      end
+
+      info = result.strip.split(' ')
+      dimensions = info[2].split('x')
+
+      return {
+        :format => info[1],
+        :width => dimensions[0],
+        :height => dimensions[1]
+      }
+    end
+
+  end
+
+end

data/lib/pdftoimage/version.rb

@@ -0,0 +1,4 @@
+module PDFToImage
+  # pdftoimage version
+  VERSION = "0.1.1"
+end

data/pdftoimage.gemspec

@@ -0,0 +1,10 @@
+# -*- encoding: utf-8 -*-
+
+begin
+  Ore::Specification.new do |gemspec|
+    # custom logic here
+  end
+rescue NameError
+  STDERR.puts "The 'pdftoimage.gemspec' file requires Ore."
+  STDERR.puts "Run `gem install ore-core` to install Ore."
+end

data/spec/pdftoimage_spec.rb

@@ -0,0 +1,31 @@
+require 'spec_helper'
+require 'pdftoimage'
+
+describe PDFToImage do
+  it "should have a VERSION constant" do
+    PDFToImage.const_get('VERSION').should_not be_empty
+  end
+
+  describe "3pages.pdf" do
+    it "should have three pages" do
+    @pages = PDFToImage.open('spec/3pages.pdf')
+      @pages.size.should equal 3
+    end
+
+    it "should allow saving" do
+      @pages = PDFToImage.open('spec/3pages.pdf')
+      @pages[0].save('spec/tmp.jpg')
+      File.exists?('spec/tmp.jpg').should equal true
+      File.unlink('spec/tmp.jpg')
+    end
+
+    it "should allow resizing" do
+      @pages = PDFToImage.open('spec/3pages.pdf')
+      @pages[0].resize('50%').save('spec/tmp2.jpg')
+      File.exists?('spec/tmp2.jpg').should equal true
+      File.unlink('spec/tmp2.jpg')
+    end
+
+
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'rspec'
+require 'pdftoimage/version'
+
+include PDFToImage

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification 
+name: pdftoimage
+version: !ruby/object:Gem::Version 
+  hash: 25
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Rob Flynn
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-10 00:00:00 +00:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 0
+        - 6
+        - 0
+        version: 0.6.0
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: bundler
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  type: :development
+  version_requirements: *id002
+description: A ruby gem for converting PDF documents into a series of images. This module is based off poppler_utils and ImageMagick.
+email: rob@thingerly.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- LICENSE.txt
+- ChangeLog.rdoc
+files: 
+- spec/spec_helper.rb
+- spec/3pages.pdf
+- lib/pdftoimage/version.rb
+- gemspec.yml
+- ChangeLog.rdoc
+- .rspec
+- pdftoimage.gemspec
+- .yardopts
+- .bundle/config
+- lib/pdftoimage/image.rb
+- Gemfile
+- Rakefile
+- LICENSE.txt
+- lib/pdftoimage.rb
+- README.rdoc
+- Gemfile.lock
+- spec/pdftoimage_spec.rb
+- .document
+has_rdoc: yard
+homepage: http://rubygems.org/gems/pdftoimage
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 23
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: pdftoimage
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A ruby gem for converting PDF documents into a series of images.
+test_files: 
+- spec/pdftoimage_spec.rb