sixarm_ruby_magic_number_type 1.0.0 → 2.0.0

data.tar.gz.sig

@@ -1,2 +1 @@
-�A��|\[�$���9e
-µ�4L-.�>϶�A��ҡ��~.�
+7vŏ���D��&�Fҧ���H:�ZD!��v\!����>!v;�$1����nT���D��d�9O���V�PYS}�M�F�U'�<s�r�N��u��,�O��t�sH��t=�M�E(%� z�o�

data/README.md

@@ -0,0 +1,104 @@
+# SixArm.com » Ruby » <br> MagicNumberType infers mime types from leading bits
+
+* Doc: <http://sixarm.com/sixarm_ruby_magic_number_type/doc>
+* Gem: <http://rubygems.org/gems/sixarm_ruby_magic_number_type>
+* Repo: <http://github.com/sixarm/sixarm_ruby_magic_number_type>
+* Email: Joel Parker Henderson, <joel@sixarm.com>
+
+
+## Introduction
+
+
+Magic numbers are the first bits of a file or data stream
+which uniquely identify the type of file or data stream.
+
+For example when the first bits are "BM",
+this identifies the file as a bitmap image file.
+
+For docs go to <http://sixarm.com/sixarm_ruby_magic_number_type/doc>
+
+Want to help? We're happy to get pull requests.
+
+
+## Install quickstart
+
+Install:
+
+    gem install sixarm_ruby_magic_number_type
+
+Gemfile:
+
+    gem "sixarm_ruby_magic_number_type", "~>2.0.0"
+
+Require:
+
+    require "sixarm_ruby_magic_number_type"
+
+
+## Install with security (optional)
+
+To enable high security for all our gems:
+
+    wget http://sixarm.com/sixarm.pem
+    gem cert --add sixarm.pem
+    gem sources --add http://sixarm.com
+
+To install with high security:
+
+    gem install sixarm_ruby_magic_number_type --test --trust-policy HighSecurity
+
+
+## Details
+
+This gem infers based on widespread programming conventions for data file formats.
+
+These magic numbers are by convention and we are using this guide:
+http://www.astro.keele.ac.uk/oldusers/rno/Computing/File_magic.html
+
+Typical uses of magic numbers:
+
+  * to quickly identify a file's data type
+  * to check if data matches the file's MIME type or extension
+  * to check if a web form file upload matches its HTTP content type
+
+Compare:
+
+  * MIME::Types ruby library 
+  * Unix magic() command for testing files on disk
+  * http://shared-mime.rubyforge.org/
+
+
+## Changes
+
+* 2012-09-08 2.0.0 Upgrade with more formats, samples, classes, and hex packing
+* 2012-04-20 1.2.0 Upgrade to much faster algorithm
+* 2012-03-14 1.1.0 Update docs, tests
+
+
+## License
+
+You may choose any of these open source licenses:
+
+  * Apache License
+  * BSD License
+  * CreativeCommons License, Non-commercial Share Alike
+  * GNU General Public License Version 2 (GPL 2)
+  * GNU Lesser General Public License (LGPL)
+  * MIT License
+  * Perl Artistic License
+  * Ruby License
+
+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.
+
+This license is for the included software that is created by SixArm;
+some of the included software may have its own licenses, copyrights, 
+authors, etc. and these do take precedence over the SixArm license.
+
+Copyright (c) 2005-2013 Joel Parker Henderson

data/Rakefile

@@ -0,0 +1,8 @@
+# -*- coding: utf-8 -*-
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test'
+  t.pattern = 'test/*.rb'
+end

data/VERSION

@@ -0,0 +1 @@
+2.0.0

data/lib/sixarm_ruby_magic_number_type.rb

@@ -1,144 +1,8 @@
 # -*- coding: utf-8 -*-
 =begin rdoc
-
-= SixArm.com » Ruby » MagicNumberType
-
-Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
-Copyright:: Copyright (c) 2010 Joel Parker Henderson
-License:: See LICENSE.txt file
-
-MagicNumberType infers a data type from the data's leading bytes.
-
-It infers based on widespread programming conventions for data file formats.
-
-Magic numbers are the first bits of a file or data stream
-which uniquely identify the type of file or data stream.
-
-For example when the first bits are "BM",
-this identifies the file as a bitmap image file.
-
-These magic numbers are by convention and we are using this guide:
-http://www.astro.keele.ac.uk/oldusers/rno/Computing/File_magic.html
-
-Typical uses of magic numbers:
-  - to quickly identify a file's data type
-  - to check if data matches the file's MIME type or extension
-  - to check if a web form file upload matches its HTTP content type
-
-Compare:
-  - MIME::Types ruby library 
-  - Unix magic() command for testing files on disk
-  - http://shared-mime.rubyforge.org/
-
+Please see README
 =end
 
