ffi-cups2 0.4.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c6209044ae5c1ea2448cab3e8d044f33adf328b4fad06cd61869c68dbbf54855
+  data.tar.gz: e4cdd08e543a84abf899938f47a175910476cb5abbb0ff21005c29d951c3c217
+SHA512:
+  metadata.gz: 3afe3c436e6f6f42f70f716289e27d88890e2460302a1bc2dbad2df1e69157228373a2fc37e2419e4dbb5fd32229d32d3681e5f847260e3b87adada433d8735e
+  data.tar.gz: 5f189e1fc6dc75c059bece9e7109a1f3e4254cbf8daff8eef768378230cd632f23df1a58611387befea69a16a9ce2e98d094658caec061efa1a3532fc668e12b

data/.gitignore

@@ -0,0 +1,14 @@
+.bundle/
+log/
+pkg/
+*.gem
+
+Gemfile.lock
+
+# YARD
+.yardopts
+.yardoc
+doc/*
+
+# Byebug
+.byebug_history

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in ffi-cups.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2021 Hugo Marquez & Contributors
+
+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.md

@@ -0,0 +1,110 @@
+# FFI-Cups
+[![Gem Version](https://badge.fury.io/rb/ffi-cups2.svg)](https://badge.fury.io/rb/ffi-cups2)
+
+ffi-cups2 is a FFI bindings for libcups providing access to the Cups API through Ruby.
+It is compatible to ffi-cups, but the maintainer of ffi-cups is not reachable.
+
+CUPS is the standards-based, open source printing system developed by Apple Inc. for macOS® and other UNIX®-like operating systems. CUPS uses the Internet Printing Protocol (IPP) to support printing to local and network printers. - from http://www.cups.org/
+
+## Installation
+```bash
+gem install ffi-cups2
+```
+
+## Setup & Requirements
+ffi-cups2 requires libcups2 to be installed
+
+## Example usage
+```ruby
+require 'ffi-cups'
+
+printers = Cups::Printer.get_destinations
+# [#<Cups::Printer:0x000055fe50b15798 @name="Virtual_PDF_Printer",
+#  @options={"copies"=>"1", "device-uri"=>"cups-pdf:/", "finishings"=>"3"
+#  "job-cancel-after"=>"10800", "job-hold-until"=>"no-hold", ...
+
+printer = Cups::Printer.get_destination("Virtual_PDF_Printer")
+# <Cups::Printer:0x0000560f1d4e0958 @name="Virtual_PDF_Printer", @options={"copies"=>"1"
+#   "device-uri"=>"cups-pdf:/", ...
+
+printer.state
+# :idle
+
+printer.state_reasons
+# ["none"]
+
+printer.find_dest_supported
+# {type: :ipp_tag_keyword,
+#  values:
+#   ["copies",
+# ...
+#    "print-scaling",
+#    "printer-resolution",
+#    "sides"]}
+
+printer.find_dest_supported("copies")
+# {type: :ipp_tag_range, values: [{lowervalue: 1, uppervalue: 9999}]}
+
+printer.find_dest_supported("sides")
+# {type: :ipp_tag_keyword, values: ["one-sided", "two-sided-long-edge", "two-sided-short-edge"]}
+
+
+# Print a file (PDF, JPG, etc) you can pass a hash of printing options if you
+# want to override the printer's default. See Cups::Constants for more options
+options = {
+  Cups::MEDIA => Cups::MEDIA_A4,
+  Cups::ORIENTATION => Cups::ORIENTATION_LANDSCAPE
+}
+
+job = printer.print_file('/tmp/example.jpg', 'Title', options)
+# <Cups::Job:0x000055c87104d1e0 @id=10, @title="README", @printer="Virtual_PDF_Printer", @format="text/plain", @state=:processing, @size=4, @completed_time=1969-12-31 18:00:00 -0600, @creation_time=2021-04-18 17:35:04 -0500, @processing_time=2021-04-18 17:35:04 -0500>
+
+# Get all jobs from a printer
+jobs = Cups::Job.get_jobs('Virtual_PDF_Printer')
+# [#<Cups::Job:0x0000563aa6359008 @id=1, @title="Test Print", @printer="Virtual_PDF_Printer", @format="text/plain", @state=:completed, @size=1, @completed_time=2021-04-08 07:06:23 -0500, @creation_time=2021-04-08 07:06:18 -0500, @processing_time=2021-04-08 07:06:18 -0500>, ...]
+
+# filtering job's query, see Constants file for more options
+jobs = Cups::Job.get_jobs('Virtual_PDF_Printer', Cups::WHICHJOBS_ACTIVE)
+
+# Query job with id and printer's name
+job = Cups::Job.get_job(10, 'Virtual_PDF_Printer')
+# <Cups::Job:0x000055c870fc8490 @id=10, @title="README", @printer="Virtual_PDF_Printer", @format="text/plain", @state=:completed, @size=4, @completed_time=2021-04-18 17:35:04 -0500, @creation_time=2021-04-18 17:35:04 -0500, @processing_time=2021-04-18 17:35:04 -0500>
+```
+
+## Remote CUPS Server
+You may create a connection object passing a :hostname and/or :port arguments.
+
+```ruby
+# Create a Connection object with hostname and/or port
+connection = Cups::Connection.new('print.example.com')
+
+# Get all printers from the remote connection
+remote_printers = Cups::Printer.get_destinations(connection)
+```
+
+## Documentation
+Check out the documentation - [docs](https://www.rubydoc.info/gems/ffi-cups2)
+
+## Authors
+- Contributors @ https://github.com/larskanis/ffi-cups/graphs/contributors
+
+## License
+The MIT License
+
+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,6 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ffi-cups"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start(__FILE__)

data/bin/setup

@@ -0,0 +1,8 @@
+#!/usr/bin/env bash
+set -euo pipefail
+IFS=$'\n\t'
+set -vx
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ffi-cups.gemspec

@@ -0,0 +1,26 @@
+require_relative 'lib/ffi-cups/version'
+
+Gem::Specification.new do |s|
+  s.name        = "ffi-cups2"
+  s.version     = Cups::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Hugo Marquez", "Nathan Ehresman", "Lars Kanis"]
+  s.email       = ["hugomarquez.dev@gmail.com", "n_github@ehresman.org", "lars@greiz-reinsdorf.de"]
+  s.homepage    = "https://github.com/larskanis/ffi-cups"
+  s.summary     = "FFI wrapper around libcups2"
+  s.description = "Simple wrapper around libcups to give CUPS printing capabilities to Ruby apps."
+  s.license     = "MIT"
+  s.required_ruby_version = Gem::Requirement.new(">= 3.2")
+
+  s.add_runtime_dependency "ffi", "~> 1.16"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  s.files         = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  s.bindir        = "exe"
+  s.executables   = s.files.grep(%r{^exe/}) { |f| File.basename(f) }
+
+  s.require_paths = ["lib"]
+end

data/lib/ffi-cups/connection.rb

@@ -0,0 +1,39 @@
+module Cups
+  class Connection
+    extend Gem::Deprecate
+
+    attr_accessor :hostname, :port
+
+    def initialize(hostname, port=nil)
+      @hostname = hostname
+      @port = port.nil? ? 631 : port
+    end
+        
+    # Wrapper around {::Cups::Http#httpConnectEncrypt}
+    # @deprecated Use {#httpConnect2} instead
+    # @return [Pointer] a http pointer 
+    def httpConnectEncrypt
+      http = Cups::Http.httpConnectEncrypt(hostname, port, Cups.cupsEncryption())
+      raise "Print server at #{hostname}:#{port} is not available" if http.null?
+      return http
+    end
+    deprecate :httpConnectEncrypt, "This function is deprecated by CUPS, please use httpConnect2 instead", 2025, 12
+
+    # Wrapper around {::Cups::Http#httpConnect2}
+    # Creates a http connection to a print server
+    # @return [Pointer] a http pointer
+    def httpConnect2
+      http = Cups::Http.httpConnect2(hostname, port, nil, 0, Cups.cupsEncryption(), 1, 30000, nil)
+      raise "Print server at #{hostname}:#{port} is not available" if http.null? 
+      return http
+    end
+
+    # Closes the http connection and autoreleases the pointer
+    # Wrapper around {::Cups::Http#httpClose}
+    # @param http (Pointer)
+    def self.close(http)
+      Cups::Http.httpClose(http)
+    end
+  end
+end
+

data/lib/ffi-cups/constants.rb

@@ -0,0 +1,98 @@
+module Cups
+  # cups.h
+  FORMAT_JPEG		        = "image/jpeg"
+  FORMAT_PDF		        = "application/pdf"
+  FORMAT_TEXT		        = "text/plain"
+  JOBID_ALL             = -1
+  WHICHJOBS_ALL         = -1
+  WHICHJOBS_ACTIVE      = 0
+  WHICHJOBS_COMPLETED   = 1
+  HTTP_DEFAULT          = nil
+
+  # Options and Values
+  COPIES                = "copies"
+  COPIES_SUPPORTED      = "copies-supported"
+  
+  FINISHINGS            = "CUPS_FINISHINGS"
+  FINISHINGS_SUPPORTED  = "finishings-supported"
+  FINISHINGS_BIND		    = "7"
+  FINISHINGS_COVER		  = "6"
+  FINISHINGS_FOLD		    = "10"
+  FINISHINGS_NONE		    = "3"
+  FINISHINGS_PUNCH		  = "5"
+  FINISHINGS_STAPLE	    = "4"
+  FINISHINGS_TRIM		    = "11"
+  
+  # MEDIA
+  MEDIA			            = "media"
+  MEDIA_READY		        = "media-ready"
+  MEDIA_SUPPORTED		    = "media-supported"
+
+  MEDIA_3X5		          = "na_index-3x5_3x5in"
+  MEDIA_4X6	  	        = "na_index-4x6_4x6in"
+  MEDIA_5X7		          = "na_5x7_5x7in"
+  MEDIA_8X10		        = "na_govt-letter_8x10in"
+  MEDIA_A3			        = "iso_a3_297x420mm"
+  MEDIA_A4		          = "iso_a4_210x297mm"
+  MEDIA_A5			        = "iso_a5_148x210mm"
+  MEDIA_A6			        = "iso_a6_105x148mm"
+  MEDIA_ENV10		        = "na_number-10_4.125x9.5in"
+  MEDIA_ENVDL		        = "iso_dl_110x220mm"
+  MEDIA_LEGAL	          = "na_legal_8.5x14in"
+  MEDIA_LETTER		      = "na_letter_8.5x11in"
+  MEDIA_PHOTO_L		      = "oe_photo-l_3.5x5in"
+  MEDIA_SUPERBA3		    = "na_super-b_13x19in"
+  MEDIA_TABLOID		      = "na_ledger_11x17in"
+
+  MEDIA_SOURCE		        = "media-source"
+  MEDIA_SOURCE_SUPPORTED	= "media-source-supported"
+
+  MEDIA_SOURCE_AUTO	  = "auto"
+  MEDIA_SOURCE_MANUAL	= "manual"
+
+  MEDIA_TYPE		        = "media-type"
+  MEDIA_TYPE_SUPPORTED	= "media-type-supported"
+
+  MEDIA_TYPE_AUTO		      = "auto"
+  MEDIA_TYPE_ENVELOPE	    = "envelope"
+  MEDIA_TYPE_LABELS	      = "labels"
+  MEDIA_TYPE_LETTERHEAD	  = "stationery-letterhead"
+  MEDIA_TYPE_PHOTO		      = "photographic"
+  MEDIA_TYPE_PHOTO_GLOSSY	= "photographic-glossy"
+  MEDIA_TYPE_PHOTO_MATTE	  = "photographic-matte"
+  MEDIA_TYPE_PLAIN		      = "stationery"
+  MEDIA_TYPE_TRANSPARENCY	= "transparency"
+
+  NUMBER_UP		        = "number-up"
+  NUMBER_UP_SUPPORTED	= "number-up-supported"
+
+  ORIENTATION		        = "orientation-requested"
+  ORIENTATION_SUPPORTED	= "orientation-requested-supported"
+
+  ORIENTATION_PORTRAIT	  = "3"
+  ORIENTATION_LANDSCAPE	= "4"
+
+  PRINT_COLOR_MODE		        = "print-color-mode"
+  PRINT_COLOR_MODE_SUPPORTED = "print-color-mode-supported"
+
+  PRINT_COLOR_MODE_AUTO	      = "auto"
+  PRINT_COLOR_MODE_MONOCHROME  = "monochrome"
+  PRINT_COLOR_MODE_COLOR	      = "color"
+
+  PRINT_QUALITY		        = "print-quality"
+  PRINT_QUALITY_SUPPORTED	= "print-quality-supported"
+
+  PRINT_QUALITY_DRAFT	= "3"
+  PRINT_QUALITY_NORMAL	= "4"
+  PRINT_QUALITY_HIGH   = "5"
+
+  SIDES			      = "sides"
+  SIDES_SUPPORTED	=	"sides-supported"
+
+  SIDES_ONE_SIDED		        = "one-sided"
+  SIDES_TWO_SIDED_PORTRAIT	  = "two-sided-long-edge"
+  SIDES_TWO_SIDED_LANDSCAPE  = "two-sided-short-edge"
+
+  PPD_MAX_NAME = 41
+  PPD_MAX_TEXT = 81
+end

data/lib/ffi-cups/enum/http/ppd.rb

@@ -0,0 +1,22 @@
+module Cups::Enum
+  module Ppd
+    extend FFI::Library
+
+    # Maps the native ppd_ui_t enum from cups/ppd.h
+    Ui = enum(
+      :ppd_ui_boolean, # 0 - True or False option
+      :ppd_ui_pickone, # 1 - Pick exactly one choice
+      :ppd_ui_pickmany # 2 - Pick one or more choices
+    )
+
+    # Maps the native ppd_section_t enum from cups/ppd.h
+    Section = enum(
+      :ppd_order_any,      # 0 - Code can be anywhere in the document
+      :ppd_order_jcl,      # 1 - Job Control Language code
+      :ppd_order_prolog,   # 2 - PostScript prolog section
+      :ppd_order_setup,    # 3 - PostScript document setup section
+      :ppd_order_page_setup, # 4 - PostScript page setup section
+      :ppd_order_exit      # 5 - PostScript exit server section
+    )
+  end
+end

data/lib/ffi-cups/enum/http/status.rb

@@ -0,0 +1,50 @@
+module Cups::Enum
+  module HTTP
+    extend FFI::Library
+
+    Status = 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
+    ]
+  end
+end

data/lib/ffi-cups/enum/ipp/job_state.rb

@@ -0,0 +1,15 @@
+module Cups::Enum
+  module IPP
+    extend FFI::Library
+    
+    JobState = enum [
+      :pending, 3,
+      :held,
+      :processing,
+      :stopped,
+      :canceled,
+      :aborted,
+      :completed
+    ]
+  end
+end

data/lib/ffi-cups/enum/ipp/res.rb

@@ -0,0 +1,10 @@
+module Cups::Enum
+  module IPP
+    extend FFI::Library
+
+    Res = enum [  # ipp_res_e  # Resolution units
+      :ipp_res_per_inch, 3, # Pixels per inch
+      :ipp_res_per_cm,  # Pixels per centimeter
+    ]
+  end
+end

data/lib/ffi-cups/enum/ipp/status.rb

@@ -0,0 +1,53 @@
+module Cups::Enum
+  module IPP
+    extend FFI::Library
+
+    Status = 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
+    ]
+  end
+end

data/lib/ffi-cups/enum/ipp/tag.rb

@@ -0,0 +1,51 @@
+module Cups::Enum
+  module IPP
+    extend FFI::Library
+
+    Tag = enum [ # ipp_tag_e **** Format tags for attributes ****
+      :ipp_tag_cups_invalid, -1,		# Invalid tag name for @link ippTagValue@
+      :ipp_tag_zero, 0x00,			# Zero tag - used for separators
+      :ipp_tag_operation,			# operation group
+      :ipp_tag_job,				# job group
+      :ipp_tag_end,				# end-of-attributes
+      :ipp_tag_printer,			# printer group
+      :ipp_tag_unsupported_group,		# Unsupported attributes group
+      :ipp_tag_subscription,			# Subscription group
+      :ipp_tag_event_notification,		# Event group
+      :ipp_tag_resource,			# resource group @private@
+      :ipp_tag_document,			# document group
+      :ipp_tag_unsupported_value, 0x10,	# Unsupported value
+      :ipp_tag_default,			# default value
+      :ipp_tag_unknown,			# unknown value
+      :ipp_tag_novalue,			# no-value value
+      :ipp_tag_notsettable, 0x15,		# Not-settable value
+      :ipp_tag_deleteattr,			# delete-attribute value
+      :ipp_tag_admindefine,			# Admin-defined value
+      :ipp_tag_integer, 0x21,		# Integer value
+      :ipp_tag_boolean,			# boolean value
+      :ipp_tag_enum,				# enumeration value
+      :ipp_tag_string, 0x30,		# Octet string value
+      :ipp_tag_date,				# date/time value
+      :ipp_tag_resolution,			# resolution value
+      :ipp_tag_range,			# range value
+      :ipp_tag_begin_collection,		# Beginning of collection value
+      :ipp_tag_textlang,			# text-with-language value
+      :ipp_tag_namelang,			# name-with-language value
+      :ipp_tag_end_collection,		# End of collection value
+      :ipp_tag_text, 0x41,			# Text value
+      :ipp_tag_name,				# name value
+      :ipp_tag_reserved_string,		# Reserved for future string value @private@
+      :ipp_tag_keyword,			# keyword value
+      :ipp_tag_uri,				# uri value
+      :ipp_tag_urischeme,			# urI scheme value
+      :ipp_tag_charset,			# character set value
+      :ipp_tag_language,			# language value
+      :ipp_tag_mimetype,			# mimE media type value
+      :ipp_tag_membername,			# collection member name value
+      :ipp_tag_extension, 0x7f,		# Extension point for 32-bit tags
+      :ipp_tag_cups_mask, 0x7fffffff,	# Mask for copied attribute values @private@
+      # the following expression is used to avoid compiler warnings with +/-0x80000000
+      :ipp_tag_cups_const, -0x7fffffff-1	# Bitflag for copied/const attribute values @private@
+    ]
+  end
+end

data/lib/ffi-cups/ffi/array.rb

@@ -0,0 +1,17 @@
+module Cups
+  module Array
+    extend FFI::Library
+    
+    ffi_lib(Cups.libcups)
+    
+    # @overload cupsArrayFirst(pointer)
+    #   @param pointer [Pointer] to _cups_array_s struct
+    #   @return [Pointer] void pointer to first element
+    attach_function 'cupsArrayFirst', [:pointer], :pointer, blocking: true
+
+    # @overload cupsArrayNext(pointer)
+    #   @param pointer [Pointer] to _cups_array_s struct
+    #   @return [Pointer] void pointer to first element
+    attach_function 'cupsArrayNext', [:pointer], :pointer, blocking: true
+  end
+end