bibtex-ruby 2.0.7 → 2.0.8

data/Gemfile

@@ -1,6 +1,9 @@
 source :rubygems
 gemspec
 
+# RDF Export
+gem 'rdf', '~>0.3'
+
 group :debug do
 	gem 'debugger', :platforms => [:mri_19]
 	gem 'ruby-debug', :platforms => [:mri_18]

data/Gemfile.lock

@@ -1,13 +1,14 @@
 PATH
   remote: .
   specs:
-    bibtex-ruby (2.0.6)
+    bibtex-ruby (2.0.8)
       latex-decode (>= 0.0.6)
       multi_json (~> 1.3)
 
 GEM
   remote: http://rubygems.org/
   specs:
+    addressable (2.2.7)
     autowatchr (0.1.5)
       watchr
     builder (3.0.0)
@@ -39,7 +40,7 @@ GEM
     linecache (0.46)
       rbx-require-relative (> 0.0.4)
     minitest (2.11.3)
-    multi_json (1.3.2)
+    multi_json (1.3.4)
     mynyml-redgreen (0.7.1)
       term-ansicolor (>= 1.0.4)
     racc (1.4.8)
@@ -52,6 +53,8 @@ GEM
       columnize
       rbx-linecache (~> 1.3)
       rbx-require-relative (>= 0.0.4)
+    rdf (0.3.5.2)
+      addressable (>= 2.2.6)
     rdoc (3.12)
       json (~> 1.4)
     ruby-debug (0.10.4)
@@ -79,6 +82,7 @@ DEPENDENCIES
   racc (~> 1.4)
   rake (~> 0.9)
   rbx-trepanning
+  rdf (~> 0.3)
   rdoc (~> 3.9)
   ruby-debug
   ruby-prof (~> 0.10)

data/History.txt

@@ -1,3 +1,9 @@
+2.0.8 / 2012-05-11
+==================
+
+* Added extend_initials feature for names
+* Added experimental RDF export (using BIBO ontology)
+
 2.0.7 / 2012-04-30
 ==================
 

data/README.md

@@ -35,7 +35,7 @@ Select a BibTeX entry and access individual fields:
     b[:pickaxe].author.length
     #=> 3
     b[:pickaxe].author.to_s
-    #=> "Thomas, Dave and Fowler, Chad and Hunt, Andy"
+    #=> "Thomas, D. and Fowler, Chad and Hunt, Andy"
     b[:pickaxe].author[2].first
     #=> "Andy"
 
@@ -48,6 +48,12 @@ Query a bibliography:
     b['@book[year=2009]'].length
     #=> 1 - the number of books published in 2009
 
+Extend first name initials throughout your bibliography:
+
+    b.extend_initials ['Dave', 'Thomas']
+    b[:pickaxe].author.to_s
+    #=> "Thomas, Dave and Fowler, Chad and Hunt, Andy"
+
 Render your bibliography in one of
 [many different citation styles](https://github.com/citation-style-language/styles)
 (requires the **citeproc-ruby** gem):

data/Rakefile

@@ -80,6 +80,8 @@ end
 
 desc 'Pushes the gem file to rubygems.org'
 task :release => ['build'] do
+  system %Q{git tag "#{BibTeX::Version::STRING}"}
+  system "git push --tags"
   system "gem push bibtex-ruby-#{BibTeX::Version::STRING}.gem"
 end
 

data/lib/bibtex/bibliography.rb

@@ -89,8 +89,9 @@ module BibTeX
       :comment, :meta_content
     
     def_delegators :@data, :length, :size, :empty?
-    def_delegators :@entries, :key?, :has_key?
+    def_delegators :@entries, :key?, :has_key?, :values_at
     
+    alias entries_at values_at
 
     # Creates a new bibliography.
     def initialize(options = {})
@@ -285,6 +286,17 @@ module BibTeX
       self
     end
     
+    # call-seq:
+    #   b.extend_initials(['Edgar Allen', 'Poe'], ['Nathaniel', 'Hawthorne'])
+    #   #=> Extends the initials in names like 'E.A. Poe' or 'Hawethorne, N.'
+    #       in the bibliography.
+    def extend_initials(*arguments)
+      arguments.each do |with_first, for_last|
+        names.each do |name|
+          name.extend_initials(with_first, for_last)
+        end
+      end
+    end
     
     def sort(*arguments, &block)
       data.sort(*arguments, &block)
@@ -341,6 +353,22 @@ module BibTeX
       xml
     end
 
+    # Returns an RDF::Graph representation of the bibliography. The graph
+    # can be serialized using any of the RDF serializer plugins.
+    def to_rdf(options = {})
+      require 'rdf'
+      
+      graph = RDF::Graph.new
+
+      q('@entry').each do |entry|
+        graph << entry.to_rdf(options)
+      end
+      
+      graph
+    rescue LoadError
+      BibTeX.log.error "Please gem install rdf for RDF support."
+    end
+    
     # call-seq:
     #   bib.query()          #=> returns all elements
     #   bib.query('@book')   #=> returns all books

data/lib/bibtex/entry.rb

@@ -107,6 +107,35 @@ module BibTeX
       article        article-journal
     }.map(&:intern)]).freeze
 
+    BIBO_FIELDS = Hash[*%w{
+      pages      pages
+      number     issue
+      isbn       isbn
+      issn       issn
+      doi        doi
+      edition    edition
+      abstract   abstract
+      volume     volume
+    }.map(&:intern)].freeze
+
+    BIBO_TYPES = Hash.new(:Document).merge(Hash[*%w{
+      booklet        Book
+      book           Book
+      conference     Conference
+      inbook         Article
+      incollection   Article
+      inproceedings  Article
+      manual         Manual
+      mastersthesis  Thesis
+      phdthesis      Thesis
+      proceedings    Proceedings
+      techreport     Report
+      journal        Journal
+      periodical     Periodical
+      unpublished    Manuscript
+      article        Article
+    }.map(&:intern)]).freeze
+
     
     attr_reader :fields, :type
     
@@ -198,20 +227,33 @@ module BibTeX
     alias type? has_type?
     
     
-    def has_field?(name)
-      name.respond_to?(:to_sym) ? fields.has_key?(name.to_sym) : false
+    def has_field?(*names)
+      names.flatten.any? do |name|
+        name.respond_to?(:to_sym) ? fields.has_key?(name.to_sym) : false
+      end
     end
 
     alias field? has_field?
 
-    def inherits?(name)
-      !has_field(name) && has_parent? && parent.provides?(name)
+    def inherits?(*names)
+      names.flatten.any? do |name|
+        !has_field(name) && has_parent? && parent.provides?(name)
+      end
     end
     
-    # Returns true if the Entry has a field (or alias) for the passed-in name.
-    def provides?(name)
-      return nil unless name.respond_to?(:to_sym)
-      has_field?(name) || has_field?(aliases[name.to_sym])
+    # Returns true if the Entry has a field (or alias) for any of the passed-in names.
+    def provides?(*names)
+      names.flatten.any? do |name|
+        if name.respond_to?(:to_sym)
+          has_field?(name) || has_field?(aliases[name.to_sym])
+        else
+          false
+        end
+      end
+    end
+    
+    def provides_or_inherits?(*names)
+      provides?(names) || inherits?(names)
     end
     
     # Returns the field value referenced by the passed-in name.
@@ -327,6 +369,16 @@ module BibTeX
       add(name.to_sym, value)
     end
 
+    # Author, Editor and Translator readers
+    NAME_FIELDS.each do |contributor|
+      define_method(contributor) do
+        get(contributor)
+      end
+      
+      alias_method "#{contributor}s", contributor
+    end
+    
+    
     # Adds a new field (name-value pair) or multiple fields to the entry.
     # Returns the entry for chainability.
     #