-require 'pp'
-
-class IO
-
-  # We implement magic by using a lookup hash.
-  # The key is a string that encodes the first bits.
-  # The value is a symbol that indicates the magic type.
-  #
-  # Examples:
-  #   IO::MagicNumberType("BM") => :bitmap
-  #   IO::MagicNumberType("GIF8") => :gif
-  #   IO::MagicNumberType("\xa6\x00") => :pgp_encrypted_data
-  #
-  # Quirks:
-  #   - JPEG adjustment:
-  #     - Some cameras put JPEG Exif data in bytes 3 & 4,
-  #       so we only check the first two bytes of a JPEG.
-  #   - TIFF has two possible matches:
-  #     - MM** is Motorola big endian
-  #     - II** is Intel little ending
-  #
-  # See:
-  #  - IO#magic_number_type
-  #  - File.magic_number_type
-
-  MagicNumberTypeHash = {
-    "BC" => :bitcode,
-    "BM" => :bitmap,
-    "BZ" => :bzip,
-    "MZ" => :exe,
-    "SIMPLE"=> :fits,
-    "GIF8" => :gif,
-    "GKSM" => :gks,
-    [0x01,0xDA].pack('c*') => :iris_rgb,
-    [0xF1,0x00,0x40,0xBB].pack('c*') => :itc,
-    [0xFF,0xD8].pack('c*') => :jpeg,
-    "IIN1" => :niff,
-    "MThd" => :midi,
-    "%PDF" => :pdf,
-    "VIEW" => :pm,
-    [0x89].pack('c*') + "PNG" => :png,
-    "%!" => :postscript,
-    "Y" + [0xA6].pack('c*') + "j" + [0x95].pack('c*') => :sun_rasterfile,
-    "MM*" + [0x00].pack('c*') => :tiff,
-    "II*" + [0x00].pack('c*') => :tiff,
-    "gimp xcf" => :gimp_xcf,
-    "#FIG" => :xfig,
-    "/* XPM */" => :xpm,
-    [0x23,0x21].pack('c*') => :shebang,
-    [0x1F,0x9D].pack('c*') => :compress,
-    [0x1F,0x8B].pack('c*') => :gzip,
-    "PK" + [0x03,0x04].pack('c*') => :pkzip,
-    "MZ" => :dos_os2_windows_executable,
-    ".ELF" => :unix_elf,
-    [0x99,0x00].pack('c*') => :pgp_public_ring,
-    [0x95,0x01].pack('c*') => :pgp_security_ring,
-    [0x95,0x00].pack('c*') => :pgp_security_ring,
-    [0xA6,0x00].pack('c*') => :pgp_encrypted_data,
-    [0xD0,0xCF,0x11,0xE0].pack('c*') => :docfile
-  }
-
-  # Detect the data type by checking various "magic number" conventions
-  # for the introductory bytes of a data stream
-  #
-  # Return the "magic number" as a symbol:
-  #  - :bitmap = Bitmap image file, typical extension ".bmp"
-  #  - :gzip = Unix GZIP compressed data, typical extension ".gz"
-  #  - :postscript = Postscript pages, typical extension ".ps"
-  # 
-  # Return nil if there's no match for any known magic number.
-  #
-  # Example:
-  #   f = File.open("test.ps","rb")
-  #   put f.magic_number(s)
-  #   => :postscript
-  #
-  # See:
-  #  - IO::MagicNumberTypeHash
-  #  - File.magic_number_type
-
-  def magic_number_type(bytes=self.read(9))
-    MagicNumberTypeHash.each_pair do |byte_string,type_symbol|
-      return type_symbol if byte_string==bytes[0,byte_string.length]
-    end
-    return nil
-  end
-
-end
-
-
-class File
-
-  # Detect the file's data type by opening the file then
-  # using IO#magic_number_type to read the first bits.
-  #
-  # Return a magic number type symbol, e.g. :bitmap, :jpg, etc.
-  #
-  # Example:
-  #   puts File.magic_number_type("test.ps") => :postscript
-  #
-  # See
-  #   - IO#MagicNumberTypeHash
-  #   - IO#magic_number_type
-
-  def self.magic_number_type(file_name)
-    File.open(file_name,"rb"){|f| f.magic_number_type }
-  end
-
-end
-
+['file','io','string'].map{|x|
+  require File.dirname(__FILE__) + "/sixarm_ruby_magic_number_type/#{x}.rb"
+}

data/lib/sixarm_ruby_magic_number_type/file.rb

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+
+class File
+
+  # Detect the file's data type by opening the file then
+  # using IO#magic_number_type to read the first bits.
+  #
+  # Return a magic number type symbol, e.g. :bitmap, :jpg, etc.
+  #
+  # Example:
+  #   puts File.magic_number_type("test.ps") => :postscript
+  #
+  # See
+  #   - IO#MagicNumberTypeHash
+  #   - IO#magic_number_type
+  #
+  def self.magic_number_type(file_name)
+    f = File.open(file_name,"rb")
+    type = f.magic_number_type
+    f.close
+    return type
+  end
+
+end

