best_type 0.0.3 → 0.0.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 9b2371da6f225b1bd22acd81086ea29b9e219f02
-  data.tar.gz: 27b8760b8632f7716eece5a0889327ae57c3da9a
+SHA256:
+  metadata.gz: 29fe983eac1114ba38d161af60db4bc5baaed14ffc7f9fa226ec0ce9f6b9658b
+  data.tar.gz: 2d8c71566c13afaf5f48253ad659a4aad8c4f345403e0067ad6bc08b793f6451
 SHA512:
-  metadata.gz: 7d8a536b778ade2b05994d6e958975a5672ffd6953946e8f677faa801d014c1ab4c13399a3b4678d2fd9c8c3477716b14867f2dd5620fc3e5d14e5cf8650da6e
-  data.tar.gz: a6f9920f32d467b5f9f18e5598da3363cbc85e62981639ec99e64ea98b7068146f7729207c588d35a2a419250f9834dce1cd11b1b16ca2711b35580df06f14bd
+  metadata.gz: 905b6b2f3bf244668bc1962eea0561cd267e7aaee333c2c4817f56ca917b7181c0d55cddfbaa952032ed839aa75422d1c3a75ee0b5b17fecf7ea826a8a4f8c28
+  data.tar.gz: a96af2728b2d1c5c15fdbb4a3a065be91d11352f81c8ab1a6ee38a517e737bc6c97625538a17a985015b58ee21332c13fded4160964f42c0189ea44bf155d7cf

data/README.md

@@ -28,6 +28,12 @@ BestType.dc_type.for_file_name('/path/to/some/file.jpg') # 'StillImage'
 
 # detect dc type for mime types
 BestType.dc_type.for_mime_type('image/jpeg') # 'StillImage'
+
+# detect dc type for file names (including full file path)
+BestType.pcdm_type.for_file_name('/path/to/some/file.jpg') # 'Image'
+
+# detect dc type for mime types
+BestType.pcdm_type.for_mime_type('image/jpeg') # 'Image'
 ```
 
 ### Add Custom Overrides
@@ -36,12 +42,14 @@ BestType.configure({
   extension_to_mime_type_overrides:
     'custom': 'custom/type'
   mime_type_to_dc_type_overrides:
-    'custom/type': 'Custom'
+    'custom/type': 'CustomDC'
+  mime_type_to_pcdm_type_overrides:
+    'custom/type': 'CustomPCDM'
 })
 
 BestType.mime_type.for_file_name('myfile.custom') # 'custom/type'
-BestType.dc_type.for_file_name('myfile.custom') # 'Custom'
-BestType.dc_type.for_mime_type('custom/type') # 'Custom'
+BestType.dc_type.for_file_name('myfile.custom') # 'CustomDC'
+BestType.pcdm_type.for_mime_type('custom/type') # 'CustomPCDM'
 
 ```
 
@@ -63,6 +71,8 @@ BestType.configure({
     'custom': 'custom/type'
   mime_type_to_dc_type_overrides:
     'custom/type': 'Custom'
+  mime_type_to_pcdm_type_overrides:
+    'custom/type': 'Custom'
 })
 ```
 
@@ -81,18 +91,24 @@ development:
     'good': 'good/type'
   mime_type_to_dc_type_overrides:
     'good/type': 'Good'
+  mime_type_to_pcdm_type_overrides:
+    'good/type': 'Goodly'
     
 test:
   extension_to_mime_type_overrides:
     'better': 'better/type'
   mime_type_to_dc_type_overrides:
     'better/type': 'Better'
+  mime_type_to_pcdm_type_overrides:
+    'best/type': 'Betterly'
 
 production:
   extension_to_mime_type_overrides:
     'best': 'best/type'
   mime_type_to_dc_type_overrides:
     'best/type': 'Best'
+  mime_type_to_pcdm_type_overrides:
+    'best/type': 'Bestly'
 ```
 
 ### Running Tests (for developers):

data/config/internal_config_options.yml

@@ -1,6 +1,12 @@
 extension_to_mime_type_overrides:
   'test': 'test/type'
   'mp4': 'video/mp4'