@@ -364,6 +416,19 @@ module BibTeX
       Digest::MD5.hexdigest(field_names(filter).map { |k| [k, fields[k]] }.flatten.join)
     end
     
+    def identifier
+      case
+      when provides?(:doi)
+        "info:doi/#{get(:doi)}"
+      when provides?(:isbn)
+        "urn:isbn:#{get(:isbn)}"
+      when provides?(:issn)
+        "urn:issn:#{get(:issn)}"
+      else
+        "urn:bibtex:#{key}"
+      end
+    end
+    
     # Called when the element was added to a bibliography.
     def added_to_bibliography(bibliography)
       super
@@ -431,6 +496,9 @@ module BibTeX
     
     alias parse_months parse_month
     
+    def date
+      get(:date) || get(:year)
+    end
     
     # Parses all name values of the entry. Tries to replace and join the
     # value prior to parsing.
@@ -494,6 +562,43 @@ module BibTeX
 
     alias cross_referenced_by children
     
+    def container_title
+      get(:booktitle) || get(:journal) || get(:container)
+    end
+    
+    def pages_from
+      fetch(:pages, '').split(/\D+/)[0]
+    end
+
+    def pages_to
+      fetch(:pages, '').split(/\D+/)[-1]
+    end
+    
+    # Returns true if this entry is published inside a book, collection or journal
+    def contained?
+      has_field?(:booktitle, :container, :journal)
+    end
+    
+    
+    # Returns a duplicate entry with all values converted using the filter.
+    # If an optional block is given, only those values will be converted where
+    # the block returns true (the block will be called with each key-value pair).
+    #
+    # @see #convert!
+    def convert(filter)
+      block_given? ? dup.convert!(filter, &Proc.new) : dup.convert!(filter)
+    end
+    
+    # In-place variant of @see #convert
+    def convert!(filter)
+      fields.each_pair { |k,v| !block_given? || yield(k,v) ? v.convert!(filter) : v }
+      self
+    end
+    
+    def <=>(other)
+      type != other.type ? type <=> other.type : key != other.key ? key <=> other.key : to_s <=> other.to_s
+    end
+    
     
     # Returns a string of all the entry's fields.
     def content(options = {})
@@ -562,24 +667,106 @@ module BibTeX
       xml
     end
     
-    # Returns a duplicate entry with all values converted using the filter.
-    # If an optional block is given, only those values will be converted where
-    # the block returns true (the block will be called with each key-value pair).
-    #
-    # @see #convert!
-    def convert(filter)
-      block_given? ? dup.convert!(filter, &Proc.new) : dup.convert!(filter)
+    # Returns a RDF::Graph representation of the entry using the BIBO ontology.
+    # TODO: improve level of detail captured by export
+    def to_rdf(options = {})
+      require 'rdf'
+      
+      bibo = RDF::Vocabulary.new('http://purl.org/ontology/bibo/')
+      
+      graph = RDF::Graph.new
+      entry = RDF::URI.new(identifier)
+
+      graph << [entry, RDF.type, bibo[BIBO_TYPES[type]]]
+      
+      [:title, :language].each do |key|        
+        graph << [entry, RDF::DC[key], get(key).to_s] if field?(key)
+      end
+
+      graph << [entry, RDF::DC.date, get(:year).to_s] if field?(:year)
+      
+      if field?(:publisher)
+        address = RDF::Vocabulary.new('http://schemas.talis.com/2005/address/schema#')
+        pub = RDF::Node.new
+
+        graph << [pub, RDF.type, RDF::FOAF[:Organization]]
+        graph << [pub, RDF::FOAF.name, get(:publisher)]
+        
+        graph << [pub, address[:localityName], get(:address)] if field?(:address)
+        
+        graph << [entry, RDF::DC.published, pub]
+      end
+
+      [:doi, :edition, :volume].each do |key|        
+        graph << [entry, bibo[key], get(key).to_s] if field?(key)
+      end
+      
+      if has_field?(:pages)
+        if get(:pages).to_s =~ /^\s*(\d+)\s*-+\s*(\d+)\s*$/
+          graph << [entry, bibo[:pageStart], $1]
+          graph << [entry, bibo[:pageEnd], $2]
+        else
+          graph << [entry, bibo[:pages], get(:pages).to_s]
+        end
+      end
+
+      if has_field?(:author)
+        seq = RDF::Node.new
+
+        graph << [seq, RDF.type, RDF[:Seq]]
+        graph << [entry, bibo[:authorList], seq]
+        
+        authors.each do |author|
+          a = RDF::Node.new
+        
+          graph << [a, RDF.type, RDF::FOAF[:Person]]
+          
+          if author.is_a?(Name)       
+            [:given, :family, :prefix, :suffix].each do |part|
+              graph << [a, bibo["#{part}Name"], author.send(part).to_s]
+            end
+          else
+            graph << [a, RDF::FOAF.name, author.to_s]
+          end
+
+          graph << [entry, RDF::DC.creator, a]
+          graph << [seq, RDF.li, a]
+        end
+      end
+
+      if has_field?(:editor)
+        seq = RDF::Node.new
+
+        graph << [seq, RDF.type, RDF[:Seq]]
+        graph << [entry, bibo[:editorList], seq]
+
+        editors.each do |editor|
+          e = RDF::Node.new
+
+          graph << [e, RDF.type, RDF::FOAF[:Person]]
+
+          if editor.is_a?(Name)
+            [:given, :family, :prefix, :suffix].each do |part|
+              graph << [e, bibo["#{part}Name"], editor.send(part).to_s]
+            end
+          else
+            graph << [e, RDF::FOAF.name, editor.to_s]
+          end
+
+          graph << [entry, bibo.editor, a]
+          graph << [seq, RDF.li, e]
+        end
+      end
+      
+      graph
+    rescue LoadError
+      BibTeX.log.error "Please gem install rdf for RDF support."
     end
     
-    # In-place variant of @see #convert
-    def convert!(filter)
-      fields.each_pair { |k,v| !block_given? || yield(k,v) ? v.convert!(filter) : v }
-      self
-    end
+    alias to_bibo to_rdf
     
-    def <=>(other)
-      type != other.type ? type <=> other.type : key != other.key ? key <=> other.key : to_s <=> other.to_s
-    end
+    
+
 
     private
     
@@ -594,5 +781,6 @@ module BibTeX
       k
     end
     
+    
   end
 end

data/lib/bibtex/names.rb

@@ -20,6 +20,7 @@ require 'forwardable'
 
 module BibTeX
 
+  # A BibTeX Names value is an ordered list of name values.
   class Names < Value
     include Enumerable
     
@@ -27,9 +28,9 @@ module BibTeX
     
     def self.parse(string)
       new(NameParser.new.parse(string))
-		rescue => e
-			BibTeX.log.info(e.message)
-			nil
+    rescue => e
+      BibTeX.log.info(e.message)
+      nil
     end
     
     def initialize(*arguments)
@@ -39,12 +40,16 @@ module BibTeX
       end
     end
 
-    def replace(*arguments); self; end
+    def replace(*arguments)
+      self
+    end
     
-    def join; self; end
+    def join
+      self
+    end
     
-    def value
-      @tokens.join(' and ')
+    def value(options = {})
+      @tokens.map { |n| n.to_s(options) }.join(' and ')
     end
     
     def to_s(options = {})
@@ -53,14 +58,24 @@ module BibTeX
       [q[0], value, q[-1]].compact.join
     end
 
-    def name?; true; end
-    def numeric?; false; end
-    def atomic?; true; end
+    def name?
+      true
+    end
+    
+    def numeric?
+      false
+    end
     
-    alias :names? :name?
-    alias :symbol? :numeric?
+    def atomic?
+      true
+    end
     
-    def to_name; self; end
+    alias names? name?
+    alias symbol? numeric?
+    
+    def to_name
+      self
+    end
     
     def to_citeproc(options = {})
       map { |n| n.to_citeproc(options) }
@@ -82,13 +97,14 @@ module BibTeX
       self
     end
     
-    alias :<< :add
-    alias :push :add
+    alias << add
+    alias push add
     
-    # Converts all string values according to the given filter.
-    def convert! (filter)
-			tokens.each { |t| t.convert!(filter) }      
-      self
+    [:convert!, :rename_if, :rename_unless, :extend_initials].each do |method_id|
+      define_method(method_id) do |*arguments|
+        tokens.each { |t| t.send(method_id, *arguments) }
+        self
+      end
     end
 
     def <=>(other)
@@ -97,20 +113,21 @@ module BibTeX
     
   end
 
+  # A Name comprises individual name parts (first, last, prefix and suffix),
+  # but behaves almost like an atomic string value.
   class Name < Struct.new(:first, :last, :prefix, :suffix)
     extend Forwardable
-
     include Comparable
-		
+    
     BibTeXML = {
-			:first  => :first,
-			:last   => :last,
-			:prefix => :prelast,
-			:suffix => :lineage
-		}.freeze
-		
+      :first  => :first,
+      :last   => :last,
+      :prefix => :prelast,
+      :suffix => :lineage
+    }.freeze
+    
     def_delegators :to_s, :=~, :===,
-			*String.instance_methods(false).reject { |m| m =~ /^\W|to_s|replace|each|first|last|!$/ }
+      *String.instance_methods(false).reject { |m| m =~ /^\W|to_s|replace|each|first|last|!$/ }
     
     class << self    
       def parse(string)
@@ -125,53 +142,114 @@ module BibTeX
     end
     
     def initialize(attributes = {})
-      attributes.each do |key,value|
-        send("#{key}=", value) if respond_to?(key)
-      end
+      set(attributes)
     end
     
     def initalize_copy(other)
-      each_pair { |k,v| self[k] = v }
+      each_pair { |k,v| self[k] = v.dup }
+    end
+    
+    # Set the name tokens to the values defined in the passed-in hash.
+    def set(attributes = {})
+      attributes.each do |key, value|
+        send("#{key}=", value) if respond_to?(key)
+      end
+      
+      self
     end
     
     def blank?
       to_a.compact.empty?
     end
+
+    # Returns the first name (or the passed-in string) as initials.
+    def initials(token = first)
+      token.to_s.gsub(/([[:upper:]])[[:lower:]]+\s*/, '\1.')
+    end
     
-    def display_order
-      [prefix, last, first, suffix].compact.join(' ')
+    # Returns true if the first name consists solely of initials.
+    def initials?
+      !(first.nil? || first.empty? || first.to_s =~ /[[:alpha:]]{2,}[^\.]/)
+    end
+
+    # Sets the name's first name to the passed-in name if the last name equals
+    # for_last and the current first name has the same initials as with_first.
+    def extend_initials(with_first, for_last)
+      rename_if :first => with_first do |name|
+        name.last == for_last && name.initials.gsub(/\s+/, '') == initials(with_first).gsub(/\s+/, '')
+      end
+    end
+    
+    # Renames the tokens according to the passed-in attributes if all of the
+    # conditions match or if the given block returns true.
+    def rename_if(attributes, conditions = {})
+      if block_given?
+        set(attributes) if yield self
+      else
+        set(attributes) if conditions.all? do |key, value|
+          respond_to?(key) && send(key) == value
+        end
+      end
+      
+      self
+    end
+    
+    def rename_unless(attributes, conditions = {})
+      if block_given?
+        set(attributes) unless yield self
+      else
+        set(attributes) unless conditions.all? do |key, value|
+          respond_to?(key) && send(key) == value
+        end
+      end
+      
+      self
+    end
+    
+    # call-seq:
+    #   name.display_order #=> 'Edgar Allen Poe'
+    #   name.display_order :initials => true #=> 'E.A. Poe'
+    #
+    # Returns the name as a string in display order.
+    def display_order(options = {})
+      [options[:initials] ? initials : first, prefix, last, suffix].compact.join(' ')
     end
     
     alias display display_order
     
-    def sort_order
-      [[prefix,last].compact.join(' '), suffix, first].compact.join(', ')
+    # call-seq:
+    #   name.sort_order #=> 'Poe, Edgar Allen'
+    #   name.sort_order :initials => true #=> 'Poe, E.A.'
+    #
+    # Returns the name as a string in sort order.
+    def sort_order(options = {})
+      [[prefix, last].compact.join(' '), suffix, options[:initials] ? initials : first].compact.join(', ')
     end
     
     alias to_s sort_order
-    
+        
     def <=>(other)
-      other.is_a?(Name) ? [last, prefix, first, suffix].compact.join(' ') <=> [other.last, other.prefix, other.first, other.suffix].compact.join(' ') : super
+      other.is_a?(Name) ? sort_order <=> other.sort_order : super
     end
     
     def to_hash
       Hash[each_pair.to_a]
     end
 
-		def to_xml
-			require 'rexml/document'			
-			xml = REXML::Element.new('bibtex:person')
+    def to_xml
+      require 'rexml/document'      
+      xml = REXML::Element.new('bibtex:person')
 
-			each_pair do |part, text|
-				unless text.nil?
-					element = REXML::Element.new("bibtex:#{BibTeXML[part]}")
-					element.text = text
-					xml.add_element(element)
-				end
-			end
-			
-			xml
-		end
+      each_pair do |part, text|
+        unless text.nil?
+          element = REXML::Element.new("bibtex:#{BibTeXML[part]}")
+          element.text = text
+          xml.add_element(element)
+        end
+      end
+      
+      xml
+    end
     
     [:strip!, :upcase!, :downcase!, :sub!, :gsub!, :chop!, :chomp!, :rstrip!].each do |method_id|
       define_method(method_id) do |*arguments, &block|
@@ -182,20 +260,20 @@ module BibTeX
       end
     end
     
-		def convert(filter)
-			dup.convert!(filter)
-		end
-		
-		def convert!(filter)
-			if f = Filters.resolve(filter)
-				each_pair { |k,v| self[k] = f.apply(v) unless v.nil? }
-			else
-				raise ArgumentError, "Failed to load filter #{filter.inspect}"
-			end
+    def convert(filter)
+      dup.convert!(filter)
+    end
+    
+    def convert!(filter)
+      if f = Filters.resolve(filter)
+        each_pair { |k,v| self[k] = f.apply(v) unless v.nil? }
+      else
+        raise ArgumentError, "Failed to load filter #{filter.inspect}"
+      end
 
-			self
-		end
-		
+      self
+    end
+    
     def to_citeproc(options = {})
       hash = {}
       hash['family'] = family unless family.nil?
@@ -213,6 +291,6 @@ module BibTeX
     alias jr= suffix=
     alias von prefix
     alias von= prefix=    
-    
+   
   end
 end

data/lib/bibtex/version.rb

@@ -18,6 +18,6 @@
 
 module BibTeX
   module Version
-    STRING = '2.0.7'.freeze
+    STRING = '2.0.8'.freeze
   end
 end

data/test/bibtex/test_bibliography.rb

@@ -71,6 +71,20 @@ module BibTeX
         END
       end
       