data/lib/sixarm_ruby_magic_number_type/io.rb

@@ -0,0 +1,33 @@
+# -*- coding: utf-8 -*-
+
+class IO
+
+  # Detect the data type by checking various "magic number" conventions
+  # for the introductory bytes of a data stream
+  #
+  # Return the "magic number" as a symbol:
+  #  - :bitmap = Bitmap image file, typical extension ".bmp"
+  #  - :gzip = Unix GZIP compressed data, typical extension ".gz"
+  #  - :postscript = Postscript pages, typical extension ".ps"
+  #
+  # Return nil if there's no match for any known magic number.
+  #
+  # Example:
+  #   IO.f = File.open("test.ps","rb")
+  #   put f.magic_number(s)
+  #   => :postscript
+  #
+  # See:
+  #  - IO::MagicNumberTypeHash
+  #  - File.magic_number_type
+  #
+  # TODO change from hash implementation to binary tree
+
+  def magic_number_type(bytes=self.read(String::MagicNumberTypeMaxLength))
+    String::MagicNumberTypeHash.each_pair do |byte_string,type_symbol|
+      return type_symbol if byte_string==bytes[0,byte_string.length]
+    end
+    return nil
+  end
+
+end

data/lib/sixarm_ruby_magic_number_type/string.rb

@@ -0,0 +1,136 @@
+# -*- coding: utf-8 -*-
+=begin rdoc
+Please see README
+=end
+
+class String
+
+  # We implement magic number type by using a lookup hash.
+  # This is fast enough for our needs; it could be optimized.
+  #
+  # The key is a string that encodes the first bits.
+  # The value is a symbol that indicates the magic type.
+  #
+  # See:
+  #  - IO#magic_number_type
+  #  - File.magic_number_type
+  #
+  # Quirks:
+  #   - JPEG adjustment:
+  #     - Some cameras put JPEG Exif data in bytes 3 & 4,
+  #       so we only check the first two bytes of a JPEG.
+  #   - TIFF has two possible matches:
+  #     - II.. Intel little ending ("II2A00")
+  #     - MM.. Motorola big endian ("MM002A")
+  #
+  # TODO change from hash implementation to binary tree
+  #
+  MagicNumberTypeHash = {
+    "<!doctyp" => :html,
+    "<html" => :html,
+    "<?xml" => :xml,
+    "<MakerFile" => :adobe_framemaker,
+    "BC" => :bitcode,
+    "BM" => :bitmap,
+    "BZ" => :bzip,
+    "MZ" => :exe,
+    "SIMPLE"=> :fits,
+    "GIF8" => :gif,
+    "GKSM" => :gks,
+    ["01DA"].pack('H*') => :iris_rgb,
+    ["F10040BB"].pack('H*') => :itc,
+    ["FFD8"].pack('H*') => :jpeg,
+    "IIN1" => :niff,
+    "MThd" => :midi,
+    "%PDF" => :pdf,
+    "VIEW" => :pm,
+    ["89504E470D0A1A0A"].pack('H*') => :png, 
+    "Y" + ["A6"].pack('H*') + "j" + ["95"].pack('H*') => :sun_rasterfile,
+    "II" + ["2A00"].pack('H*') => :tiff,  # II means Intel format, then 42 little-endian                                                                                                                                                                                 
+    "MM" + ["002A"].pack('H*') => :tiff,  # MM means Motorola format, then 42 big-endian  
+    "gimp xcf" => :gimp_xcf,
+    "#FIG" => :xfig,
+    "/* XPM */" => :xpm,
+    ["1F9D"].pack('H*') => :compress,
+    ["1F8B"].pack('H*') => :gzip,
+    "\x1F\xA0" => :tar_file_using_lzh_compression,
+    "PK\x03\x04" => :pkzip,
+    "7Z\xBC\xAF\x27\x1C" => :seven_zip,
+    "MZ" => :dos_os2_windows_executable,
+    ".ELF" => :unix_elf,
+    "\x99\x00" => :pgp_public_ring,
+    "\x95\x01" => :pgp_security_ring,
+    "\x95\x00" => :pgp_security_ring,
+    "\xA6\x00" => :pgp_encrypted_data,
+    "\xD0\xCF\x11\xE0" => :docfile,
+    #TODO matroska seems to have multiple magic file types-- diagnose and fix
+    #"\x1a\x45\xdf\xa3\xa3\x42\x86\x81\x01\x42\xf7\x81\x01\x42\xf2\x81\x04\x42\xf3\x81\x08\x42\x82\x88matroska" => :matroska_stream,
+    ".RTS COMPRESSED IMAGE" => :runtime_software_disk_image,
+    "WS" => :wordstar_document,
+    "!BDN" => :microsoft_outlook_personal_folder_file,
+    "# Disk Descripto" => :vmware_disk_description,
+    "# Microsoft Developer Studio" => :microsoft_developer_studio,
+    "#!AMR" => :adaptive_multi_rate,
+    "#?RADIANCE." => :radiance_high_dynamic_range_image_file,
+    "%!PS-Adobe-3.0 EPSF-3.0" => :encapsulated_postscript,
+    "8BPS" => :adobe_photoshop,
+    "\x00\xBF" => :adobe_flash_shared_object,  # Typically a flash cookie
+    "\x00\x00\x00\x14ftypisom" => :iso_base_media,  # ISO Base Media file (MPEG-4) v1
+    "\x00\x00\x00\x14ftypqt" => :quicktime_movie,
+    "\x00\x00\x00\x14fty3gp5" => :mpeg4_video,
+    "\x00\x00\x00\x14ftymp42" => :mpeg4_video_quicktime,
+    "\x00\x00\x00\x14ftyM4A" => :app_lossless_audio_codec,
+    "\x00\x01\x00\x00MYISAM DATABASE" => :msisam_database,  # e.g. Microsoft Money
+    "\x00\x01\x00\x00Standard ACE DB" => :microsoft_access_ace_db,
+    "\x00\x01\x00\x00Standard Jet DB" => :microsoft_access_jet_db,
+    "\x00\x01BA" => :palm_address_book,
+    "\x00\x01BD" => :palm_date_book,
+    "\x01\x0F\x00\x00" => :microsoft_sql_server_2000,
+    "(This file must be converted with BinHex" => :binhex,
+    "***  Installation Started" => :symantec_wise_installer_log_file,
+    ".REC" => :realplayer_video,
+    ".RMF" => :realplayer_media,
+    "01ORDNANCE SURVEY" => :national_transfer_format_map,
+    "\x31\xBE" => :microsoft_write,
+    "\x32\xBE" => :microsoft_write,
+    "4" + ["CDB2A1"].pack('H*') => :tcpdump,
+    ":VERSION" => :surfplan_kite_project,
+    "AC10" => :autocad,
+    ".snd" => :sun_microsystems_law_audio_file,
+    # Short ones below that would mask longer ones above
+    "\x23\x21" => :shebang,
+    "%!" => :postscript
+  }
+
+  MagicNumberTypeMaxLength = 64  # Longest key
+
+
+  # Detect the data type by checking various "magic number" conventions
+  # for the introductory bytes of a data stream
+  #
+  # Return the "magic number" as a symbol:
+  #  - :bitmap = Bitmap image file, typical extension ".bmp"
+  #  - :gzip = Unix GZIP compressed data, typical extension ".gz"
+  #  - :postscript = Postscript pages, typical extension ".ps"
+  #
+  # Return nil if there's no match for any known magic number.
+  #
+  # Examples:
+  #   "BM".magic_number_type => :bitmap
+  #   "GIF8".magic_numer_type => :gif
+  #   "\xa6\x00".magic_number_type => :pgp_encrypted_data
+  #
+  # TODO change from hash implementation to binary tree
+  #
+  def magic_number_type
+    String::MagicNumberTypeHash.each_pair do |byte_string,type_symbol|
+      return type_symbol if byte_string==self.byteslice(0,byte_string.length)
+    end
+    return nil
+  end
+
+  protected
+
+end
+
+

data/test/sixarm_ruby_magic_number_type_test.rb

@@ -0,0 +1,9 @@
+# -*- coding: utf-8 -*-
+require 'minitest/autorun'
+require 'simplecov'
+SimpleCov.start
+
+['file','io','string'].map{|x|
+  require "sixarm_ruby_magic_number_type_test/#{x}_test.rb"
+}
+

data/test/sixarm_ruby_magic_number_type_test/file_test.rb

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+require 'minitest/autorun'
+require 'simplecov'
+SimpleCov.start
+require 'sixarm_ruby_magic_number_type'
+
+describe File do
+
+  before do
+    SAMPLE_FILE_NAME_TO_MAGIC_NUMBER_TYPE ||= {
+      'sample.fit' => :fits,
+      'sample.gif' => :gif,
+      'sample.html' => :html,
+      'sample.xml' => :xml,
+      'sample.jpg' => :jpeg,
+      'sample.png' => :png,
+      'sample.ps' => :postscript,
+      'sample.ras' => :sun_rasterfile,
+      'sample.sgi' => :iris_rgb,
+      'sample.tiff' => :tiff,
+      'sample.bz2' => :bzip,
+      'sample.gz' => :gzip,
+    }
+  end
+
+  it "solves the magic number type" do
+    SAMPLE_FILE_NAME_TO_MAGIC_NUMBER_TYPE.each_pair{|file_name, type|
+      path = File.join("test","sixarm_ruby_magic_number_type_test","samples",file_name)
+      File.exist?(path).must_equal true
+      File.magic_number_type(path).must_equal type, "Trying #{file_name}"
+    }
+  end
+
+end
+

