exempi 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f8b542870176af4c52ddf7a13d1f4bae891db89b
+  data.tar.gz: 3cea7bcc51f8f8921f45277bd43980b90dfcd810
+SHA512:
+  metadata.gz: 8002302d3272d602a1c50ec9e2932bd2c25e00298439d09754b5500c5a817aaacd1614499ae229ccac144fd9c8e826ebcb9d37da247a1d1e7cbd74888b1dda67
+  data.tar.gz: b95e971af05e2f0b82810031449c511414fa2eb5dcd1e7ceee52677039be54f10680c4fb9c00c76d1529ad00db8ae5f783e4ec37030510496191613a352aa64d

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,34 @@
+Copyright (C) 2015 Misty De Meo
+Copyright (C) 2012 Canadian Museum for Human Rights
+Copyright (C) 2007-2008,2012 Hubert Figuiere
+Copyright 2002-2007 Adobe Systems Incorporated
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1 Redistributions of source code must retain the above copyright
+notice, this list of conditions and the following disclaimer.
+
+2 Redistributions in binary form must reproduce the above copyright
+notice, this list of conditions and the following disclaimer in the
+documentation and/or other materials provided with the
+distribution.
+
+3 Neither the name of the Authors, nor the names of its
+contributors may be used to endorse or promote products derived
+from this software wit hout specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+OF THE POSSIBILITY OF SUCH DAMAGE.

data/README.md

