enhanced_marc 0.1.5

data/lib/enhanced_marc/sound_record.rb

@@ -0,0 +1,37 @@
+module MARC
+
+  # A class that represents an individual MARC record. Every record
+  # is made up of a collection of MARC::Field objects. 
+
+  class SoundRecord < Record
+
+    def initialize
+      super
+      @leader[6] = 'i' if @leader[6,1] == ' '
+      @leader[7] = 'm' if @leader[7,1] == ' '    
+      @record_type = 'REC'  
+      @bibliographic_level = @leader.get_blvl
+      self.extend SoundType      
+      self.inspect_fixed_fields      
+    end
+    
+    def is_valid_type?
+      return false unless @leader[6,1].match(/[ij]{1}/)
+      return true
+    end
+    def is_valid_blvl?
+      return false unless @leader[7,1].match(/[abcdims]{1}/)
+      return true
+    end
+    def self.new_from_record(record)
+      rec = SoundRecord.new
+      record.instance_variables.each { | var |
+        rec.instance_variable_set(var, record.instance_variable_get(var))
+      }
+      return Exception.new("Incorrect type declaration in leader") unless rec.is_valid_type?
+      return Exception.new("Incorrect bibliographic declaration in leader") unless rec.is_valid_blvl?
+      return rec
+    end    
+    
+  end
+end

data/lib/enhanced_marc/sound_type.rb

@@ -0,0 +1,4 @@
+module SoundType
+  include RecordType
+  public :accompanying_matter, :audience_level, :form, :composition_form, :music_format, :is_conference?
+end

data/lib/enhanced_marc/visual_record.rb

@@ -0,0 +1,37 @@
+module MARC
+
+  # A class that represents an individual MARC record. Every record
+  # is made up of a collection of MARC::Field objects. 
+
+  class VisualRecord < Record
+
+    def initialize
+      super
+      @leader[6] = 'g' if @leader[6,1] == ' '
+      @leader[7] = 'm' if @leader[7,1] == ' '    
+      @record_type = 'VIS'  
+      @bibliographic_level = @leader.get_blvl
+      self.extend VisualType      
+      self.inspect_fixed_fields      
+    end
+    
+    def is_valid_type?
+      return false unless @leader[6,1].match(/[gkro]{1}/)
+      return true
+    end
+    def is_valid_blvl?
+      return false unless @leader[7,1].match(/[abcdims]{1}/)    
+      return true
+    end
+    def self.new_from_record(record)
+      rec = VisualRecord.new
+      record.instance_variables.each { | var |
+        rec.instance_variable_set(var, record.instance_variable_get(var))
+      }
+      return Exception.new("Incorrect type declaration in leader") unless rec.is_valid_type?
+      return Exception.new("Incorrect bibliographic declaration in leader") unless rec.is_valid_blvl?
+      return rec
+    end    
+    
+  end
+end

data/lib/enhanced_marc/visual_type.rb

@@ -0,0 +1,38 @@
+module VisualType
+  include RecordType
+  public :form, :audience_level, :is_govdoc?
+  
+  def running_time
+    if @record_type == 'VIS'
+      unless self['008'].value[18,3] == 'nnn'
+        return "Unknown" if self['008'].value[18,3] == "---"
+        return self['008'].value[18,3].sub(/^0*/, '')
+      end
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      next unless fxd_fld.value[0,1].match(/[gkor]{1}/)
+      unless fxd_fld.value[1,3] == 'nnn'
+        return "Unknown" if fxd_fld.value[1,3] == "---"
+        return fxd_fld.value[1,3].sub(/^0*/, '')
+      end
+    }       
+    return false    
+  end
+  
+  def material_type(human_readable=false)
+    tmat_map = {'a'=>'Art original', 'b'=>'Kit','c'=>'Art reproduction','d'=>'Diorama',
+      'f'=>'Filmstrip','g'=>'Game','i'=>'Picture','k'=>'Graphic','l'=>'Technical drawing',
+      'm'=>'Motion picture','n'=>'Chart','o'=>'Flash card','p'=>'Microscope slide',
+      'q'=>'Model','r'=>'Realia','s'=>'Slide','t'=>'Transparency','v'=>'Videorecording',
+      'w'=>'Toy','z'=>'Other'}
+    human_readable = tmat_map if human_readable
+    return self.field_parser({:match=>'VIS', :start=>33,:end=>1}, {:match=>/[gkor]{1}/, :start=>16,:end=>1}, human_readable)   
+  end
+  
+  def technique(human_readable=false)
+    tech_map = {'a'=>'Animation','c'=>'Animation and live action','l'=>'Live action',
+      'n'=>'N/A','u'=>'Unknown','z'=>'Other'}
+    human_readable = tmat_map if human_readable
+    return self.field_parser({:match=>'VIS', :start=>34,:end=>1}, {:match=>/[gkor]{1}/, :start=>17,:end=>1}, human_readable)       
+  end
+end

data/lib/enhanced_marc/xmlreader.rb

@@ -0,0 +1,58 @@
+module MARC  
+  class XMLReader
+    # will accept parse events until a record has been built up
+    #
+    def build_record
+      record = MARC::Record.new
+      data_field = nil
+      control_field = nil
+      subfield = nil
+      text = '' 
+      attrs = nil
+
+      while @parser.has_next?
+        event = @parser.pull
+
+        if event.text?
+          text += REXML::Text::unnormalize(event[0])
+          next
+        end
+
+        if event.start_element?
+          text = ''
+          attrs = event[1]
+          case strip_ns(event[0])
+          when 'controlfield'
+            text = ''
+            control_field = MARC::ControlField.new(attrs['tag'])
+          when 'datafield'
+            text = ''
+            data_field = MARC::DataField.new(attrs['tag'], attrs['ind1'], 
+              attrs['ind2'])
+          when 'subfield'
+            text = ''
+            subfield = MARC::Subfield.new(attrs['code'])
+          end
+        end
+
+        if event.end_element?
+          case strip_ns(event[0])
+          when 'leader'
+            record.leader = text
+          when 'record'
+            return record
+          when 'controlfield'
+            control_field.value = text
+            record.append(control_field)
+          when 'datafield'
+            record.append(data_field)
+          when 'subfield'
+            subfield.value = text
+            data_field.append(subfield)
+          end
+        end
+      end
+      record.to_typed_record
+    end
+  end
+end

data/pkg/enhanced_marc-0.1/Changes

@@ -0,0 +1 @@
+2009-08-07:  Refactored to monkeypatch ruby-marc rather than replace it.

data/pkg/enhanced_marc-0.1/LICENSE

@@ -0,0 +1,21 @@
+The MIT License
+
+Copyright (c) 2007 Ross Singer
+
+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/pkg/enhanced_marc-0.1/README

