cupsffi 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+*.gem
+.bundle
+*.swp

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in cupsffi.gemspec
+gemspec

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/cupsffi.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "cupsffi/version"
+
+Gem::Specification.new do |s|
+  s.name        = "cupsffi"
+  s.version     = Cupsffi::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Nathan Ehresman"]
+  s.email       = ["nehresma@gmail.com"]
+  s.homepage    = ""
+  s.summary     = %q{FFI wrapper around libcups}
+  s.description = %q{Simple wrapper around libcups to give CUPS printing capabilities to Ruby apps.}
+
+  s.add_development_dependency "ffi"
+
+  s.rubyforge_project = "cupsffi"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/cupsffi/job.rb

@@ -0,0 +1,60 @@
+# The MIT License
+#
+# Copyright (c) 2011 Nathan Ehresman
+#
+# 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.
+
+class CupsJob
+  attr_reader :id, :printer
+
+  def initialize(id, printer = nil)
+    @id = Integer(id)
+    @printer = printer unless printer.nil?
+  end
+
+  def cancel(printer = nil)
+    raise "cancel parameter must be a CupsPrinter or String" unless printer.nil? || [CupsPrinter, String].include?(printer.class)
+    p = printer || @printer
+    r = CupsFFI::cupsCancelJob(p.kind_of?(String) ? p : p.name, @id)
+    raise CupsFFI::cupsLastErrorString() if r == 0
+  end
+
+  def status(printer = nil)
+    raise "status parameter must be a CupsPrinter or String" unless printer.nil? || [CupsPrinter, String].include?(printer.class)
+    pointer = FFI::MemoryPointer.new :pointer
+    p = printer || @printer
+    job_count = CupsFFI::cupsGetJobs(pointer, p.kind_of?(String) ? p : p.name, 0, CupsFFI::CUPS_WHICHJOBS_ALL)
+
+    free_jobs = lambda do
+      CupsFFI::cupsFreeJobs(job_count, pointer.get_pointer(0))
+    end
+
+    job_count.times do |i|
+      job = CupsFFI::CupsJobS.new(pointer.get_pointer(0) + (CupsFFI::CupsJobS.size * i))
+      if job[:id] == @id then
+        state = job[:state]
+        free_jobs.call
+        return state
+      end
+    end
+
+    free_jobs.call
+    raise "Job not found on printer"
+  end
+end

data/lib/cupsffi/lib.rb

@@ -0,0 +1,390 @@
+# The MIT License
+#
+# Copyright (c) 2011 Nathan Ehresman
+#
+# 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.
+
+require 'ffi'
+
+module CupsFFI
+  extend FFI::Library
+  ffi_lib 'cups'
+
+  ### cups.h API
+
+  CUPS_JOBID_ALL = -1
+  CUPS_WHICHJOBS_ALL = -1
+  CUPS_WHICHJOBS_ACTIVE = 0
+  CUPS_WHICHJOBS_COMPLETED = 1
+  CUPS_HTTP_DEFAULT = nil
+
+  class CupsOptionS < FFI::Struct
+    layout  :name, :string,
+            :value, :string
+  end
+
+  class CupsDestS < FFI::Struct
+    layout  :name, :string,
+            :instance, :string,
+            :is_default, :int,
+            :num_options, :int,
+            :options, :pointer  # pointer type is CupsOptionS
+  end
+
+  IppJState = enum [:pending, 3,
+                    :held,
+                    :processing,
+                    :stopped,
+                    :canceled,
+                    :aborted,
+                    :completed]
+
+  class CupsJobS < FFI::Struct
+    layout  :id, :int,
+            :dest, :string,
+            :title, :string,
+            :user, :string,
+            :format, :string,
+            :state, IppJState,
+            :size, :int,
+            :priority, :int,
+            :completed_time, :long,
+            :creation_time, :long,
+            :processing_time, :long
+  end
+
+  HttpStatus = enum [:http_error, -1,
+                     :http_continue, 100,
+                     :http_switching_protocols,
+                     :http_ok, 200,
+                     :http_created,
+                     :http_accepted,
+                     :http_not_authoritative,
+                     :http_no_content,
+                     :http_reset_content,
+                     :http_partial_content,
+                     :http_multiple_choices, 300,
+                     :http_moved_permanently,
+                     :http_moved_temporarily,
+                     :http_see_other,
+                     :http_not_modified,
+                     :http_use_proxy,
+                     :http_bad_request, 400,
+                     :http_unauthorized,
+                     :http_payment_required,
+                     :http_forbidden,
+                     :http_not_found,
+                     :http_method_not_allowed,
+                     :http_not_acceptable,
+                     :http_proxy_authentication,
+                     :http_request_timeout,
+                     :http_conflict,
+                     :http_gone,
+                     :http_length_required,
+                     :http_precondition,
+                     :http_request_too_large,
+                     :http_uri_too_long,
+                     :http_unsupported_mediatype,
+                     :http_requested_range,
+                     :http_expectation_failed,
+                     :http_upgrade_required, 426,
+                     :http_server_error, 500,
+                     :http_not_implemented,
+                     :http_bad_gateway,
+                     :http_service_unavailable,
+                     :http_gateway_timeout,
+                     :http_not_supported,
+                     :http_authorization_canceled, 1000]
+
+  IppStatus = enum [:ipp_ok, 0,
+                    :ipp_ok_subst,
+                    :ipp_ok_conflict,
+                    :ipp_ok_ignored_subscriptions,
+                    :ipp_ok_ignored_notifications,
+                    :ipp_ok_too_many_events,
+                    :ipp_ok_but_cancel_subscription,
+                    :ipp_ok_events_complete,
+                    :ipp_redirection_other_site, 512,
+                    :cups_see_other, 640,
+                    :ipp_bad_request, 1024,
+                    :ipp_forbidden,
+                    :ipp_not_authenticated,
+                    :ipp_not_authorized,
+                    :ipp_not_possible,
+                    :ipp_timeout,
+                    :ipp_not_found,
+                    :ipp_gone,
+                    :ipp_request_entity,
+                    :ipp_request_value,
+                    :ipp_document_format,
+                    :ipp_attributes,
+                    :ipp_uri_scheme,
+                    :ipp_charset,
+                    :ipp_conflict,
+                    :ipp_compression_not_supported,
+                    :ipp_compression_error,
+                    :ipp_document_format_error,
+                    :ipp_document_access_error,
+                    :ipp_attributes_not_settable,
+                    :ipp_ignored_all_subscriptions,
+                    :ipp_too_many_subscriptions,
+                    :ipp_ignored_all_notifications,
+                    :ipp_print_support_file_not_found,
+                    :ipp_internal_error, 1280,
+                    :ipp_operation_not_supported,
+                    :ipp_service_unavailable,
+                    :ipp_version_not_supported,
+                    :ipp_device_error,
+                    :ipp_temporary_error,
+                    :ipp_not_accepting,
+                    :ipp_printer_busy,
+                    :ipp_error_job_canceled,
+                    :ipp_multiple_jobs_not_supported,
+                    :ipp_printer_is_deactivated
+                  ]
+
+
+
+
+
+  attach_function 'cupsGetDests', [ :pointer ], :int
+
+  # :int is the number of CupsDestS structs to free
+  # :pointer is the first one
+  attach_function 'cupsFreeDests', [ :int, :pointer ], :void
+
+  # Parameters:
+  #  - printer name
+  #  - file name
+  #  - job title
+  #  - number of options
+  #  - a pointer to a CupsOptionS struct
+  # Returns
+  #  - job number or 0 on error
+  attach_function 'cupsPrintFile', [ :string, :string, :string, :int, :pointer ], :int
+
+  attach_function 'cupsLastErrorString', [], :string
+
+  # Parameters
+  #  - printer name
+  #  - job id
+  attach_function 'cupsCancelJob', [:string, :int], :void
+
+  # Parameters
+  #  - pointer to struct CupsJobS to populate
+  #  - printer name
+  #  - myjobs (0 == all users, 1 == mine)
+  #  - whichjobs (CUPS_WHICHJOBS_ALL, CUPS_WHICHJOBS_ACTIVE, or CUPS_WHICHJOBS_COMPLETED)
+  # Returns:
+  #  - number of jobs
+  attach_function 'cupsGetJobs', [:pointer, :string, :int, :int], :int
+
+  # Parameters
+  #  - number of jobs
+  #  - pointer to the first CupsJobS to free
+  attach_function 'cupsFreeJobs', [:int, :pointer ], :void
+
+  # Parameters
+  #  - pointer to http connection to server or CUPS_HTTP_DEFAULT
+  #  - printer name
+  #  - title of job
+  #  - number of options
+  #  - pointer to a CupsOptionS struct
+  # Returns
+  #  - job number or 0 on error
+  attach_function 'cupsCreateJob', [:pointer, :string, :string, :int, :pointer], :int
+
+  # Parameters
+  #  - pointer to http connection to server or CUPS_HTTP_DEFAULT
+  #  - printer name
+  #  - job id
+  #  - name of document
+  #  - mime type format
+  #  - last document (1 for last document in job, 0 otherwise)
+  # Returns
+  #  - HttpStatus
+  attach_function 'cupsStartDocument', [:pointer, :string, :int, :string, :string, :int], HttpStatus
+
+  # Parameters
+  #  - pointer to http connection to server or CUPS_HTTP_DEFAULT
+  #  - data in a character string
+  #  - length of data
+  # Returns
+  #  - HttpStatus
+  attach_function 'cupsWriteRequestData', [:pointer, :string, :size_t], HttpStatus
+
+  # Parameters
+  #  - pointer to http connection to server or CUPS_HTTP_DEFAULT
+  #  - printer name
+  # Returns
+  #  - IppStatus
+  attach_function 'cupsFinishDocument', [:pointer, :string], IppStatus
+
+  # Parameters
+  #  - printer name
+  # Returns
+  #  - filename for PPD file
+  attach_function 'cupsGetPPD', [:string], :string
+
+  # Parameters
+  #  - option name
+  #  - option value
+  #  - number of options
+  #  - pointer to options
+  # Returns
+  #  - number of options
+  attach_function 'cupsAddOption', [:string, :string, :int, :pointer], :int
+
+  # Parameters
+  #  - number of options
+  #  - pointer to options
+  attach_function 'cupsFreeOptions', [:int, :pointer], :void
+
+
+
+  ### ppd.h API
+  PPD_MAX_NAME = 41
+  PPD_MAX_TEXT = 81
+
+  PPDCSE = enum [:ppd_cs_cmyk, -4,
+                :ppd_cs_cmy,
+                :ppd_cs_gray, 1,
+                :ppd_cs_rgb, 3,
+                :ppd_cs_rgbk,
+                :ppd_cs_n]
+  PPDUIE = enum [:boolean, :pickone, :pickmany]
+  PPDSectionE = enum [:any, :document, :exit, :jcl, :page, :prolog]
+
+  class PPDFileS < FFI::ManagedStruct
+    layout  :language_level, :int,
+            :color_device, :int,
+            :variable_sizes, :int,
+            :accurate_screens, :int,
+            :contone_only, :int,
+            :landscape, :int,
+            :model_number, :int,
+            :manual_copies, :int,
+            :throughput, :int,
+            :colorspace, PPDCSE,
+            :patches, :string,
+            :num_emulations, :int,
+            :emulations, :pointer,
+            :jcl_begin, :string,
+            :jcl_ps, :string,
+            :jcl_end, :string,
+            :lang_encoding, :string,
+            :lang_version, :string,
+            :modelname, :string,
+            :ttrasterizer, :string,
+            :manufacturer, :string,
+            :product, :string,
+            :nickname, :string,
+            :short_nickname, :string,
+            :num_groups, :int,
+            :groups, :pointer,
+            :num_sizes, :int,
+            :sizes, :pointer,
+            :custom_min, [:float, 2],
+            :custom_max, [:float, 2],
+            :custom_margins, [:float, 4],
+            :num_consts, :int,
+            :consts, :pointer,
+            :num_fonts, :int,
+            :fonts, :pointer, # **char
+            :num_profiles, :int,
+            :profiles, :pointer,
+            :num_filters, :int,
+            :filters, :pointer, # **char
+            :flip_duplex, :int,
+            :protocols, :string,
+            :pcfilename, :string,
+            :num_attrs, :int,
+            :cur_attr, :int,
+            :attrs, :pointer,
+            :sorted_attrs, :pointer,
+            :options, :pointer,
+            :coptions, :pointer,
+            :marked, :pointer,
+            :cups_uiconstraints, :pointer
+
+    def self.release(ptr)
+      CupsFFI::ppdClose(ptr)
+    end
+  end
+
+  class PPDChoiceS < FFI::Struct
+    layout  :marked, :char,
+            :choice, [:char, PPD_MAX_NAME],
+            :text, [:char, PPD_MAX_TEXT],
+            :code, :string,
+            :option, :pointer
+  end
+
+  class PPDOptionS < FFI::Struct
+    layout  :conflicted, :char,
+            :keyword, [:char, PPD_MAX_NAME],
+            :defchoice, [:char, PPD_MAX_NAME],
+            :text, [:char, PPD_MAX_TEXT],
+            :ui, PPDUIE,
+            :section, PPDSectionE,
+            :order, :float,
+            :num_choices, :int,
+            :choices, :pointer
+  end
+
+  # Parameters
+  #  - filename for PPD file
+  # Returns
+  #  - pointer to PPDFileS struct
+  attach_function 'ppdOpenFile', [:string], :pointer
+
+  # Parameters
+  #  - pointer to PPDFileS struct
+  attach_function 'ppdClose', [:pointer], :void
+
+  # Parameters
+  #  - pointer to PPDFileS struct
+  # Returns
+  #  - pointer to PPDOptionS struct
+  attach_function 'ppdFirstOption', [:pointer], :pointer
+
+  # Parameters
+  #  - pointer to PPDFileS struct
+  # Returns
+  #  - pointer to PPDOptionS struct
+  attach_function 'ppdNextOption', [:pointer], :pointer
+
+
+
+
+
+  ### array.h API
+
+  # Parameters
+  #  - pointer to _cups_array_s struct
+  # Returns
+  #  - void pointer to first element
+  attach_function 'cupsArrayFirst', [:pointer], :pointer
+
+  # Parameters
+  #  - pointer to _cups_array_s struct
+  # Returns
+  #  - void pointer to first element
+  attach_function 'cupsArrayNext', [:pointer], :pointer
+end

data/lib/cupsffi/ppd.rb

@@ -0,0 +1,66 @@
+# The MIT License
+#
+# Copyright (c) 2011 Nathan Ehresman
+#
+# 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.
+
+class CupsPPD
+  def initialize(printer_name)
+    @file = CupsFFI::cupsGetPPD(printer_name)
+    raise "No PPD found for #{printer_name}" if @file.nil?
+
+    @pointer = CupsFFI::ppdOpenFile(@file)
+    raise "Unable to open PPD #{file}" if @pointer.null?
+
+    @ppd_file_s = CupsFFI::PPDFileS.new(@pointer)
+  end
+
+  def close
+    CupsFFI::ppdClose(@pointer)
+    File.unlink(@file)
+  end
+
+  def options
+    options = []
+    option_pointer = CupsFFI::ppdFirstOption(@pointer)
+    while !option_pointer.null?
+      option = CupsFFI::PPDOptionS.new(option_pointer)
+      choices = []
+      option[:num_choices].times do |i|
+        choice = CupsFFI::PPDChoiceS.new(option[:choices] + (CupsFFI::PPDChoiceS.size * i))
+        choices.push({
+          :text => String.new(choice[:text]),
+          :choice => String.new(choice[:choice])
+        })
+      end
+      options.push({
+        :keyword => String.new(option[:keyword]),
+        :default_choice => String.new(option[:defchoice]),
+        :text => String.new(option[:text]),
+        :ui => String.new(option[:ui].to_s),
+        :section => String.new(option[:section].to_s),
+        :order => option[:order],
+        :choices => choices
+      })
+
+      option_pointer = CupsFFI::ppdNextOption(@pointer)
+    end
+    options
+  end
+end

