file_data 4.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 008003613bb4284356911dcc023da0a9190f9787
+  data.tar.gz: 95cfd92bf198612c9e20796577809f507cd866ab
+SHA512:
+  metadata.gz: fd9ae2b5d47292ee6a0318dce866f97fa4d42ad812de9e05e5e1c18e140fa0186ab93045af8a7c0c8fafc01b9ad5d9e2e0fd7b77fee2d86d9de873d2fbe29274
+  data.tar.gz: 759531661d30f168362e75494e2dff6c003cefc3dd6819d6875882df32280aa617e00f98d16648f003633a80ba173c9610d40ddb20ab6648bcbbc65bc2bc17ab

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,50 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/spec/examples.txt
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+# Used by dotenv library to load environment variables.
+# .env
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+*.bridgesupport
+build-iPhoneOS/
+build-iPhoneSimulator/
+
+## Specific to RubyMotion (use of CocoaPods):
+#
+# We recommend against adding the Pods directory to your .gitignore. However
+# you should judge for yourself, the pros and cons are mentioned at:
+# https://guides.cocoapods.org/using/using-cocoapods.html#should-i-check-the-pods-directory-into-source-control
+#
+# vendor/Pods/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalization:
+/.bundle/
+/vendor/bundle
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require ./spec/spec_helper.rb

data/.rubocop.yml

@@ -0,0 +1,19 @@
+Metrics/LineLength:
+  Max: 100
+  Exclude:
+    - 'spec/**/*_spec.rb'
+Metrics/MethodLength:
+  Max: 15
+Metrics/ClassLength:
+  Max: 100
+EndOfLine:
+  Enabled: false
+Style/BlockLength:
+  Exclude:
+    - 'spec/**/*_spec.rb'
+Style/BlockComments:
+  Exclude:
+    - 'spec/spec_helper.rb'
+AllCops:
+  Exclude:
+    - 'file_data.gemspec'

data/.travis.yml