@@ -0,0 +1,61 @@
+# Exempi
+
+Exempi is an ultra-thin [FFI](https://github.com/ffi/ffi)-based wrapper for the [Exempi](http://libopenraw.freedesktop.org/wiki/Exempi) C library. It wraps Exempi's functions in the Exempi module.
+
+Don't like dealing with C functions directly? Check out [Fasttrack](https://github.com/mistydemeo/fasttrack), an object-oriented wrapper around Exempi.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'exempi'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install exempi
+
+## Usage samples
+
+Opening a file:
+
+```ruby
+# create an empty file pointer
+file_ptr = Exempi.xmp_files_new
+Exempi.xmp_files_open file_ptr, "myfile.jpg", :XMP_OPEN_READ
+```
+
+Extracting XMP from a file:
+
+```ruby
+xmp_ptr = Exempi.files_get_new_xmp file_ptr
+```
+
+Fetching an XMP property from a file:
+
+```ruby
+# Exempi provides a set of standard namespace URIs for you
+exif_ns = Exempi::Namespaces::XMP_NS_EXIF
+xmp_string = Exempi.xmp_string_new
+
+Exempi.xmp_get_property xmp_ptr, exif_ns, 'DateTimeOriginal', xmp_string
+datetime = Exempi.xmp_string_cstr xmp_string
+Exempi.xmp_string_free xmp_string
+```
+
+For more information see Exempi's function documentation, included in lib/exempi/exempi.rb.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## License
+
+3-clause BSD, identical to the license used by Exempi and Adobe XMP Toolkit. For the license text, see LICENSE.

data/Rakefile

@@ -0,0 +1,9 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake/testtask'
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['test/*_test.rb']
+  t.verbose = true
+end

data/exempi.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/exempi/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Misty De Meo"]
+  gem.email         = ["mistydemeo@gmail.com"]
+  gem.description   = <<-EOS
+                      Exempi is a thin FFI-based wrapper around the
+                      Exempi library. It provides a variety of
+                      functions for reading, writing, and manipulating
+                      XMP metadata.
+                      EOS
+  gem.summary       = %q{Ruby wrapper for Exempi}
+  gem.homepage      = "https://github.com/mistydemeo/exempi"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "exempi"
+  gem.require_paths = ["lib"]
+  gem.version       = Exempi::VERSION
+
+  gem.add_dependency 'ffi', '>= 1.1.5'
+
+  gem.add_development_dependency 'rake', '>= 0.9.2.2'
+end

data/lib/exempi.rb

@@ -0,0 +1,4 @@
+require 'exempi/consts'
+require 'exempi/exempi'
+require 'exempi/errors'
+require 'exempi/exceptions'

data/lib/exempi/consts.rb

@@ -0,0 +1,338 @@
+# These constants and comments are taken from Exempi's xmp.h
+# 
+# Copyright (C) 2015 Misty De Meo
+# Copyright (C) 2012 Canadian Museum for Human Rights
+# Copyright (C) 2007-2008,2012 Hubert Figuiere
+# Copyright 2002-2007 Adobe Systems Incorporated
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1 Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# 
+# 2 Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the
+# distribution.
+#
+# 3 Neither the name of the Authors, nor the names of its
+# contributors may be used to endorse or promote products derived
+# from this software wit hout specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+# OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require 'exempi/exceptions'
+
+require 'date'
+require 'ffi'
+
+module Exempi
+  extend FFI::Library
+
+  # Option bits for xmp_files_open()
+  XMP_OPEN_FILE_OPTIONS = enum [
+    :XMP_OPEN_NOOPTION,           0x00000000, # No open option
+    :XMP_OPEN_READ,               0x00000001, # Open for read-only access.
+    :XMP_OPEN_FORUPDATE,          0x00000002, # Open for reading and writing.
+    :XMP_OPEN_ONLYXMP,            0x00000004, # Only the XMP is wanted, allows space/time optimizations.
+    :XMP_OPEN_CACHETNAIL,         0x00000008, # Cache thumbnail if possible, GetThumbnail will be called.
+    :XMP_OPEN_STRICTLY,           0x00000010, # Be strict about locating XMP and reconciling with other forms.
+    :XMP_OPEN_USESMARTHANDLER,    0x00000020, # Require the use of a smart handler.
+    :XMP_OPEN_USEPACKETSCANNING,  0x00000040, # Force packet scanning, don't use a smart handler.
+    :XMP_OPEN_LIMITSCANNING,      0x00000080, # Only packet scan files "known" to need scanning.
+    :XMP_OPEN_REPAIR_FILE,        0x00000100, # Attempt to repair a file opened for update, default is to not open (throw an exception).
+    :XMP_OPEN_INBACKGROUND,       0x10000000  # Set if calling from background thread.
+  ]
+
+  # Option bits for xmp_files_close()
+  XMP_CLOSE_FILE_OPTIONS = enum [
+    :XMP_CLOSE_NOOPTION,   0x0000,
+    :XMP_CLOSE_SAFEUPDATE, 0x0001
+  ]
+
+  # File formats
+  XMP_FILE_TYPE = enum [
+    :XMP_FT_PDF,     0x50444620,  # 'PDF '
+    :XMP_FT_PS,      0x50532020,  # 'PS  ', general PostScript following DSC conventions.
+    :XMP_FT_EPS,     0x45505320,  # 'EPS ', encapsulated PostScript.
+
+    :XMP_FT_JPEG,    0x4A504547,  # 'JPEG'
+    :XMP_FT_JPEG2K,  0x4A505820,  # 'JPX ', ISO 15444-1
+    :XMP_FT_TIFF,    0x54494646,  # 'TIFF'
+    :XMP_FT_GIF,     0x47494620,  # 'GIF '
+    :XMP_FT_PNG,     0x504E4720,  # 'PNG '
+    
+    :XMP_FT_SWF,     0x53574620,  # 'SWF '
+    :XMP_FT_FLA,     0x464C4120,  # 'FLA '
+    :XMP_FT_FLV,     0x464C5620,  # 'FLV '
+
+    :XMP_FT_MOV,     0x4D4F5620,  # 'MOV ', Quicktime
+    :XMP_FT_AVI,     0x41564920,  # 'AVI '
+    :XMP_FT_CIN,     0x43494E20,  # 'CIN ', Cineon
+    :XMP_FT_WAV,     0x57415620,  # 'WAV '
+    :XMP_FT_MP3,     0x4D503320,  # 'MP3 '
+    :XMP_FT_SES,     0x53455320,  # 'SES ', Audition session
+    :XMP_FT_CEL,     0x43454C20,  # 'CEL ', Audition loop
+    :XMP_FT_MPEG,    0x4D504547,  # 'MPEG'
+    :XMP_FT_MPEG2,   0x4D503220,  # 'MP2 '
+    :XMP_FT_MPEG4,   0x4D503420,  # 'MP4 ', ISO 14494-12 and -14
+    :XMP_FT_WMAV,    0x574D4156,  # 'WMAV', Windows Media Audio and Video
+    :XMP_FT_AIFF,    0x41494646,  # 'AIFF'
+
+    :XMP_FT_HTML,    0x48544D4C,  # 'HTML'
+    :XMP_FT_XML,     0x584D4C20,  # 'XML '
+    :XMP_FT_TEXT,    0x74657874,  # 'text'
+
+    # Adobe application file formats.
+    :XMP_FT_PHOTOSHOP,        0x50534420,  # 'PSD '
+    :XMP_FT_ILLUSTRATOR,      0x41492020,  # 'AI  '
+    :XMP_FT_INDESIGN,         0x494E4444,  # 'INDD'
+    :XMP_FT_AEPROJECT,        0x41455020,  # 'AEP '
+    :XMP_FT_AEPROJTEMPLATE,   0x41455420,  # 'AET ', After Effects Project Template
+    :XMP_FT_AEFILTERPRESET,   0x46465820,  # 'FFX '
+    :XMP_FT_ENCOREPROJECT,    0x4E434F52,  # 'NCOR'
+    :XMP_FT_PREMIEREPROJECT,  0x5052504A,  # 'PRPJ'
+    :XMP_FT_PREMIERETITLE,    0x5052544C,  # 'PRTL'
+
+    # Catch all.
+    :XMP_FT_UNKNOWN, 0x20202020
+  ]
+
+  XMP_FILE_FORMAT_OPTIONS = enum [
+    :XMP_FMT_CAN_INJECT_XMP,        0x00000001,
+    :XMP_FMT_CAN_EXPAND,            0x00000002,
+    :XMP_FMT_CAN_REWRITE,           0x00000004,
+    :XMP_FMT_PREFERS_IN_PLACE,      0x00000008,
+    :XMP_FMT_CAN_RECONCILE,         0x00000010,
+    :XMP_FMT_ALLOWS_ONLY_XMP,       0x00000020,
+    :XMP_FMT_RETURNS_RAW_PACKET,    0x00000040,
+    :XMP_FMT_HANDLER_OWNS_FILE,     0x00000100,
+    :XMP_FMT_ALLOW_SAFE_UPDATE,     0x00000200,
+    :XMP_FMT_NEEDS_READONLY_PACKET, 0x00000400,
+    :XMP_FMT_USE_SIDECAR_XMP,       0x00000800,
+    :XMP_FMT_FOLDER_BASED_FORMAT,   0x00001000,
+    :_XMP_FMT_LAST
+  ]
+
+  XMP_ITER_OPTIONS = enum [
+    :XMP_ITER_CLASSMASK,      0x00FF,  # The low 8 bits are an enum of what data structure to iterate.
+    :XMP_ITER_PROPERTIES,     0x0000,  # Iterate the property tree of a TXMPMeta object.
+    :XMP_ITER_ALIASES,        0x0001,  # Iterate the global alias table.
+    :XMP_ITER_NAMESPACES,     0x0002,  # Iterate the global namespace table.
+    :XMP_ITER_JUSTCHILDREN,   0x0100,  # Just do the immediate children of the root, default is subtree.
+    :XMP_ITER_JUSTLEAFNODES,  0x0200,  # Just do the leaf nodes, default is all nodes in the subtree.
+    :XMP_ITER_JUSTLEAFNAME,   0x0400,  # Return just the leaf part of the path, default is the full path.
+    :XMP_ITER_INCLUDEALIASES, 0x0800,  # Include aliases, default is just actual properties.
+    :XMP_ITER_OMITQUALIFIERS, 0x1000   # Omit all qualifiers.
+  ]
+
+  XMP_ITER_SKIP_OPTIONS = enum [
+    :XMP_ITER_SKIPSUBTREE,   0x0001, # Skip the subtree below the current node.
+    :XMP_ITER_SKIPSIBLINGS,  0x0002 # Skip the subtree below and remaining siblings of the current node.
+  ]
+
+  XMP_PROPS_BITS = enum [
+    # Options relating to the XML string form of the property value.
+    :XMP_PROP_VALUE_IS_URI,     0x00000002, # The value is a URI, use rdf:resource attribute.
+                                           # DISCOURAGED
+
+    # Options relating to qualifiers attached to a property.
+    :XMP_PROP_HAS_QUALIFIERS,   0x00000010, # The property has qualifiers, includes rdf:type and xml:lang.
+    :XMP_PROP_IS_QUALIFIER,     0x00000020, # This is a qualifier, includes rdf:type and xml:lang.
+    :XMP_PROP_HAS_LANG,         0x00000040, # Implies XMP_PropHasQualifiers, property has xml:lang.
+    :XMP_PROP_HAS_TYPE,         0x00000080, # Implies XMP_PropHasQualifiers, property has rdf:type.
+    
+    # Options relating to the data structure form.
+    :XMP_PROP_VALUE_IS_STRUCT,  0x00000100, # The value is a structure with nested fields.
+    :XMP_PROP_VALUE_IS_ARRAY,   0x00000200, # The value is an array (RDF alt/bag/seq).
+    :XMP_PROP_ARRAY_IS_UNORDERED, 0x00000200,  # The item order does not matter. (e.g. same as XMP_PROP_VALUE_IS_ARRAY)
+    :XMP_PROP_ARRAY_IS_ORDERED, 0x00000400, # Implies XMP_PropValueIsArray, item order matters.
+    :XMP_PROP_ARRAY_IS_ALT,     0x00000800, # Implies XMP_PropArrayIsOrdered, items are alternates.
+    
+    # Additional struct and array options.
+    :XMP_PROP_ARRAY_IS_ALTTEXT,    0x00001000, # Implies kXMP_PropArrayIsAlternate, items are localized text.
+    :XMP_PROP_ARRAY_INSERT_BEFORE, 0x00004000, # Used by array functions.
+    :XMP_PROP_ARRAY_INSERT_AFTER,  0x00008000, # Used by array functions.
+    
+    # Other miscellaneous options.
+    :XMP_PROP_IS_ALIAS,         0x00010000, # This property is an alias name for another property.
+    :XMP_PROP_HAS_ALIASES,      0x00020000, # This property is the base value for a set of aliases.
+    :XMP_PROP_IS_INTERNAL,      0x00040000, # This property is an "internal" property, owned by applications.
+    :XMP_PROP_IS_STABLE,        0x00100000, # This property is not derived from the document content.
+    :XMP_PROP_IS_DERIVED,       0x00200000, # This property is derived from the document content.
+
+    # Note that these are commented out in Exempi
+    # kXMPUtil_AllowCommas,   0x10000000UL,  ! Used by TXMPUtils::CatenateArrayItems and ::SeparateArrayItems.
+    # kXMP_DeleteExisting,    0x20000000UL,  ! Used by TXMPMeta::SetXyz functions to delete any pre-existing property.
+    # kXMP_SchemaNode,        0x80000000UL,  ! Returned by iterators - #define to avoid warnings
+
+    # Original values of these bitmasks noted; we can't access them by name
+    # XMP_PROP_ARRAY_FORM_MASK  = XMP_PROP_VALUE_IS_ARRAY | XMP_PROP_ARRAY_IS_ORDERED | XMP_PROP_ARRAY_IS_ALT | XMP_PROP_ARRAY_IS_ALTTEXT,
+    :XMP_PROP_ARRAY_FORM_MASK,  0x00000200 | 0x00000400 | 0x00000800 | 0x00001000,
+
+    # XMP_PROP_COMPOSITE_MASK   = XMP_PROP_VALUE_IS_STRUCT | XMP_PROP_ARRAY_FORM_MASK,  /* Is it simple or composite (array or struct)? */
+    :XMP_PROP_COMPOSITE_MASK,   0x00000100 | 0x00001E00,
+    :XMP_IMPL_RESERVED_MASK,    0x70000000   # Reserved for transient use by the implementation.
+  ]
+
+  # These values are used in the enum below
+  XMP_LITTLEENDIAN_BIT    = 0x0001  # ! Don't use directly, see the combined values below!
+  XMP_UTF16_BIT           = 0x0002
+  XMP_UTF32_BIT           = 0x0004
+
+  # Options for xmp_serialize
+  # Unnamed in exempi, named :XmpSerialOptions here
+  XMP_SERIAL_OPTIONS = enum [
+    :XMP_SERIAL_OMITPACKETWRAPPER,   0x0010,  # Omit the XML packet wrapper. */
+    :XMP_SERIAL_READONLYPACKET,      0x0020,  # Defat is a writeable packet. */
+    :XMP_SERIAL_USECOMPACTFORMAT,    0x0040,  # Use a compact form of RDF. */
+    
+    :XMP_SERIAL_INCLUDETHUMBNAILPAD, 0x0100,  # Include a padding allowance for a thumbnail image. */
+    :XMP_SERIAL_EXACTPACKETLENGTH,   0x0200,  # The padding parameter is the overall packet length. */
+    :XMP_SERIAL_WRITEALIASCOMMENTS,  0x0400,  # Show aliases as XML comments. */
+    :XMP_SERIAL_OMITALLFORMATTING,   0x0800,  # Omit all formatting whitespace. */
+    
+    :XMP_SERIAL_ENCODINGMASK,        0x0007,
+    :XMP_SERIAL_ENCODEUTF8,          0,
+    :XMP_SERIAL_ENCODEUTF16BIG,      XMP_UTF16_BIT,
+    :XMP_SERIAL_ENCODEUTF16LITTLE,   XMP_UTF16_BIT | XMP_LITTLEENDIAN_BIT,
+    :XMP_SERIAL_ENCODEUTF32BIG,      XMP_UTF32_BIT,
+    :XMP_SERIAL_ENCODEUTF32LITTLE,   XMP_UTF32_BIT | XMP_LITTLEENDIAN_BIT
+  ]
+
+  # Values used for tzSign field.
+  # Another unnamed enum, used in XmpDateTime below
+  TzSignValues = enum [
+    :XMP_TZ_WEST, -1, # West of UTC
+    :XMP_TZ_UTC,  0,  # UTC
+    :XMP_TZ_EAST, +1  # East of UTC
+  ]
+
+  class XmpDateTime < FFI::Struct
+    layout(
+           :year,       :int32,
+           :month,      :int32, # 1..12
+           :day,        :int32, # 1..31
+           :hour,       :int32, # 0..23
+           :minute,     :int32, # 0..59
+           :second,     :int32, # 0..59
+           :tzSign,     Exempi::TzSignValues, # -1..+1, 0 means UTC, -1 is west, +1 is east.
+           :tzHour,     :int32, # 0..23
+           :tzMinute,   :int32, # 0..59
+           :nanoSecond, :int32
+    )
+
+    # Converts a XmpDateTime struct into a Ruby object
+    # @return [DateTime] A new Ruby DateTime object
+    def to_datetime
+      sign = self[:tzSign] == :XMP_TZ_WEST ? '-' : '+'
+      zone = "%s%02d:%02d" % [sign, self[:tzHour], self[:tzMinute]]
+
+      second = self[:second] + Rational(self[:nanoSecond],1000000000)
+
+      DateTime.new self[:year], self[:month], self[:day], self[:hour],
+        self[:minute], second, zone
+    end
+
+    # Creates an XmpDateTime struct using a Ruby DateTime object,
+    # or a date string which is parseable by DateTime
+    # @param [DateTime, String] source the date to convert
+    # @return [Exempi::XmpDateTime] an XmpDateTime struct
+    def self.from_datetime source
+      if source.is_a? String
+        source = DateTime.parse source
+      end
+
+      struct = self.new
+      [:year, :month, :day, :hour, :minute, :second].each do |field|
+        struct[field] = source.send field
+      end
+      struct[:nanoSecond] = source.to_time.nsec
+
+      match = source.zone.match /(?<sign>[-+]){1}(?<hour>\d\d){1}:(?<minute>\d\d){1}/
+      if match
+        if match[:sign] == '-' then struct[:tzSign] = -1
+        elsif match[:hour] == '00' && match[:minute] == '00' then struct[:tzSign] = 0
+        else struct[:tzSign] = 1
+        end
+
+        struct[:tzHour] = match[:hour].to_i
+        struct[:tzMinute] = match[:minute].to_i
+      end
+
+      struct
+    end
+  end
+
+  # Creates DataConverter classes from each of these enums
+  [ "XMP_OPEN_FILE_OPTIONS", "XMP_CLOSE_FILE_OPTIONS", "XMP_FILE_TYPE",
+    "XMP_FILE_FORMAT_OPTIONS", "XMP_ITER_OPTIONS", "XMP_ITER_SKIP_OPTIONS",
+    "XMP_PROPS_BITS", "XMP_SERIAL_OPTIONS" ].each do |enum|
+      klass = Class.new do
+        extend FFI::DataConverter
+        native_type FFI::Type::INT
+        @enum = enum
+
+        def self.to_native(values, ctx)
+          case values
+          when Symbol
+            val = Exempi.const_get(@enum)[values]
+            if not val
+              raise Exempi::InvalidOptionError,
+                "#{values} is not a valid option for #{@enum}"
+            else
+              val
+            end
+          when Fixnum then values
+          when NilClass then 0
+          else
+            invalid_opt = values.find {|v| Exempi.const_get(@enum)[v].nil?}
+            if invalid_opt
+              raise Exempi::InvalidOptionError,
+                "#{invalid_opt} is not a valid option for #{@enum}"
+            end
+
+            values.inject(0) {|mask, value| mask |= Exempi.const_get(@enum)[value]}
+          end
+        end
+      end
+
+      klass_name = enum.split("_").map {|str| str.capitalize}.join
+      const_set klass_name, klass
+    end
+
+  # Converts a bitfield into a hash of named options via bitwise AND.
+  # @param [Integer] int the bitfield integer
+  # @param [FFI::Enum] enum the enum with which to compare
+  # @param [Boolean] short_name true to return shortened option names
+  # @return [Hash] a hash which includes symbol representations of the included options
+  def self.parse_bitmask int, enum, short_name=false
+    enum_hash = enum.to_hash
+    opt_hash = {}
+    enum_hash.each do |k,v|
+      if short_name
+        option = k.to_s.split("_")[2..-1].join("_").downcase.to_sym
+      else
+        option = k
+      end
+
+      opt_hash[option] = ((int & v) == v)
+    end
+
+    opt_hash
+  end
+end

data/lib/exempi/errors.rb

@@ -0,0 +1,97 @@
+# Error values and comments are taken from Exempi's xmperrors.h
+# 
+# Copyright (C) 2015 Misty De Meo
+# Copyright (C) 2012 Canadian Museum for Human Rights
+# Copyright (C) 2007 Hubert Figuiere
+# Copyright 2002-2007 Adobe Systems Incorporated
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1 Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# 
+# 2 Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the
+# distribution.
+#
+# 3 Neither the name of the Authors, nor the names of its
+# contributors may be used to endorse or promote products derived
+# from this software wit hout specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+# OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module Exempi
+  # This maps the numeric exceptions to their names.
+  # The numeric values are output by xmp_get_error()
+  ErrorCodes = {
+      # More or less generic error codes.
+       0     =>  :XMPErr_Unknown,
+      -1     =>  :XMPErr_TBD,
+      -2     =>  :XMPErr_Unavailable,
+      -3     =>  :XMPErr_BadObject,
+      -4     =>  :XMPErr_BadParam,
+      -5     =>  :XMPErr_BadValue,
+      -6     =>  :XMPErr_AssertFailure,
+      -7     =>  :XMPErr_EnforceFailure,
+      -8     =>  :XMPErr_Unimplemented,
+      -9     =>  :XMPErr_InternalFailure,
+      -10    =>  :XMPErr_Deprecated,
+      -11    =>  :XMPErr_ExternalFailure,
+      -12    =>  :XMPErr_UserAbort,
+      -13    =>  :XMPErr_StdException,
+      -14    =>  :XMPErr_UnknownException,
+      -15    =>  :XMPErr_NoMemory,
+
+      # More specific parameter error codes.
+      -101   =>  :XMPErr_BadSchema,
+      -102   =>  :XMPErr_BadXPath,
+      -103   =>  :XMPErr_BadOptions,
+      -104   =>  :XMPErr_BadIndex,
+      -105   =>  :XMPErr_BadIterPosition,
+      -106   =>  :XMPErr_BadParse,
+      -107   =>  :XMPErr_BadSerialize,
+      -108   =>  :XMPErr_BadFileFormat,
+      -109   =>  :XMPErr_NoFileHandler,
+      -110   =>  :XMPErr_TooLargeForJPEG,
+
+      # File format and internal structure error codes.
+      -201   =>  :XMPErr_BadXML,
+      -202   =>  :XMPErr_BadRDF,
+      -203   =>  :XMPErr_BadXMP,
+      -204   =>  :XMPErr_EmptyIterator,
+      -205   =>  :XMPErr_BadUnicode,
+      -206   =>  :XMPErr_BadTIFF,
+      -207   =>  :XMPErr_BadJPEG,
+      -208   =>  :XMPErr_BadPSD,
+      -209   =>  :XMPErr_BadPSIR,
+      -210   =>  :XMPErr_BadIPTC,
+      -211   =>  :XMPErr_BadMPEG
+  }
+
+  # Returns a symbol representing the XMP error for an int code.
+  # Used with the output of Exempi.xmp_get_error
+  # This is just a bit of sugar over Exempi::ErrorCodes[code]
+  # @param [Integer] code integer error code; should be obtained from
+  #   Exempi.xmp_get_error
+  def self.exception_for code
+    if !ErrorCodes[code]
+      raise ArgumentError, "#{error_code} is not an Exempi error code"
+    end
+    ErrorCodes[code]
+  end
+end

data/lib/exempi/exceptions.rb

@@ -0,0 +1,24 @@
+require 'exempi/errors'
+
+module Exempi
+  # This class provides a convenient interface for throwing exceptions
+  # when using Exempi functions. It allows the caller to specify an
+  # error code (retrievable from xmp_get_error()), and provides a
+  # method to retrieve the error name based on the code.
+  class ExempiError < StandardError
+    attr :error_code
+    def initialize error_code=0
+      if !Exempi::ErrorCodes[error_code]
+        raise ArgumentError, "#{error_code} is not an Exempi error code"
+      end
+      @error_code = error_code
+    end
+
+    # @return [Symbol] Exempi's error string for this exception
+    def xmp_error
+      Exempi::ErrorCodes[@error_code]
+    end
+  end
+
+  class InvalidOptionError < StandardError; end
+end

data/lib/exempi/exempi.rb

@@ -0,0 +1,325 @@
+# These comments are taken from Exempi's xmp.h
+# 
+# Copyright (C) 2015 Misty De Meo
+# Copyright (C) 2012 Canadian Museum for Human Rights
+# Copyright (C) 2007-2008,2012 Hubert Figuiere
+# Copyright 2002-2007 Adobe Systems Incorporated
+# All rights reserved.
+#
+# Redistribution and use in source and binary forms, with or without
+# modification, are permitted provided that the following conditions
+# are met:
+#
+# 1 Redistributions of source code must retain the above copyright
+# notice, this list of conditions and the following disclaimer.
+# 
+# 2 Redistributions in binary form must reproduce the above copyright
+# notice, this list of conditions and the following disclaimer in the
+# documentation and/or other materials provided with the
+# distribution.
+#
+# 3 Neither the name of the Authors, nor the names of its
+# contributors may be used to endorse or promote products derived
+# from this software wit hout specific prior written permission.
+#
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+# "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+# LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+# FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+# COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+# (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+# SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+# STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+# OF THE POSSIBILITY OF SUCH DAMAGE.
+
+require 'exempi/consts'
+
+require 'ffi'
+
+module Exempi
+  extend FFI::Library
+  ffi_lib 'exempi'
+
+  # we redefine attach_function so we can wrap all of the C functions
+  class << self
+    def verbose?; @verbose; end
+    attr_writer :verbose
+
+    def attach_function name, func, args, returns=nil, options={}
+      super
+      old_method = method(name)
+      define_singleton_method(name) do |*args|
+        shutup! { old_method.call(*args) }
+      end
+    end
+
+    protected
+
+    # Exempi spews stderr all over the place without giving you any way
+    # to quiet it! Boo!
+    def shutup!
+      if not verbose?
+        io = IO.new 2
+        stderr = io.dup
+        io.reopen IO::NULL
+      end
+      yield
+    ensure
+      io.reopen stderr unless verbose?
+    end
+  end
+
+  # Init the library. Must be called before anything else
+  attach_function :xmp_init, [  ], :bool
+  attach_function :xmp_terminate, [  ], :void
+
+  # get the error code that last occurred.
+  # @todo make this thread-safe. Getting the error code
+  # from another thread than the on it occurred in is undefined.
+  attach_function :xmp_get_error, [  ], :int
+
+  attach_function :xmp_files_new, [  ], :pointer
+  attach_function :xmp_files_open_new, [ :string, XmpOpenFileOptions ], :pointer
+  attach_function :xmp_files_open, [ :pointer, :string, XmpOpenFileOptions ], :bool
+
+  # Close an XMP file. Will flush the changes.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xf the file object
+  # @param [Exempi::XmpCloseFileOptions] options the options to close.
+  # @return [Boolean] true on succes, false on error
+  # xmp_get_error() will give the error code.
+  attach_function :xmp_files_close, [ :pointer, XmpCloseFileOptions ], :bool
+
+  attach_function :xmp_files_get_new_xmp, [ :pointer ], :pointer
+  attach_function :xmp_files_get_xmp, [ :pointer, :pointer ], :bool
+
+  attach_function :xmp_files_can_put_xmp, [ :pointer, :pointer ], :bool
+  attach_function :xmp_files_put_xmp, [ :pointer, :pointer ], :bool
+
+  # Get the file info from the open file
+  # @param [FFI::Pointer, FFI::MemoryPointer] xf the file object
+  # @param [FFI::Pointer, FFI::MemoryPointer] filePath the file path object to store the path in. Pass NULL if not needed.
+  # @param [FFI::Pointer, FFI::MemoryPointer] options the options for open. Pass NULL if not needed.
+  # @param [FFI::Pointer, FFI::MemoryPointer] file_format the detected file format. Pass NULL if not needed.
+  # @param [FFI::Pointer, FFI::MemoryPointer] handler_flags the format options like from %xmp_files_get_format_info.
+  # @return [Boolean] false in case of error.
+  attach_function :xmp_files_get_file_info, [ :pointer, :pointer, :pointer, :pointer, :pointer ], :bool
+
+  # Free a XmpFilePtr.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xf the file ptr. Cannot be NULL
+  # @return [Boolean] false on error.
+  # xmp_get_error() will give the error code.
+  attach_function :xmp_files_free, [ :pointer ], :bool
+
+  # Get the format info 
+  # @param [Integer] format type identifier
+  # @param [FFI::Pointer, FFI::MemoryPointer] option the options for the file format handler
+  # @return [Boolean] false on error
+  attach_function :xmp_files_get_format_info, [ :int, :pointer ], :bool
+
+  # Check the file format of a file. Use the same logic as in xmp_files_open()
+  # @param [String] filePath the path to the file
+  # @return [Integer] XMP_FT_UNKNOWN on error or if the file type is unknown
+  attach_function :xmp_files_check_file_format, [ :string ], :int
+
+  # Register a new namespace to add properties to.
+  # This is done automatically when reading the metadata block
+  # @param [String] namespaceURI the namespace URI to register
+  # @param [String] suggestedPrefix the suggested prefix
+  # @param [FFI::Pointer, FFI::MemoryPointer] registeredPrefix the really registered prefix. Not necessarily
+  #   %suggestedPrefix. 
+  # @return [Boolean] true if success, false otherwise.
+  attach_function :xmp_register_namespace, [ :string, :string, :pointer ], :bool
+
+  # Check if a namespace is registered.
+  # @param [String] ns the namespace to check.
+  # @param [FFI::Pointer, FFI::MemoryPointer] prefix The prefix associated if registered. Pass NULL
+  #   if not interested.
+  # @return [Boolean] true if registered.
+  # NEW in 2.1
+  attach_function :xmp_namespace_prefix, [ :string, :pointer ], :bool
+
+  # Check if a ns prefix is registered.
+  # @param [String] prefix the prefix to check.
+  # @param [FFI::Pointer, FFI::MemoryPointer] ns the namespace associated if registered. Pass NULL 
+  # if not interested.
+  # @return [Boolean] true if registered.
+  # NEW in 2.1
+  attach_function :xmp_prefix_namespace_uri, [ :string, :pointer ], :bool
+
+  attach_function :xmp_new_empty, [  ], :pointer
+
+  # Create a new XMP packet
+  # @param [String] buffer the buffer to load data from. UTF-8 encoded.
+  # @param [Integer] len the buffer length in byte
+  # @return [FFI::Pointer] the packet pointer. Must be free with xmp_free()
+  attach_function :xmp_new, [ :string, :uint ], :pointer
+
+  # Create a new XMP packet from the one passed.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the instance to copy. Can be NULL.
+  # @return [FFI::Pointer] the packet pointer. NULL is failer (or NULL is passed).
+  attach_function :xmp_copy, [ :pointer ], :pointer
+
+  # Free the xmp packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the xmp packet to free
+  attach_function :xmp_free, [ :pointer ], :bool
+
+  # Parse the XML passed through the buffer and load
+  # it.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet.
+  # @param [String] buffer the buffer.
+  # @param [Integer] len the length of the buffer.
+  attach_function :xmp_parse, [ :pointer, :string, :uint ], :bool
+
+  # Serialize the XMP Packet to the given buffer
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP Packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] buffer the buffer to write the XMP to
+  # @param [Exempi::XmpSerialOptions] options options on how to write the XMP.  See XMP_SERIAL_*
+  # @param [Integer] padding number of bytes of padding, useful for modifying
+  #                embedded XMP in place.
+  # @return [Boolean] TRUE if success.
+  attach_function :xmp_serialize, [ :pointer, :pointer, XmpSerialOptions, :uint32 ], :bool
+
+  # Serialize the XMP Packet to the given buffer with formatting
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP Packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] buffer the buffer to write the XMP to
+  # @param [Exempi::XmpSerialOptions] options options on how to write the XMP.  See XMP_SERIAL_*
+  # @param [Integer] padding number of bytes of padding, useful for modifying
+  #                embedded XMP in place.
+  # @param [String] newline the new line character to use
+  # @param [String] tab the indentation character to use
+  # @param [Integer] indent the initial indentation level
+  # @return [Boolean] TRUE if success.
+  attach_function :xmp_serialize_and_format, [ :pointer, :pointer, XmpSerialOptions, :uint32, :string, :string, :int32 ], :bool
+
+  # Get an XMP property and it option bits from the XMP packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema
+  # @param [String] name
+  # @param [FFI::Pointer, FFI::MemoryPointer] property the allocated XmpStringPtr
+  # @param [FFI::Pointer, FFI::MemoryPointer] propsBits pointer to the option bits. Pass NULL if not needed
+  # @return [Boolean] true if found
+  attach_function :xmp_get_property, [ :pointer, :string, :string, :pointer, :pointer ], :bool
+  attach_function :xmp_get_property_date, [ :pointer, :string, :string, XmpDateTime, :pointer ], :bool
+  attach_function :xmp_get_property_float, [ :pointer, :string, :string, :pointer, :pointer ], :bool
+  attach_function :xmp_get_property_bool, [ :pointer, :string, :string, :pointer, :pointer ], :bool
+  attach_function :xmp_get_property_int32, [ :pointer, :string, :string, :pointer, :pointer ], :bool
+  attach_function :xmp_get_property_int64, [ :pointer, :string, :string, :pointer, :pointer ], :bool
+
+  # Get an item frpm an array property
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the xmp meta
+  # @param [String] schema the schema
+  # @param [String] name the property name
+  # @param [Integer] index the index in the array
+  # @param [FFI::Pointer, FFI::MemoryPointer] property the property value
+  # @param [FFI::Pointer, FFI::MemoryPointer] propsBits the property bits. Pass NULL is unwanted.
+  # @return [Boolean] TRUE if success.
+  attach_function :xmp_get_array_item, [ :pointer, :string, :string, :int32, :pointer, :pointer ], :bool
+
+  # Set an XMP property in the XMP packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema
+  # @param [String] name
+  # @param [String] value 0 terminated string
+  # @param [Exempi::XmpPropsBits] optionBits
+  # @return [Boolean] false if failure
+  attach_function :xmp_set_property, [ :pointer, :string, :string, :string, XmpPropsBits ], :bool
+
+  # Set a date XMP property in the XMP packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema
+  # @param [String] name
+  # @param [FFI::Pointer, FFI::MemoryPointer] value the date-time struct
+  # @param [Exempi::XmpPropsBits] optionBits
+  # @return [Boolean] false if failure
+  attach_function :xmp_set_property_date, [ :pointer, :string, :string, :pointer, XmpPropsBits ], :bool
+
+  # Set a float XMP property in the XMP packet
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema
+  # @param [String] name
+  # @param [Float] value the float value
+  # @param [Exempi::XmpPropsBits] optionBits
+  # @return [Boolean] false if failure
+  attach_function :xmp_set_property_float, [ :pointer, :string, :string, :double, XmpPropsBits ], :bool
+  attach_function :xmp_set_property_bool, [ :pointer, :string, :string, :bool, XmpPropsBits ], :bool
+  attach_function :xmp_set_property_int32, [ :pointer, :string, :string, :int32, XmpPropsBits ], :bool
+  attach_function :xmp_set_property_int64, [ :pointer, :string, :string, :int64, XmpPropsBits ], :bool
+  attach_function :xmp_set_array_item, [ :pointer, :string, :string, :int32, :string, :uint32 ], :bool
+
+  attach_function :xmp_append_array_item, [ :pointer, :string, :string, :uint32, :string, :uint32 ], :bool
+
+  # Delete a property from the XMP Packet provided
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema the schema of the property
+  # @param [String] name the name of the property
+  attach_function :xmp_delete_property, [ :pointer, :string, :string ], :bool
+
+  # Determines if a property exists in the XMP Packet provided
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema the schema of the property. Can't be NULL or empty.
+  # @param [String] name the name of the property. Can't be NULL or empty.
+  # @return [Boolean] true is the property exists
+  attach_function :xmp_has_property, [ :pointer, :string, :string ], :bool
+
+  # Get a localised text from a localisable property.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema the schema
+  # @param [String] name the property name.
+  # @param [String] genericLang the generic language you may want as a fall back. 
+  # Can be NULL or empty.
+  # @param [String] specificLang the specific language you want. Can't be NULL or empty.
+  # @param [FFI::Pointer, FFI::MemoryPointer] actualLang the actual language of the value. Can be NULL if 
+  # not wanted.
+  # @param [FFI::Pointer, FFI::MemoryPointer] itemValue the localized value. Can be NULL if not wanted.
+  # @param [FFI::Pointer, FFI::MemoryPointer] propBits the options flags describing the property. Can be NULL.
+  # @return [Boolean] true if found, false otherwise.
+  attach_function :xmp_get_localized_text, [ :pointer, :string, :string, :string, :string, :pointer, :pointer, :pointer ], :bool
+
+  # Set a localised text in a localisable property.
+  # @param [FFI::Pointer, FFI::MemoryPointer] xmp the XMP packet
+  # @param [String] schema the schema
+  # @param [String] name the property name.
+  # @param [String] genericLang the generic language you may want to set too. 
+  # Can be NULL or empty.
+  # @param [String] specificLang the specific language you want. Can't be NULL or empty.
+  # @param [String] value the localized value. Cannot be NULL.
+  # @param [Exempi::XmpPropsBits] optionBits the options flags describing the property.
+  # @return [Boolean] true if set, false otherwise.
+  attach_function :xmp_set_localized_text, [ :pointer, :string, :string, :string, :string, :string, XmpPropsBits ], :bool
+
+  attach_function :xmp_delete_localized_text, [ :pointer, :string, :string, :string, :string ], :bool
+
+  # Instanciate a new string 
+  # @return [FFI::Pointer] the new instance. Must be freed with 
+  #   xmp_string_free()
+  attach_function :xmp_string_new, [  ], :pointer
+
+  # Free a XmpStringPtr
+  # @param [FFI::Pointer, FFI::MemoryPointer] s the string to free
+  attach_function :xmp_string_free, [ :pointer ], :void
+
+  # Get the C string from the XmpStringPtr
+  # @param [FFI::Pointer, FFI::MemoryPointer] s the string object
+  # @return [String] the const char * for the XmpStringPtr. It 
+  #   belong to the object.
+  attach_function :xmp_string_cstr, [ :pointer ], :string
+
+  attach_function :xmp_iterator_new, [ :pointer, :string, :string, XmpIterOptions ], :pointer
+  attach_function :xmp_iterator_free, [ :pointer ], :bool
+
+  # Iterate to the next value
+  # @param [FFI::Pointer, FFI::MemoryPointer] iter the iterator
+  # @param [FFI::Pointer, FFI::MemoryPointer] schema the schema name. Pass NULL if not wanted
+  # @param [FFI::Pointer, FFI::MemoryPointer] propName the property path. Pass NULL if not wanted
+  # @param [FFI::Pointer, FFI::MemoryPointer] propValue the value of the property. Pass NULL if not wanted.
+  # @param [FFI::Pointer, FFI::MemoryPointer] options the options for the property. Pass NULL if not wanted.
+  # @return [Boolean] true if still something, false if none
+  attach_function :xmp_iterator_next, [ :pointer, :pointer, :pointer, :pointer, :pointer ], :bool
+  attach_function :xmp_iterator_skip, [ :pointer, XmpIterSkipOptions ], :bool
+
+  # We do this first, before anything else!!
+  xmp_init
+end

