mime_type 0.0.1

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 Topspin Media Inc.
+
+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,31 @@
+What is MimeType
+================
+
+A Ruby library to identify the MIME type of a local file
+
+Why MimeType was born
+=====================
+
+At [Topspin](http://topspinmedia.com) we provide [ArtistLink](http://artistlink.com), a platform for musician to upload and share their songs and videos.
+Artistlink provides a form to upload media files, and we need a way to present them differently if they are images, videos, sounds or other files.
+
+How to use from the command line (executable)
+=============================================
+
+Type `mime_type_of` followed by the path of a local file.
+This is will show the MIME type of that file.
+
+How to use in other Ruby programs
+=================================
+
+Install by running `gem install mime_type` or adding `mime_type` in the Gemfile of your bundled project.
+
+Call `MimeType::of(file)` to know the MIME type of `file`.
+`file` can be any derivation of the `File` object such that `file.path` returns its local path.
+
+How to contribute
+=================
+
+Make sure tests pass, then either submit a Pull Request.
+A list of [nice TODOs](http://github.com/topspin/mime_type/tree/master/TODO.md) is provided.
+You can also build a new version of the gem and move it to your gem repository.

data/bin/mime_type_of

@@ -0,0 +1,56 @@
+#!/usr/bin/env ruby
+begin
+  require 'mime_type'
+rescue LoadError
+  require 'rubygems'
+  require 'mime_type'
+end
+
+require 'optparse'
+class MimeTypeParser
+  def self.parse(args)
+    options = {}
+    options[:output] = :html
+
+    opt_parser = OptionParser.new do |opts|
+      opts.banner = "Usage: #{File.basename($0)} [file_path]"
+
+      opts.separator ''
+      opts.separator 'Specific options:'
+
+      opts.on("-m", "--[no-]magic", "Use File magic number") do |n|
+        options[:by_file_magic] = n
+      end
+           
+      opts.on("-t", "--[no-]file-type", "Use File type") do |n|
+        options[:by_file_type] = n
+      end
+
+      opts.separator ''
+      opts.separator 'Common options:'
+
+      opts.on_tail('-h', '--help', 'Show this message') do
+        puts opts
+        exit
+      end
+
+      opts.on_tail('--version', 'Show version') do
+        puts MimeType::VERSION
+        exit
+      end
+    end
+
+    opt_parser.parse!(args)
+    options
+  end
+end
+
+if ARGV.empty?
+  abort "Please specify an file, e.g. `#{File.basename($0)} example.jpg'"
+else
+  file_path = ARGV[0]
+end
+options = MimeTypeParser.parse(ARGV)
+
+mime_type = File.open(file_path) {|file| MimeType.of file, options}
+puts "The MIME type of #{file_path} is: #{mime_type}"

data/lib/mime_type.rb

@@ -0,0 +1,35 @@
+require 'magic'
+require 'mimemagic'
+
+# Provides a methods to read the MIME type of a local file
+module MimeType
+
+  # Returns the MIME type of a local file
+  #
+  # @param [File] file Local file (or any Object with a +path+ method)
+  # @param [Hash] options the options to read the MIME type
+  # @option options [Boolean] :by_magic Use the File Magic type
+  # @option options [Integer] :by_file_type Use the File extension
+  # @return [String] MIME path of the file or +nil+ if unrecognized
+  #
+  # @note More info about techniques to guess the MIME type at
+  # {https://github.com/qoobaa/magic Magic Gem docs}
+  # and
+  # {http://rdoc.info/github/minad/mimemagic/frames/file/README MimeMagic doc}
+  #
+  # @example Read the MIME type of a local JPEG file
+  #   MimeType.of("example.jpg")
+  #
+  #   # => 'image/jpeg'
+  def self.of(file, options ={})
+    mime_type = nil
+    if options.fetch(:by_magic, true)
+      mime_magic = MimeMagic.by_magic(File.open file.path)
+      mime_type ||= mime_magic.type if mime_magic
+    end
+    if options.fetch(:by_file_type, true)
+      mime_type ||= Magic.guess_file_mime_type(file.path)
+    end
+    mime_type
+  end
+end

data/lib/mime_type/version.rb

@@ -0,0 +1,3 @@
+module MimeType
+  VERSION = '0.0.1'
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: mime_type
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Claudio Baccigalupo
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: magic
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mimemagic
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: redcarpet
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Returns the MIME type of a local file
+email:
+- claudio@topspinmedia.com
+executables:
+- mime_type_of
+extensions: []
+extra_rdoc_files: []
+files:
+- bin/mime_type_of
+- lib/mime_type/version.rb
+- lib/mime_type.rb
+- MIT-LICENSE
+- README.md
+homepage: https://github.com/topspin/mime_type
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -555311211199056139
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -555311211199056139
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: ! 'MimeType provides one method: * of, which returns the MIME type of the
+  file passed as argument'
+test_files: []
+has_rdoc: