cupsffi 0.0.1 → 0.0.2

data/COPYING

@@ -0,0 +1,21 @@
+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.

data/README

@@ -0,0 +1,56 @@
+CupsFFI is an FFI wrapper around libcups providing access to the Cups API
+as well as the PPD API.  It was written using Ruby 1.9.2 but has not been
+tested with previous versions.
+
+## License
+
+CupsFFI is MIT licensed.
+
+## Installation
+
+    gem install cupsffi
+
+## Setup
+
+Nothing required.  libcups is used to find and read all configuration.
+
+## Example usage
+
+    require 'cupsffi'
+    # Returns array of printer names:
+    #  => ["HP-Officejet-7200-series", "test-printer"] 
+    printers = CupsPrinter.get_all_printer_names
+
+    printer = CupsPrinter.new(printers.first)
+
+    # Returns a hash of the Cups printer options:
+    # => {"auth-info-required"=>"none",
+    #     "copies"=>"1",
+    #     "device-uri"=>"ipp://192.168.250.55/ipp/3000", ...
+    printer.attributes
+
+    # Return a hash of :state and :reasons.
+    # :state is :idle, :printing, or :stopped.  For example:
+    # {:state=>:idle, :reasons=>["none"]}
+    printer.state
+
+    # Print a file (pdf, jpg, ps, etc.).  You can pass in a hash of printer
+    # options if you want to override the printer's defaults.  A CupsJob object
+    # is returned.  CupsJob can be used to check on the job status.
+    job = printer.print_file('/tmp/example.jpg', {'InputSlot' => 'Upper', 'PageSize' => 'A4'})
+
+    # A job's status is a CupsFFI::IppJState enumeration: 
+    # [:pending, :held, :processing, :stopped, :canceled, :aborted, :completed]
+    job.status
+
+    # Cancel a specific job
+    job.cancel
+
+    # Print a binary blob of data.  The data should be in a String, and is
+    # passed to libcups as a char array.  You must also specify the mime type.
+    # Like print_file, printer options are... optional.  A CupsJob object is
+    # returned.
+    job = printer.print_data('hello world', 'text/plain')
+
+    # Cancel all outstanding jobs on the printer
+    printer.cancel_all_jobs

data/lib/cupsffi/lib.rb

@@ -24,7 +24,17 @@ require 'ffi'
 
 module CupsFFI
   extend FFI::Library
-  ffi_lib 'cups'
+
+  paths =
+    Array(
+      ENV['CUPS_LIB'] ||
+      Dir['/{opt,usr}/{,local/}lib{,64}/libcups.{dylib,so*}']
+      )
+  begin
+    ffi_lib(*paths)
+  rescue LoadError => le
+    raise LoadError, "Didn't find libcups on your system."
+  end
 
   ### cups.h API
 

data/lib/cupsffi/version.rb

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

metadata

@@ -1,12 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: cupsffi
 version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 0
-  - 1
-  version: 0.0.1
+  prerelease: 
+  version: 0.0.2
 platform: ruby
 authors: 
 - Nathan Ehresman
@@ -14,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-05 00:00:00 -05:00
+date: 2011-03-07 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -25,8 +21,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :development
   version_requirements: *id001
@@ -41,7 +35,9 @@ extra_rdoc_files: []
 
 files: 
 - .gitignore
+- COPYING
 - Gemfile
+- README
 - Rakefile
 - cupsffi.gemspec
 - lib/cupsffi.rb
@@ -64,21 +60,17 @@ required_ruby_version: !ruby/object:Gem::Requirement
   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
+rubygems_version: 1.6.1
 signing_key: 
 specification_version: 3
 summary: FFI wrapper around libcups