govkit-ca 0.0.14 → 0.0.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 552c21addb48040ade097636fd88ec1e60464d4b
-  data.tar.gz: 4a99ef183fefcddfdd06516aaaf968c8bcb55f03
+  metadata.gz: 2051edb2b22dbfb63480ac487f4fe82c4cd5f7f1
+  data.tar.gz: 762e642d14e7869f88ea766eaf33d8ca2b64442a
 SHA512:
-  metadata.gz: 964b1d7bfb550b526a8ed5cc7cd7f093aab3d2f096f182abe41a492e867fcf43ab31d115051f53968665da977cdc07abb95c41e50de1dc533f79b66be9d082ea
-  data.tar.gz: e9f9c2b9923969bbdf265a5fcef8d376058fcd87ed067e22068137a800f88786c5f7e0c09ba5da825cc3efc2c1c4e3efefffb90cd425b4f8a0caa97ff90c86e9
+  metadata.gz: 8ac0daf7e97e39bdf8f6eff4bdb3d3611c55604fc980570558ffeb59c0bec4ba24dd2207ebe58fef4565159978d23e25d16feeb01f8f07f729e3413933d8f62b
+  data.tar.gz: d07c817b8b21b71559d1fd0e69ffd7edfd18875a4f461e9ec00d2d66b277ac633153292bbd44d946c1232d81f149d63565cf06c415a8c22cf0ac04172979a5c2

data/README.md

@@ -22,36 +22,48 @@ require 'govkit-ca'
 client = GovKit::CA::Represent.new
 ```
 
-Send a request to the [`/postcodes` endpoint](https://represent.opennorth.ca/api/#postcode):
+Send a request to the [`/postcodes/` endpoint](https://represent.opennorth.ca/api/#postcode):
 
 ```ruby
 client.postcodes('A1A1A1')
 ```
 
-Send a request to the [`/representative-sets` endpoint](https://represent.opennorth.ca/api/#representativeset):
+Send a request to the [`/representative-sets/` endpoint](https://represent.opennorth.ca/api/#representativeset):
 
 ```ruby
 client.representative_sets(limit: 0)
 ```
 
-Send a request to the [`/representatives` endpoint](https://represent.opennorth.ca/api/#representative):
+Send a request to the [`/representatives/` endpoint](https://represent.opennorth.ca/api/#representative):
 
 ```ruby
 client.representatives(representative_set: 'toronto-city-council')
 ```
 
-Send a request to the [`/boundary-sets` endpoint](https://represent.opennorth.ca/api/#boundaryset):
+Send a request to the [`/boundary-sets/` endpoint](https://represent.opennorth.ca/api/#boundaryset):
 
 ```ruby
 client.boundary_sets(limit: 0)
 ```
 
-Send a request to the [`/boundaries` endpoint](https://represent.opennorth.ca/api/#boundary):
+Send a request to the [`/boundaries/` endpoint](https://represent.opennorth.ca/api/#boundary):
 
 ```ruby
 client.boundaries(boundary_set: 'toronto-wards')
 ```
 
+Send a request to the [`/elections/` endpoint](https://represent.opennorth.ca/api/#election):
+
+```ruby
+client.elections(limit: 0)
+```
+
+Send a request to the [`/candidates/` endpoint](https://represent.opennorth.ca/api/#candidate):
+
+```ruby
+client.candidates(election: 'house-of-commons')
+```
+
 Read the full documentation on [RubyDoc.info](http://rubydoc.info/gems/govkit-ca/GovKit/CA/Represent).
 
 ## Postal code to electoral district lookup
@@ -64,7 +76,6 @@ GovKit-CA provides an API for free postal code to electoral district lookups, us
 * [greenparty.ca](http://www.greenparty.ca/)
 * [liberal.ca](https://www.liberal.ca/)
 * [ndp.ca](http://www.ndp.ca/)
-* [cbc.ca](http://www.cbc.ca/)
 * [digital-copyright.ca](http://www.digital-copyright.ca/)
 
 These sources can be unstable or incorrect.

data/lib/gov_kit-ca.rb

@@ -17,7 +17,6 @@ end
 require 'gov_kit-ca/postal_code'
 require 'gov_kit-ca/postal_code/strategy_set'
 require 'gov_kit-ca/postal_code/strategy/base'
-require 'gov_kit-ca/postal_code/strategy/cbc_ca'
 require 'gov_kit-ca/postal_code/strategy/conservative_ca'
 require 'gov_kit-ca/postal_code/strategy/digital-copyright_ca'
 require 'gov_kit-ca/postal_code/strategy/elections_ca'

data/lib/gov_kit-ca/represent.rb

@@ -106,7 +106,7 @@ module GovKit
       # Get candidates.
       #
       # @param [Hash] opts optional arguments
-      # @option opts [String] :electon an election
+      # @option opts [String] :election an election
       # @option opts [Array<Float>,String] :point a comma-separated latitude and longitude
       # @option opts [Array<Strong>,String] :districts a comma-separated list of boundaries
       # @option opts [Integer] :limit
@@ -119,7 +119,7 @@ module GovKit
         if Array === opts[:districts]
           opts[:districts] = opts[:districts].join(',')
         end
-        request(['candidates', opts.delete(:candidate)], opts)
+        request(['candidates', opts.delete(:election)], opts)
       end
 
     private

data/lib/gov_kit-ca/version.rb

@@ -1,5 +1,5 @@
 module GovKit
   module CA
-    VERSION = "0.0.14"
+    VERSION = "0.0.15"
   end
 end

data/spec/represent_spec.rb

@@ -1,137 +1,45 @@
 require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
 
 RSpec.describe GovKit::CA::Represent do
-  describe '#boundary_sets' do
-    let :api do
-      GovKit::CA::Represent.new
-    end
-
-    it 'should accept a custom connection' do
-      connection = Faraday.new do |connection|
-        connection.request :url_encoded
-        connection.adapter Faraday.default_adapter
-      end
-      expect{GovKit::CA::Represent.new(connection)}.to_not raise_error
-    end
-
-    it 'should return boundary sets' do
-      response = api.boundary_sets
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-    end
-
-    it 'should return a boundary set' do
-      response = api.boundary_sets(:boundary_set => 'federal-electoral-districts')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('related')
-    end
-
-    it 'should raise an error if the boundary set does not exist' do
-      expect{api.boundary_sets(:boundary_set => 'foo')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundary-sets/foo/?")
-    end
-
-    it 'should raise an error if the limit is invalid' do
-      expect{api.boundary_sets(:limit => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/boundary-sets/?limit=-1 Invalid limit '-1' provided. Please provide a positive integer >= 0.")
-    end
-
-    it 'should raise an error if the offset is invalid' do
-      expect{api.boundary_sets(:offset => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/boundary-sets/?offset=-1 Invalid offset '-1' provided. Please provide a positive integer >= 0.")
+  it 'should accept a custom connection' do
+    connection = Faraday.new do |connection|
+      connection.request :url_encoded
+      connection.adapter Faraday.default_adapter
     end
+    expect{GovKit::CA::Represent.new(connection)}.to_not raise_error
   end
 
   describe '#representative_sets' do
-    let :api do
-      GovKit::CA::Represent.new
-    end
-
-    it 'should return representative sets' do
-      response = api.representative_sets
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-    end
-
-    it 'should return a representative set' do
-      response = api.representative_sets(:representative_set => 'house-of-commons')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('related')
-    end
-
-    it 'should raise an error if the representative set does not exist' do
-      expect{api.representative_sets(:representative_set => 'foo')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/representative-sets/foo/?")
-    end
-
-    it 'should raise an error if the limit is invalid' do
-      expect{api.representative_sets(:limit => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/representative-sets/?limit=-1 Invalid limit '-1' provided. Please provide a positive integer >= 0.")
-    end
-
-    it 'should raise an error if the offset is invalid' do
-      expect{api.representative_sets(:offset => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/representative-sets/?offset=-1 Invalid offset '-1' provided. Please provide a positive integer >= 0.")
-    end
+    include_examples 'set', 'representative_sets', 'house-of-commons'
   end
 
-  describe '#postcodes' do
-    let :api do
-      GovKit::CA::Represent.new
-    end
-
-    it 'should query by postal code' do
-      response = api.postcodes('A1A1A1')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('code')
-    end
+  # @note These tests will fail if the election is inactive.
+  describe '#elections' do
+    include_examples 'set', 'elections', 'house-of-commons'
+  end
 
-    it 'should accept an array of boundary sets' do
-      response = api.postcodes('A1A1A1', :sets => ['federal-electoral-districts', 'census-subdivisions'])
-      expect(response).to be_a(Hash)
-      expect((response['boundaries_centroid'] + response['boundaries_concordance']).size).to eq(2)
-    end
+  describe '#boundary_sets' do
+    include_examples 'set', 'boundary_sets', 'federal-electoral-districts'
+  end
 
-    it 'should accept a comma-separated list of boundary sets' do
-      response = api.postcodes('A1A1A1', :sets => 'federal-electoral-districts,census-subdivisions')
-      expect(response).to be_a(Hash)
-      expect((response['boundaries_centroid'] + response['boundaries_concordance']).size).to eq(2)
-    end
+  describe '#representatives' do
+    include_examples 'representative', 'representatives', 'st-johns-city-council', 11, :set => :representative_set, :point => :point
+  end
 
-    it 'should raise an error if the postal code does not exist' do
-      expect{api.postcodes('foo')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/postcodes/FOO/?")
-    end
+  # @note These tests will fail if the election is inactive.
+  describe '#candidates' do
+    include_examples 'representative', 'candidates', 'house-of-commons', 20, :set => :election, :point => :point
   end
 
   describe '#boundaries' do
+    include_examples 'item', 'boundaries', 'st-johns-wards', 5, :set => :boundary_set, :point => :contains
+
     let :api do
       GovKit::CA::Represent.new
     end
 
-    it 'should return boundaries' do
-      response = api.boundaries
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to_not be_nil
-    end
-
-    it 'should return boundaries from a boundary set' do
-      response = api.boundaries(:boundary_set => 'st-johns-wards')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['objects'].size).to eq(5)
-    end
-
-    it 'should return a boundary from a boundary set' do
-      response = api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'ward-1')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('related')
-    end
-
-    it 'should return the representatives of a boundary from a boundary set' do
-      response = api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'ward-1', :representatives => true)
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
+    it 'should raise an error if the boundary set does not exist' do
+      expect{api.boundaries(:boundary_set => 'nonexistent')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/nonexistent/?")
     end
 
     it 'should return boundaries from many boundary sets as an array' do
@@ -150,37 +58,19 @@ RSpec.describe GovKit::CA::Represent do
       expect(response['objects'].size).to eq(10)
     end
 
-    it 'should accept a point as an array' do
-      response = api.boundaries(:contains => ['47.5699', '-52.6954'])
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
-    end
-
-    it 'should accept a point as a comma-separated list' do
-      response = api.boundaries(:contains => '47.5699,-52.6954')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
-    end
-
-    it 'should raise an error if the point is invalid' do
-      expect{api.boundaries(:contains => '0,0,0')}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/boundaries/?contains=0,0,0 Invalid latitude,longitude '0,0,0' provided.")
-    end
-
-    it 'should raise an error if the boundary set does not exist' do
-      expect{api.boundaries(:boundary_set => 'foo')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/foo/?")
-    end
-
     context 'when retrieving a boundary' do
+      it 'should return a boundary from a boundary set' do
+        response = api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'ward-1')
+        expect(response).to be_a(Hash)
+        expect(response).to have_key('related')
+      end
+
       it 'should raise an error if the boundary set does not exist' do
-        expect{api.boundaries(:boundary_set => 'foo', :boundary => 'ward-1')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/foo/ward-1/?")
+        expect{api.boundaries(:boundary_set => 'nonexistent', :boundary => 'ward-1')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/nonexistent/ward-1/?")
       end
 
       it 'should raise an error if the boundary does not exist' do
-        expect{api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'foo')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/st-johns-wards/foo/?")
+        expect{api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'nonexistent')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/boundaries/st-johns-wards/nonexistent/?")
       end
 
       it 'should raise an error if the boundary set is not given' do
@@ -189,12 +79,20 @@ RSpec.describe GovKit::CA::Represent do
     end
 
     context 'when retrieving the representatives of a boundary' do
+      it 'should return the representatives of a boundary from a boundary set' do
+        response = api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'ward-1', :representatives => true)
+        expect(response).to be_a(Hash)
+        expect(response).to have_key('objects')
+        expect(response).to have_key('meta')
+        expect(response['meta']['next']).to be_nil
+      end
+
       it 'should not raise an error if the boundary set does not exist' do
-        expect{api.boundaries(:boundary_set => 'foo', :boundary => 'ward-1', :representatives => true)}.to_not raise_error
+        expect{api.boundaries(:boundary_set => 'nonexistent', :boundary => 'ward-1', :representatives => true)}.to_not raise_error
       end
 
       it 'should not raise an error if the boundary does not exist' do
-        expect{api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'foo', :representatives => true)}.to_not raise_error
+        expect{api.boundaries(:boundary_set => 'st-johns-wards', :boundary => 'nonexistent', :representatives => true)}.to_not raise_error
       end
 
       it 'should raise an error if the boundary set is not given' do
@@ -205,83 +103,33 @@ RSpec.describe GovKit::CA::Represent do
         expect{api.boundaries(:boundary_set => 'st-johns-wards', :representatives => true)}.to raise_error(ArgumentError, ':boundary_set and :boundary must be set if :representatives is true')
       end
     end
-
-    it 'should raise an error if the limit is invalid' do
-      expect{api.boundaries(:limit => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/boundaries/?limit=-1 Invalid limit '-1' provided. Please provide a positive integer >= 0.")
-    end
-
-    it 'should raise an error if the offset is invalid' do
-      expect{api.boundaries(:offset => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/boundaries/?offset=-1 Invalid offset '-1' provided. Please provide a positive integer >= 0.")
-    end
   end
 
-  describe '#representatives' do
+  describe '#postcodes' do
     let :api do
       GovKit::CA::Represent.new
     end
 
-    it 'should return representatives' do
-      response = api.representatives
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to_not be_nil
-    end
-
-    it 'should return representatives from a representative set' do
-      response = api.representatives(:representative_set => 'st-johns-city-council')
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
-    end
-
-    it 'should accept a point as an array' do
-      response = api.representatives(:point => ['47.5699', '-52.6954'])
-      expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
-    end
-
-    it 'should accept a point as a comma-separated list' do
-      response = api.representatives(:point => '47.5699,-52.6954')
+    it 'should query by postal code' do
+      response = api.postcodes('A1A1A1')
       expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
+      expect(response).to have_key('code')
     end
 
-    it 'should accept an array of districts' do
-      response = api.representatives(:districts => ['federal-electoral-districts/10007', 'census-subdivisions/1001519'])
+    it 'should accept an array of boundary sets' do
+      response = api.postcodes('A1A1A1', :sets => ['federal-electoral-districts', 'census-subdivisions'])
       expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
+      expect((response['boundaries_centroid'] + response['boundaries_concordance']).size).to eq(2)
     end
 
-    it 'should accept a comma-separated list of districts' do
-      response = api.representatives(:districts => 'federal-electoral-districts/10007,census-subdivisions/1001519')
+    it 'should accept a comma-separated list of boundary sets' do
+      response = api.postcodes('A1A1A1', :sets => 'federal-electoral-districts,census-subdivisions')
       expect(response).to be_a(Hash)
-      expect(response).to have_key('objects')
-      expect(response).to have_key('meta')
-      expect(response['meta']['next']).to be_nil
-    end
-
-    it 'should raise an error if the point is invalid' do
-      expect{api.representatives(:point => '0,0,0')}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/representatives/?point=0,0,0 Invalid latitude,longitude '0,0,0' provided.")
-    end
-
-    it 'should not raise an error if the representative set does not exist' do
-      expect{api.representatives(:representative_set => 'foo')}.to_not raise_error
-    end
-
-    it 'should raise an error if the limit is invalid' do
-      expect{api.representatives(:limit => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/representatives/?limit=-1 Invalid limit '-1' provided. Please provide a positive integer >= 0.")
+      expect((response['boundaries_centroid'] + response['boundaries_concordance']).size).to eq(2)
     end
 
-    it 'should raise an error if the offset is invalid' do
-      expect{api.representatives(:offset => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/representatives/?offset=-1 Invalid offset '-1' provided. Please provide a positive integer >= 0.")
+    it 'should raise an error if the postal code does not exist' do
+      expect{api.postcodes('Z0Z0Z0')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/postcodes/Z0Z0Z0/?")
     end
   end
 end

data/spec/spec_helper.rb

@@ -8,32 +8,33 @@ SimpleCov.start do
 end
 
 require 'rspec'
-require File.dirname(__FILE__) + '/../lib/gov_kit-ca'
-
 RSpec.configure do |config|
   config.filter_run_excluding :broken => true
 end
 
+Dir['./spec/support/**/*.rb'].sort.each { |f| require f}
+require File.dirname(__FILE__) + '/../lib/gov_kit-ca'
+
 EXPECTATIONS = {
-  conservative_ca: {
+  :conservative_ca => {
     'T1P1K1' => [48010],
     'K0A1K0' => [35025, 35052, 35063],
   },
-  elections_ca: {
+  :elections_ca => {
     'G0C2Y0' => [24026],
     'T5S2B9' => [48031],
   },
-  green_party_ca: {
+  :green_party_ca => {
     'G0C2Y0' => [24026],
     'T5S2B9' => [48031],
   },
-  liberal_ca: {
+  :liberal_ca => {
     'G0C2Y0' => [24026],
     'T5S2B9' => [48031],
     'B0J2L0' => [12002], # too few
     'K0A1K0' => [35076], # too few
   },
-  ndp_ca: {
+  :ndp_ca => {
     'G0C2Y0' => [24026],
     'T5S2B9' => [48031],
     'B0J2L0' => [12002, 12008],
@@ -41,13 +42,7 @@ EXPECTATIONS = {
   },
 
   # Deprecated.
-  cbc_ca: {
-    'G0C2Y0' => [24019],
-    'T5S2B9' => [48015, 48017],
-    'B0J2L0' => [12002, 12007, 12008],
-    'K0A1K0' => [35025, 35052, 35063, 35064],
-  },
-  digital_copyright_ca: {
+  :digital_copyright_ca => {
     'G0C2Y0' => [24019, 24039],
     'T5S2B9' => [48012, 48013, 48014, 48015, 48017, 48018],
     'B0J2L0' => [12002, 12007, 12008],

data/spec/strategy_set_spec.rb

@@ -19,7 +19,6 @@ RSpec.describe GovKit::CA::PostalCode::StrategySet do
           GovKit::CA::PostalCode::Strategy::LiberalCa,
           GovKit::CA::PostalCode::Strategy::NDPCa,
           # GovKit::CA::PostalCode::Strategy::GreenPartyCa,
-          # GovKit::CA::PostalCode::Strategy::CBCCa,
           # GovKit::CA::PostalCode::Strategy::ConservativeCa,
         ])
       end

data/spec/support/shared_examples_for_represent.rb

@@ -0,0 +1,118 @@
+RSpec.shared_examples 'pagination' do |method,endpoint|
+  it 'should raise an error if the limit is invalid' do
+    expect{api.send(method, :limit => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/#{endpoint}/?limit=-1 Invalid limit '-1' provided. Please provide a positive integer >= 0.")
+  end
+
+  it 'should raise an error if the offset is invalid' do
+    expect{api.send(method, :offset => -1)}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/#{endpoint}/?offset=-1 Invalid offset '-1' provided. Please provide a positive integer >= 0.")
+  end
+end
+
+RSpec.shared_examples 'set' do |method,set|
+  include_examples 'pagination', method, method.sub('_', '-')
+
+  let :option do
+    method.chomp('s').to_sym
+  end
+
+  let :endpoint do
+    method.sub('_', '-')
+  end
+
+  let :api do
+    GovKit::CA::Represent.new
+  end
+
+  it 'should return sets' do
+    response = api.send(method)
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+  end
+
+  it 'should return a set' do
+    response = api.send(method, option => set)
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('related')
+  end
+
+  it 'should raise an error if the set does not exist' do
+    expect{api.send(method, option => 'nonexistent')}.to raise_error(GovKit::CA::ResourceNotFound, "404 https://represent.opennorth.ca/#{endpoint}/nonexistent/?")
+  end
+end
+
+RSpec.shared_examples 'item' do |method,set,size,options|
+  include_examples 'pagination', method, method
+
+  let :endpoint do
+    method
+  end
+
+  let :api do
+    GovKit::CA::Represent.new
+  end
+
+  it 'should return items' do
+    response = api.send(method)
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['meta']['next']).to_not be_nil
+  end
+
+  it 'should return items from a set' do
+    response = api.send(method, options.fetch(:set) => set)
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['objects'].size).to eq(size)
+  end
+
+  it 'should accept a point as an array' do
+    response = api.send(method, options.fetch(:point) => ['47.5699', '-52.6954'])
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['meta']['next']).to be_nil
+  end
+
+  it 'should accept a point as a comma-separated list' do
+    response = api.send(method, options.fetch(:point) => '47.5699,-52.6954')
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['meta']['next']).to be_nil
+  end
+
+  it 'should raise an error if the point is invalid' do
+    expect{api.send(method, options.fetch(:point) => '0,0,0')}.to raise_error(GovKit::CA::InvalidRequest, "400 https://represent.opennorth.ca/#{endpoint}/?#{options[:point]}=0,0,0 Invalid latitude,longitude '0,0,0' provided.")
+  end
+end
+
+RSpec.shared_examples 'representative' do |method,set,size,options|
+  include_examples 'item', method, set, size, options
+
+  let :api do
+    GovKit::CA::Represent.new
+  end
+
+  it 'should not raise an error if the set does not exist' do
+    expect{api.send(method, options.fetch(:set) => 'foo')}.to_not raise_error
+  end
+
+  it 'should accept an array of districts' do
+    response = api.send(method, :districts => ['federal-electoral-districts/10007', 'census-subdivisions/1001519'])
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['meta']['next']).to be_nil
+  end
+
+  it 'should accept a comma-separated list of districts' do
+    response = api.send(method, :districts => 'federal-electoral-districts/10007,census-subdivisions/1001519')
+    expect(response).to be_a(Hash)
+    expect(response).to have_key('objects')
+    expect(response).to have_key('meta')
+    expect(response['meta']['next']).to be_nil
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: govkit-ca
 version: !ruby/object:Gem::Version
-  version: 0.0.14
+  version: 0.0.15
 platform: ruby
 authors:
 - Open North
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-09-10 00:00:00.000000000 Z
+date: 2015-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -142,7 +142,6 @@ files:
 - lib/gov_kit-ca.rb
 - lib/gov_kit-ca/postal_code.rb
 - lib/gov_kit-ca/postal_code/strategy/base.rb
-- lib/gov_kit-ca/postal_code/strategy/cbc_ca.rb
 - lib/gov_kit-ca/postal_code/strategy/conservative_ca.rb
 - lib/gov_kit-ca/postal_code/strategy/digital-copyright_ca.rb
 - lib/gov_kit-ca/postal_code/strategy/elections_ca.rb
@@ -154,8 +153,6 @@ files:
 - lib/gov_kit-ca/represent.rb
 - lib/gov_kit-ca/version.rb
 - lib/govkit-ca.rb
-- lib/rid_to_edid.yml
-- spec/cbc_ca_spec.rb
 - spec/conservative_ca_spec.rb
 - spec/digital-copyright_ca_spec.rb
 - spec/elections_ca_spec.rb
@@ -167,6 +164,7 @@ files:
 - spec/represent_spec.rb
 - spec/spec_helper.rb
 - spec/strategy_set_spec.rb
+- spec/support/shared_examples_for_represent.rb
 - tasks/postal-code-for-districts.csv
 - tasks/tasks.rb
 homepage: https://github.com/opennorth/govkit-ca
@@ -194,7 +192,6 @@ signing_key:
 specification_version: 4
 summary: Easy access to Canadian civic data around the web
 test_files:
-- spec/cbc_ca_spec.rb
 - spec/conservative_ca_spec.rb
 - spec/digital-copyright_ca_spec.rb
 - spec/elections_ca_spec.rb
@@ -206,4 +203,5 @@ test_files:
 - spec/represent_spec.rb
 - spec/spec_helper.rb
 - spec/strategy_set_spec.rb
+- spec/support/shared_examples_for_represent.rb
 has_rdoc: 

data/lib/gov_kit-ca/postal_code/strategy/cbc_ca.rb

@@ -1,31 +0,0 @@
-module GovKit
-  module CA
-    module PostalCode
-      module Strategy
-        # @deprecated Due to redistribution.
-        class CBCCa < Base
-          base_uri 'www.cbc.ca'
-          http_method :get
-          path '/news/politics/canadavotes2011/myelection/postalcodes/index.php?pc=<%= @postal_code %>'
-
-        private
-
-          def electoral_districts!
-            JSON.load(response.parsed_response).map{|x| self.class.rid_to_edid[x['rid'].to_i]}
-          end
-
-          def valid?
-            response.code != 404
-          end
-
-          # cbc.ca uses an internal riding ID, which must be matched to a
-          # canonical electoral district ID.
-          # @return [Hash] a map of cbc.ca riding ID to electoral district ID
-          def self.rid_to_edid
-            @@yml ||= YAML.load_file(File.expand_path('../../../../rid_to_edid.yml', __FILE__))
-          end
-        end
-      end
-    end
-  end
-end

data/lib/rid_to_edid.yml

@@ -1,309 +0,0 @@
----
-1: 10001
-2: 10002
-3: 10003
-4: 10004
-5: 10005
-6: 10006
-7: 10007
-8: 11001
-9: 11002
-10: 11003
-11: 11004
-12: 12001
-13: 12002
-14: 12007
-15: 12003
-16: 12004
-17: 12005
-18: 12006
-19: 12008
-20: 12009
-21: 12010
-22: 12011
-23: 13001
-24: 13002
-25: 13003
-26: 13004
-27: 13005
-28: 13006
-29: 13007
-30: 13008
-31: 13009
-32: 13010
-33: 24046
-34: 24001
-35: 24002
-36: 24003
-37: 24004
-38: 24054
-39: 24005
-40: 24006
-41: 24007
-42: 24008
-43: 24009
-44: 24010
-45: 24011
-46: 24012
-47: 24013
-48: 24015
-49: 24016
-50: 24017
-51: 24018
-52: 24019
-53: 24020
-54: 24041
-55: 24021
-56: 24022
-57: 24023
-58: 24024
-59: 24025
-60: 24026
-61: 24027
-62: 24028
-63: 24029
-64: 24030
-65: 24031
-66: 24032
-67: 24033
-68: 24034
-69: 24035
-70: 24036
-71: 24037
-72: 24038
-73: 24039
-74: 24040
-75: 24042
-76: 24043
-77: 24058
-78: 24014
-79: 24044
-80: 24045
-81: 24047
-82: 24048
-83: 24049
-84: 24050
-85: 24051
-86: 24052
-87: 24053
-88: 24055
-89: 24056
-90: 24057
-91: 24059
-92: 24060
-93: 24061
-94: 24062
-95: 24063
-96: 24064
-97: 24065
-98: 24066
-99: 24067
-100: 24068
-101: 24069
-102: 24070
-103: 24071
-104: 24072
-105: 24073
-106: 24074
-107: 24075
-108: 35001
-109: 35002
-110: 35003
-111: 35004
-112: 35005
-113: 35006
-114: 35007
-115: 35008
-116: 35009
-117: 35026
-118: 35010
-119: 35011
-120: 35012
-121: 35013
-122: 35015
-123: 35016
-124: 35017
-125: 35018
-126: 35014
-127: 35019
-128: 35020
-129: 35021
-130: 35022
-131: 35023
-132: 35024
-133: 35025
-134: 35027
-135: 35028
-136: 35029
-137: 35030
-138: 35031
-139: 35032
-140: 35033
-141: 35034
-142: 35035
-143: 35036
-144: 35037
-145: 35038
-146: 35039
-147: 35046
-148: 35040
-149: 35041
-150: 35042
-151: 35043
-152: 35044
-153: 35045
-154: 35047
-155: 35048
-156: 35049
-157: 35050
-158: 35051
-159: 35052
-160: 35053
-161: 35054
-162: 35055
-163: 35056
-164: 35057
-165: 35058
-166: 35059
-167: 35060
-168: 35061
-169: 35062
-170: 35063
-171: 35064
-172: 35065
-173: 35066
-174: 35067
-175: 35068
-176: 35069
-177: 35070
-178: 35071
-179: 35072
-180: 35073
-181: 35074
-182: 35075
-183: 35076
-184: 35077
-185: 35078
-186: 35079
-187: 35080
-188: 35081
-189: 35082
-190: 35083
-191: 35084
-192: 35085
-193: 35086
-194: 35087
-195: 35088
-196: 35089
-197: 35090
-198: 35091
-199: 35092
-200: 35093
-201: 35094
-202: 35095
-203: 35096
-204: 35097
-205: 35098
-206: 35099
-207: 35100
-208: 35101
-209: 35102
-210: 35103
-211: 35104
-212: 35105
-213: 35106
-214: 46001
-215: 46002
-216: 46003
-217: 46004
-218: 46005
-219: 46006
-220: 46007
-221: 46008
-222: 46009
-223: 46010
-224: 46011
-225: 46012
-226: 46013
-227: 46014
-228: 47001
-229: 47002
-230: 47004
-231: 47003
-232: 47005
-233: 47006
-234: 47007
-235: 47008
-236: 47009
-237: 47010
-238: 47011
-239: 47012
-240: 47013
-241: 47014
-242: 48006
-243: 48003
-244: 48002
-245: 48004
-246: 48005
-247: 48007
-248: 48008
-249: 48009
-250: 48010
-251: 48012
-252: 48013
-253: 48014
-254: 48011
-255: 48015
-256: 48016
-257: 48017
-258: 48018
-259: 48001
-260: 48019
-261: 48020
-262: 48021
-263: 48022
-264: 48023
-265: 48024
-266: 48025
-267: 48026
-268: 48027
-269: 48028
-270: 59001
-271: 59026
-272: 59002
-273: 59003
-274: 59004
-275: 59005
-276: 59006
-277: 59008
-278: 59009
-279: 59010
-280: 59011
-281: 59012
-282: 59013
-283: 59014
-284: 59015
-285: 59016
-286: 59017
-287: 59019
-288: 59020
-289: 59018
-290: 59007
-291: 59021
-292: 59022
-293: 59023
-294: 59024
-295: 59025
-296: 59027
-297: 59028
-298: 59029
-299: 59030
-300: 59031
-301: 59032
-302: 59033
-303: 59034
-304: 59035
-305: 59036
-306: 60001
-307: 61001
-308: 62001

data/spec/cbc_ca_spec.rb

@@ -1,19 +0,0 @@
-require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
-
-RSpec.describe GovKit::CA::PostalCode::Strategy::CBCCa do
-  describe '#electoral_districts', :broken => true do
-    it 'should return the electoral districts within a postal code' do
-      EXPECTATIONS[:cbc_ca].each do |postal_code,electoral_districts|
-        expect(GovKit::CA::PostalCode::Strategy::CBCCa.new(postal_code).electoral_districts).to eq(electoral_districts)
-      end
-    end
-
-    it 'should return false if a postal code contains no electoral districts' do
-      expect(GovKit::CA::PostalCode::Strategy::CBCCa.new('H0H0H0').electoral_districts).to eq(false)
-    end
-
-    it 'should return false if a postal code does not exist' do
-      expect(GovKit::CA::PostalCode::Strategy::CBCCa.new('X1B1B1').electoral_districts).to eq(false)
-    end
-  end
-end