data/test/sixarm_ruby_magic_number_type_test/io_test.rb

@@ -0,0 +1,13 @@
+# -*- coding: utf-8 -*-
+require 'minitest/autorun'
+require 'simplecov'
+SimpleCov.start
+require 'sixarm_ruby_magic_number_type'
+
+describe IO do
+
+  # So far, all our needs go through File.
+  # If you want to add tests here, please do.
+
+end
+

data/test/sixarm_ruby_magic_number_type_test/samples/sample.html

@@ -0,0 +1 @@
+<html></html>

data/test/sixarm_ruby_magic_number_type_test/samples/sample.xml

@@ -0,0 +1 @@
+<?xml></xml>

data/test/sixarm_ruby_magic_number_type_test/string_test.rb

@@ -0,0 +1,94 @@
+# -*- coding: utf-8 -*-
+require 'minitest/autorun'
+require 'simplecov'
+SimpleCov.start
+require 'sixarm_ruby_magic_number_type'
+
+
+describe String do
+
+  before do
+    SAMPLE_STRING_TO_MAGIC_NUMBER_TYPE ||= {
+      "<!doctyp" => :html,
+      "<html" => :html,
+      "<?xml" => :xml,
+      "<MakerFile" => :adobe_framemaker,
+      "BC" => :bitcode,
+      "BM" => :bitmap,
+      "BZ" => :bzip,
+      "MZ" => :exe,
+      "SIMPLE"=> :fits,
+      "GIF8" => :gif,
+      "GKSM" => :gks,
+      ["01DA"].pack('H*') => :iris_rgb,
+      ["F10040BB"].pack('H*') => :itc,
+      ["FFD8"].pack('H*')  => :jpeg,
+      "IIN1" => :niff,
+      "MThd" => :midi,
+      "%PDF" => :pdf,
+      "VIEW" => :pm,
+      ["89504E470D0A1A0A"].pack('H*') => :png, 
+      "Y" + ["A6"].pack('H*') + "j" + ["95"].pack('H*') => :sun_rasterfile,
+      "II" + ["2A00"].pack('H*') => :tiff,  # II means Intel format, then 42 little-endian
+      "MM" + ["002A"].pack('H*') => :tiff,  # MM means Motorola format, then 42 big-endian
+      "gimp xcf" => :gimp_xcf,
+      "#FIG" => :xfig,
+      "/* XPM */" => :xpm,
+      ["1F9D"].pack('H*') => :compress,
+      ["1F8B"].pack('H*') => :gzip,
+      "\x1F\xA0" => :tar_file_using_lzh_compression,
+      "PK\x03\x04" => :pkzip,
+      "7Z\xBC\xAF\x27\x1C" => :seven_zip,
+      "MZ" => :dos_os2_windows_executable,
+      ".ELF" => :unix_elf,
+      "\x99\x00" => :pgp_public_ring,
+      "\x95\x01" => :pgp_security_ring,
+      "\x95\x00" => :pgp_security_ring,
+      "\xA6\x00" => :pgp_encrypted_data,
+      "\xD0\xCF\x11\xE0" => :docfile,
+      #TODO matroska seems to have multiple magic file types-- diagnose and fix
+      #"\x1a\x45\xdf\xa3\xa3\x42\x86\x81\x01\x42\xf7\x81\x01\x42\xf2\x81\x04\x42\xf3\x81\x08\x42\x82\x88matroska" => :matroska_stream,
+      ".RTS COMPRESSED IMAGE" => :runtime_software_disk_image,
+      "WS" => :wordstar_document,
+      "!BDN" => :microsoft_outlook_personal_folder_file,
+      "# Disk Descripto" => :vmware_disk_description,
+      "# Microsoft Developer Studio" => :microsoft_developer_studio,
+      "#!AMR" => :adaptive_multi_rate,
+      "#?RADIANCE." => :radiance_high_dynamic_range_image_file,
+      "%!PS-Adobe-3.0 EPSF-3.0" => :encapsulated_postscript,
+      "8BPS" => :adobe_photoshop,
+      "\x00\xBF" => :adobe_flash_shared_object,  # Typically a flash cookie
+      "\x00\x00\x00\x14ftypisom" => :iso_base_media,  # ISO Base Media file (MPEG-4) v1
+      "\x00\x00\x00\x14ftypqt" => :quicktime_movie,
+      "\x00\x00\x00\x14fty3gp5" => :mpeg4_video,
+      "\x00\x00\x00\x14ftymp42" => :mpeg4_video_quicktime,
+      "\x00\x00\x00\x14ftyM4A" => :app_lossless_audio_codec,
+      "\x00\x01\x00\x00MYISAM DATABASE" => :msisam_database,  # e.g. Microsoft Money
+      "\x00\x01\x00\x00Standard ACE DB" => :microsoft_access_ace_db,
+      "\x00\x01\x00\x00Standard Jet DB" => :microsoft_access_jet_db,
+      "\x00\x01BA" => :palm_address_book,
+      "\x00\x01BD" => :palm_date_book,
+      "\x01\x0F\x00\x00" => :microsoft_sql_server_2000,
+      "(This file must be converted with BinHex" => :binhex,
+      "***  Installation Started" => :symantec_wise_installer_log_file,
+      ".REC" => :realplayer_video,
+      ".RMF" => :realplayer_media,
+      "01ORDNANCE SURVEY" => :national_transfer_format_map,
+      "\x31\xBE" => :microsoft_write,
+      "\x32\xBE" => :microsoft_write,
+      "4" + ['CDB2A1'].pack('H*') => :tcpdump,
+      ":VERSION" => :surfplan_kite_project,
+      "AC10" => :autocad,
+      ".snd" => :sun_microsystems_law_audio_file,
+      "\x23\x21" => :shebang,
+      "%!" => :postscript
+    }
+  end
+
+  it "solves the magic number type" do
+    SAMPLE_STRING_TO_MAGIC_NUMBER_TYPE.each_pair{|string, type|
+      string.magic_number_type.must_equal type, "Trying #{string} => #{type}"
+    }
+  end
+
+end

