verso 0.0.3 → 0.0.4

data/README.md

@@ -65,6 +65,11 @@ Search for Occupations, get back lists of "occupation data," i.e., a list of lis
     creds.first.title # => "Computer Programming (NOCTI)"
     creds.first.related_courses.last # => "Programming, Advanced"
 
+## Additional Documentation
+
+* [http://api.cteresource.org/docs](http://api.cteresource.org/docs)
+* [http://rubydoc.info/gems/verso/](http://rubydoc.info/gems/verso/)
+
 In general, the objects returned from the wrapper should respond to calls to
 the attributes described in the API documentation. Open an issue on GitHub or
 send an email to lcapps@cteresource.org if you have questions or concerns.

data/lib/verso/course_list.rb

@@ -29,9 +29,10 @@ module Verso
   #   courses = Verso::CourseList.new(:text => "internet", :cluster => "Marketing") # => <Verso::CourseList:0x007fa5a19b6c90 @attrs={ . . . }>
   #   courses.count # => 1
   #
-  # @example An empty search returns an empty list
+  # @example Calling #new with no attrs
   #   courses = Verso::CourseList.new
-  #   courses.count # => 0
+  #   courses.count # => A big number
+  #   courses # => All the courses
   #
   # @overload initialize(attrs={})
   #   @option attrs [String] :code Course code
@@ -48,7 +49,7 @@ module Verso
     private
 
     def courses
-      @courses ||= if q_uri.query_values.values.any?
+      @courses ||= if attrs.empty? || q_uri.query_values.values.any?
                        get_attr(:courses).collect { |c| Course.new(c) }
                    else
                      []
@@ -66,7 +67,7 @@ module Verso
     end
 
     def path
-      q_uri.request_uri
+      attrs.empty? ? '/courses/' : q_uri.request_uri
     end
   end
 end

data/lib/verso/version.rb

@@ -1,3 +1,3 @@
 module Verso
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/spec/cluster_list_spec.rb

@@ -1,85 +1,13 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::ClusterList do
   use_vcr_cassette :record => :new_episodes
 
   before(:each) do
     @list = Verso::ClusterList.new
+    @kontained = Verso::Cluster
   end
 
-  describe '#[]' do
-    it 'responds' do
-      @list.should respond_to(:[])
-    end
-
-    it 'is a Verso::Cluster object' do
-      @list[3].should be_a(Verso::Cluster)
-    end
-  end
-
-  describe '#each' do
-    it 'responds' do
-      @list.should respond_to(:each)
-    end
-
-    it 'yields' do
-      expect { |b| @list.each("foo", &b).to yield_control }
-    end
-
-    it 'yields Verso::Cluster objects' do
-      @list.each do |c|
-        c.should be_a(Verso::Cluster)
-      end
-    end
-  end
-
-  describe '#empty?' do
-    it 'responds' do
-      @list.should respond_to(:empty?)
-    end
-
-    it 'is not empty' do
-      @list.should_not be_empty
-    end
-  end
-
-  describe '#last' do
-    it 'responds' do
-      @list.should respond_to(:last)
-    end
-
-    it 'is a Verso::Cluster object' do
-      @list.last.should be_a(Verso::Cluster)
-    end
-  end
-
-  describe '#length' do
-    it 'responds' do
-      @list.should respond_to(:length)
-    end
-
-    it 'is 16' do
-      @list.length.should == 16
-    end
-  end
-
-  describe '#first' do
-    it 'responds' do
-      @list.should respond_to(:first)
-    end
-
-    it 'is a Verso::Cluster object' do
-      @list.first.should be_a(Verso::Cluster)
-    end
-  end
-
-  describe '#count' do
-    it 'responds' do
-      @list.should respond_to(:count)
-    end
-
-    it 'is 16' do
-      @list.count.should == 16
-    end
-  end
+  it_behaves_like "any Verso list"
 end

data/spec/correlation_list_spec.rb

@@ -1,4 +1,5 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::CorrelationList do
   use_vcr_cassette :record => :new_episodes
@@ -9,6 +10,7 @@ describe Verso::CorrelationList do
       :edition => Verso::EditionList.new.last.year,
       :name => "english"
     )
+    @kontained = Verso::Task
   end
 
   describe '#code' do
@@ -27,87 +29,5 @@ describe Verso::CorrelationList do
     it { @list.title.should == 'English' }
   end
 
-  describe '#[]' do
-    it 'responds' do
-      @list.should respond_to(:[])
-    end
-
-    it 'is a Verso::Task' do
-      @list[@list.count / 2].should be_a(Verso::Task)
-    end
-  end
-
-  describe '#each' do
-    it 'responds' do
-      @list.should respond_to(:each)
-    end
-
-    it 'yields' do
-      expect { |b| @list.each("foo", &b).to yield_control }
-    end
-
-    it 'yields a Verso::Task' do
-      @list.each do |t|
-        t.should be_a(Verso::Task)
-      end
-    end
-  end
-
-  describe '#empty?' do
-    it 'responds' do
-      @list.should respond_to(:empty?)
-    end
-
-    it 'is not empty' do
-      @list.should_not be_empty
-    end
-  end
-
-  describe '#last' do
-    it 'responds' do
-      @list.should respond_to(:last)
-    end
-
-    it 'is a Verso::Task' do
-      @list.last.should be_a(Verso::Task)
-    end
-  end
-
-  describe '#length' do
-    it 'responds' do
-      @list.should respond_to(:length)
-    end
-
-    it 'is a Fixnum' do
-      @list.length.should be_a(Fixnum)
-    end
-
-    it 'is not zero' do
-      @list.length.should_not == 0
-    end
-  end
-
-  describe '#first' do
-    it 'responds' do
-      @list.should respond_to(:first)
-    end
-
-    it 'is a Verso::Task' do
-      @list.first.should be_a(Verso::Task)
-    end
-  end
-
-  describe '#count' do
-    it 'responds' do
-      @list.should respond_to(:count)
-    end
-
-    it 'is a Fixnum' do
-      @list.count.should be_a(Fixnum)
-    end
-
-    it 'is not zero' do
-      @list.count.should_not == 0
-    end
-  end
+  it_behaves_like 'any Verso list'
 end

data/spec/course_list_spec.rb

@@ -1,9 +1,10 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::CourseList do
   use_vcr_cassette :record => :new_episodes
 
-  describe 'searches' do
+  describe 'search' do
     it "searches by code" do
       results = Verso::CourseList.new(:code => "6320")
       results.each { |c| c.code.should == "6320" }
@@ -27,13 +28,12 @@ describe Verso::CourseList do
         should eq("Equine Management Production")
     end
 
-    it "can find courses by program area too" do
+    it "finds courses by program area too" do
       results = Verso::CourseList.new(:program_area => "across the board")
       results.first.title.strip.should eq("Work-Based Learning through Service")
     end
 
-    it "should return empty results when queries are empty" do
-      Verso::CourseList.new({}).count.should == 0
+    it "returns empty results when queries are empty" do
       [:text, :program_area, :cluster].each do |k|
         Verso::CourseList.new(k => nil).count.should == 0
         Verso::CourseList.new(k => '').count.should == 0
@@ -41,85 +41,18 @@ describe Verso::CourseList do
       Verso::CourseList.new(:text => '', :program_area => '', :cluster => '').
         count.should == 0
     end
+
+    it 'return everything when #new is called without attrs' do
+      Verso::CourseList.new.count.should_not == 0
+    end
   end
 
   describe 'array-like behavior' do
     before(:each) do
-      @courses = Verso::CourseList.new(:cluster => "Information Technology")
-    end
-
-    describe '#[]' do
-      it 'responds' do
-        @courses.should respond_to(:[])
-      end
-
-      it 'gets a Verso::Course object' do
-        @courses[10].should be_a(Verso::Course)
-      end
-    end
-
-    describe '#each' do
-      it 'responds' do
-        @courses.should respond_to(:each)
-      end
-
-      it 'yields' do
-        expect { |b| @courses.each("foo", &b).to yield_control }
-      end
-
-      it 'yields Verso::Course objects' do
-        @courses.each { |c| c.should be_a(Verso::Course) }
-      end
-    end
-
-    describe '#empty?' do
-      it 'responds' do
-        @courses.should respond_to(:empty?)
-      end
-
-      it 'is not empty' do
-        @courses.should_not be_empty
-      end
+      @list = Verso::CourseList.new(:cluster => "Information Technology")
+      @kontained = Verso::Course
     end
 
-    describe '#last' do
-      it 'responds' do
-        @courses.should respond_to(:last)
-      end
-
-      it 'is a Verso::Course object' do
-        @courses.last.should be_a(Verso::Course)
-      end
-    end
-
-    describe '#length' do
-      it 'responds' do
-        @courses.should respond_to(:length)
-      end
-
-      it 'is a Fixnum' do
-        @courses.length.should be_a(Fixnum)
-      end
-    end
-
-    describe '#first' do
-      it 'responds' do
-        @courses.should respond_to(:first)
-      end
-
-      it 'is a Verso::Course object' do
-        @courses.first.should be_a(Verso::Course)
-      end
-    end
-
-    describe '#count' do
-      it 'responds' do
-        @courses.should respond_to(:count)
-      end
-
-      it 'is a Fixnum' do
-        @courses.count.should be_a(Fixnum)
-      end
-    end
+    it_behaves_like "any Verso list"
   end
 end

data/spec/credential_list_spec.rb

@@ -1,98 +1,29 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::CredentialList do
   use_vcr_cassette :record => :new_episodes
   describe 'array-like behavior' do
     before(:each) do
-      @credentials = Verso::CredentialList.new
+      @list = Verso::CredentialList.new
+      @kontained = Verso::Credential
     end
 
-    describe '#[]' do
-      it 'responds' do
-        @credentials.should respond_to(:[])
-      end
+    it_behaves_like 'any Verso list'
 
-      it 'gets a Verso::Credential object' do
-        @credentials[10].should be_a(Verso::Credential)
-      end
-    end
-
-    describe '#each' do
-      it 'responds' do
-        @credentials.should respond_to(:each)
-      end
-
-      it 'yields' do
-        expect { |b| @credentials.each("foo", &b).to yield_control }
-      end
-
-      it 'yields Verso::Credential objects' do
-        @credentials.each { |c| c.should be_a(Verso::Credential) }
-      end
-    end
-
-    describe '#empty?' do
-      it 'responds' do
-        @credentials.should respond_to(:empty?)
-      end
-
-      it 'is not empty' do
-        @credentials.should_not be_empty
-      end
-    end
-
-    describe '#last' do
-      it 'responds' do
-        @credentials.should respond_to(:last)
-      end
-
-      it 'is a Verso::Credential object' do
-        @credentials.last.should be_a(Verso::Credential)
-      end
-    end
-
-    describe '#length' do
-      it 'responds' do
-        @credentials.should respond_to(:length)
-      end
-
-      it 'is a Fixnum' do
-        @credentials.length.should be_a(Fixnum)
-      end
-    end
-
-    describe '#first' do
-      it 'responds' do
-        @credentials.should respond_to(:first)
-      end
-
-      it 'is a Verso::Credential object' do
-        @credentials.first.should be_a(Verso::Credential)
-      end
-    end
-
-    describe '#count' do
-      it 'responds' do
-        @credentials.should respond_to(:count)
-      end
-
-      it 'is a Fixnum' do
-        @credentials.count.should be_a(Fixnum)
-      end
-    end
   end
 
   describe 'search' do
     before(:each) do
-      @credentials = Verso::CredentialList.new(:text => 'nocti')
+      @list = Verso::CredentialList.new(:text => 'nocti')
     end
 
     it 'is a collection of Verso::Credential objects' do
-      @credentials.first.should be_a(Verso::Credential)
+      @list.first.should be_a(Verso::Credential)
     end
 
     it 'is related to the search term' do
-      @credentials.first.source.title.should match (/NOCTI/)
+      @list.first.source.title.should match (/NOCTI/)
     end
   end
 

data/spec/edition_list_spec.rb

@@ -1,96 +1,24 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::EditionList do
   use_vcr_cassette :record => :new_episodes
 
   before(:each) do
-    @editions = Verso::EditionList.new
+    @list = Verso::EditionList.new
+    @kontained = OpenStruct
   end
 
-  describe 'array-like behavior' do
-    describe '#[]' do
-      it 'responds' do
-        @editions.should respond_to(:[])
-      end
-
-      it 'gets a OpenStruct object' do
-        @editions[0].should be_a(OpenStruct)
-      end
-    end
-
-    describe '#each' do
-      it 'responds' do
-        @editions.should respond_to(:each)
-      end
-
-      it 'yields' do
-        expect { |b| @editions.each("foo", &b).to yield_control }
-      end
-
-      it 'yields OpenStruct objects' do
-        @editions.each { |c| c.should be_a(OpenStruct) }
-      end
-    end
-
-    describe '#empty?' do
-      it 'responds' do
-        @editions.should respond_to(:empty?)
-      end
-
-      it 'is not empty' do
-        @editions.should_not be_empty
-      end
-    end
-
-    describe '#last' do
-      it 'responds' do
-        @editions.should respond_to(:last)
-      end
-
-      it 'is a OpenStruct object' do
-        @editions.last.should be_a(OpenStruct)
-      end
-    end
-
-    describe '#length' do
-      it 'responds' do
-        @editions.should respond_to(:length)
-      end
-
-      it 'is a Fixnum' do
-        @editions.length.should be_a(Fixnum)
-      end
-    end
-
-    describe '#first' do
-      it 'responds' do
-        @editions.should respond_to(:first)
-      end
-
-      it 'is a OpenStruct object' do
-        @editions.first.should be_a(OpenStruct)
-      end
-    end
-
-    describe '#count' do
-      it 'responds' do
-        @editions.should respond_to(:count)
-      end
-
-      it 'is a Fixnum' do
-        @editions.count.should be_a(Fixnum)
-      end
-    end
-  end
+  it_behaves_like 'any Verso list'
 
   describe 'OpenStruct edition proxy' do
     describe '#year' do
       it 'responds' do
-        @editions.last.should respond_to(:year)
+        @list.last.should respond_to(:year)
       end
 
       it 'looks like a year' do
-        @editions.first.year.should match(/2\d{3}/)
+        @list.first.year.should match(/2\d{3}/)
       end
     end
   end

data/spec/emphasis_list_spec.rb

@@ -1,85 +1,13 @@
 require 'spec_helper'
+require 'shared_verso_list_examples'
 
 describe Verso::EmphasisList do
   use_vcr_cassette :record => :new_episodes
 
   before do
-    @emphases = Verso::EmphasisList.new
+    @list = Verso::EmphasisList.new
+    @kontained = Verso::Emphasis
   end
 
-  describe 'array-like behavior' do
-    describe '#[]' do
-      it 'responds' do
-        @emphases.should respond_to(:[])
-      end
-
-      it 'gets a Verso::Emphasis object' do
-        @emphases[10].should be_a(Verso::Emphasis)
-      end
-    end
-
-    describe '#each' do
-      it 'responds' do
-        @emphases.should respond_to(:each)
-      end
-
-      it 'yields' do
-        expect { |b| @emphases.each("foo", &b).to yield_control }
-      end
-
-      it 'yields Verso::Emphasis objects' do
-        @emphases.each { |c| c.should be_a(Verso::Emphasis) }
-      end
-    end
-
-    describe '#empty?' do
-      it 'responds' do
-        @emphases.should respond_to(:empty?)
-      end
-
-      it 'is not empty' do
-        @emphases.should_not be_empty
-      end
-    end
-
-    describe '#last' do
-      it 'responds' do
-        @emphases.should respond_to(:last)
-      end
-
-      it 'is a Verso::Emphasis object' do
-        @emphases.last.should be_a(Verso::Emphasis)
-      end
-    end
-
-    describe '#length' do
-      it 'responds' do
-        @emphases.should respond_to(:length)
-      end
-
-      it 'is a Fixnum' do
-        @emphases.length.should be_a(Fixnum)
-      end
-    end
-
-    describe '#first' do
-      it 'responds' do
-        @emphases.should respond_to(:first)
-      end
-
-      it 'is a Verso::Emphasis object' do
-        @emphases.first.should be_a(Verso::Emphasis)
-      end
-    end
-
-    describe '#count' do
-      it 'responds' do
-        @emphases.should respond_to(:count)
-      end
-
-      it 'is a Fixnum' do
-        @emphases.count.should be_a(Fixnum)
-      end
-    end
-  end
+  it_behaves_like 'any Verso list'
 end