citeproc 0.0.1 → 0.0.2

data/Gemfile

@@ -1,2 +1,11 @@
 source :rubygems
 gemspec
+
+group :debug do
+	gem 'ruby-debug', :platforms => [:ruby_18, :jruby]
+	gem 'ruby-debug19', :require => 'ruby-debug', :platforms => [:ruby_19]
+end
+
+group :optional do
+	gem 'chronic', '~>0.6'
+end

data/auto.watchr

@@ -11,7 +11,7 @@ Signal.trap('INT' ) { abort("\n") } # Ctrl-C
 
 def rspec (*paths)
 	paths = paths.reject { |p| !File.exists?(p) }
-	run "bundle exec rspec #{ paths.empty? ? 'spec' : paths.join(' ') }"
+	run "bundle exec rspec --tty -c #{ paths.empty? ? 'spec' : paths.join(' ') }"
 end
 
 def run (cmd)

data/lib/citeproc.rb

@@ -1,9 +1,20 @@
-require 'rubygems'
+
+require 'multi_json'
+require 'forwardable'
+
 
 require 'citeproc/version'
+
+require 'citeproc/compatibility'
 require 'citeproc/extensions'
+
 require 'citeproc/errors'
+
 require 'citeproc/abbreviate'
+require 'citeproc/attributes'
+require 'citeproc/variable'
+require 'citeproc/date'
+
 require 'citeproc/engine'
 require 'citeproc/processor'
 require 'citeproc/utilities'

data/lib/citeproc/attributes.rb

