csl 1.0.0.pre14 → 1.0.0.pre15

data/lib/csl/style/label.rb

@@ -1,6 +1,14 @@
 module CSL
   class Style
 
+    # Labels are used for printing the term matching the variable selected
+    # with the required variable attribute, which must be set to "locator,
+    # "page", or one of the number variables.
+    #
+    # The term is only rendered if the selected variable is non-empty.
+    #
+    # If the {Label} is the child of a {Names} node, the parent's variable
+    # is used instead of the local attribute.
     class Label < Node
 
       attr_struct :variable, :form, :plural,
@@ -10,8 +18,21 @@ module CSL
 
       @variables = [:locator, :page].concat(Schema.variables[:number]).freeze
 
+      @terms = Hash.new { |h,k| h[k] = k }
+
+      @terms['number-of-pages'] = 'page'
+      @terms['number-of-volumes'] = 'volume'
+      @terms['chapter-number'] = 'chapter'
+      @terms['collection-number'] = 'collection'
+
       class << self
+        # @!attribute [r] variables
+        # @return [Array<Symbol>] a list of valid label variable values
         attr_reader :variables
+
+        # @!attribute [r] terms
+        # @return [Hash<String, String>] a cache for variable-term mapping
+        attr_reader :terms
       end
 
       def has_variable?
@@ -51,6 +72,9 @@ module CSL
       end
       alias name_label? names_label?
 
+      def term
+        Label.terms[variable]
+      end
     end
 
   end

data/lib/csl/version.rb

@@ -1,3 +1,3 @@
 module CSL  
-  VERSION = '1.0.0.pre14'.freeze
+  VERSION = '1.0.0.pre15'.freeze
 end

data/spec/csl/style/label_spec.rb

@@ -2,6 +2,56 @@ require 'spec_helper'
 
 module CSL
   describe Style::Label do
-    let(:label) { Style::Label.new }
+
+    it { should_not be_names_label }
+    it { should_not be_always_pluralize }
+    it { should_not be_never_pluralize }
+
+    describe '.terms' do
+      Hash[%w{
+        page              page
+        issue             issue
+        edition           edition
+        number-of-pages   page
+        number-of-volumes volume
+        chapter-number    chapter
+      }].each do |variable, term|
+        it "returns #{term.inspect} for #{variable.inspect}" do
+          Label.terms[variable].should == term
+        end
+      end
+    end
+
+    describe 'a label inside a names node' do
+      before(:each) { Style::Names.new << subject }
+
+      it { should be_names_label }
+
+      describe '#variable' do
+        before(:each) { subject.parent[:variable] = 'editor' }
+
+        it 'returns the names variable(s)' do
+          subject.variable.should == 'editor'
+        end
+
+        it 'returns the names variable(s) even when the local attribute is set' do
+          subject[:variable] = 'page'
+          subject.variable.should == 'editor'
+        end
+      end
+    end
+
+    describe '#term' do
+      it { should be_empty }
+
+      it 'returns the term for the current variable' do
+        subject[:variable] = 'page'
+        subject.term.should == 'page'
+
+        subject[:variable] = 'number-of-volumes'
+        subject.term.should == 'volume'
+      end
+    end
+
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: csl
 version: !ruby/object:Gem::Version
-  version: 1.0.0.pre14
+  version: 1.0.0.pre15
   prerelease: 6
 platform: ruby
 authors:
@@ -182,7 +182,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -4493018161482760031
+      hash: 3229480668265481885
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: