enhanced_marc 0.1.5

data/lib/enhanced_marc/record_type.rb

@@ -0,0 +1,310 @@
+module RecordType
+  
+  private
+  
+  def is_govdoc?(human_readable=false)
+    govdoc_map={'a'=>'Autonomous or semiautonomous components', 'c'=>'Multilocal', 'f'=>'Federal',
+      'i'=>'International', 'l'=>'Local', 'm'=>'Multistate', 'o'=>'Undetermined', 's'=>'State', 'u'=>'Unknown', 'z'=>'Other'}
+    human_readable = govdoc_map if human_readable
+    return self.field_parser({:match=>/^BKS$|^COM$|^MAP$|^SER$|^VIS$/, :start=>28,:end=>1}, {:match=>/[atmefsgkor]{1}/, :start=>11,:end=>1}, human_readable)
+  end    
+  
+  def nature_of_contents(human_readable=false)
+    cont_map = {'a'=>'Abstracts','b'=>'Bibliography','c'=>'Catalog','d'=>'Dictionary',
+      'e'=>'Encyclopedia', 'f'=>'Handbook', 'g'=>'Legal article', 'h'=>'Biography', 'i'=>'Index',
+      'j'=>'Patent document', 'k'=>'Discography', 'l'=>'Legislation', 'm'=>'Thesis', 'n'=>'Literature survey',
+      'o'=>'Review', 'p'=>'Programmed text', 'q'=>'Filmography', 'r'=>'Directory', 's'=>'Statistics', 
+      't'=>'Technical report', 'u'=>'Standard/specification', 'v'=>'Legal case', 'w'=>'Law report', 'x'=>'Other report',
+      'y'=>'Yearbook', 'z'=>'Treaty', '2'=>'Offprint', '5'=>'Calendar', '6'=>'Comic/Graphic Novel'}
+      
+    contents = []
+    idx = nil
+    if self.record_type == 'BKS'
+      idx = 24
+      len = 4
+    elsif self.record_type == 'SER'
+      idx = 25
+      len = 3
+    end
+    if idx
+      self['008'].value[idx,len].split(//).each { | char | 
+        next if char == " "
+        if human_readable
+          contents << cont_map[char] if cont_map[char]
+        else
+          contents << char
+        end
+      }
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      idx = nil
+      if fxd_fld.value[0,1].match(/[at]{1}/)
+        idx = 7
+        len = 4
+      elsif fxd_fld.value[0,1].match('s')
+        idx = 8
+        len = 3
+      end     
+      if idx 
+        fxd_fld.value[idx,len].split(//).each { | char | 
+          next if char == " "
+          if human_readable
+            contents << cont_map[char] if cont_map[char]
+          else
+            contents << char
+          end
+        }
+      end
+    }       
+    return false if contents.empty?
+    return contents      
+  end
+  
+
+  def is_conference?
+    return true if self['008'].value[29,1] == '1' && @record_type.match(/^BKS$|^SER$/)      
+    return true if self['008'].value[30,2].match(/c/) && @record_type.match(/^SCO$|^REC$/) 
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      return true if fxd_fld.value[12,1] == '1' && fxd_fld.value[0,1].match(/[ats]{1}/)
+
+      return true if fxd_fld.value[13,2].match(/c/) && fxd_fld.value[0,1].match(/[cdij]{1}/)
+    }      
+    return false  
+  end
+  
+  def set_conference(value=false, field=nil)
+    if field
+      return Exception.new("Field is not an 006") unless field.tag == '006'
+      return Exception.new("Field is not a BKS or SER") unless field.value[0,1].match(/[ats]{1}/)
+      if value
+        field.value[12] = '1'
+      else
+        field.value[12] = '0'
+      end
+    else  
+      field = @fields['008']
+      field = MARC::Controlfield.new('008') unless field
+      if value
+        field[29] = '1'
+      else
+        field[29] = '0'
+      end
+    end    
+    
+  end  
+  
+  def accompanying_matter(human_readable=false)
+    accm_map = {'a'=>'Discography','b'=>'Bibliography','c'=>'Thematic index','d'=>'Libretto',
+      'e'=>'Composer biography', 'f'=>'Performer biography', 'g'=>'Technical/historical information on instruments', 
+      'h'=>'Technical information on music', 'i'=>'Historical information', 'j'=>'Historical information other than music',
+      'k'=>'Ethnological information', 'n'=>'Not applicable', 'r'=>'Instructional materials', 's'=>'Music', 
+      'z'=>'Other accompanying matter'}
+      matter = []
+
+      if ['SCO', 'REC'].index(@record_type)
+      self['008'].value[24,6].split(//).each { | char | 
+        next if char == " "
+        if human_readable
+          matter << accm_map[char] if accm_map[char]
+        else
+          matter << char
+        end
+      }
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+  
+      if fxd_fld.value[0,1].match(/[cdij]{1}/)
+        fxd_fld.value[7,6].split(//).each { | char | 
+          next if char == " "
+          if human_readable
+            matter << accm_map[char]
+          else
+            matter << char
+          end
+        }
+      end
+    }       
+    return false if matter.empty?
+    return matter          
+  end  
+  
+  def audience_level(human_readable=false)
+    audn_map = {'a'=>'Preschool', 'b'=>'Children age 6-8', 'c'=>'Children age 9-13',
+      'd'=>'Adolescent', 'e'=>'Adult', 'f'=>'Specialized', 'g'=>'General', 'j'=>'Juvenile'
+      }
+    human_readable = audn_map if human_readable
+    return self.field_parser({:match=>/^BKS$|^VIS$|^MIX$|^MAP$|^SCO$|^REC$|^COM$/, :start=>22,:end=>1}, {:match=>/[atmefpcdijgkor]{1}/, :start=>5,:end=>1}, human_readable)
+  end  
+  
+  def form(human_readable=false)
+    form_map = {'a'=>'Microfilm', 'b'=>'Microfiche', 'c'=>'Microopaque',
+      'd'=>'Large print', 'f'=>'Braille', 'r'=>'Reproduction', 's'=>'Electronic'
+    }
+    idx = nil
+    if self.record_type.match(/^MAP$|^VIS$/)
+      idx = 29
+    else
+      idx = 23
+    end
+    unless self['008'].value[idx,1] == ' '
+      if human_readable
+        return form_map[self['008'].value[idx,1]]
+      else
+        return self['008'].value[idx,1]
+      end
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      idx = nil
+      if fxd_fld.value[0,1].match(/[efgkor]{1}/)
+        idx = 6
+      else
+        idx = 12
+      end     
+      next if fxd_fld.value[idx,1] == ' '        
+      if human_readable
+        return form_map[fxd_fld.value[idx,1]]
+      else
+        return fxd_fld.value[idx,1]
+      end        
+    }       
+    return false
+  end
+  
+  def has_index?
+    return true if self['008'].value[31,1] == '1'      
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      return true if fxd_fld.value[14,1] == '1'
+    }      
+    return false      
+  end
+  
+  def composition_form(human_readable=false)
+    comp_map = {'an'=>'Anthem','bd'=>'Ballad','bt'=>'Ballet','bg'=>'Bluegrass music',
+      'bl'=>'Blues','cn'=>'Canon or round','ct'=>'Catata','cz'=>'Canzona','cr'=>'Carol',
+      'ca'=>'Chaconne','cs'=>'Chance composition','cp'=>'Polyphonic chanson','cc'=>'Christian chant',
+      'cb'=>'Chant','cl'=>'Chorale prelude','ch'=>'Chorale','cg'=>'Concerti grossi','co'=>'Concerto',
+      'cy'=>'Country music','df'=>'Dance form','dv'=>'Divertimento/serenade/cassation/divertissement/notturni',
+      'ft'=>'Fantasia','fm'=>'Folk music','fg'=>'Fugue','gm'=>'Gospel music','hy'=>"Hymn",'jz'=>'Jazz',
+      'md'=>'Madrigal','mr'=>'March','ms'=>'Mass','mz'=>'Mazurka','mi'=>'Minuet','mo'=>'Motet',
+      'mp'=>'Motion picture music','mu'=>'Multiple forms','mc'=>'Musical revue/comedy',
+      'nc'=>'Nocturne','nn'=>'Not a musical recording','op'=>'Opera','or'=>'Oratorio',
+      'ov'=>'Overture','pt'=>'Part-song','ps'=>'Passacaglia','pm'=>'Passion music',
+      'pv'=>'Pavanes','po'=>'Polonaises','pp'=>'Popular music','pr'=>'Prelude','pg'=>'Program music',
+      'rg'=>'Ragtime music','rq'=>'Requiem','rp'=>'Rhapsody','ri'=>'Ricercars','rc'=>'Rock music',
+      'rd'=>'Rondo','sn'=>'Sonata','sg'=>'Song','sd'=>'Square dance music','st'=>'Study/exercise',
+      'su'=>'Suite','sp'=>'Symphonic poem','sy'=>'Symphony','tc'=>'Toccata','ts'=>'Trio-sonata',
+      'uu'=>'Unknown','vr'=>'Variation','wz'=>'Waltz','zz'=>'Other'      
+      }
+    if @record_type.match(/^SCO$|^REC$/)
+      unless self['008'].value[18,2] == '  '
+        if human_readable
+          return comp_map[self['008'].value[18,2]]
+        else
+          return self['008'].value[18,2]
+        end
+      end
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      next unless fxd_fld.value[0,1].match(/[cdij]{1}/)
+      unless fxd_fld.value[1,2] == '  '
+        if human_readable
+          return comp_map[fxd_fld.value[1,2]]
+        else
+          return fxd_fld.value[1,2]
+        end
+      end
+    }       
+    return false      
+  end
+  
+  def music_format(human_readable=false)
+    fmus_map = {'a'=>'Full score','b'=>'Full score, miniature/study size','c'=>'Accompaniment reduced for keyboard',
+      'd'=>'Voice score','e'=>'Condensed score','g'=>'Close score','m'=>'Multiple formats','n'=>'N/A',
+      'u'=>'Unknown','z'=>'Other'}
+    human_readable = fmus_map if human_readable
+    return self.field_parser({:match=>/^SCO$|^REC$/, :start=>20,:end=>1}, {:match=>/[cdij]{1}/, :start=>3,:end=>1}, human_readable)
+#    if self.record_type.match(/^SCO$|^REC$/)
+#      unless self['008'].value[20,1] == ' '
+#        if human_readable
+#          return fmus_map[self['008'].value[20,1]]
+#        else
+#          return self['008'].value[20,1]
+#        end
+#      end
+#    end
+##    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+ #     next unless fxd_fld.value[0,1].match(/[cdij]{1}/)   
+#      next if fxd_fld.value[3,1] == ' '        
+#      if human_readable
+#        return fmus_map[fxd_fld.value[3,1]]
+#      else
+#        return fxd_fld.value[3,1]
+#      end        
+ #   }       
+ #   return false
+  end
+  
+  def has_index?
+    return true if self['008'].value[31,1] == '1'      
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      return true if fxd_fld.value[14,1] == '1'
+    }      
+    return false            
+  end
+  
+  def literary_text(human_readable=true)
+    ltxt_map = {'a'=>'Autobiography', 'b'=>'Biography','c'=>'Conference proceeding','d'=>'Drama',
+      'e'=>'Essay','f'=>'Fiction','g'=>'Reporting','h'=>'History','i'=>'Instruction','j'=>'Language instruction',
+      'k'=>'Comedy','l'=>'Lecture/speech','m'=>'Memoir','n'=>'N/A','o'=>'Folktale','p'=>'Poetry','r'=>'Rehearsal',
+      's'=>'Sounds','t'=>'Interview','z'=>'Other'}
+      txts = []
+      
+      if ['SCO', 'REC'].index(@record_type)
+      self['008'].value[30,2].split(//).each { | char | 
+        next if char == " "
+        if human_readable
+          txts << ltxt_map[char]
+        else
+          txts << char
+        end
+      }
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+  
+      if fxd_fld.value[0,1].match(/[cdij]{1}/)
+        fxd_fld.value[13,2].split(//).each { | char | 
+          next if char == " "
+          if human_readable
+            txts << ltxt_map[char]
+          else
+            txts << char
+          end
+        }
+      end
+    }       
+    return false if txts.empty?
+    return txts          
+  end
+  protected
+  def field_parser(eight, six, human_readable_map=nil)
+    if self.record_type.match(eight[:match])
+      unless self['008'].value[eight[:start],eight[:end]] == ' '*eight[:end]
+        if human_readable_map
+          return human_readable_map[self['008'].value[eight[:start],eight[:end]]]
+        else
+          return self['008'].value[eight[:start],eight[:end]]
+        end
+      end
+    end
+    @fields.find_all {|f| ('006') === f.tag}.each { | fxd_fld |
+      next unless fxd_fld.value[0,1].match(six[:match])   
+      next if fxd_fld.value[six[:start],six[:end]] == ' '*six[:end]
+      if human_readable_map
+        return human_readable_map[fxd_fld.value[six[:start],six[:end]]]
+      else
+        return fxd_fld.value[six[:start],six[:end]]
+      end        
+    }       
+    return false  
+  end
+end

data/lib/enhanced_marc/score_record.rb

@@ -0,0 +1,38 @@
+module MARC
+
+  # A class that represents an individual MARC record. Every record
+  # is made up of a collection of MARC::Field objects. 
+
+  class ScoreRecord < Record
+
+    def initialize
+      super
+      @leader[6] = 'c' if @leader[6,1] == ' '
+      @leader[7] = 'm' if @leader[7,1] == ' '    
+      @record_type = 'SCO'  
+      @bibliographic_level = @leader.get_blvl
+      self.extend ScoreType      
+      self.inspect_fixed_fields      
+    end
+    
+    def is_valid_type?
+      return false unless @leader[6,1].match(/[cd]{1}/)
+      return true
+    end
+    def is_valid_blvl?
+      return true if @leader[7,1].match(/[acdim]{1}/) and @leader[6,1].match('d')
+      return true if @leader[7,1].match(/[abcdims]{1}/) and @leader[6,1].match('c')
+      return false
+    end
+    def self.new_from_record(record)
+      rec = ScoreRecord.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/score_type.rb

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

data/lib/enhanced_marc/serial_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 SerialRecord < Record
+
+    def initialize
+      super
+      @leader[6] = 'a' if @leader[6,1] == ' '
+      @leader[7] = 's' if @leader[7,1] == ' '    
+      @record_type = 'SER'  
+      @bibliographic_level = @leader.get_blvl
+      self.extend SerialType      
+      self.inspect_fixed_fields      
+    end
+    
+    def is_valid_type?
+      return false unless @leader[6,1].match('a')
+      return true
+    end
+    def is_valid_blvl?
+      return false unless @leader[7,1].match(/[bis]{1}/)    
+      return true
+    end
+    def self.new_from_record(record)
+      rec = SerialRecord.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/serial_type.rb

@@ -0,0 +1,87 @@
+module SerialType
+  include RecordType
+  public :is_govdoc?, :nature_of_contents, :is_conference?, :form
+  def alphabet(human_readable=false)
+    alph_map = {'a'=>'Roman', 'b'=>'Extended Roman', 'c'=>'Cyrillic',
+      'd'=>'Japanese', 'e'=>'Chinese', 'f'=>'Arabic', 'g'=>'Greek',
+      'h'=>'Hebrew', 'i'=>'Thai', 'j'=>'Devanagari', 'k'=>'Korean', 'l'=>'Tamil',
+      'u'=>'Unknown', 'z'=>'Other'
+      }
+    human_readable = alph_map if human_readable
+    return self.field_parser({:match=>'SER', :start=>33,:end=>1}, {:match=>'s', :start=>16,:end=>1}, human_readable)
+  end
+  
+  def frequency(human_readable=false) 
+    freq_map = {'a'=>'Annual','b'=>'Bimonthly','c'=>'Semiweekly','d'=>'Daily',
+      'e'=>'Biweekly','f'=>'Semiannual','g'=>'Biennial','h'=>'Triennial','i'=>'3 times/week',
+      'j'=>'3 times/month', 'k'=>'Continuously updated','m'=>'Monthly','q'=>'Quarterly',
+      's'=>'Semimonthly','t'=>'3 times/year','u'=>'Unknown','w'=>'Weekly','z'=>'Other'
+      }
+    human_readable = freq_map if human_readable
+    resp = self.field_parser({:match=>'SER', :start=>18,:end=>1}, {:match=>'s', :start=>1,:end=>1}, human_readable)
+    return resp if resp      
+    if human_readable
+      return 'No determinable frequency'
+    else
+      return false
+    end
+  end
+  
+  def regularity(human_readable=false)
+    regl_map = {'n'=>'Normalized irregular','r'=>'Regular','u'=>'Unknown','x'=>'Completely irregular'}
+    human_readable = regl_map if human_readable
+    return self.field_parser({:match=>'SER', :start=>19,:end=>1}, {:match=>'s', :start=>2,:end=>1}, human_readable)
+  end
+  
+  def serial_type(human_readable=false)
+    srtp_map = {'d'=>'Database','l'=>'Loose-leaf','m'=>'Monographic series','n'=>'Newspaper','p'=>'Periodical','w'=>'Website'}
+    human_readable = srtp_map if human_readable
+    resp = self.field_parser({:match=>'SER', :start=>21,:end=>1}, {:match=>'s', :start=>4,:end=>1}, human_readable)
+    return resp if resp    
+    if human_readable
+      return 'Other'
+    else
+      return false
+    end    
+  end
+  
+  def original_form(human_readable=false)
+    orig_map = {'a'=>'Microfilm','b'=>'Microfiche','c'=>'Microopaque','d'=>'Large print',
+      'e'=>'Newspaper format','f'=>'Braille','s'=>'Electronic'}
+    human_readable = orig_map if human_readable
+    resp = self.field_parser({:match=>'SER', :start=>22,:end=>1}, {:match=>'s', :start=>5,:end=>1}, human_readable)
+    return resp if resp      
+
+    if human_readable
+      return 'Other'
+    else
+      return false
+    end         
+  
+  end
+  
+  def nature_of_work(human_readable=false)
+    entw_map = {'a'=>'Abstracts','b'=>'Bibliography','c'=>'Catalog','d'=>'Dictionary',
+      'e'=>'Encyclopedia', 'f'=>'Handbook', 'g'=>'Legal article', 'h'=>'Biography', 'i'=>'Index',
+      'j'=>'Patent document', 'k'=>'Discography', 'l'=>'Legislation', 'm'=>'Thesis', 'n'=>'Literature survey',
+      'o'=>'Review', 'p'=>'Programmed text', 'q'=>'Filmography', 'r'=>'Directory', 's'=>'Statistics', 
+      't'=>'Technical report', 'u'=>'Standard/specification', 'v'=>'Legal case', 'w'=>'Law report', 'x'=>'Other report',
+      'z'=>'Treaty'}
+
+    human_readable = entw_map if human_readable
+    resp = self.field_parser({:match=>'SER', :start=>24,:end=>1}, {:match=>'s', :start=>7,:end=>1}, human_readable)
+    return resp if resp
+    if human_readable
+      return 'Not specified'
+    else
+      return false
+    end         
+  
+  end
+  
+  def entry(human_readable=false)
+    entry_map = {'0'=>'Successive','1'=>'Latest','2'=>'Integrated'}
+    human_readable = entry_map if human_readable
+    return self.field_parser({:match=>'SER', :start=>34,:end=>1}, {:match=>'s', :start=>17,:end=>1}, human_readable)    
+  end
+end