@@ -0,0 +1,95 @@
+
+module CiteProc
+  
+  module Attributes
+    extend Forwardable
+    
+    def self.included(base)
+      base.extend(ClassMethods)
+    end
+    
+    def attributes
+      @attributes ||= {}
+    end
+    
+    def merge(other)
+      return self if other.nil?
+      
+      case other
+      when String, /^\s*\{/
+        other = MulitJson.encode(other, :symbolize_keys => true)
+      when Hash
+        other = other.deep_copy
+      else
+        other = other.to_hash
+      end
+
+      other.each_pair { |k,v| attributes[k.to_sym] = v }
+      
+      self
+    end
+
+    alias update merge
+    
+    def reverse_merge(other)
+      other.merge(self)
+    end
+
+    alias to_hash attributes
+
+    module ClassMethods
+
+      def create(parameters)
+        new.merge(parameters)
+      end
+      
+      def attr_predicates(*arguments)
+        arguments.flatten.each do |field|
+          field, default = *(field.is_a?(Hash) ? field.to_a.flatten : [field]).map(&:to_s)
+          attr_field(field, default, true)
+        end
+      end
+
+      def attr_fields
+        arguments.flatten.each do |field|
+          attr_field(*(field.is_a?(Hash) ? field.to_a.flatten : [field]).map(&:to_s))
+        end
+      end
+      
+      def attr_field(field, default = nil, predicate = false)
+        method_id = field.downcase.gsub(/[-\s]+/, '_')
+
+        unless instance_methods.include?(method_id)
+          if default
+            define_method(method_id) do
+              attributes[field.to_sym]
+            end
+          else
+            define_method(method_id) do
+              attributes[field.to_sym] ||= default
+            end
+          end
+        end
+
+        writer_id = [method_id,'='].join
+        unless instance_methods.include?(writer_id)
+          define_method(writer_id) do |value|
+            attributes[field.to_sym] = value
+          end
+        end
+        
+        predicate_id = [method_id, '?'].join  
+        if predicate && !instance_methods.include?(predicate_id)
+          define_method(predicate_id) do
+            ![nil, false, '', [], 'false', 'no', 'never'].include?(attributes[field.to_sym])
+          end
+          
+          has_predicate = ['has_', predicate_id].join
+          alias_method(has_predicate, predicate_id) unless instance_methods.include?(has_predicate)
+        end
+      end
+    
+    end
+  
+  end
+end

data/lib/citeproc/compatibility.rb

@@ -0,0 +1,10 @@
+unless Symbol.is_a?(Comparable)
+  class Symbol
+    include Comparable
+    
+    def <=>(other)
+      return nil unless other.respond_to?(:to_s)
+      to_s <=> other.to_s
+    end
+  end
+end

data/lib/citeproc/date.rb

@@ -0,0 +1,166 @@
+
+require 'date'
+
+begin
+  require 'chronic'
+rescue LoadError => e
+  # warn 'failed to load chronic gem'
+end
+
+module CiteProc
+
+  class Date < Variable
+
+    include Attributes
+
+    alias attributes value
+    alias to_hash value
+    
+    @parser = Object.const_defined?(:Chronic) ? ::Chronic : ::Date
+    
+    class << self
+
+      def parse(date_string)
+        new(@parser.parse(date_string))
+      rescue => e
+        raise ArgumentError.new("failed to parse date from #{date_string.inspect}", e)
+      end
+      
+      def today
+        new(::Date.today)
+      end
+      
+      alias now today
+      
+    end
+    
+
+    def initialize(attributes = ::Date.today)
+      super
+    end
+    
+    def initialize_copy(other)
+      @value = other.value.deep_copy
+    end
+    
+    def parse(attributes)
+      case
+      when attributes.is_a?(Date)
+        @value = attributes.dup
+
+      when attributes.is_a?(Numeric)
+        @value = { :'date-parts' => [[attributes.to_i]] }
+        
+      when attributes.is_a?(Hash)
+        attributes = attributes.symbolize_keys
+        if attributes.has_key?(:raw)
+          @value = Date.parse(attributes.delete(:raw)).value
+          @value.merge!(attributes)
+        else
+          @value = attributes.deep_copy
+        end
+        to_i!
+        
+      when attributes.respond_to?(:strftime)
+        @value = { :'date-parts' => [attributes.strftime('%Y-%m-%d').split(/-/).map(&:to_i)] }
+        
+      when attributes.is_a?(Array)
+        @value = { :'date-parts' => attributes[0].is_a?(Array) ? attributes : [attributes] }
+        to_i!
+        
+      when attributes.respond_to?(:to_s)
+        @value = Date.parse(attributes.to_s).value
+        
+      else
+        raise ArgumentError, "failed to parse date from #{attributes.inspect}"
+      end
+    end
+
+    attr_predicates :circa, :season, :literal, :'date-parts'
+
+    def date_parts
+      @value[:'date-parts'] ||= [[]]
+    end
+    
+    alias parts date_parts
+    alias parts= date_parts=
+
+    %w{ year month day }.each_with_index do |m,i|
+      define_method(m) { parts[0][i] }
+      define_method("#{m}=") { |v| parts[0][i] = v.to_i }
+    end
+
+    def start_date
+      ::Date.new(*parts[0])
+    end
+    
+    def start_date=(date)
+      parts[0] = date.strftime('%Y-%m-%d').split(/-/).map(&:to_i)
+    end
+
+    def end_date=(date)
+      parts[1] = date.nil? ? [0,0,0] : date.strftime('%Y-%m-%d').split(/-/).map(&:to_i)
+    end
+    
+    # Returns a Ruby date object for this instance, or Range object if this
+    # instance is closed range
+    def to_ruby
+      closed_range? ? start_date ... end_date : start_date
+    end
+    
+    def end_date
+      closed_range? ? ::Date.new(*parts[1]) : nil
+    end
+    
+    def has_end_date?
+      parts[1] && !parts[1].empty?
+    end
+    
+    # Returns true if this date is a range
+    alias range? has_end_date?
+    
+    def open_range?
+      range? && parts[1].uniq == [0]
+    end
+
+    def closed_range?
+      range? && !open_range?
+    end
+
+    alias uncertain? circa?
+        
+    # Marks the date as uncertain
+    def uncertain!; @value[:'circa'] = true; end
+    
+    # Marks the date as a certain date
+    def certain!; @value[:'circa'] = false; end    
+
+    def certain?; !uncertain?; end
+        
+    def numeric?; false; end
+    
+    def bc?; year && year < 0; end
+    def ad?; !bc? && year < 1000; end
+    
+    def to_s
+      literal? ? literal : @value.inspect
+    end
+    
+    def sort_order
+      "%04d%02d%02d-%04d%02d%02d" % ((parts[0] + [0,0,0])[0,3] + ((parts[1] || []) + [0,0,0])[0,3])
+    end
+        
+    def <=>(other)
+      return nil unless other.is_a?(Date)
+      [year, sort_order] <=> [other.year, other.sort_order]
+    end
+    
+    private
+    
+    def to_i!
+      parts.each { |p| p.map!(&:to_i) }
+    end
+    
+  end
+  
+end

data/lib/citeproc/engine.rb

@@ -10,9 +10,11 @@ module CiteProc
     @subclasses ||= []
 
     class << self
-      
+            
       attr_reader :subclasses, :type, :version
    
+      attr_writer :default
+   
       private :new
       
       def inherited(subclass)
@@ -21,6 +23,10 @@ module CiteProc
         @subclasses = subclasses.sort_by { |engine| -1 * engine.priority }
       end
 
+      def default
+        @default ||= autodetect or warn 'no citeproc engine found'
+      end
+      
       # Returns the engine class for the given name or nil. If no suitable
       # class is found and a block is given, executes the block and returns
       # the result. The list of available engines will be passed to the block.
@@ -99,20 +105,26 @@ module CiteProc
       raise NotImplementedByEngine
     end
     
+    alias process_citation_cluster process
+
     def append
       raise NotImplementedByEngine
     end
     
     alias append_citation_cluster append
-    
-    def process_citation_cluster
+
+    def preview
       raise NotImplementedByEngine
     end
-        
-    def make_bibliography
+    
+    alias preview_citation_cluster preview
+    
+    def bibliography
       raise NotImplementedByEngine
     end
     
+    alias make_bibliography bibliography
+    
     def update_items
       raise NotImplementedByEngine
     end

data/lib/citeproc/errors.rb

@@ -8,10 +8,10 @@ module CiteProc
     end    
   end
   
-  class EngineError < Error
-  end
+  class EngineError < Error; end
   
-  class NotImplementedByEngine < EngineError
-  end
+  class NotImplementedByEngine < EngineError; end
+  
+  class ArgumentError < Error; end
   
 end

data/lib/citeproc/extensions.rb

@@ -7,7 +7,7 @@ module CiteProc
         Hash[*map { |k,v| [
           k.is_a?(Symbol) ? k : k.respond_to?(:deep_copy) ? k.deep_copy : k.clone,
           v.is_a?(Symbol) ? v : v.respond_to?(:deep_copy) ? v.deep_copy : v.clone
-        ]}.flatten]
+        ]}.flatten(1)]
       end
     end
    
@@ -23,6 +23,20 @@ module CiteProc
       
     end
     
+    # shamelessly copied from active_support
+    module SymbolizeKeys
+      def symbolize_keys
+        inject({}) do |options, (key, value)|
+          options[(key.to_sym rescue key) || key] = value
+          options
+        end
+      end
+      
+      def symbolize_keys!
+        replace(symbolize_keys)
+      end
+    end
+    
     module AliasMethods
       private
       def alias_methods(*arguments)
@@ -37,6 +51,7 @@ end
 class Hash
   include CiteProc::Extensions::DeepCopy
   include CiteProc::Extensions::DeepFetch
+  include CiteProc::Extensions::SymbolizeKeys unless Hash.instance_methods.include?(:symbolize_keys)
 end
 
 # module Kernel

data/lib/citeproc/processor.rb

@@ -2,6 +2,8 @@
 module CiteProc
   class Processor
 
+    extend Forwardable
+    
     @defaults ||= {
       :locale => 'en-US',
       :style  => 'chicago-author-date',
@@ -14,11 +16,14 @@ module CiteProc
     end
 
     attr_reader :options, :engine, :items
+    
+    def_delegators :@engine, :process, :append, :preview, :bibliography, :style, :style=, :abbreviate, :abbreviations, :abbreviations=
      
     def initialize(options = {})
       @options = Processor.defaults.merge(options)
-      @engine = Engine.autodetect(@options).new :processor => self
+      @engine = Engine.autodetect(@options).new(:processor => self)
+      @items = {}
     end
     
   end
-end
+end

data/lib/citeproc/variable.rb

@@ -0,0 +1,121 @@
+
+module CiteProc
+  
+  #
+  # A CiteProc Variable represents the content of a text, numeric, date, or
+  # name variable.
+  #
+  class Variable
+
+    extend Forwardable
+    
+    include Comparable
+    
+    @fields = Hash.new { |h,k| h.fetch(k.to_sym, nil) }.merge({
+      :date => %w{ accessed container event-date issued original-date },
+      
+      :names => %w{
+        author editor translator recipient interviewer publisher composer
+        original-publisher original-author container-author collection-editor },
+      
+      :text => %w{
+        id abstract annote archive archive-location archive-place authority
+        call-number chapter-number citation-label citation-number collection-title
+        container-title DOI edition event event-place first-reference-note-number
+        genre ISBN issue jurisdiction keyword locator medium note number
+        number-of-pages number-of-volumes original-publisher original-publisher-place
+        original-title page page-first publisher publisher-place references
+        section status title URL version volume year-suffix }
+    })
+    
+    @fields.each_value { |v| v.map!(&:to_sym) }
+    
+    @types = Hash.new { |h,k| h.fetch(k.to_sym, nil) }.merge(
+      Hash[*@fields.keys.map { |k| @fields[k].map { |n| [n,k] } }.flatten]
+    ).freeze
+    
+    @fields[:name] = @fields[:names]
+    @fields[:dates] = @fields[:date]
+    
+    @fields[:all] = @fields[:any] =
+      [:date,:names,:text].reduce([]) { |s,a| s.concat(@fields[a]) }.sort
+
+    @fields.freeze
+
+    class << self
+      attr_reader :fields, :types
+      
+      def parse(*args)
+      end
+    end
+    
+    def initialize(attributes = nil)
+      parse(attributes)
+      yield self if block_given?
+    end
+    
+    def initialize_copy(other)
+      @value = other.value.dup
+    end
+    
+    attr_accessor :value
+
+    def_delegators :@value, :to_s, :strip!, :upcase!, :downcase!, :sub!, :gsub!, :chop!, :chomp!, :rstrip!
+    
+    def_delegators :to_s, :empty?, :=~, :===, :match, :intern, :to_sym, :end_with?, :start_with?, :include?, :upcase, :downcase, :reverse, :chop, :chomp, :rstrip, :gsub, :sub, :size, :strip, :succ, :to_c, :to_r, :to_str, :split, :each_byte, :each_char, :each_line
+
+    def parse(attributes)
+      case
+      when attributes.is_a?(Hash)
+        attributes.each_key do |key|
+          writer = "#{key}="
+          send(writer, attributes[key]) if respond_to?(writer)
+        end
+      when attributes.respond_to?(:to_s)
+        @value = attributes.to_s.dup
+      end
+    end
+    
+    def type
+      @type ||= self.class.name.split(/::/)[-1].downcase.to_sym
+    end
+    
+    def numeric?
+      self =~ /\d/ ? to_i : false
+    end
+    
+    # @returns (first) numeric data contained in the variable's value
+    def to_i
+      to_s =~ /(-?\d+)/ && $1.to_i || 0
+    end
+    
+    def to_f
+      to_s =~ /(-?\d[\d,\.]*)/ && $1.tr(',','.').to_f || 0.0
+    end
+    
+    def strip_markup
+      gsub(/<[^>]*>/, '')
+    end
+    
+    def strip_markup!
+      gsub!(/<[^>]*>/, '')
+    end 
+    
+    def <=>(other)
+      case
+      when other.respond_to?(:strip_markup)
+        strip_markup <=> other.strip_markup
+      when other && other.respond_to?(:to_s)
+        to_s <=> other.to_s
+      else
+        nil
+      end
+    end
+    
+    def to_json
+      MultiJson.encode(@value)
+    end
+  end
+  
+  class Text < Variable; end
+end

data/lib/citeproc/version.rb

@@ -1,3 +1,3 @@
 module CiteProc
-  VERSION = '0.0.1'.freeze
+  VERSION = '0.0.2'.freeze
 end

data/spec/citeproc/abbreviate_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 module CiteProc
-  describe 'Abbreviate' do
+  describe Abbreviate do
     before { Object.class_eval { include Abbreviate } }
 
     let(:subject) { Object.new }

data/spec/citeproc/attributes_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+module CiteProc
+  describe Attributes do
+  
+    before(:each) { Object.instance_eval { include Attributes } }
+  
+    let(:instance) { o = Object.new }
+    let(:other) { o = Object.new; o.attributes[:foo] = 'bar'; o }
+  
+    it { should_not be_nil }
+  
+    describe '.attr_fields' do
+    
+      # before(:all) { class Object; attr_fields :value, %w[ is-numeric punctuation-mode ]; end }
+
+      it 'generates setters for attr_field values' do
+        # pending
+        # lambda { Object.new.is_numeric }.should_not raise_error
+      end
+    
+      it 'generates no other setters' do
+        lambda { Object.new.some_other_value }.should raise_error
+      end
+    end
+  
+    describe '#merge' do    
+    
+      it 'merges non-existent values from other object' do
+        Object.new.merge(other).attributes[:foo].should == 'bar'
+      end
+    
+      # it 'does not overwrite existing values when merging other object' do
+      #   instance.merge(other)['foo'].should == 'bar'
+      # end
+    
+    end
+  
+  end
+end

data/spec/citeproc/date_spec.rb

@@ -0,0 +1,103 @@
+require 'spec_helper'
+
+module CiteProc
+  describe Date do
+    
+    it { should_not be nil }
+    
+    it { should_not be_numeric }
+    
+    describe '.new' do
+      
+    end
+    
+    describe '.create' do
+      it 'should accept parameters and return a new instance' do
+        Date.create('date-parts' => [[2001, 1]]).year.should == 2001
+      end
+    end
+    
+    describe 'literal dates' do      
+      it 'is not literal by default' do
+        Date.new.should_not be_literal
+      end
+      
+      it 'is literal if it contains only a literal field' do
+        Date.create(:literal => 'foo').should be_literal
+      end
+      
+      it 'is literal if it contains a literal field' do
+        Date.create('date-parts' => [[2000]], :literal => 'foo').should be_literal
+      end
+    end
+    
+    describe 'uncertain dates' do
+      it 'are uncertain' do
+        Date.new({ 'date-parts' => [[-225]], 'circa' => '1' }).should be_uncertain
+        Date.new { |d| d.parts = [[-225]]; d.uncertain! }.should be_uncertain
+      end
+    end
+    
+    describe 'sorting' do
+      
+      let(:ad2k) { Date.create('date-parts' => [[2000]])}
+      let(:may) { Date.create('date-parts' => [[2000, 5]])}
+      let(:first_of_may) { Date.create('date-parts' => [[2000, 5, 1]])}
+      
+      let(:bc100) { Date.create('date-parts' => [[-100]]) }
+      let(:bc50) { Date.create('date-parts' => [[-50]]) }
+      let(:ad50) { Date.create('date-parts' => [[50]]) }
+      let(:ad100) { Date.create('date-parts' => [[100]]) }
+
+      it 'dates with more date-parts will come after those with fewer parts' do
+        (ad2k < may  && may < first_of_may).should be true
+      end
+      
+      it 'negative years are sorted inversely' do
+        [ad50, bc100, bc50, ad100].sort.map(&:year).should == [-100, -50, 50, 100]
+      end
+    end
+
+
+    describe '#display' do
+      it 'returns an empty string by default' do
+        Date.new({}).to_s == ''
+      end
+    end
+
+    describe '#to_json' do    
+      it 'supports simple parts' do
+        Date.new(%w{2000 1 15}).to_json.should == '{"date-parts":[[2000,1,15]]}'
+      end
+
+      it 'supports integers and strings parts' do
+        Date.new(['2000', '1', '15']).to_json.should == '{"date-parts":[[2000,1,15]]}'
+        Date.new([2000, 1, 15]).to_json.should == '{"date-parts":[[2000,1,15]]}'
+        Date.new(['2000', 1, '15']).to_json.should == '{"date-parts":[[2000,1,15]]}'
+      end
+
+      it 'supports negative years' do
+        Date.new(-200).to_json.should == '{"date-parts":[[-200]]}'
+      end
+
+      it 'supports seasons' do
+        Date.create({:season => '1', 'date-parts' => [[1950]]}).to_json.should == '{"date-parts":[[1950]],"season":"1"}'
+        Date.create({:season => 'Trinity', 'date-parts' => [[1975]]}).to_json.should == '{"date-parts":[[1975]],"season":"Trinity"}'
+      end
+
+      it 'supports string literals' do
+        Date.new(:literal => '13th century').to_json.should == '{"literal":"13th century"}'
+      end
+
+      it 'supports raw strings' do
+        Date.new(:raw => '23 May 1955').to_json.should == '{"date-parts":[[1955,5,23]]}'
+      end
+
+      it 'supports open and closed ranges' do
+        Date.new([[2000,11],[2000,12]]).to_json.should == '{"date-parts":[[2000,11],[2000,12]]}'
+        Date.new([[2000,11],[0,0]]).to_json.should == '{"date-parts":[[2000,11],[0,0]]}'
+      end
+    end
+
+  end
+end

data/spec/citeproc/engine_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 module CiteProc
-  describe 'Engine' do
+  describe Engine do
 
     it 'cannot be instantiated' do
       lambda { Engine.new }.should raise_error(NoMethodError)

data/spec/citeproc/extensions_spec.rb

@@ -22,6 +22,15 @@ describe Hash do
       hash.deep_copy[:a][:b].should_not equal(hash[:a][:b])
       hash.deep_copy[:a][:b][:c].should == hash[:a][:b][:c]
     end
+
+    context 'when given nested arrays' do
+      let(:hash) {{:a => [[1,2]]}}
+      it 'it returns a deep copy' do
+        hash.deep_copy[:a].should == hash[:a]
+        hash.deep_copy[:a].should_not equal(hash[:a])
+      end
+      
+    end
   end
   
   describe '#deep_fetch' do

data/spec/citeproc/processor_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 module CiteProc
-  describe 'Processor' do
+  describe Processor do
     before { Class.new(Engine) }
     
     let(:subject) { Processor.new }

data/spec/citeproc/variable_spec.rb

@@ -0,0 +1,168 @@
+require 'spec_helper'
+
+module CiteProc
+  describe Variable do
+    
+    describe '.new' do
+      it { should be_an_instance_of(Variable) }
+      
+      it 'is empty by default' do
+        Variable.new.should be_empty
+      end
+      
+      it 'equals an empty string (==) by default' do
+        Variable.new.should == ''
+      end
+      
+      it 'matches an empty pattern by default' do
+        Variable.new.should =~ /^$/
+      end
+      
+      it 'accepts a string value' do
+        Variable.new('test').should == 'test'
+      end
+
+      it 'accepts a numeric value' do
+        Variable.new(23).should == '23'
+        Variable.new(23.1).should == '23.1'
+      end
+      
+      it 'accepts an attributes hash' do
+        Variable.new(:value => 'test').should == 'test'
+      end
+      
+      it 'supports self yielding block' do
+        Variable.new { |v| v.value = 'test' }.should == 'test'
+      end
+    end
+
+    describe '.fields' do
+      it 'contains :names fields' do
+        Variable.fields[:names].should_not be_empty
+        Variable.fields[:name].should equal Variable.fields[:names]
+      end
+
+      it 'contains :date fields' do
+        Variable.fields[:date].should_not be_empty
+        Variable.fields[:dates].should equal Variable.fields[:date]
+      end
+
+      it 'contains :text fields' do
+        Variable.fields[:text].should_not be_empty
+      end
+      
+      it 'accepts either string or symbol input' do
+        Variable.fields[:names].should equal Variable.fields['names']
+      end  
+    end
+    
+    describe '.types' do
+      it 'given a field name returns the corresponding type' do
+        Variable.types[:author].should == :names
+        Variable.types[:issued].should == :date
+        Variable.types[:abstract].should == :text
+      end
+      
+      it 'accepts either string or symbol input' do
+        Variable.types.should have_key(:author)
+        Variable.types['author'].should equal Variable.types[:author]
+      end
+    end
+    
+    describe '#to_s' do
+      it 'displays the value' do
+        Variable.new('test').to_s.should == 'test'
+      end
+    end
+    
+    describe '#to_i' do
+      it 'returns zero by default' do
+        Variable.new.to_i.should == 0
+      end
+      
+      context 'when the value is numeric' do
+        %w{ -23 -1 0 1 23 }.each do |value|
+          it "returns the integer value (#{value})" do
+            Variable.new(value).to_i.should equal(value.to_i)
+          end
+        end
+        
+        it 'returns only the first numeric value if there are several' do
+          Variable.new('testing 1, 2, 3...').to_i.should == 1
+        end
+      end
+    end
+
+    describe '#to_f' do
+      it 'returns zero by default' do
+        Variable.new.to_f.should == 0.0
+      end
+      
+      context 'when the value is numeric' do
+        %w{ -23.2 -1.45 0.2 1.733 23 }.each do |value|
+          it "returns the integer value (#{value})" do
+            Variable.new(value).to_f.should == value.to_f
+          end
+        end
+        
+        it 'returns only the first numeric value if there are several' do
+          Variable.new('testing 1, 2, 3...').to_f.should == 1.0
+        end
+        
+        it 'works with dot and comma separators' do
+          Variable.new('1,23').to_f.should == Variable.new('1.23').to_f
+        end
+      end
+    end
+    
+    describe '#numeric?' do
+      it 'returns false by default' do
+        Variable.new.should_not be_numeric
+      end
+
+      context 'variable contains a number' do
+        it 'returns true (string initialized)' do
+          Variable.new('23').should be_numeric
+          Variable.new('foo 23').should be_numeric
+        end
+        it 'returns true (integer initialized)' do
+          Variable.new(23).should be_numeric
+        end
+      end 
+      context 'variable does not contain a number' do
+        it 'returns false for strings' do
+          Variable.new('test').should_not be_numeric
+        end
+      end
+    end
+    
+    describe '#strip_markup' do
+      let(:greeting) { '<h1>hello<b> world</b></h1>' }
+      it 'returns a string stripped of html tags' do
+        Variable.new(greeting).strip_markup.should == 'hello world'
+      end
+      it 'does not alter the value itself' do
+        v = Variable.new(greeting)
+        v.strip_markup
+        v.should == greeting
+      end
+    end
+
+    describe '#strip_markup!' do
+      let(:greeting) { '<h1>hello<b> world</b></h1>' }
+      it 'strips of html tags' do
+        v = Variable.new(greeting)
+        v.strip_markup!
+        v.should == 'hello world'
+      end
+    end
+    
+    
+    describe 'sorting' do
+    end
+    
+    describe '#to_json' do
+    end
+    
+  end
+end

metadata

@@ -1,126 +1,140 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: citeproc
-version: !ruby/object:Gem::Version
-  version: 0.0.1
+version: !ruby/object:Gem::Version 
   prerelease: 
+  version: 0.0.2
 platform: ruby
-authors:
-- Sylvester Keil
+authors: 
+  - Sylvester Keil
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-08-03 00:00:00.000000000 +02:00
+
+date: 2011-08-08 00:00:00 +02:00
 default_executable: 
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: multi_json
-  requirement: &2157053340 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: *2157053340
-- !ruby/object:Gem::Dependency
-  name: cucumber
-  requirement: &2157052700 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 1.0.2
-  type: :development
-  prerelease: false
-  version_requirements: *2157052700
-- !ruby/object:Gem::Dependency
-  name: rspec
-  requirement: &2157052100 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: 2.6.0
-  type: :development
-  prerelease: false
-  version_requirements: *2157052100
-- !ruby/object:Gem::Dependency
-  name: watchr
-  requirement: &2157051560 !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0.7'
-  type: :development
-  prerelease: false
-  version_requirements: *2157051560
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: multi_json
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ~>
+          - !ruby/object:Gem::Version 
+            version: "1.0"
+    type: :runtime
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: cucumber
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 1.0.2
+    type: :development
+    version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: rspec
+    prerelease: false
+    requirement: &id003 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 2.6.0
+    type: :development
+    version_requirements: *id003
+  - !ruby/object:Gem::Dependency 
+    name: watchr
+    prerelease: false
+    requirement: &id004 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0.7"
+    type: :development
+    version_requirements: *id004
 description: A a cite processor for Citation Style Language (CSL) styles.
 email: http://sylvester.keil.or.at
 executables: []
+
 extensions: []
-extra_rdoc_files:
-- README.md
-files:
-- .gitignore
-- .rspec
-- Gemfile
-- LICENSE
-- README.md
-- auto.watchr
-- citeproc.gemspec
-- lib/citeproc.rb
-- lib/citeproc/abbreviate.rb
-- lib/citeproc/engine.rb
-- lib/citeproc/errors.rb
-- lib/citeproc/extensions.rb
-- lib/citeproc/processor.rb
-- lib/citeproc/utilities.rb
-- lib/citeproc/version.rb
-- spec/citeproc/abbreviate_spec.rb
-- spec/citeproc/engine_spec.rb
-- spec/citeproc/extensions_spec.rb
-- spec/citeproc/processor_spec.rb
-- spec/citeproc/utilities_spec.rb
-- spec/spec_helper.rb
+
+extra_rdoc_files: 
+  - README.md
+files: 
+  - .gitignore
+  - .rspec
+  - Gemfile
+  - LICENSE
+  - README.md
+  - auto.watchr
+  - citeproc.gemspec
+  - lib/citeproc.rb
+  - lib/citeproc/abbreviate.rb
+  - lib/citeproc/attributes.rb
+  - lib/citeproc/compatibility.rb
+  - lib/citeproc/date.rb
+  - lib/citeproc/engine.rb
+  - lib/citeproc/errors.rb
+  - lib/citeproc/extensions.rb
+  - lib/citeproc/processor.rb
+  - lib/citeproc/utilities.rb
+  - lib/citeproc/variable.rb
+  - lib/citeproc/version.rb
+  - spec/citeproc/abbreviate_spec.rb
+  - spec/citeproc/attributes_spec.rb
+  - spec/citeproc/date_spec.rb
+  - spec/citeproc/engine_spec.rb
+  - spec/citeproc/extensions_spec.rb
+  - spec/citeproc/processor_spec.rb
+  - spec/citeproc/utilities_spec.rb
+  - spec/citeproc/variable_spec.rb
+  - spec/spec_helper.rb
 has_rdoc: true
 homepage: http://inukshuk.github.com/citeproc
-licenses:
-- FreeBSD
+licenses: 
+  - FreeBSD
 post_install_message: 
-rdoc_options:
-- --line-numbers
-- --inline-source
-- --title
-- ! '"CiteProc"'
-- --main
-- README.md
-- --webcvs=http://github.com/inukshuk/citeproc/tree/master/
-require_paths:
-- lib
-required_ruby_version: !ruby/object:Gem::Requirement
+rdoc_options: 
+  - --line-numbers
+  - --inline-source
+  - --title
+  - "\"CiteProc\""
+  - --main
+  - README.md
+  - --webcvs=http://github.com/inukshuk/citeproc/tree/master/
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.5.1
 signing_key: 
 specification_version: 3
 summary: A cite processor interface.
-test_files:
-- spec/citeproc/abbreviate_spec.rb
-- spec/citeproc/engine_spec.rb
-- spec/citeproc/extensions_spec.rb
-- spec/citeproc/processor_spec.rb
-- spec/citeproc/utilities_spec.rb
-- spec/spec_helper.rb
+test_files: 
+  - spec/citeproc/abbreviate_spec.rb
+  - spec/citeproc/attributes_spec.rb
+  - spec/citeproc/date_spec.rb
+  - spec/citeproc/engine_spec.rb
+  - spec/citeproc/extensions_spec.rb
+  - spec/citeproc/processor_spec.rb
+  - spec/citeproc/utilities_spec.rb
+  - spec/citeproc/variable_spec.rb
+  - spec/spec_helper.rb