+  'vtt': 'text/vtt'
+  'm4v': 'video/x-m4v'
 mime_type_to_dc_type_overrides:
   'test/type': 'Test'
   'application/mxf': 'MovingImage'
+  'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'Text'
+  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'Dataset'
+mime_type_to_pcdm_type_overrides:
+  'test/type': 'Test'

data/lib/best_type.rb

@@ -2,6 +2,7 @@ require 'best_type/version'
 require 'best_type/config'
 require 'best_type/mime_type_lookup'
 require 'best_type/dc_type_lookup'
+require 'best_type/pcdm_type_lookup'
 require 'yaml'
 
 module BestType
@@ -15,6 +16,10 @@ module BestType
     @dc_type ||= BestType::DcTypeLookup.new(mime_type)
   end
 
+  def self.pcdm_type
+    @pcdm_type ||= BestType::PcdmTypeLookup.new(mime_type)
+  end
+
   def self.config(reload = false, user_config_options = {})
     if @config.nil? || reload
       @semaphore.synchronize do

data/lib/best_type/config.rb

@@ -1,7 +1,7 @@
 module BestType
   class Config
 
-    attr_reader :extension_to_mime_type_overrides, :mime_type_to_dc_type_overrides
+    attr_reader :extension_to_mime_type_overrides, :mime_type_to_dc_type_overrides, :mime_type_to_pcdm_type_overrides
 
     def initialize(user_config_options = {})
       # Get defaults from internal_custom_mapping.yml in gem
@@ -9,12 +9,14 @@ module BestType
       internal_config_file_path = File.join(gem_dir, 'config/internal_config_options.yml')
       internal_config_options = YAML.load_file(internal_config_file_path)
 
-      @extension_to_mime_type_overrides = internal_config_options['extension_to_mime_type_overrides']
-      @mime_type_to_dc_type_overrides = internal_config_options['mime_type_to_dc_type_overrides']
+      @extension_to_mime_type_overrides = internal_config_options['extension_to_mime_type_overrides'] || {}
+      @mime_type_to_dc_type_overrides = internal_config_options['mime_type_to_dc_type_overrides'] || {}
+      @mime_type_to_pcdm_type_overrides = internal_config_options['mime_type_to_pcdm_type_overrides'] || {}
 
       stringify_user_config_options_keys!(user_config_options)
       add_extension_to_mime_type_overrides(user_config_options['extension_to_mime_type_overrides']) if user_config_options.key?('extension_to_mime_type_overrides')
       add_mime_type_to_dc_type_overrides(user_config_options['mime_type_to_dc_type_overrides']) if user_config_options.key?('mime_type_to_dc_type_overrides')
+      add_mime_type_to_pcdm_type_overrides(user_config_options['mime_type_to_pcdm_type_overrides']) if user_config_options.key?('mime_type_to_pcdm_type_overrides')
     end
 
     private
@@ -27,6 +29,10 @@ module BestType
       @mime_type_to_dc_type_overrides.merge!(overrides)
     end
 
+    def add_mime_type_to_pcdm_type_overrides(overrides)
+      @mime_type_to_pcdm_type_overrides.merge!(overrides)
+    end
+
     def stringify_user_config_options_keys!(user_config_options)
       user_config_options_keys = user_config_options.keys
       user_config_options_keys.each do |key|

data/lib/best_type/dc_type_lookup.rb

@@ -3,13 +3,39 @@ module BestType
 
     attr_reader :config
 
-    FALLBACK_DC_TYPE = 'Software'.freeze
+    COLLECTION = 'Collection'.freeze
+    DATASET = 'Dataset'.freeze
+    EVENT = 'Event'.freeze
+    INTERACTIVE_RESOURCE = 'InteractiveResource'.freeze
+    MOVING_IMAGE = 'MovingImage'.freeze
+    PHYSICAL_OBJECT = 'PhysicalObject'.freeze
+    SERVICE = 'Service'.freeze
+    SOFTWARE = 'Software'.freeze
+    SOUND = 'Sound'.freeze
+    STILL_IMAGE = 'StillImage'.freeze
+    TEXT = 'Text'.freeze
+
+    # these include values that will not be derived from MIME/content types
+    VALID_TYPES = [
+      COLLECTION, EVENT, INTERACTIVE_RESOURCE, MOVING_IMAGE, PHYSICAL_OBJECT,
+      SERVICE, SOFTWARE, SOUND, STILL_IMAGE, TEXT
+    ].freeze
+
+    FALLBACK_DC_TYPE = SOFTWARE
 
     def initialize(mime_type_lookup_instance)
       @mime_type_lookup = mime_type_lookup_instance
       @config = @mime_type_lookup.config
     end
 
+    def fallback_type
+      FALLBACK_DC_TYPE
+    end
+
+    def valid_type?(value)
+      VALID_TYPES.include? value
+    end
+
     def for_file_name(file_name_or_path)
       for_mime_type(@mime_type_lookup.for_file_name(file_name_or_path))
     end
@@ -20,13 +46,13 @@ module BestType
       return dc_type unless dc_type.nil?
 
       mimes_to_dc = {
-        /^image/ => 'StillImage',
-        /^video/ => 'MovingImage',
-        /^audio/ => 'Sound',
-        /^text/ => 'Text',
-        /^application\/(pdf|msword)/ => 'Text',
-        /excel|spreadsheet|xls|application\/sql/ => 'Dataset',
-        /^application/ => 'Software'
+        /^image/ => STILL_IMAGE,
+        /^video/ => MOVING_IMAGE,
+        /^audio/ => SOUND,
+        /^text/ => TEXT,
+        /^application\/(pdf|msword)/ => TEXT,
+        /excel|spreadsheet|xls|application\/sql/ => DATASET,
+        /^application/ => SOFTWARE
       }
 
       dc_type = mimes_to_dc.find { |pattern, _type_val| mime_type =~ pattern }

data/lib/best_type/pcdm_type_lookup.rb

@@ -0,0 +1,116 @@
+module BestType
+  class PcdmTypeLookup
+
+    attr_reader :config
+
+    # https://github.com/duraspace/pcdm/blob/master/pcdm-ext/file-format-types.rdf
+    ARCHIVE = "Archive".freeze
+    AUDIO = "Audio".freeze
+    DATABASE = "Database".freeze
+    DATASET = "Dataset".freeze
+    EMAIL = "Email".freeze
+    FONT = "Font".freeze
+    HTML = "HTML".freeze
+    IMAGE = "Image".freeze
+    PAGE_DESCRIPTION = "PageDescription".freeze
+    PRESENTATION = "Presentation".freeze
+    SOFTWARE = "Software".freeze
+    SOURCE_CODE = "SourceCode".freeze
+    SPREADSHEET = "Spreadsheet".freeze
+    STRUCTURED_TEXT = "StructuredText".freeze
+    TEXT = "Text".freeze
+    UNKNOWN = "Unknown".freeze
+    UNSTRUCTURED_TEXT = "UnstructuredText".freeze
+    VIDEO = "Video".freeze
+    WEBSITE = "Website".freeze
+
+    # these include values that will not be derived from MIME/content types
+    VALID_TYPES = [
+      ARCHIVE, AUDIO, DATABASE, DATASET, EMAIL, FONT, HTML, IMAGE, PAGE_DESCRIPTION, PRESENTATION, SOFTWARE,
+      SOURCE_CODE, SPREADSHEET, STRUCTURED_TEXT, TEXT, UNKNOWN, UNSTRUCTURED_TEXT, VIDEO, WEBSITE
+    ].freeze
+
+    FALLBACK_TYPE = UNKNOWN
+
+    def initialize(mime_type_lookup_instance)
+      @mime_type_lookup = mime_type_lookup_instance
+      @config = @mime_type_lookup.config
+    end
+
+    def fallback_type
+      FALLBACK_TYPE
+    end
+
+    def valid_type?(value)
+      VALID_TYPES.include? value
+    end
+
+    def for_file_name(file_name_or_path)
+      for_mime_type(@mime_type_lookup.for_file_name(file_name_or_path))
+    end
+
+    def for_mime_type(mime_type)
+      # Check config overrides first
+      file_type = @config.mime_type_to_pcdm_type_overrides.fetch(mime_type, nil)
+      return file_type unless file_type.nil?
+
+      mimes_to_type = {
+        /^image/i => IMAGE,
+        /^video/i => VIDEO,
+        /^audio/i => AUDIO,
+        /^text/i => {
+          /\/css/i => SOURCE_CODE,
+          /\/html/i => HTML,
+          /.+/ => TEXT
+        },
+        /excel|spreadsheet|xls/i => SPREADSHEET,
+        /application\/sql/i => DATABASE,
+        /csv/i => DATASET,
+        /octet.stream/i => UNKNOWN,
+        /^application/i => {
+          /\/access/i => DATABASE,
+          /\/css/i => SOURCE_CODE,
+          /\/html/i => HTML,
+          /\/x-iwork-keynote/i => PRESENTATION,
+          /\/x-iwork-numbers/i => SPREADSHEET,
+          /\/x-iwork-pages/i => PAGE_DESCRIPTION,
+          /\/mbox/i => EMAIL,
+          /\/mp4/i => VIDEO,
+          /\/mp4a/i => AUDIO,
+          /\/msaccess/i => DATABASE,
+          /\/mxf/i => VIDEO,
+          /\/(pdf|msword)/i => PAGE_DESCRIPTION,
+          /\/postscript/i => PAGE_DESCRIPTION,
+          /\/powerpoint/i => PRESENTATION,
+          /\/rtf/i => PAGE_DESCRIPTION,
+          /\/sql/i => DATABASE,
+          /\/swf/ => VIDEO,
+          /\/vnd.ms-asf/i => VIDEO,
+          /\/vnd.ms-word/i => PAGE_DESCRIPTION,
+          /\/vnd.ms-wpl/i => PAGE_DESCRIPTION,
+          /\/vnd.oasis.opendocument.text/i => PAGE_DESCRIPTION,
+          /\/vnd.openxmlformats-officedocument.presentation/i => PRESENTATION,
+          /\/vnd.openxmlformats-officedocument.wordprocessingml/i => PAGE_DESCRIPTION,
+          /\/vnd.ms-powerpoint/i => PRESENTATION,
+          /\/vnd.sun.xml.calc/i => SPREADSHEET,
+          /\/vnd.sun.xml.impress/i => PRESENTATION,
+          /\/vnd.sun.xml.writer/i => PAGE_DESCRIPTION,
+          /\/xml/i => STRUCTURED_TEXT,
+          /\/x.mspublisher/i => PAGE_DESCRIPTION,
+          /\/x.shockwave-flash/ => VIDEO,
+          /\/x.spss/i => DATASET,
+          /\/zip/i => ARCHIVE,
+          /.+/ => UNKNOWN
+        }
+      }
+
+      file_type = mimes_to_type.detect { |pattern, _type_val| mime_type =~ pattern }
+      return fallback_type unless file_type
+      if file_type&.last.is_a? Hash
+        file_type = file_type.last.detect { |pattern, _type_val| mime_type =~ pattern }
+      end
+      file_type.nil? ? fallback_type : file_type.last
+    end
+
+  end
+end

data/lib/best_type/version.rb

@@ -1,6 +1,6 @@
 module BestType
 
-  VERSION = '0.0.3'.freeze
+  VERSION = '0.0.10'.freeze
 
   def self.version
     VERSION

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: best_type
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.10
 platform: ruby
 authors:
 - Eric O'Hanlon
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
 date: 2018-03-25 00:00:00.000000000 Z
@@ -106,6 +106,7 @@ files:
 - lib/best_type/config.rb
 - lib/best_type/dc_type_lookup.rb
 - lib/best_type/mime_type_lookup.rb
+- lib/best_type/pcdm_type_lookup.rb
 - lib/best_type/version.rb
 - lib/tasks/best_type.rake
 - lib/tasks/best_type/ci.rake
@@ -113,7 +114,7 @@ homepage: https://github.com/cul/best_type
 licenses:
 - MIT
 metadata: {}
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -128,9 +129,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.14
-signing_key: 
+rubygems_version: 3.0.8
+signing_key:
 specification_version: 4
 summary: A library for selecting the best mime type or dc type for a file.
 test_files: []