metadata

@@ -1,88 +1,112 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: sixarm_ruby_magic_number_type
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 2.0.0
   prerelease: 
-  version: 1.0.0
 platform: ruby
-authors: 
+authors:
 - SixArm
 autorequire: 
 bindir: bin
-cert_chain: 
-- |
-  -----BEGIN CERTIFICATE-----
-  MIIDBDCCAm2gAwIBAgIJAKPwEETU5bHoMA0GCSqGSIb3DQEBBQUAMGAxCzAJBgNV
-  BAYTAlVTMRMwEQYDVQQIEwpDYWxpZm9ybmlhMRYwFAYDVQQHEw1TYW4gRnJhbmNp
-  c2NvMQ8wDQYDVQQKEwZTaXhBcm0xEzARBgNVBAMTCnNpeGFybS5jb20wHhcNMTAx
-  MjEzMjMyNzEzWhcNMTMwOTA4MjMyNzEzWjBgMQswCQYDVQQGEwJVUzETMBEGA1UE
-  CBMKQ2FsaWZvcm5pYTEWMBQGA1UEBxMNU2FuIEZyYW5jaXNjbzEPMA0GA1UEChMG
-  U2l4QXJtMRMwEQYDVQQDEwpzaXhhcm0uY29tMIGfMA0GCSqGSIb3DQEBAQUAA4GN
-  ADCBiQKBgQC94mD9JDwBsunsOI0VR3CXXbOWg9cWaWciwFyJNFiM7A9I8KPLfXUw
-  QC4czUe5ZuG4WHvinrWhkrCK+1dWBqoEClxdF/FoKO5a+tonGCjjmfy81JmFjjyx
-  eTsjsHyvw+Qik9kpf9aj6+pnkNrVswgNHVea2o9yabbEiS6VSeJWoQIDAQABo4HF
-  MIHCMB0GA1UdDgQWBBQzPJtqmSgc53eDN7aSzDQwr9TALDCBkgYDVR0jBIGKMIGH
-  gBQzPJtqmSgc53eDN7aSzDQwr9TALKFkpGIwYDELMAkGA1UEBhMCVVMxEzARBgNV
-  BAgTCkNhbGlmb3JuaWExFjAUBgNVBAcTDVNhbiBGcmFuY2lzY28xDzANBgNVBAoT
-  BlNpeEFybTETMBEGA1UEAxMKc2l4YXJtLmNvbYIJAKPwEETU5bHoMAwGA1UdEwQF
-  MAMBAf8wDQYJKoZIhvcNAQEFBQADgYEAooEexP/oPam1TP71SyuhxMb+uTrZbSQe
-  jVB+ExRwWadGwaNPUA56d39qwavwP+iu+3JpeonNMVvbWXF5naCX/dNFIeREHzER
-  ZDRQYMqru9TEMna6HD9zpcstF7vwThGovlOQ+3Y6plQ4nMzipXcZ9THqs65PIL0q
-  eabwpCbAopo=
-  -----END CERTIFICATE-----
-
-date: 2011-02-07 00:00:00 -08:00
-default_executable: 
+cert_chain:
+- !binary |-
+  LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSURCRENDQW0yZ0F3SUJB
+  Z0lKQUtQd0VFVFU1YkhvTUEwR0NTcUdTSWIzRFFFQkJRVUFNR0F4Q3pBSkJn
+  TlYKQkFZVEFsVlRNUk13RVFZRFZRUUlFd3BEWVd4cFptOXlibWxoTVJZd0ZB
+  WURWUVFIRXcxVFlXNGdSbkpoYm1OcApjMk52TVE4d0RRWURWUVFLRXdaVGFY
+  aEJjbTB4RXpBUkJnTlZCQU1UQ25OcGVHRnliUzVqYjIwd0hoY05NVEF4Ck1q
+  RXpNak15TnpFeldoY05NVE13T1RBNE1qTXlOekV6V2pCZ01Rc3dDUVlEVlFR
+  R0V3SlZVekVUTUJFR0ExVUUKQ0JNS1EyRnNhV1p2Y201cFlURVdNQlFHQTFV
+  RUJ4TU5VMkZ1SUVaeVlXNWphWE5qYnpFUE1BMEdBMVVFQ2hNRwpVMmw0UVhK
+  dE1STXdFUVlEVlFRREV3cHphWGhoY20wdVkyOXRNSUdmTUEwR0NTcUdTSWIz
+  RFFFQkFRVUFBNEdOCkFEQ0JpUUtCZ1FDOTRtRDlKRHdCc3Vuc09JMFZSM0NY
+  WGJPV2c5Y1dhV2Npd0Z5Sk5GaU03QTlJOEtQTGZYVXcKUUM0Y3pVZTVadUc0
+  V0h2aW5yV2hrckNLKzFkV0Jxb0VDbHhkRi9Gb0tPNWErdG9uR0Nqam1meTgx
+  Sm1Gamp5eAplVHNqc0h5dncrUWlrOWtwZjlhajYrcG5rTnJWc3dnTkhWZWEy
+  bzl5YWJiRWlTNlZTZUpXb1FJREFRQUJvNEhGCk1JSENNQjBHQTFVZERnUVdC
+  QlF6UEp0cW1TZ2M1M2VETjdhU3pEUXdyOVRBTERDQmtnWURWUjBqQklHS01J
+  R0gKZ0JRelBKdHFtU2djNTNlRE43YVN6RFF3cjlUQUxLRmtwR0l3WURFTE1B
+  a0dBMVVFQmhNQ1ZWTXhFekFSQmdOVgpCQWdUQ2tOaGJHbG1iM0p1YVdFeEZq
+  QVVCZ05WQkFjVERWTmhiaUJHY21GdVkybHpZMjh4RHpBTkJnTlZCQW9UCkJs
+  TnBlRUZ5YlRFVE1CRUdBMVVFQXhNS2MybDRZWEp0TG1OdmJZSUpBS1B3RUVU
+  VTViSG9NQXdHQTFVZEV3UUYKTUFNQkFmOHdEUVlKS29aSWh2Y05BUUVGQlFB
+  RGdZRUFvb0VleFAvb1BhbTFUUDcxU3l1aHhNYit1VHJaYlNRZQpqVkIrRXhS
+  d1dhZEd3YU5QVUE1NmQzOXF3YXZ3UCtpdSszSnBlb25OTVZ2YldYRjVuYUNY
+  L2RORkllUkVIekVSClpEUlFZTXFydTlURU1uYTZIRDl6cGNzdEY3dndUaEdv
+  dmxPUSszWTZwbFE0bk16aXBYY1o5VEhxczY1UElMMHEKZWFid3BDYkFvcG89
+  Ci0tLS0tRU5EIENFUlRJRklDQVRFLS0tLS0K
+date: 2012-09-07 00:00:00.000000000 Z
 dependencies: []
-
 description: 
 email: sixarm@sixarm.com
 executables: []
-
 extensions: []
-
 extra_rdoc_files: []
-
-files: 
-- README.rdoc
-- LICENSE.txt
+files:
+- .gemtest
+- Rakefile
+- README.md
+- VERSION
 - lib/sixarm_ruby_magic_number_type.rb
-- test/sixarm_ruby_magic_number_type/sample.fit
-- test/sixarm_ruby_magic_number_type/sample.gif
-- test/sixarm_ruby_magic_number_type/sample.jpg
-- test/sixarm_ruby_magic_number_type/sample.png
-- test/sixarm_ruby_magic_number_type/sample.ps
-- test/sixarm_ruby_magic_number_type/sample.ras
-- test/sixarm_ruby_magic_number_type/sample.sgi
-- test/sixarm_ruby_magic_number_type/sample.tiff
-- test/sixarm_ruby_magic_number_type/sample.xcf.bz2
-- test/sixarm_ruby_magic_number_type/sample.xcf.gz
-has_rdoc: true
+- lib/sixarm_ruby_magic_number_type/file.rb
+- lib/sixarm_ruby_magic_number_type/io.rb
+- lib/sixarm_ruby_magic_number_type/string.rb
+- test/sixarm_ruby_magic_number_type_test.rb
+- test/sixarm_ruby_magic_number_type_test/file_test.rb
+- test/sixarm_ruby_magic_number_type_test/io_test.rb
+- test/sixarm_ruby_magic_number_type_test/string_test.rb
+- test/sixarm_ruby_magic_number_type_test/samples/sample.html
+- test/sixarm_ruby_magic_number_type_test/samples/sample.xml
+- test/sixarm_ruby_magic_number_type_test/samples/sample.fit
+- test/sixarm_ruby_magic_number_type_test/samples/sample.gif
+- test/sixarm_ruby_magic_number_type_test/samples/sample.jpg
+- test/sixarm_ruby_magic_number_type_test/samples/sample.png
+- test/sixarm_ruby_magic_number_type_test/samples/sample.ps
+- test/sixarm_ruby_magic_number_type_test/samples/sample.ras
+- test/sixarm_ruby_magic_number_type_test/samples/sample.sgi
+- test/sixarm_ruby_magic_number_type_test/samples/sample.tiff
+- test/sixarm_ruby_magic_number_type_test/samples/sample.bz2
+- test/sixarm_ruby_magic_number_type_test/samples/sample.gz
 homepage: http://sixarm.com/
 licenses: []
-
 post_install_message: 
 rdoc_options: []
-
-require_paths: 
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: 
-rubygems_version: 1.5.0
+rubygems_version: 1.8.23
 signing_key: 
 specification_version: 3
-summary: "SixArm.com \xC2\xBB Ruby \xC2\xBB Magic number type inspects bytes to decide on a mime type"
-test_files: []
-
+summary: SixArm.com » Ruby » Magic number type inspects bytes to decide on a mime
+  type
+test_files:
+- test/sixarm_ruby_magic_number_type_test.rb
+- test/sixarm_ruby_magic_number_type_test/file_test.rb
+- test/sixarm_ruby_magic_number_type_test/io_test.rb
+- test/sixarm_ruby_magic_number_type_test/string_test.rb
+- test/sixarm_ruby_magic_number_type_test/samples/sample.html
+- test/sixarm_ruby_magic_number_type_test/samples/sample.xml
+- test/sixarm_ruby_magic_number_type_test/samples/sample.fit
+- test/sixarm_ruby_magic_number_type_test/samples/sample.gif
+- test/sixarm_ruby_magic_number_type_test/samples/sample.jpg
+- test/sixarm_ruby_magic_number_type_test/samples/sample.png
+- test/sixarm_ruby_magic_number_type_test/samples/sample.ps
+- test/sixarm_ruby_magic_number_type_test/samples/sample.ras
+- test/sixarm_ruby_magic_number_type_test/samples/sample.sgi
+- test/sixarm_ruby_magic_number_type_test/samples/sample.tiff
+- test/sixarm_ruby_magic_number_type_test/samples/sample.bz2
+- test/sixarm_ruby_magic_number_type_test/samples/sample.gz
+has_rdoc: true

data/LICENSE.txt

@@ -1,12 +0,0 @@
-LICENSE
-
-You may choose any of these licenses:
-
-  - CreativeCommons License, Non-commercial Share Alike
-  - LGPL, GNU Lesser General Public License
-  - MIT License
-  - Ruby License
-
-THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
-IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
-WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

data/README.rdoc

@@ -1,30 +0,0 @@
-
-= SixArm.com » Ruby » MagicNumberType
-
-Author:: Joel Parker Henderson, joelparkerhenderson@gmail.com
-Copyright:: Copyright (c) 2010 Joel Parker Henderson
-License:: See LICENSE.txt file
-
-MagicNumberType infers the mime type of data from the leading bits.
-
-It infers based on widespread programming conventions for data file formats.
-
-Magic numbers are the first bits of a file or data stream
-which uniquely identify the type of file or data stream.
-
-For example when the first bits are "BM",
-this identifies the file as a bitmap image file.
-
-These magic numbers are by convention and we are using this guide:
-http://www.astro.keele.ac.uk/oldusers/rno/Computing/File_magic.html
-
-Typical uses of magic numbers:
-  - to quickly identify a file's data type
-  - to check if data matches the file's MIME type or extension
-  - to check if a web form file upload matches its HTTP content type
-
-Compare:
-  - MIME::Types ruby library 
-  - Unix magic() command for testing files on disk
-  - http://shared-mime.rubyforge.org/
-