@@ -0,0 +1,5 @@
+sudo: false
+language: ruby
+rvm:
+  - 2.3.3
+before_install: gem install bundler -v 1.14.3

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,56 @@
+PATH
+  remote: .
+  specs:
+    file_data (4.0.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    coveralls (0.8.19)
+      json (>= 1.8, < 3)
+      simplecov (~> 0.12.0)
+      term-ansicolor (~> 1.3)
+      thor (~> 0.19.1)
+      tins (~> 1.6)
+    diff-lcs (1.3)
+    docile (1.1.5)
+    fakefs (0.10.2)
+    json (2.0.3)
+    rake (10.5.0)
+    rspec (3.5.0)
+      rspec-core (~> 3.5.0)
+      rspec-expectations (~> 3.5.0)
+      rspec-mocks (~> 3.5.0)
+    rspec-core (3.5.4)
+      rspec-support (~> 3.5.0)
+    rspec-expectations (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-mocks (3.5.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.5.0)
+    rspec-support (3.5.0)
+    simplecov (0.12.0)
+      docile (~> 1.1.0)
+      json (>= 1.8, < 3)
+      simplecov-html (~> 0.10.0)
+    simplecov-html (0.10.0)
+    term-ansicolor (1.4.0)
+      tins (~> 1.0)
+    thor (0.19.4)
+    tins (1.13.2)
+
+PLATFORMS
+  ruby
+  x64-mingw32
+
+DEPENDENCIES
+  bundler (~> 1.14)
+  coveralls (~> 0.8)
+  fakefs (~> 0.10)
+  file_data!
+  rake (~> 10.0)
+  rspec (~> 3.0)
+
+BUNDLED WITH
+   1.14.3

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2017 Scott
+
+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,222 @@
+file_data
+=========
+
+[![Build Status](https://travis-ci.org/ScottHaney/file_data.svg?branch=master)](https://travis-ci.org/ScottHaney/file_data)
+[![Coverage Status](https://coveralls.io/repos/github/ScottHaney/file_data/badge.svg?branch=master)](https://coveralls.io/github/ScottHaney/file_data?branch=master)
+[![Code Climate](https://codeclimate.com/github/ScottHaney/file_data/badges/gpa.svg)](https://codeclimate.com/github/ScottHaney/file_data)
+
+Ruby library that reads file metadata.
+
+Current support
+
+* Exif: Only jpeg files are supported and FlashPix extensions are not supported
+
+## Exif documentation
+
+Exif data is hierarchical and consists of tag/value pairs. The first level is whether or not the tag applies to the image or the image's thumbnail. Next a tag may be one of several sections and within the section it will have a unique numeric value. So given this terminology a unique key for an exif tag would be something like image/section1/123 for a tag that applies to the image in section 1 with a tag id of 123.
+
+To read exif data a stream of the jpeg data should be used as input. For performance reasons all of the data that is desired should be extracted in a single method from FileData::Exif. All methods will manipulate the stream position after they are called and the user should not count on the stream position being at a specific location after a FileData::Exif method call.
+
+Examples:
+
+```ruby
+# Get Exif data from a file path or stream
+
+# Complete example with file path...
+tag_value = FileData::Exif.new.image_data_only('/path/to/file.jpg')
+
+# Complete example with a file stream... 
+File.open('/path/to/file.jpg', 'rb') do |f|
+  hash = FileData::Exif.new.image_data_only(f)
+end
+
+# Examples for all commands
+
+## Commands that get multiple tag values
+
+# Get only the image Exif data
+hash = FileData::Exif.new.image_data_only(file_path_or_stream)
+
+# Get only the thumbnail Exif data
+hash = FileData::Exif.new.thumbnail_data_only(file_path_or_stream)
+
+# Get all data (image and thumbnail)
+# Use result.image or result.thumbnail to get value hashes
+result = FileData::Exif.new.all_data(file_path_or_stream)
+
+## Commands that get a single tag value
+# tag_key is section/tag_id from the description in the first paragraph
+# tag_key values can be taken from the hash keys in FileData::ExifTags.tag_groups
+# all FileData::ExifTags.tag_groups keys are given after the examples
+
+# Image example
+tag_value = FileData::Exif.new.only_image_tag(file_path_or_stream, tag_id)
+
+# Thumbnail example
+tag_value = FileData::Exif.new.only_thumbnail_tag(file_path_or_stream, tag_id)
+```
+
+## Known Tag Keys
+
+Below is the contents of FileData::ExifTags.tag_groups which lists all known tag keys and their uniquely assigned names
+
+```ruby
+# Tiff Tags (0th and 1st IFDs)
+FileData::ExifTags.tag_groups[:Tiff] =
+  {
+    256 => :Image_Structure_Width,
+    257 => :Image_Structure_Length,
+    258 => :Image_Structure_BitsPerSample,
+    259 => :Image_Structure_Compression,
+    262 => :Image_Structure_PhotometricInterpretation,
+    270 => :Other_ImageDescription,
+    271 => :Other_Make,
+    272 => :Other_Model,
+    273 => :Recording_StripOffsets,
+    274 => :Image_Structure_Orientation,
+    277 => :Image_Structure_SamplesPerPixel,
+    278 => :Recording_RowsPerStrip,
+    279 => :Recording_StripByteCounts,
+    283 => :Image_Structure_YResolution,
+    284 => :Image_Structure_PlanarConfiguration,
+    296 => :Image_Structure_ResolutionUnit,
+    301 => :Image_Data_TransferFunction,
+    305 => :Other_Software,
+    306 => :Other_DateTime,
+    315 => :Other_Artist,
+    318 => :Image_Data_WhitePoint,
+    319 => :Image_Data_PrimaryChromaticities,
+    513 => :Recording_JPEGInterchangeFormat,
+    514 => :Recording_JPEGInterchangeFormatLength,
+    529 => :Image_Data_YCbCrCoefficients,
+    530 => :Image_Structure_YCbCrSubSampling,
+    531 => :Image_Structure_YCbCrPositioning,
+    532 => :Image_Data_ReferenceBlackWhite,
+    33_432 => :Other_Copyright
+  }
+
+# Exif IFD Tags
+FileData::ExifTags.tag_groups[34_665] =
+  {
+    33_434 => :Exif_PictureTakingConditions_ExposureTime,
+    33_437 => :Exif_PictureTakingConditions_FNumber,
+    34_850 => :Exif_PictureTakingConditions_ExposureProgram,
+    34_852 => :Exif_PictureTakingConditions_SpectralSensitivity,
+    34_855 => :Exif_PictureTakingConditions_PhotographicSensitivity,
+    34_856 => :Exif_PictureTakingConditions_OECF,
+    34_864 => :Exif_PictureTakingConditions_SensitivityType,
+    34_865 => :Exif_PictureTakingConditions_StandardOutputSensitivity,
+    34_866 => :Exif_PictureTakingConditions_RecommendedExposureIndex,
+    34_867 => :Exif_PictureTakingConditions_ISOSpeed,
+    34_868 => :Exif_PictureTakingConditions_ISOSpeedLatitudeyyy,
+    34_869 => :Exif_PictureTakingConditions_ISOSpeedLatitudezzz,
+    36_864 => :Exif_Version_ExifVersion,
+    36_867 => :Exif_DateAndTime_DateTimeOriginal,
+    36_868 => :Exif_DateAndTime_DateTimeDigitized,
+    37_121 => :Exif_Configuration_ComponentsConfiguration,
+    37_122 => :Exif_Configuration_CompressedBitsPerPixel,
+    37_377 => :Exif_PictureTakingConditions_ShutterSpeedValue,
+    37_378 => :Exif_PictureTakingConditions_ApertureValue,
+    37_379 => :Exif_PictureTakingConditions_BrightnessValue,
+    37_380 => :Exif_PictureTakingConditions_ExposureBiasValue,
+    37_381 => :Exif_PictureTakingConditions_MaxApertureValue,
+    37_382 => :Exif_PictureTakingConditions_SubjectDistance,
+    37_383 => :Exif_PictureTakingConditions_MeteringMode,
+    37_384 => :Exif_PictureTakingConditions_LightSource,
+    37_385 => :Exif_PictureTakingConditions_Flash,
+    37_396 => :Exif_PictureTakingConditions_SubjectArea,
+    37_386 => :Exif_PictureTakingConditions_FocalLength,
+    37_500 => :Exif_Configuration_MakerNote,
+    37_510 => :Exif_Configuration_UserComment,
+    37_520 => :Exif_DateAndTime_SubsecTime,
+    37_521 => :Exif_DateAndTime_SubsecTimeOriginal,
+    37_522 => :Exif_DateAndTime_SubsecTimeDigitized,
+    37_888 => :Exif_ShootingSituation_Temperature,
+    37_889 => :Exif_ShootingSituation_Humidity,
+    37_890 => :Exif_ShootingSituation_Pressure,
+    37_891 => :Exif_ShootingSituation_WaterDepth,
+    37_892 => :Exif_ShootingSituation_Acceleration,
+    37_893 => :Exif_ShootingSituation_CameraElevationAngle,
+    40_960 => :Exif_Version_FlashpixVersion,
+    40_961 => :Exif_ColorSpace_ColorSpace,
+    40_962 => :Exif_Configuration_PixelXDimension,
+    40_963 => :Exif_Configuration_PixelYDimension,
+    40_964 => :Exif_RelatedFile_RelatedSoundFile,
+    41_483 => :Exif_PictureTakingConditions_FlashEnergy,
+    41_484 => :Exif_PictureTakingConditions_SpatialFrequencyResponse,
+    41_486 => :Exif_PictureTakingConditions_FocalPlaneXResolution,
+    41_487 => :Exif_PictureTakingConditions_FocalPlaneYResolution,
+    41_488 => :Exif_PictureTakingConditions_FocalPlanResolutionUnit,
+    41_492 => :Exif_PictureTakingConditions_SubjectLocation,
+    41_493 => :Exif_PictureTakingConditions_ExposureIndex,
+    41_495 => :Exif_PictureTakingConditions_SensingMode,
+    41_728 => :Exif_PictureTakingConditions_FileSource,
+    41_729 => :Exif_PictureTakingConditions_SceneType,
+    41_730 => :Exif_PictureTakingConditions_CFAPattern,
+    41_985 => :Exif_PictureTakingConditions_CustomRendered,
+    41_986 => :Exif_PictureTakingConditions_ExposureMode,
+    41_987 => :Exif_PictureTakingConditions_WhiteBalance,
+    41_988 => :Exif_PictureTakingConditions_DigitalZoomRatio,
+    41_989 => :Exif_PictureTakingConditions_FocalLengthIn35mmFilm,
+    41_990 => :Exif_PictureTakingConditions_SceneCaptureType,
+    41_991 => :Exif_PictureTakingConditions_GainControl,
+    41_992 => :Exif_PictureTakingConditions_Contrast,
+    41_993 => :Exif_PictureTakingConditions_Saturation,
+    41_994 => :Exif_PictureTakingConditions_Sharpness,
+    41_995 => :Exif_PictureTakingConditions_DeviceSettingDescription,
+    41_996 => :Exif_PictureTakingConditions_SubjectDistanceRange,
+    42_016 => :Exif_Other_ImageUniqueID,
+    42_032 => :Exif_Other_CameraOwnerName,
+    42_033 => :Exif_Other_BodySerialNumber,
+    42_034 => :Exif_Other_LensSpecification,
+    42_035 => :Exif_Other_LensMake,
+    42_036 => :Exif_Other_LensModel,
+    42_037 => :Exif_Other_LensSerialNumber,
+    42_240 => :Exif_ColorSpace_Gamma
+  }
+
+# GPS IFD Tags
+FileData::ExifTags.tag_groups[34_853] =
+  {
+    0 => :GPS_Version,
+    1 => :GPS_LatitudeRef,
+    2 => :GPS_Latitude,
+    3 => :GPS_LongitudeRef,
+    4 => :GPS_Longitude,
+    5 => :GPS_AltitudeRef,
+    6 => :GPS_Altitude,
+    7 => :GPS_TimeStamp,
+    8 => :GPS_Satellites,
+    9 => :GPS_Status,
+    10 => :GPS_MeasureMode,
+    11 => :GPS_DOP,
+    12 => :GPS_SpeedRef,
+    13 => :GPS_Speed,
+    14 => :GPS_TrackRef,
+    15 => :GPS_Track,
+    16 => :GPS_ImgDirectionRef,
+    17 => :GPS_ImgDirection,
+    18 => :GPS_MapDatum,
+    19 => :GPS_DestLatitudeRef,
+    20 => :GPS_DestLatitude,
+    21 => :GPS_DestLongitudeRef,
+    22 => :GPS_DestLongitude,
+    23 => :GPS_DestBearingRef,
+    24 => :GPS_DestBearing,
+    25 => :GPS_DestDistanceRef,
+    26 => :GPS_DestDistance,
+    27 => :GPS_ProcessingMethod,
+    28 => :GPS_AreaInformation,
+    29 => :GPS_DateStamp,
+    30 => :GPS_Differential,
+    31 => :GPS_HPositioningError
+  }
+
+# Interoperability IFD Tags
+FileData::ExifTags.tag_groups[40_965] =
+  {
+    1 => :Interoperability_Index
+  }
+```
+
+

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec

data/file_data.gemspec

@@ -0,0 +1,38 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'file_data/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "file_data"
+  spec.version       = FileData::VERSION
+  spec.authors       = ["Scott"]
+  spec.email         = [""]
+
+  spec.summary       = %q{Extracts file metadata information (currently only supports exif metadata for jpeg files)}
+  spec.description   = %q{Extracts file metadata information (currently only supports exif metadata for jpeg files)}
+  spec.homepage      = ""
+  spec.license       = "MIT"
+
+  # Prevent pushing this gem to RubyGems.org. To allow pushes either set the 'allowed_push_host'
+  # to allow pushing to a single host or delete this section to allow pushing to any host.
+  if spec.respond_to?(:metadata)
+    spec.metadata['allowed_push_host'] = 'https://rubygems.org'
+  else
+    raise "RubyGems 2.0 or newer is required to protect against " \
+      "public gem pushes."
+  end
+
+  spec.files         = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{^(test|spec|features)/})
+  end
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.14"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+  spec.add_development_dependency "coveralls", "~> 0.8"
+  spec.add_development_dependency "fakefs", "~> 0.10"
+end

data/lib/file_data.rb

@@ -0,0 +1 @@
+require 'file_data/formats/exif/exif'

data/lib/file_data/core_extensions/enumerable_extensions.rb

@@ -0,0 +1,6 @@
+# Adds the ability to concatenate enumerables with #condense
+module EnumerableExtensions
+  def condense
+    Enumerator.new { |e| each { |seq| seq.each { |v| e << v } } }.lazy
+  end
+end

data/lib/file_data/file_types/jpeg.rb

@@ -0,0 +1,52 @@
+module FileData
+  # Represents a Jpeg image stream
+  class Jpeg
+    SOI_BYTES = [255, 216].freeze
+    SECTION_HEADER_SIZE = 4
+    INVALID_HEADER_MSG = 'the given file is not a jpeg file since it does not'\
+     'begin with the start of image (SOI) bytes.'.freeze
+
+    def initialize(stream)
+      @stream = stream
+    end
+
+    def each_section
+      read_header
+      Enumerator.new { |e| yield_sections(e) }.lazy
+    end
+
+    def read_header
+      soi = read_bytes(SOI_BYTES.size)
+      raise INVALID_HEADER_MSG unless soi == SOI_BYTES
+    end
+
+    def yield_sections(e)
+      loop do
+        next_section_pos = yield_section(e)
+        break unless section_pos?(next_section_pos)
+        @stream.seek(next_section_pos)
+      end
+    end
+
+    def yield_section(e)
+      section_start_pos = @stream.pos + 2
+      marker, size = read_section_header
+      e.yield marker, size
+      section_start_pos + size
+    end
+
+    def section_pos?(section_pos)
+      # Make sure that there are enough bytes for a section header.
+      # This also handles an ending two byte JPEG EOI sequence.
+      @stream.size - section_pos >= SECTION_HEADER_SIZE
+    end
+
+    def read_section_header
+      [read_bytes(2), read_bytes(2).inject { |a, v| (a << 8) + v }]
+    end
+
+    def read_bytes(num_bytes)
+      @stream.each_byte.take(num_bytes)
+    end
+  end
+end

data/lib/file_data/formats/exif/exif.rb

@@ -0,0 +1,31 @@
+require_relative 'exif_reader'
+require_relative 'exif_jpeg'
+
+module FileData
+  # Convenience class for extracting exif data from a file or stream
+  class Exif
+    # Create methods that forward to ExifReader
+    ExifReader.public_instance_methods.each do |method_name|
+      define_method(method_name) do |input, *other_args|
+        delegate_to_exif_reader(input, method_name, other_args)
+      end
+    end
+
+    private
+
+    def delegate_to_exif_reader(input, name, other_args)
+      streamify(input) do |stream|
+        exif = ExifJpeg.new(stream).exif
+        ExifReader.new.send(name, exif, *other_args)
+      end
+    end
+
+    def streamify(input)
+      if input.is_a?(String)
+        File.open(input, 'rb') { |f| yield f }
+      else
+        yield input
+      end
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_data.rb

@@ -0,0 +1,16 @@
+module FileData
+  # Container for Exif tag values
+  class ExifData
+    SECTIONS = { 0 => :image, 1 => :thumbnail }.freeze
+    SECTIONS.each { |section| define_method(section[1]) { @hash[section[0]] } }
+
+    def initialize
+      @hash = SECTIONS.each_with_object({}) { |pair, hash| hash[pair[0]] = {} }
+    end
+
+    def add_tag(index, ifd_id, tag_id, tag_value)
+      name = ExifTags.get_tag_name(ifd_id, tag_id)
+      @hash[index][name] = tag_value
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_jpeg.rb

@@ -0,0 +1,28 @@
+require 'file_data/file_types/jpeg'
+require_relative 'exif_stream'
+
+module FileData
+  # Retrieves an ExifStream from a jpeg stream
+  class ExifJpeg
+    APP1_BYTES = [255, 225].freeze
+    EXIF_ID = "Exif\0\0".bytes.to_a.freeze
+
+    def initialize(stream)
+      @stream = stream
+    end
+
+    def exif
+      ExifStream.new(@stream) if seek_exif
+    end
+
+    def seek_exif
+      Jpeg.new(@stream).each_section
+          .select { |marker, _| exif_section?(marker) }
+          .first
+    end
+
+    def exif_section?(marker)
+      marker == APP1_BYTES && @stream.each_byte.take(EXIF_ID.size) == EXIF_ID
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_reader.rb

@@ -0,0 +1,54 @@
+require_relative 'exif_jpeg'
+require 'set'
+require_relative 'exif_tag_reader'
+require_relative 'exif_data'
+
+module FileData
+  # Returns the exif data from a jpeg file
+  class ExifReader
+    def image_data_only(exif_stream)
+      exif_tags_internal(exif_stream, 0).image
+    end
+
+    def thumbnail_data_only(exif_stream)
+      exif_tags_internal(exif_stream, 1).thumbnail
+    end
+
+    def all_data(exif_stream)
+      exif_tags_internal(exif_stream, 0, 1)
+    end
+
+    def only_image_tag(exif_stream, tag_id)
+      exif_tag_internal(exif_stream, 0, tag_id)
+    end
+
+    def only_thumbnail_tag(exif_stream, tag_id)
+      exif_tag_internal(exif_stream, 1, tag_id)
+    end
+
+    def tags(exif_stream, *ifds_to_include)
+      return [] if exif_stream.nil?
+
+      exif_stream.read_header
+      ExifTagReader.new(exif_stream, *ifds_to_include).tags
+    end
+
+    private
+
+    def exif_tags_internal(exif_stream, *ifds_to_include)
+      tags(exif_stream, *ifds_to_include).each_with_object(ExifData.new) do |tag_info, data|
+        data.add_tag(*tag_info, exif_stream.read_tag_value)
+      end
+    end
+
+    def exif_tag_internal(exif_stream, ifd_index, tag_to_find)
+      exif_stream.read_tag_value if find_tag(exif_stream, ifd_index, tag_to_find)
+    end
+
+    def find_tag(exif_stream, ifd_index, tag_to_find)
+      tags(exif_stream, ifd_index).find do |_, ifd_id, tag_num|
+        tag_to_find == [ifd_id, tag_num]
+      end
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_stream.rb

@@ -0,0 +1,106 @@
+require 'forwardable'
+
+module FileData
+  # Wraps a stream with exif specific logic
+  class ExifStream
+    MOTOROLLA_BYTES = 'MM'.bytes.to_a.freeze
+    INTEL_BYTES = 'II'.bytes.to_a.freeze
+
+    TYPE_BYTE = 1
+    TYPE_ASCII = 2
+    TYPE_SHORT = 3
+    TYPE_LONG = 4
+    TYPE_RATIONAL = 5
+    TYPE_UNDEFINED = 7
+    TYPE_SLONG = 9
+    TYPE_SRATIONAL = 10
+
+    HIGH_BIT_MASK = 2**31
+
+    VALUE_OFFSET_SIZE = 4
+
+    extend Forwardable
+    def_delegators :@stream, :seek, :pos
+
+    def initialize(stream)
+      @stream = stream
+      @section_offset = stream.pos
+    end
+
+    def read_header
+      @is_big_endian =
+        case @stream.each_byte.take(2)
+        when INTEL_BYTES then false
+        when MOTOROLLA_BYTES then true
+        else raise 'the byte order bytes did not match any expected value'
+        end
+
+      raise 'the tiff constant 42 is missing' unless read_value(2) == 42
+    end
+
+    def seek_exif(offset)
+      @stream.seek(@section_offset + offset)
+    end
+
+    def read_tag_value
+      type = read_value(2)
+      size = read_value(4)
+
+      case type
+      when TYPE_RATIONAL, TYPE_SRATIONAL
+        read_large_val(type)
+      when TYPE_BYTE, TYPE_SHORT, TYPE_LONG, TYPE_SLONG
+        read_small_val(type)
+      when TYPE_ASCII
+        read_text(size)
+      when TYPE_UNDEFINED
+        read_undefined(size)
+      end
+    end
+
+    def read_text(size)
+      read_raw_val(size).pack('c*').chomp("\x00")
+    end
+
+    def read_undefined(size)
+      [read_raw_val(size), @is_big_endian]
+    end
+
+    def read_raw_val(size)
+      seek_to_large_val if size > VALUE_OFFSET_SIZE
+      @stream.each_byte.take([size, VALUE_OFFSET_SIZE].max)
+    end
+
+    def read_large_val(type)
+      seek_to_large_val
+      read_rational(type == TYPE_SRATIONAL)
+    end
+
+    def read_small_val(type)
+      value = read_value(4)
+      type == TYPE_SLONG ? to_slong(value) : value
+    end
+
+    def seek_to_large_val
+      seek_exif(read_value(4))
+    end
+
+    def read_rational(is_srational)
+      Array.new(2) do
+        piece = read_value(4)
+        is_srational ? to_slong(piece) : piece
+      end.join('/')
+    end
+
+    def to_slong(raw_value)
+      -(raw_value & HIGH_BIT_MASK) + (raw_value & ~HIGH_BIT_MASK)
+    end
+
+    def read_value(num_bytes)
+      bytes = @stream.each_byte.take(num_bytes)
+      bytes.reverse! unless @is_big_endian
+
+      bytes.inject { |total, val| (total << 8) + val }
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_tag_reader.rb

@@ -0,0 +1,46 @@
+require_relative 'exif_stream'
+require_relative 'ordinal_ifd'
+
+module FileData
+  # Enumerates the tags in an ExifStream
+  class ExifTagReader
+    NO_NEXT_IFD = 0
+
+    attr_accessor :stream, :ifds_to_include
+
+    def initialize(exif_stream, *ifds_to_include)
+      @stream = exif_stream
+      @ifds_to_include = ifds_to_include
+    end
+
+    def tags
+      Enumerator.new do |e|
+        2.times do |index|
+          break if (ifd = next_ifd(index)).nil?
+          process_ifd(ifd, e)
+        end
+      end
+    end
+
+    def process_ifd(ifd, e)
+      # Yield the tags or just skip ahead
+
+      if ifds_to_include.include?(ifd.index)
+        ifd.tags.each { |t| e.yield t }
+      else
+        # Avoid skipping the last ifd as this is needless work
+        ifd.skip unless ifd.index == 1
+      end
+    end
+
+    def next_ifd(index)
+      ifd_offset = stream.read_value(4)
+      ifd_from_offset(ifd_offset, index) unless ifd_offset == NO_NEXT_IFD
+    end
+
+    def ifd_from_offset(ifd_offset, index)
+      stream.seek_exif(ifd_offset)
+      OrdinalIfd.new(stream, index)
+    end
+  end
+end

data/lib/file_data/formats/exif/exif_tags.rb

@@ -0,0 +1,173 @@
+module FileData
+  # Contains tag number to name information taken from the exif spec
+  class ExifTags
+    singleton_class.class_eval { attr_accessor :tag_groups }
+    @tag_groups = {}
+
+    def self.get_tag_name(ifd_id, tag_id)
+      get_known_name(ifd_id, tag_id) || "#{ifd_id}-#{tag_id}".to_sym
+    end
+
+    def self.get_known_name(ifd_id, tag_id)
+      ifd_group = tag_groups[ifd_id]
+      ifd_group[tag_id] unless ifd_group.nil?
+    end
+  end
+end
+
+# Tiff Tags (0th and 1st IFDs)
+FileData::ExifTags.tag_groups[:Tiff] =
+  {
+    256 => :Image_Structure_Width,
+    257 => :Image_Structure_Length,
+    258 => :Image_Structure_BitsPerSample,
+    259 => :Image_Structure_Compression,
+    262 => :Image_Structure_PhotometricInterpretation,
+    270 => :Other_ImageDescription,
+    271 => :Other_Make,
+    272 => :Other_Model,
+    273 => :Recording_StripOffsets,
+    274 => :Image_Structure_Orientation,
+    277 => :Image_Structure_SamplesPerPixel,
+    278 => :Recording_RowsPerStrip,
+    279 => :Recording_StripByteCounts,
+    283 => :Image_Structure_YResolution,
+    284 => :Image_Structure_PlanarConfiguration,
+    296 => :Image_Structure_ResolutionUnit,
+    301 => :Image_Data_TransferFunction,
+    305 => :Other_Software,
+    306 => :Other_DateTime,
+    315 => :Other_Artist,
+    318 => :Image_Data_WhitePoint,
+    319 => :Image_Data_PrimaryChromaticities,
+    513 => :Recording_JPEGInterchangeFormat,
+    514 => :Recording_JPEGInterchangeFormatLength,
+    529 => :Image_Data_YCbCrCoefficients,
+    530 => :Image_Structure_YCbCrSubSampling,
+    531 => :Image_Structure_YCbCrPositioning,
+    532 => :Image_Data_ReferenceBlackWhite,
+    33_432 => :Other_Copyright
+  }
+
+# Exif IFD Tags
+FileData::ExifTags.tag_groups[34_665] =
+  {
+    33_434 => :Exif_PictureTakingConditions_ExposureTime,
+    33_437 => :Exif_PictureTakingConditions_FNumber,
+    34_850 => :Exif_PictureTakingConditions_ExposureProgram,
+    34_852 => :Exif_PictureTakingConditions_SpectralSensitivity,
+    34_855 => :Exif_PictureTakingConditions_PhotographicSensitivity,
+    34_856 => :Exif_PictureTakingConditions_OECF,
+    34_864 => :Exif_PictureTakingConditions_SensitivityType,
+    34_865 => :Exif_PictureTakingConditions_StandardOutputSensitivity,
+    34_866 => :Exif_PictureTakingConditions_RecommendedExposureIndex,
+    34_867 => :Exif_PictureTakingConditions_ISOSpeed,
+    34_868 => :Exif_PictureTakingConditions_ISOSpeedLatitudeyyy,
+    34_869 => :Exif_PictureTakingConditions_ISOSpeedLatitudezzz,
+    36_864 => :Exif_Version_ExifVersion,
+    36_867 => :Exif_DateAndTime_DateTimeOriginal,
+    36_868 => :Exif_DateAndTime_DateTimeDigitized,
+    37_121 => :Exif_Configuration_ComponentsConfiguration,
+    37_122 => :Exif_Configuration_CompressedBitsPerPixel,
+    37_377 => :Exif_PictureTakingConditions_ShutterSpeedValue,
+    37_378 => :Exif_PictureTakingConditions_ApertureValue,
+    37_379 => :Exif_PictureTakingConditions_BrightnessValue,
+    37_380 => :Exif_PictureTakingConditions_ExposureBiasValue,
+    37_381 => :Exif_PictureTakingConditions_MaxApertureValue,
+    37_382 => :Exif_PictureTakingConditions_SubjectDistance,
+    37_383 => :Exif_PictureTakingConditions_MeteringMode,
+    37_384 => :Exif_PictureTakingConditions_LightSource,
+    37_385 => :Exif_PictureTakingConditions_Flash,
+    37_396 => :Exif_PictureTakingConditions_SubjectArea,
+    37_386 => :Exif_PictureTakingConditions_FocalLength,
+    37_500 => :Exif_Configuration_MakerNote,
+    37_510 => :Exif_Configuration_UserComment,
+    37_520 => :Exif_DateAndTime_SubsecTime,
+    37_521 => :Exif_DateAndTime_SubsecTimeOriginal,
+    37_522 => :Exif_DateAndTime_SubsecTimeDigitized,
+    37_888 => :Exif_ShootingSituation_Temperature,
+    37_889 => :Exif_ShootingSituation_Humidity,
+    37_890 => :Exif_ShootingSituation_Pressure,
+    37_891 => :Exif_ShootingSituation_WaterDepth,
+    37_892 => :Exif_ShootingSituation_Acceleration,
+    37_893 => :Exif_ShootingSituation_CameraElevationAngle,
+    40_960 => :Exif_Version_FlashpixVersion,
+    40_961 => :Exif_ColorSpace_ColorSpace,
+    40_962 => :Exif_Configuration_PixelXDimension,
+    40_963 => :Exif_Configuration_PixelYDimension,
+    40_964 => :Exif_RelatedFile_RelatedSoundFile,
+    41_483 => :Exif_PictureTakingConditions_FlashEnergy,
+    41_484 => :Exif_PictureTakingConditions_SpatialFrequencyResponse,
+    41_486 => :Exif_PictureTakingConditions_FocalPlaneXResolution,
+    41_487 => :Exif_PictureTakingConditions_FocalPlaneYResolution,
+    41_488 => :Exif_PictureTakingConditions_FocalPlanResolutionUnit,
+    41_492 => :Exif_PictureTakingConditions_SubjectLocation,
+    41_493 => :Exif_PictureTakingConditions_ExposureIndex,
+    41_495 => :Exif_PictureTakingConditions_SensingMode,
+    41_728 => :Exif_PictureTakingConditions_FileSource,
+    41_729 => :Exif_PictureTakingConditions_SceneType,
+    41_730 => :Exif_PictureTakingConditions_CFAPattern,
+    41_985 => :Exif_PictureTakingConditions_CustomRendered,
+    41_986 => :Exif_PictureTakingConditions_ExposureMode,
+    41_987 => :Exif_PictureTakingConditions_WhiteBalance,
+    41_988 => :Exif_PictureTakingConditions_DigitalZoomRatio,
+    41_989 => :Exif_PictureTakingConditions_FocalLengthIn35mmFilm,
+    41_990 => :Exif_PictureTakingConditions_SceneCaptureType,
+    41_991 => :Exif_PictureTakingConditions_GainControl,
+    41_992 => :Exif_PictureTakingConditions_Contrast,
+    41_993 => :Exif_PictureTakingConditions_Saturation,
+    41_994 => :Exif_PictureTakingConditions_Sharpness,
+    41_995 => :Exif_PictureTakingConditions_DeviceSettingDescription,
+    41_996 => :Exif_PictureTakingConditions_SubjectDistanceRange,
+    42_016 => :Exif_Other_ImageUniqueID,
+    42_032 => :Exif_Other_CameraOwnerName,
+    42_033 => :Exif_Other_BodySerialNumber,
+    42_034 => :Exif_Other_LensSpecification,
+    42_035 => :Exif_Other_LensMake,
+    42_036 => :Exif_Other_LensModel,
+    42_037 => :Exif_Other_LensSerialNumber,
+    42_240 => :Exif_ColorSpace_Gamma
+  }
+
+# GPS IFD Tags
+FileData::ExifTags.tag_groups[34_853] =
+  {
+    0 => :GPS_Version,
+    1 => :GPS_LatitudeRef,
+    2 => :GPS_Latitude,
+    3 => :GPS_LongitudeRef,
+    4 => :GPS_Longitude,
+    5 => :GPS_AltitudeRef,
+    6 => :GPS_Altitude,
+    7 => :GPS_TimeStamp,
+    8 => :GPS_Satellites,
+    9 => :GPS_Status,
+    10 => :GPS_MeasureMode,
+    11 => :GPS_DOP,
+    12 => :GPS_SpeedRef,
+    13 => :GPS_Speed,
+    14 => :GPS_TrackRef,
+    15 => :GPS_Track,
+    16 => :GPS_ImgDirectionRef,
+    17 => :GPS_ImgDirection,
+    18 => :GPS_MapDatum,
+    19 => :GPS_DestLatitudeRef,
+    20 => :GPS_DestLatitude,
+    21 => :GPS_DestLongitudeRef,
+    22 => :GPS_DestLongitude,
+    23 => :GPS_DestBearingRef,
+    24 => :GPS_DestBearing,
+    25 => :GPS_DestDistanceRef,
+    26 => :GPS_DestDistance,
+    27 => :GPS_ProcessingMethod,
+    28 => :GPS_AreaInformation,
+    29 => :GPS_DateStamp,
+    30 => :GPS_Differential,
+    31 => :GPS_HPositioningError
+  }
+
+# Interoperability IFD Tags
+FileData::ExifTags.tag_groups[40_965] =
+  {
+    1 => :Interoperability_Index
+  }

data/lib/file_data/formats/exif/ifd.rb

@@ -0,0 +1,39 @@
+module FileData
+  # Contains the ability to enumerate through the exif tags in an ifd
+  module TagEnumerator
+    TAG_RECORD_SIZE = 12
+
+    def tags_enum
+      Enumerator.new do |e|
+        read_num_tags.times do
+          tag_start_pos = stream.pos
+          e.yield stream.read_value(2)
+          stream.seek(tag_start_pos + TAG_RECORD_SIZE)
+        end
+      end.lazy
+    end
+
+    def read_num_tags
+      stream.read_value(2)
+    end
+
+    def tags_size(num_tags)
+      num_tags * TAG_RECORD_SIZE
+    end
+  end
+
+  # Represents the tags present in any ifd (ordinal or extra)
+  class Ifd
+    include TagEnumerator
+
+    attr_accessor :stream
+
+    def initialize(exif_stream)
+      @stream = exif_stream
+    end
+
+    def tags
+      tags_enum
+    end
+  end
+end

data/lib/file_data/formats/exif/ordinal_ifd.rb

@@ -0,0 +1,51 @@
+require_relative 'ifd'
+require_relative 'exif_tags'
+
+module FileData
+  # Represents either the zeroth or first ifd
+  class OrdinalIfd
+    attr_reader :stream, :index
+
+    include TagEnumerator
+
+    def initialize(exif_stream, index)
+      @stream = exif_stream
+      @index = index
+    end
+
+    def tags
+      Enumerator.new do |e|
+        tags_enum.each { |tag_id| process_tag(e, tag_id) }
+      end
+    end
+
+    def process_tag(enumerator, tag_id)
+      if pointer_tag?(tag_id)
+        process_extra_ifd(enumerator, tag_id)
+      else
+        yield_tag(enumerator, :Tiff, tag_id)
+      end
+    end
+
+    def pointer_tag?(tag_id)
+      ExifTags.tag_groups.key?(tag_id)
+    end
+
+    def process_extra_ifd(enumerator, tag_id)
+      seek_ifd(stream.read_tag_value)
+      tags_enum.each { |t| yield_tag(enumerator, tag_id, t) }
+    end
+
+    def yield_tag(enumerator, ifd_id, tag_id)
+      enumerator.yield [index, ifd_id, tag_id]
+    end
+
+    def seek_ifd(pointer_value)
+      stream.seek_exif(pointer_value)
+    end
+
+    def skip
+      stream.seek(tags_size(read_num_tags), IO::SEEK_CUR)
+    end
+  end
+end

data/lib/file_data/version.rb

@@ -0,0 +1,3 @@
+module FileData
+  VERSION = '4.0.0'.freeze
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: file_data
+version: !ruby/object:Gem::Version
+  version: 4.0.0
+platform: ruby
+authors:
+- Scott
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2017-05-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: coveralls
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: fakefs
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+description: Extracts file metadata information (currently only supports exif metadata
+  for jpeg files)
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".rspec"
+- ".rubocop.yml"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- file_data.gemspec
+- lib/file_data.rb
+- lib/file_data/core_extensions/enumerable_extensions.rb
+- lib/file_data/file_types/jpeg.rb
+- lib/file_data/formats/exif/exif.rb
+- lib/file_data/formats/exif/exif_data.rb
+- lib/file_data/formats/exif/exif_jpeg.rb
+- lib/file_data/formats/exif/exif_reader.rb
+- lib/file_data/formats/exif/exif_stream.rb
+- lib/file_data/formats/exif/exif_tag_reader.rb
+- lib/file_data/formats/exif/exif_tags.rb
+- lib/file_data/formats/exif/ifd.rb
+- lib/file_data/formats/exif/ordinal_ifd.rb
+- lib/file_data/version.rb
+homepage: ''
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+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.5.1
+signing_key: 
+specification_version: 4
+summary: Extracts file metadata information (currently only supports exif metadata
+  for jpeg files)
+test_files: []