+      describe '#entries_at' do
+        it 'returns a list of all entries identified by the passed-in keys' do
+          assert_equal [@bib['segaran2007'], @bib['rails']], @bib.entries_at('segaran2007', :rails)
+        end
+      end
+      
+      describe '#extend_initials' do
+        it 'extends the initials in matching names' do
+          @bib.names.map(&:to_s).wont_include 'Flanagan, Dave'
+          @bib.extend_initials(['Dave', 'Flanagan'])
+          @bib.names.map(&:to_s).must_include 'Flanagan, Dave'
+        end
+      end
+      
       it 'supports access by index' do
         assert_equal 'ruby', @bib[1].keywords 
       end

data/test/bibtex/test_names.rb

@@ -5,6 +5,10 @@ require 'helper'
 module BibTeX
   class NamesTest < MiniTest::Spec
     
+    before do
+      @poe = Name.new(:first => 'Edgar Allen', :last => 'Poe')
+    end
+    
     describe 'string behaviour' do
       before do
         @name = Name.new(:first => 'Charles Louis Xavier Joseph', :prefix => 'de la', :last => 'Vallee Poussin', :suffix => 'Jr.')
@@ -18,7 +22,85 @@ module BibTeX
       it 'should implement gsub!' do
         assert_equal 'dX la VallXX PoussXn, Jr., CharlXs LouXs XavXXr JosXph', @name.gsub!(/[ei]/, 'X').to_s        
       end
+    end
+    
+    describe '#display_order' do
+      it 'returns the name as "first last"' do
+        @poe.display_order.must_be :==, 'Edgar Allen Poe'
+      end
+      
+      it 'accepts the :initials option' do
+        @poe.display_order(:initials => true).must_be :==, 'E.A. Poe'
+      end
+    end
+
+    describe '#sort_order' do
+      it 'returns the name as "last, first"' do
+        @poe.sort_order.must_be :==, 'Poe, Edgar Allen'
+      end
+      
+      it 'accepts the :initials option' do
+        @poe.sort_order(:initials => true).must_be :==, 'Poe, E.A.'
+      end
+    end
+    
+    describe '#initials?' do
+      it 'returns true if the name contains a solely initials as a first name' do
+        @poe.initials?.must_equal false
+        
+        @poe.first = 'Edgar A.'
+        @poe.initials?.must_equal false
+
+        @poe.first = 'E.A.'
+        @poe.initials?.must_equal true
+
+        @poe.first = ''
+        @poe.initials?.must_equal false
+
+        @poe.first = nil
+        @poe.initials?.must_equal false
+      end
+    end
+    
+    describe '#rename_if' do
+      it 'renames the name to the given attributes if no condition is given' do
+        @poe.rename_if({ :first => 'E.A.' }).first.must_equal 'E.A.'
+      end
+
+      it 'renames the name to the given attributes if all conditions match' do
+        @poe.rename_if({ :first => 'E.A.' }, { :last => @poe.last }).first.must_equal 'E.A.'
+        @poe.rename_if({ :first => 'E.A.' }, { :last => @poe.last, :first => @poe.first }).first.must_equal 'E.A.'
+      end
+
+      it 'renames the name to the given attributes if the block returns true' do
+        @poe.rename_if({ :first => 'E.A.' }) {|n| true}.first.must_equal 'E.A.'
+      end
+
+      it 'does not rename the name to the given attributes if at least one condition does not match' do
+        @poe.rename_if({ :first => 'E.A.' }, { :last => 'foo' }).first.wont_equal 'E.A.'
+        @poe.rename_if({ :first => 'E.A.' }, { :last => 'foo', :first => @poe.first }).first.wont_equal 'E.A.'
+        @poe.rename_if({ :first => 'E.A.' }, { :last => @poe.last, :first => 'foo' }).first.wont_equal 'E.A.'
+      end
+
+      it 'does not rename the name to the given attributes if the block returns false' do
+        @poe.rename_if({ :first => 'E.A.' }) {|n| false}.first.wont_equal 'E.A.'
+      end
+    end
+    
+    describe '#extend_initials' do
+      it 'extends the first name if the last name and initials match' do
+        Name.new(:first => 'E.A.', :last => 'Poe').extend_initials('Edgar Allen', 'Poe').first.must_equal 'Edgar Allen'
+        Name.new(:first => 'Edgar A.', :last => 'Poe').extend_initials('Edgar Allen', 'Poe').first.must_equal 'Edgar Allen'
+        Name.new(:first => 'E. A.', :last => 'Poe').extend_initials('Edgar Allen', 'Poe').first.must_equal 'Edgar Allen'
+        Name.new(:first => 'E. Allen', :last => 'Poe').extend_initials('Edgar Allen', 'Poe').first.must_equal 'Edgar Allen'
+        Name.new(:first => 'E.A.', :last => 'Poe').extend_initials('Edgar A.', 'Poe').first.must_equal 'Edgar A.'
+      end
       