data/lib/exempi/namespaces.rb

@@ -0,0 +1,161 @@
+# Copyright 2002 Adobe Systems Incorporated
+# All Rights Reserved.
+#
+# NOTICE:  Adobe permits you to use, modify, and distribute this file in accordance with the terms
+# of the Adobe license agreement accompanying it.
+# 
+# Copyright (c) 1999 - 2010, Adobe Systems IncorporatedAll rights reserved.
+# 
+# Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
+# 
+# * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
+# 
+# * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.
+# 
+# * Neither the name of Adobe Systems Incorporated, nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission.
+# 
+# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOTLIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FORA PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER ORCONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, ORPROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OFLIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDINGNEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THISSOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+module Exempi
+  module Namespaces
+    # Standard namespace URI constants
+    # 
+    # \name XML namespace constants for standard XMP schema.
+    # @{
+    #
+    # \def XMP_NS_XMP
+    # \brief The XML namespace for the XMP "basic" schema.
+    #
+    # \def XMP_NS_XMP_Rights
+    # \brief The XML namespace for the XMP copyright schema.
+    #
+    # \def XMP_NS_XMP_MM
+    # \brief The XML namespace for the XMP digital asset management schema.
+    #
+    # \def XMP_NS_XMP_BJ
+    # \brief The XML namespace for the job management schema.
+    #
+    # \def XMP_NS_XMP_T
+    # \brief The XML namespace for the XMP text document schema.
+    #
+    # \def XMP_NS_XMP_T_PG
+    # \brief The XML namespace for the XMP paged document schema.
+    #
+    # \def XMP_NS_PDF
+    # \brief The XML namespace for the PDF schema.
+    #
+    # \def XMP_NS_Photoshop
+    # \brief The XML namespace for the Photoshop custom schema.
+    #
+    # \def XMP_NS_EXIF
+    # \brief The XML namespace for Adobe's EXIF schema.
+    #
+    # \def XMP_NS_TIFF
+    # \brief The XML namespace for Adobe's TIFF schema.
+
+    XMP_NS_XMP        = "http://ns.adobe.com/xap/1.0/"
+
+    XMP_NS_XMP_Rights = "http://ns.adobe.com/xap/1.0/rights/"
+    XMP_NS_XMP_MM     = "http://ns.adobe.com/xap/1.0/mm/"
+    XMP_NS_XMP_BJ     = "http://ns.adobe.com/xap/1.0/bj/"
+
+    XMP_NS_PDF        = "http://ns.adobe.com/pdf/1.3/"
+    XMP_NS_Photoshop  = "http://ns.adobe.com/photoshop/1.0/"
+    XMP_NS_PSAlbum    = "http://ns.adobe.com/album/1.0/"
+    XMP_NS_EXIF       = "http://ns.adobe.com/exif/1.0/"
+    XMP_NS_EXIF_Aux   = "http://ns.adobe.com/exif/1.0/aux/"
+    XMP_NS_TIFF       = "http://ns.adobe.com/tiff/1.0/"
+    XMP_NS_PNG        = "http://ns.adobe.com/png/1.0/"
+    XMP_NS_SWF        = "http://ns.adobe.com/swf/1.0/"
+    XMP_NS_JPEG       = "http://ns.adobe.com/jpeg/1.0/"
+    XMP_NS_JP2K       = "http://ns.adobe.com/jp2k/1.0/"
+    XMP_NS_CameraRaw  = "http://ns.adobe.com/camera-raw-settings/1.0/"
+    XMP_NS_DM         = "http://ns.adobe.com/xmp/1.0/DynamicMedia/"
+    XMP_NS_Script     = "http://ns.adobe.com/xmp/1.0/Script/"
+    XMP_NS_ASF        = "http://ns.adobe.com/asf/1.0/"
+    XMP_NS_WAV        = "http://ns.adobe.com/xmp/wav/1.0/"
+    XMP_NS_BWF        = "http://ns.adobe.com/bwf/bext/1.0/"
+
+    XMP_NS_XMP_Note   = "http://ns.adobe.com/xmp/note/"
+
+    XMP_NS_AdobeStockPhoto = "http://ns.adobe.com/StockPhoto/1.0/"
+    XMP_NS_CreatorAtom = "http://ns.adobe.com/creatorAtom/1.0/"
+
+    # \name XML namespace constants for qualifiers and structured property fields.
+    # @{
+    #
+    # \def XMP_NS_XMP_IdentifierQual
+    # \brief The XML namespace for qualifiers of the xmp:Identifier property.
+    #
+    # \def XMP_NS_XMP_Dimensions
+    # \brief The XML namespace for fields of the Dimensions type.
+    #
+    # \def XMP_NS_XMP_Image
+    # \brief The XML namespace for fields of a graphical image. Used for the Thumbnail type.
+    #
+    # \def XMP_NS_XMP_ResourceEvent
+    # \brief The XML namespace for fields of the ResourceEvent type.
+    #
+    # \def XMP_NS_XMP_ResourceRef
+    # \brief The XML namespace for fields of the ResourceRef type.
+    #
+    # \def XMP_NS_XMP_ST_Version
+    # \brief The XML namespace for fields of the Version type.
+    #
+    # \def XMP_NS_XMP_ST_Job
+    # \brief The XML namespace for fields of the JobRef type.
+
+    XMP_NS_XMP_IdentifierQual = "http://ns.adobe.com/xmp/Identifier/qual/1.0/"
+    XMP_NS_XMP_Dimensions     = "http://ns.adobe.com/xap/1.0/sType/Dimensions#"
+    XMP_NS_XMP_Text           = "http://ns.adobe.com/xap/1.0/t/"
+    XMP_NS_XMP_PagedFile      = "http://ns.adobe.com/xap/1.0/t/pg/"
+    XMP_NS_XMP_Graphics       = "http://ns.adobe.com/xap/1.0/g/"
+    XMP_NS_XMP_Image          = "http://ns.adobe.com/xap/1.0/g/img/"
+    XMP_NS_XMP_Font           = "http://ns.adobe.com/xap/1.0/sType/Font#"
+    XMP_NS_XMP_ResourceEvent  = "http://ns.adobe.com/xap/1.0/sType/ResourceEvent#"
+    XMP_NS_XMP_ResourceRef    = "http://ns.adobe.com/xap/1.0/sType/ResourceRef#"
+    XMP_NS_XMP_ST_Version     = "http://ns.adobe.com/xap/1.0/sType/Version#"
+    XMP_NS_XMP_ST_Job         = "http://ns.adobe.com/xap/1.0/sType/Job#"
+    XMP_NS_XMP_ManifestItem   = "http://ns.adobe.com/xap/1.0/sType/ManifestItem#"
+
+    # Deprecated XML namespace constants
+    XMP_NS_XMP_T     = "http://ns.adobe.com/xap/1.0/t/"
+    XMP_NS_XMP_T_PG  = "http://ns.adobe.com/xap/1.0/t/pg/"
+    XMP_NS_XMP_G_IMG = "http://ns.adobe.com/xap/1.0/g/img/"
+
+    # XML namespace constants from outside Adobe.
+    # @{
+    #
+    # \def XMP_NS_DC
+    # \brief The XML namespace for the Dublin Core schema.
+    #
+    # \def XMP_NS_IPTCCore
+    # \brief The XML namespace for the IPTC Core schema.
+    #
+    # \def XMP_NS_RDF
+    # \brief The XML namespace for RDF.
+    #
+    # \def XMP_NS_XML
+    # \brief The XML namespace for XML.
+
+    XMP_NS_DC             = "http://purl.org/dc/elements/1.1/"
+
+    XMP_NS_IPTCCore       = "http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/"
+
+    XMP_NS_DICOM          = "http://ns.adobe.com/DICOM/"
+
+    XMP_NS_PDFA_Schema    = "http://www.aiim.org/pdfa/ns/schema#"
+    XMP_NS_PDFA_Property  = "http://www.aiim.org/pdfa/ns/property#"
+    XMP_NS_PDFA_Type      = "http://www.aiim.org/pdfa/ns/type#"
+    XMP_NS_PDFA_Field     = "http://www.aiim.org/pdfa/ns/field#"
+    XMP_NS_PDFA_ID        = "http://www.aiim.org/pdfa/ns/id/"
+    XMP_NS_PDFA_Extension = "http://www.aiim.org/pdfa/ns/extension/"
+
+    XMP_NS_PDFX           = "http://ns.adobe.com/pdfx/1.3/"
+    XMP_NS_PDFX_ID        = "http://www.npes.org/pdfx/ns/id/"
+
+    XMP_NS_RDF            = "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+    XMP_NS_XML            = "http://www.w3.org/XML/1998/namespace"
+
+  end
+end

data/lib/exempi/version.rb

@@ -0,0 +1,3 @@
+module Exempi
+  VERSION = "0.1"
+end

data/test/dataconverter_test.rb

@@ -0,0 +1,48 @@
+require 'exempi/consts'
+
+require 'minitest/autorun'
+
+describe "dataconverter helper" do
+	it "should be able to look up single symbol values" do
+    Exempi::XmpOpenFileOptions.to_native(:XMP_OPEN_READ, nil).must_equal 0x00000001
+  end
+
+  it "should be able to look up an array of symbol values" do
+    Exempi::XmpOpenFileOptions.to_native([:XMP_OPEN_USESMARTHANDLER,
+      :XMP_OPEN_USEPACKETSCANNING], nil).must_equal 0x00000060
+  end
+
+  it "should be able to handle pure integer values" do
+    Exempi::XmpOpenFileOptions.to_native(0x00000001, nil).must_equal 0x00000001
+  end
+
+  it "should return 0 when nil is passed" do
+    Exempi::XmpOpenFileOptions.to_native(nil, nil).must_equal 0
+  end
+
+  it "should raise when invalid options are passed" do
+    lambda do
+      Exempi::XmpOpenFileOptions.to_native(:notanoption, nil)
+    end.must_raise Exempi::InvalidOptionError
+
+    lambda do
+      Exempi::XmpOpenFileOptions.to_native([:notanoption, :notanoption], nil)
+    end.must_raise Exempi::InvalidOptionError
+  end
+
+  it "should be able to translate integers into hashes of options" do
+    hash = Exempi.parse_bitmask 0x00000060, Exempi::XMP_OPEN_FILE_OPTIONS
+
+    assert hash[:XMP_OPEN_USESMARTHANDLER]
+    assert hash[:XMP_OPEN_USEPACKETSCANNING]
+    refute hash[:XMP_OPEN_FORUPDATE]
+  end
+
+  it "should optionally be able to return short option names" do
+    hash = Exempi.parse_bitmask 0x00000060, Exempi::XMP_OPEN_FILE_OPTIONS, true
+
+    assert hash[:usesmarthandler]
+    assert hash[:usepacketscanning]
+    refute hash[:forupdate]
+  end
+end