data/lib/cupsffi/printer.rb

@@ -0,0 +1,159 @@
+# The MIT License
+#
+# Copyright (c) 2011 Nathan Ehresman
+#
+# 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.
+
+class CupsPrinter
+  attr_reader :name
+
+  def initialize(name)
+    raise "Printer not found" unless CupsPrinter.get_all_printer_names.include? name
+    @name = name
+  end
+
+  def self.get_all_printer_names
+    p = FFI::MemoryPointer.new :pointer
+    dest_count = CupsFFI::cupsGetDests(p)
+    ary = []
+    dest_count.times do |i|
+      d = CupsFFI::CupsDestS.new(p.get_pointer(0) + (CupsFFI::CupsDestS.size * i))
+      ary.push(d[:name].dup)
+    end
+    CupsFFI::cupsFreeDests(dest_count, p.get_pointer(0))
+    ary
+  end
+
+  def attributes
+    p = FFI::MemoryPointer.new :pointer
+    dest_count = CupsFFI::cupsGetDests(p)
+    hash = {}
+    dest_count.times do |i|
+      dest = CupsFFI::CupsDestS.new(p.get_pointer(0) + (CupsFFI::CupsDestS.size * i))
+      next unless dest[:name] == @name
+      dest[:num_options].times do |j|
+        options = CupsFFI::CupsOptionS.new(dest[:options] + (CupsFFI::CupsOptionS.size * j))
+        hash[options[:name].dup] = options[:value].dup
+      end
+    end
+    CupsFFI::cupsFreeDests(dest_count, p.get_pointer(0))
+    hash
+  end
+
+  def state
+    o = attributes
+
+    {
+      :state =>
+        case o['printer-state']
+          when "3" then :idle
+          when "4" then :printing
+          when "5" then :stopped
+          else :unknown
+        end,
+      :reasons => o['printer-state-reasons'].split(/,/)
+    }
+  end
+
+  def print_file(file_name, options = {})
+    raise "File not found: #{file_name}" unless File.exists? file_name
+
+    options_pointer = nil
+    num_options = 0
+    unless options.empty?
+      validate_options(options)
+      options_pointer = FFI::MemoryPointer.new :pointer
+      options.map do |key,value|
+        num_options = CupsFFI::cupsAddOption(key.to_s, value.to_s, num_options, options_pointer)
+      end
+      options_pointer = options_pointer.get_pointer(0)
+    end
+
+    job_id = CupsFFI::cupsPrintFile(@name, file_name, file_name, num_options, options_pointer)
+
+    if job_id == 0
+      last_error = CupsFFI::cupsLastErrorString()
+      CupsFFI::cupsFreeOptions(num_options, options_pointer) unless options_pointer.nil?
+      raise last_error
+    end
+
+    CupsFFI::cupsFreeOptions(num_options, options_pointer) unless options_pointer.nil?
+    CupsJob.new(job_id, self)
+  end
+
+  def print_data(data, mime_type, options = {})
+    options_pointer = nil
+    num_options = 0
+    unless options.empty?
+      validate_options(options)
+      options_pointer = FFI::MemoryPointer.new :pointer
+      options.map do |key,value|
+        num_options = CupsFFI::cupsAddOption(key.to_s, value.to_s, num_options, options_pointer)
+      end
+      options_pointer = options_pointer.get_pointer(0)
+    end
+
+    job_id = CupsFFI::cupsCreateJob(CupsFFI::CUPS_HTTP_DEFAULT, @name, 'data job', num_options, options_pointer)
+    if job_id == 0
+      last_error = CupsFFI::cupsLastErrorString()
+      CupsFFI::cupsFreeOptions(num_options, options_pointer) unless options_pointer.nil?
+      raise last_error
+    end
+
+    http_status = CupsFFI::cupsStartDocument(CupsFFI::CUPS_HTTP_DEFAULT, @name,
+                                             job_id, 'my doc', mime_type, 1)
+
+    http_status = CupsFFI::cupsWriteRequestData(CupsFFI::CUPS_HTTP_DEFAULT, data, data.length)
+
+    ipp_status = CupsFFI::cupsFinishDocument(CupsFFI::CUPS_HTTP_DEFAULT, @name)
+
+    unless ipp_status == :ipp_ok
+      CupsFFI::cupsFreeOptions(num_options, options_pointer) unless options_pointer.nil?
+      raise ipp_status.to_s
+    end
+
+    CupsFFI::cupsFreeOptions(num_options, options_pointer) unless options_pointer.nil?
+    CupsJob.new(job_id, self)
+  end
+
+  def cancel_all_jobs
+    r = CupsFFI::cupsCancelJob(@name, CupsFFI::CUPS_JOBID_ALL)
+    raise CupsFFI::cupsLastErrorString() if r == 0
+  end
+
+
+  private
+  def validate_options(options)
+    ppd = CupsPPD.new(@name)
+
+    # Build a hash of the ppd options for quick lookup
+    ppd_options = {}
+    ppd.options.each do |ppd_option|
+      ppd_options[ppd_option[:keyword]] = ppd_option
+    end
+
+    # Examine each input option to make sure that both the key and value are
+    # found in the ppd options.
+    options.each do |key,value|
+      raise "Invalid option #{key} for printer #{@name}" if ppd_options[key].nil?
+      choices = ppd_options[key][:choices].map{|c| c[:choice]}
+      raise "Invalid value #{value} for option #{key}" unless choices.include?(value)
+    end
+  end
+end

data/lib/cupsffi/version.rb

@@ -0,0 +1,3 @@
+module Cupsffi
+  VERSION = "0.0.1"
+end

data/lib/cupsffi.rb

@@ -0,0 +1,6 @@
+require 'ffi'
+
+require 'cupsffi/lib'
+require 'cupsffi/printer'
+require 'cupsffi/job'
+require 'cupsffi/ppd'

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: cupsffi
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Nathan Ehresman
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-05 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: ffi
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+description: Simple wrapper around libcups to give CUPS printing capabilities to Ruby apps.
+email: 
+- nehresma@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- Rakefile
+- cupsffi.gemspec
+- lib/cupsffi.rb
+- lib/cupsffi/job.rb
+- lib/cupsffi/lib.rb
+- lib/cupsffi/ppd.rb
+- lib/cupsffi/printer.rb
+- lib/cupsffi/version.rb
+has_rdoc: true
+homepage: ""
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: cupsffi
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: FFI wrapper around libcups
+test_files: []
+