mediainfo 0.6.1 → 0.6.2

data/Changelog

@@ -1,3 +1,6 @@
+v0.6.2 XML Configuration Examples
+- added examples on how to configure XML back end
+
 v0.6.1 GitHub Home Page
 - use GitHub Pages url as home page for gem
 

data/README.markdown

@@ -15,6 +15,22 @@ You can specify an alternate path if necessary:
   
     Mediainfo.path = "/opt/local/bin/mediainfo"
   
+
+By default, REXML is used as the XML parser. If you'd like, you can 
+configure Mediainfo to use Hpricot or Nokogiri instead using one of 
+the following approaches:
+
+  * define the `MEDIAINFO_XML_PARSER` environment variable to be the 
+    name of the parser as you'd pass to a :gem or :require call. 
+    
+    e.g. `export MEDIAINFO_XML_PARSER=nokogiri`
+    
+  * assign to Mediainfo.xml_parser after you've loaded the gem, 
+    following the same naming conventions mentioned previously.
+    
+    e.g. `Mediainfo.xml_parser = "hpricot"`
+    
+
 Once you've got an instance setup, you can call numerous methods to get 
 a variety of information about a file. Some attributes may be present 
 for some files where others are not, but any supported attribute 

data/Rakefile

@@ -23,6 +23,7 @@ Echoe.new "mediainfo" do |p|
   p.email = "sethrasmussen@gmail.com"
   p.url = "http://greatseth.github.com/mediainfo"
   p.ignore_pattern = %w( test/**/* )
+  p.retain_gemspec = true
   p.honor_gitignore!
 end
 

data/lib/mediainfo.rb

@@ -1,35 +1,59 @@
 require "mediainfo/string"
 require "mediainfo/attr_readers"
 
-# Mediainfo is a class encapsulating the ability to run `mediainfo` 
-# on a file and expose the information it produces in a straightforward 
-# manner.
-# 
-# Basic usage:
-#   
-#   info = Mediainfo.new "/path/to/file"
-#   
-# That will issue the system call to `mediainfo` and parse the output. 
-# From there, you can call numerous methods to get a variety of information 
-# about a file. Some attributes may be present for some files where others 
-# are not.
-# 
-# You may also initialize a Mediainfo instance using raw CLI output 
-# you have saved for some reason.
-# 
-#   info = Mediainfo.new
-#   info.raw_response = cli_output
-# 
-# Setting the raw_response triggers the system call, and from that point on 
-# the object should behave the same as if you'd initialized it with the path 
-# to a file.
-# 
-# For a list of all possible attributes supported:
-#   
-#   Mediainfo.supported_attributes
-#   
-# In addition to the stock arguments provided by parsing `mediainfo` output, 
-# some convenience methods and added behavior is added.
+=begin
+# Mediainfo
+
+Mediainfo is a class wrapping [the mediainfo CLI](http://mediainfo.sourceforge.net).
+
+## Installation
+  
+    $ gem install mediainfo -s http://gemcutter.org
+  
+## Usage
+  
+    info = Mediainfo.new "/path/to/file"
+  
+That will issue the system call to `mediainfo` and parse the output. 
+You can specify an alternate path if necessary:
+  
+    Mediainfo.path = "/opt/local/bin/mediainfo"
+  
+
+By default, REXML is used as the XML parser. If you'd like, you can 
+configure Mediainfo to use Hpricot or Nokogiri instead using one of 
+the following approaches:
+
+  * define the `MEDIAINFO_XML_PARSER` environment variable to be the 
+    name of the parser as you'd pass to a :gem or :require call. 
+    
+    e.g. `export MEDIAINFO_XML_PARSER=nokogiri`
+    
+  * assign to Mediainfo.xml_parser after you've loaded the gem, 
+    following the same naming conventions mentioned previously.
+    
+    e.g. `Mediainfo.xml_parser = "hpricot"`
+    
+
+Once you've got an instance setup, you can call numerous methods to get 
+a variety of information about a file. Some attributes may be present 
+for some files where others are not, but any supported attribute 
+should at least return `nil`.
+
+For a list of all possible attributes supported:
+  
+    Mediainfo.supported_attributes
+  
+## Requirements
+
+This requires at least the following version of the Mediainfo CLI:
+  
+    MediaInfo Command line,
+    MediaInfoLib - v0.7.25
+  
+Previous versions of this gem(<= 0.5.1) worked against v0.7.11, which did not 
+generate XML output, and is no longer supported.
+=end
 class Mediainfo
   extend AttrReaders
   

data/mediainfo.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{mediainfo}
-  s.version = "0.6.1"
+  s.version = "0.6.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
   s.authors = ["Seth Thomas Rasmussen"]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: mediainfo
 version: !ruby/object:Gem::Version 
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors: 
 - Seth Thomas Rasmussen