@@ -0,0 +1,51 @@
+Enhanced MARC is a set of classes, modules and methods that sit on top of ruby-marc (http://rubyforge.org/projects/marc) to help parse the contents of MARC records more easily and conveniently.
+Installation:
+  gem sources -a http://gems.github.com
+  sudo gem install rsinger-enhanced_marc
+  
+Usage:
+
+  require 'enhanced_marc'
+  
+  reader = MARC::Reader.new('marc.dat')
+  
+  records = []
+  
+  reader.each do | record |
+    records << record
+  end
+  
+  >> records[0].class
+  => MARC::BookRecord
+  
+  >> records[0].is_conference?
+  => false
+  
+  >> records[0].is_manuscript?
+  => false
+  
+  # Send a boolean true if you want human readable forms, rather than MARC codes.
+  >> records[0].literary_form(true)
+  => "Non-fiction"
+  
+  >> records[0].nature_of_contents(true)
+  => ["Bibliography", "Catalog"]
+  
+  >> records[1].class
+  => MARC::SoundRecord
+  
+  >> records[1].composition_form(true)
+  => "Jazz"
+  
+  >> records[2].class
+  => MARC::MapRecord
+  
+  >> records[2].projection(true)
+  => ["Cylindrical", "Mercator"]
+  
+  >> records[2].relief(true)
+  => ["Color"]
+  
+  
+  
+  

data/pkg/enhanced_marc-0.1/Rakefile

@@ -0,0 +1,41 @@
+RUBY_ENHANCED_MARC_VERSION = '0.1'
+
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+
+task :default => [:test]
+
+Rake::TestTask.new('test') do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/tc_*.rb'
+  t.verbose = true
+  t.ruby_opts = ['-r marc', '-r test/unit']
+end
+
+Rake::RDocTask.new('doc') do |rd|
+  rd.rdoc_files.include("enhanced_marc/**/*.rb")
+  rd.main = 'MARC::Record'
+  rd.rdoc_dir = 'doc'
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    
+    s.add_dependency('marc')
+    s.add_dependency('locale')
+    s.name = 'enhanced_marc'
+    s.author = 'Ross Singer'
+    s.email = 'rossfsinger@gmail.com'
+    s.homepage = 'http://github.com/rsinger/enhanced-marc/tree'
+    s.summary = 'A DSL for MARC data'
+    s.description = 'A set of enhancements to ruby-marc to make parsing MARC data easier'    
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end
+

data/pkg/enhanced_marc-0.1/test/ts_enhanced_marc.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+# local marc library gets tested
+# not already installed one
+$LOAD_PATH.unshift("enhanced_marc")

data/test/ts_enhanced_marc.rb

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+
+# local marc library gets tested
+# not already installed one
+$LOAD_PATH.unshift("enhanced_marc")

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification 
+name: enhanced_marc
+version: !ruby/object:Gem::Version 
+  version: 0.1.5
+platform: ruby
+authors: 
+- Ross Singer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-06 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: marc
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: locale
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+    version: 
+description: A set of enhancements to ruby-marc to make parsing MARC data easier
+email: rossfsinger@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README
+files: 
+- Changes
+- LICENSE
+- README
+- Rakefile
+- VERSION
+- enhanced_marc-0.1.gem
+- enhanced_marc.gemspec
+- lib/enhanced_marc.rb
+- lib/enhanced_marc/book_record.rb
+- lib/enhanced_marc/book_type.rb
+- lib/enhanced_marc/computer_record.rb
+- lib/enhanced_marc/computer_type.rb
+- lib/enhanced_marc/leader.rb
+- lib/enhanced_marc/leftovers.rb
+- lib/enhanced_marc/map_record.rb
+- lib/enhanced_marc/map_type.rb
+- lib/enhanced_marc/mixed_record.rb
+- lib/enhanced_marc/mixed_type.rb
+- lib/enhanced_marc/reader.rb
+- lib/enhanced_marc/record.rb
+- lib/enhanced_marc/record_type.rb
+- lib/enhanced_marc/score_record.rb
+- lib/enhanced_marc/score_type.rb
+- lib/enhanced_marc/serial_record.rb
+- lib/enhanced_marc/serial_type.rb
+- lib/enhanced_marc/sound_record.rb
+- lib/enhanced_marc/sound_type.rb
+- lib/enhanced_marc/visual_record.rb
+- lib/enhanced_marc/visual_type.rb
+- lib/enhanced_marc/xmlreader.rb
+- pkg/enhanced_marc-0.1.gem
+- pkg/enhanced_marc-0.1.tgz
+- pkg/enhanced_marc-0.1.zip
+- pkg/enhanced_marc-0.1/Changes
+- pkg/enhanced_marc-0.1/LICENSE
+- pkg/enhanced_marc-0.1/README
+- pkg/enhanced_marc-0.1/Rakefile
+- pkg/enhanced_marc-0.1/test/ts_enhanced_marc.rb
+- test/ts_enhanced_marc.rb
+has_rdoc: true
+homepage: http://github.com/rsinger/enhanced-marc/tree
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: A DSL for MARC data
+test_files: 
+- test/ts_enhanced_marc.rb