+      it 'does not extend the first name if the last name or initials do not match' do
+        Name.new(:first => 'E.A.', :last => 'Poe').extend_initials('Edgar Allen', 'Poser').first.wont_equal 'Edgar Allen'
+        Name.new(:first => 'E.A.', :last => 'Poe').extend_initials('Edgar Ellen', 'Poe').first.wont_equal 'Edgar Ellen'
+        Name.new(:first => 'E.R.', :last => 'Poe').extend_initials('Edgar Allen', 'Poe').first.wont_equal 'Edgar Allen'
+      end
     end
     
 		describe "conversions" do
@@ -39,8 +121,8 @@ module BibTeX
 					Names.parse("S{\\o}ren Kirkegaard and Emmanuel L\\'evinas").convert(:latex).to_s.must_be :==, 'Kirkegaard, Søren and Lévinas, Emmanuel'
 				end
 			end
-
 		end
     
   end
+  
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bibtex-ruby
 version: !ruby/object:Gem::Version
-  version: 2.0.7
+  version: 2.0.8
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-30 00:00:00.000000000 Z
+date: 2012-05-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: latex-decode
-  requirement: &70149186709340 !ruby/object:Gem::Requirement
+  requirement: &70229986220740 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.0.6
   type: :runtime
   prerelease: false
-  version_requirements: *70149186709340
+  version_requirements: *70229986220740
 - !ruby/object:Gem::Dependency
   name: multi_json
-  requirement: &70149186708580 !ruby/object:Gem::Requirement
+  requirement: &70229986220220 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -32,10 +32,10 @@ dependencies:
         version: '1.3'
   type: :runtime
   prerelease: false
-  version_requirements: *70149186708580
+  version_requirements: *70229986220220
 - !ruby/object:Gem::Dependency
   name: rake
-  requirement: &70149186708040 !ruby/object:Gem::Requirement
+  requirement: &70229986219680 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -43,10 +43,10 @@ dependencies:
         version: '0.9'
   type: :development
   prerelease: false
-  version_requirements: *70149186708040
+  version_requirements: *70229986219680
 - !ruby/object:Gem::Dependency
   name: racc
-  requirement: &70149186707340 !ruby/object:Gem::Requirement
+  requirement: &70229986219200 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -54,10 +54,10 @@ dependencies:
         version: '1.4'
   type: :development
   prerelease: false
-  version_requirements: *70149186707340
+  version_requirements: *70229986219200
 - !ruby/object:Gem::Dependency
   name: rdoc
-  requirement: &70149186706200 !ruby/object:Gem::Requirement
+  requirement: &70229986218720 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
@@ -65,7 +65,7 @@ dependencies:
         version: '3.9'
   type: :development
   prerelease: false
-  version_requirements: *70149186706200
+  version_requirements: *70229986218720
 description: ! "\t\tBibTeX-Ruby is the Rubyist's swiss-army-knife for all things BibTeX.
   It\n    includes a parser for all common BibTeX objects (@string, @preamble,\n    @comment
   and regular entries) and a sophisticated name parser that\n    tokenizes correctly
@@ -180,12 +180,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -4363834808819370688
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: -4363834808819370688
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.10