data/test/datetime_test.rb

@@ -0,0 +1,35 @@
+require 'exempi/consts'
+
+require 'minitest/autorun'
+
+describe "DateTime struct wrapper" do
+  it "should be able to construct an XmpDateTime struct manually" do
+    date = Exempi::XmpDateTime.new
+    date[:year]  = 2012
+    date[:month] = 9
+    date[:day]   = 7
+  end
+
+  it "should be able to create an XmpDateTime struct from a DateTime object" do
+    today = DateTime.now
+    date = Exempi::XmpDateTime.from_datetime today
+
+    date[:year].must_equal today.year
+  end
+
+  it "should be able to create an XmpDateTime struct from a string" do
+    today = '2012-09-07'
+    date = Exempi::XmpDateTime.from_datetime today
+
+    date[:year].must_equal 2012
+    date[:month].must_equal 9
+    date[:day].must_equal 7
+  end
+
+  it "should be able to translate XmpDateTime structs into DateTime objects" do
+    today = DateTime.now
+    date = Exempi::XmpDateTime.from_datetime today
+
+    date.to_datetime.must_equal today
+  end
+end

data/test/helpers_test.rb

@@ -0,0 +1,22 @@
+require 'exempi'
+
+require 'minitest/autorun'
+
+describe "Exempi helpers" do
+  it "should be able to silence stderr for noisy blocks" do
+    Exempi.verbose = false
+    lambda do
+      Exempi.send(:shutup!) { STDERR.puts "You should not see this" }
+    end.must_be_silent
+  end
+
+  it "should wrap Exempi functions correctly" do
+    Exempi.verbose = false
+    lambda do
+      # Exempi spews errors to stderr, so we've wrapped attach_function
+      # in order to ensure that every function call is wrapped with
+      # the silencing shutup! method
+      Exempi.xmp_files_open_new('no_file_here', 0)
+    end.must_be_silent
+  end
+end

metadata

@@ -0,0 +1,95 @@
+--- !ruby/object:Gem::Specification
+name: exempi
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Misty De Meo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-12-03 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ffi
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.5
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.9.2.2
+description: |2
+                        Exempi is a thin FFI-based wrapper around the
+                        Exempi library. It provides a variety of
+                        functions for reading, writing, and manipulating
+                        XMP metadata.
+email:
+- mistydemeo@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- exempi.gemspec
+- lib/exempi.rb
+- lib/exempi/consts.rb
+- lib/exempi/errors.rb
+- lib/exempi/exceptions.rb
+- lib/exempi/exempi.rb
+- lib/exempi/namespaces.rb
+- lib/exempi/version.rb
+- test/dataconverter_test.rb
+- test/datetime_test.rb
+- test/helpers_test.rb
+homepage: https://github.com/mistydemeo/exempi
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Ruby wrapper for Exempi
+test_files:
+- test/dataconverter_test.rb
+- test/datetime_test.rb
+- test/helpers_test.rb
+has_rdoc: