govkit-ca 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in govkit-ca.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 James McKinney
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,44 @@
+# GovKit-CA
+
+GovKit-CA is a Ruby gem that provides easy access to Canadian civic data around the web. It currently provides an API for free postal code to electoral district lookups, using the following sources:
+
+* [elections.ca](http://elections.ca/)
+* [cbc.ca](http://www.cbc.ca/)
+* [ndp.ca](http://www.ndp.ca/)
+* [digital-copyright.ca](http://www.digital-copyright.ca/)
+* [liberal.ca](http://www.liberal.ca/)
+
+GovKit-CA follows from [Participatory Politics Foundation](http://www.participatorypolitics.org/)'s [GovKit](https://github.com/opengovernment/govkit) gem. GovKit-CA is not affiliated with the Participatory Politics Foundation or GovKit.
+
+# Installation
+
+    gem install govkit
+
+# Examples
+
+    >> require 'govkit-ca'
+
+    >> GovKit::CA::PostalCode.find_electoral_districts_by_postal_code('A1A1A1')
+    => [10007]
+    >> GovKit::CA::PostalCode.find_electoral_districts_by_postal_code('K0A1K0')
+    => [35087, 35025, 35052, 35012, 35040, 35063, 35064]
+
+    >> GovKit::CA::PostalCode.find_province_by_postal_code('A1A1A1')
+    => "Newfoundland and Labrador"
+    >> GovKit::CA::PostalCode.find_province_by_postal_code('K0A1K0')
+    => "Ontario"
+
+Postal codes may contain lowercase letters. Spaces and non-alphanumeric characters are removed before processing.
+
+GovKit-CA will raise GovKit::CA::ResourceNotFound if the electoral districts within a postal code cannot be determined.
+
+# Bugs? Questions?
+
+Govkit-CA's main repository is on GitHub: [http://github.com/jpmckinney/govkit-ca](http://github.com/jpmckinney/govkit-ca), where your contributions, forks, bug reports, feature requests, and feedback are greatly welcomed.
+
+# TODOs
+
+* Write tests
+* Add a `ElectoralDistrict` class to convert IDs to English and french names.
+
+Copyright (c) 2011 James McKinney, released under the MIT license

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+require File.expand_path('../tasks/rid_to_edid', __FILE__)

data/USAGE

@@ -0,0 +1 @@
+See README.md for full usage details.

data/govkit-ca.gemspec

@@ -0,0 +1,27 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "gov_kit-ca/version"
+
+Gem::Specification.new do |s|
+  s.name        = "govkit-ca"
+  s.version     = GovKit::CA::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["James McKinney"]
+  s.email       = ["james@slashpoundbang.com"]
+  s.homepage    = "http://github.com/jpmckinney/govkit-ca"
+  s.summary     = %q{Easy access to Canadian civic data around the web}
+  s.description = %q{GovKit-CA lets you quickly get encapsulated Ruby objects for Canadian civic data.}
+
+  s.rubyforge_project = "govkit-ca"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  #s.add_runtime_dependency('graticule', '>= 0.2.8')
+  s.add_runtime_dependency('httparty', '>= 0.6.1')
+  s.add_runtime_dependency('nokogiri', '>= 1.4.4')
+  s.add_runtime_dependency('yajl-ruby', '>= 0.7.8')
+  s.add_development_dependency('rspec', '>= 2')
+end

data/lib/data/rid_to_edid.yml

@@ -0,0 +1,309 @@
+---
+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/lib/gov_kit-ca.rb

@@ -0,0 +1,18 @@
+$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__))) unless $LOAD_PATH.include?(File.expand_path(File.dirname(__FILE__)))
+
+require 'json'
+require 'yaml'
+
+#require 'graticule'
+require 'httparty'
+require 'nokogiri'
+require 'yajl'
+
+module GovKit
+  module CA
+    autoload :PostalCode, 'gov_kit-ca/postal_code'
+
+    class GovKitError < StandardError; end
+    class ResourceNotFound < GovKitError; end
+  end
+end

data/lib/gov_kit-ca/postal_code.rb

@@ -0,0 +1,68 @@
+require 'gov_kit-ca/postal_code/strategy'
+
+module GovKit
+  module CA
+    # A collection of postal code helpers.
+    # @see http://en.wikipedia.org/wiki/Postal_codes_in_Canada Postal codes in Canada
+    module PostalCode
+      # Returns the electoral districts within a postal code.
+      #
+      # Statistics Canada charges for its Postal Codes by Federal Ridings File
+      # (PCFRF). A free alternative requires scraping data from other sources.
+      #
+      # @param [String] postal_code a postal code
+      # @return [Array<Fixnum>] the electoral districts within the postal code
+      # @raise [ResourceNotFound] if the electoral districts cannot be determined
+      # @see http://www.statcan.gc.ca/bsolc/olc-cel/olc-cel?lang=eng&catno=92F0193X Statistics Canada's product page for the Postal Codes by Federal Ridings File (PCFRF)
+      def self.find_electoral_districts_by_postal_code(postal_code)
+        StrategySet.run format_postal_code(postal_code)
+      end
+
+      # Returns the province that a postal code belongs to.
+      # @param [String] postal_code a postal code
+      # @return [String] the province that the postal code belongs to
+      # @raise [ResourceNotFound] if the province cannot be determined
+      # @see http://en.wikipedia.org/wiki/List_of_postal_codes_in_Canada List of postal codes in Canada
+      def self.find_province_by_postal_code(postal_code)
+        case format_postal_code(postal_code)
+        when /\AA/
+          'Newfoundland and Labrador'
+        when /\AB/
+          'Nova Scotia'
+        when /\AC/
+          'Prince Edward Island'
+        when /\AE/
+          'New Brunswick'
+        when /\A[GHJ]/
+          'Quebec'
+        when /\A[KLMNP]/
+          'Ontario'
+        when /\AR/
+          'Manitoba'
+        when /\AS/
+          'Saskatchewan'
+        when /\AT/
+          'Alberta'
+        when /\AV/
+          'British Columbia'
+        # http://en.wikipedia.org/wiki/List_of_X_postal_codes_of_Canada
+        when /\AX0[ABC]/
+          'Nunavut'
+        when /\AX0[EG]/, /\AX1A/
+          'Northwest Territories'
+        when /\AY/
+          'Yukon'
+        else
+          raise ResourceNotFound, "The province cannot be determined from the postal code"
+        end
+      end
+
+      # Formats a postal code as A1A1A1. Removes non-alphanumeric characters.
+      # @param [String] postal_code a postal code
+      # @return [String] a formatted postal code
+      def self.format_postal_code(postal_code)
+        postal_code.upcase.gsub(/[^A-Z0-9]/, '')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,45 @@
+module GovKit
+  module CA
+    module PostalCode
+      # The set of postal code to electoral district strategies.
+      class StrategySet
+        # Stores the strategy set.
+        # @return [Array<Strategy::Base>] the strategy set
+        def self.strategies
+          @@strategies ||= []
+        end
+
+        # Adds a strategy to the strategy set.
+        # @param [Strategy::Base] strategy a strategy
+        # @return [Array<Strategy::Base>] the strategy set
+        def self.register(strategy)
+          strategies << strategy
+        end
+
+        # Runs through the strategies in order of registration. Returns the
+        # output of the first strategy to successfully determine electoral
+        # districts from a postal code.
+        # @param [String] postal_code a postal code
+        # @return [Array<Fixnum>] the electoral districts within the postal code
+        # @raise [ResourceNotFound] if no strategy succeeds
+        def self.run(postal_code)
+          strategies.each do |strategy|
+            electoral_districts = strategy.new(postal_code).electoral_districts
+            return electoral_districts if electoral_districts
+          end
+
+          raise ResourceNotFound
+        end
+      end
+    end
+  end
+end
+
+require 'gov_kit-ca/postal_code/strategy/base'
+require 'gov_kit-ca/postal_code/strategy/elections-ca'
+require 'gov_kit-ca/postal_code/strategy/cbc-ca'
+require 'gov_kit-ca/postal_code/strategy/ndp-ca'
+require 'gov_kit-ca/postal_code/strategy/digital_copyright-ca'
+require 'gov_kit-ca/postal_code/strategy/liberal-ca'
+#require 'gov_kit-ca/postal_code/strategy/parl-gc-ca'
+#require 'gov_kit-ca/postal_code/strategy/conservative-ca'

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

@@ -0,0 +1,45 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # Abstract class for implementing postal code to electoral district
+        # strategies.
+        #
+        # The following methods must be implemented in sub-classes:
+        #
+        # * `electoral_districts!`
+        class Base
+          include HTTParty
+          follow_redirects false
+          headers 'User-Agent' => 'GovKit-CA +http://govkit.org'
+
+          # Creates a new postal code to electoral district strategy.
+          # @param [String] postal_code a postal code
+          def initialize(postal_code)
+            @postal_code = postal_code
+          end
+
+          # Returns the electoral districts within a postal code.
+          # @return [Array<Fixnum>] the electoral districts within the postal code
+          def electoral_districts
+            valid? && electoral_districts!.map(&:to_i)
+          end
+
+        private
+
+          # Returns the electoral districts within a postal code, without
+          # passing validation first.
+          # @return [Array<Fixnum>] the electoral districts within the postal code
+          def electoral_districts!
+            raise NotImplementedError
+          end
+
+          # @return [Boolean] whether the electoral districts can be determined
+          def valid?
+            true
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # cbc.ca ought to be a reliable source. It is unknown if its database
+        # is kept up-to-date between elections, however.
+        # @see https://github.com/danielharan/pc_scraper
+        class CbcCa < Base
+          base_uri 'www.cbc.ca'
+
+          def initialize(postal_code)
+            @fsa, @letter, @ldu = postal_code.downcase.match(/\A((.).{2})(.{3})\Z/)[1..3]
+            super
+          end
+
+          def json_response # Yajl barfs on bad encoding
+            Yajl::Parser.parse(response.parsed_response) rescue JSON.parse(response.parsed_response)
+          end
+
+        private
+
+          def electoral_districts!
+            json_response.map{|x| self.class.rid_to_edid[x['rid']]}
+          end
+
+          def valid?
+            !!response.headers['expires']
+          end
+
+          def response
+            @response ||= self.class.get "/news/canadavotes/myriding/postalcodes/#{@letter}/#{@fsa}/#{@ldu}.html"
+          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('../../../../data/rid_to_edid.yml', __FILE__))
+          end
+        end
+
+        StrategySet.register CbcCa
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # conservative.ca seems unreliable. In the case of B0J2L0, for example,
+        # it does not return three ridings like other sources.
+        class ConservativeCa < Base
+          base_uri 'www.conservative.ca'
+
+        private
+
+          def electoral_districts!
+            # TODO returns HTML with electoral district names only
+          end
+
+          def valid?
+            # TODO
+          end
+
+          def response
+            @response ||= self.class.get "/?section_id=1051&postal_code=#{@postal_code}"
+          end
+        end
+
+        StrategySet.register ConservativeCa
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        class DigitalCopyrightCa < Base
+          base_uri 'www.digital-copyright.ca'
+
+        private
+
+          def electoral_districts!
+            Nokogiri::HTML(response.parsed_response).css('.node .content a').map{|a| a[:href][/\d+\Z/]}
+          end
+
+          def valid?
+            !response.parsed_response.match /\binvalid postal code\b/
+          end
+
+          def response
+            @response ||= self.class.get "/edid/postal?postalcode=#{@postal_code}"
+          end
+        end
+
+        StrategySet.register DigitalCopyrightCa
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # elections.ca is a reliable source, but it does not return electoral
+        # districts for postal codes that contain multiple electoral districts.
+        # @see https://github.com/danielharan/postal_code_to_edid_webservice
+        class ElectionsCa < Base
+          base_uri 'elections.ca'
+
+        private
+
+          def electoral_districts!
+            [ response.headers['location'][/&ED=(\d{5})&/, 1] ]
+          end
+
+          def valid?
+            !!response.headers['location']
+          end
+
+          def response
+            @response ||= self.class.head "/scripts/pss/FindED.aspx?PC=#{@postal_code}"
+          end
+        end
+
+        StrategySet.register ElectionsCa
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        class LiberalCa < Base
+          base_uri 'www.liberal.ca'
+
+        private
+
+          def electoral_districts!
+            Nokogiri::HTML(response.parsed_response).css('img.RidingListImage').map{|img| img[:src][/\d{5}/]}
+          end
+
+          def valid?
+            !response.parsed_response.match /\bOopsies!/
+          end
+
+          def response
+            @response ||= self.class.get "/riding/postal/#{@postal_code}/"
+          end
+        end
+
+        StrategySet.register LiberalCa
+      end
+    end
+  end
+end

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

@@ -0,0 +1,29 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # ndp.ca does not return electoral districts for postal codes that
+        # contain multiple electoral districts.
+        class NDPCa < Base
+          base_uri 'www.ndp.ca'
+
+        private
+
+          def electoral_districts!
+            [ response.headers['location'][/\d+\Z/] ]
+          end
+
+          def valid?
+            response.headers['location'] != 'http://www.ndp.ca/'
+          end
+
+          def response
+            @response ||= self.class.head "http://www.ndp.ca/riding/#{@postal_code}"
+          end
+        end
+
+        StrategySet.register NDPCa
+      end
+    end
+  end
+end

data/lib/gov_kit-ca/postal_code/strategy/parl-gc-ca.rb

@@ -0,0 +1,29 @@
+module GovKit
+  module CA
+    module PostalCode
+      module Strategy
+        # parl.gc.ca seems unreliable. In the case of K0A1K0, for example, it
+        # does not return seven ridings like other sources.
+        class ParlGcCa < Base
+          base_uri 'www2.parl.gc.ca'
+
+        private
+
+          def electoral_districts!
+            # TODO returns HTML with electoral district names only
+          end
+
+          def valid?
+            # TODO
+          end
+
+          def response
+            @response ||= self.class.get "/parlinfo/Compilations/HouseOfCommons/MemberByPostalCode.aspx?PostalCode=#{@postal_code}"
+          end
+        end
+
+        StrategySet.register ParlGcCa
+      end
+    end
+  end
+end

data/lib/gov_kit-ca/version.rb

@@ -0,0 +1,5 @@
+module GovKit
+  module CA
+    VERSION = "0.0.1"
+  end
+end

data/lib/govkit-ca.rb

@@ -0,0 +1 @@
+require 'gov_kit-ca'

data/spec/postal_code_spec.rb

@@ -0,0 +1,3 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+# TODO

data/spec/spec.opts

@@ -0,0 +1,5 @@
+--colour
+--format nested
+--loadby mtime
+--reverse
+--backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,3 @@
+require 'rubygems'
+require 'rspec'
+require File.dirname(__FILE__) + '/../lib/gov_kit-ca'

data/tasks/rid_to_edid.rb

@@ -0,0 +1,136 @@
+require 'csv'
+require 'open-uri'
+require File.expand_path('../../lib/gov_kit-ca', __FILE__)
+
+# http://www.digital-copyright.ca/pcfrf/pcfrf.tgz contains
+# `postal-code-for-districts.csv`, "which is 308 postal codes that should
+# map to each of the 308 different electoral districts." However, six of the
+# postal codes are invalid (G0A2C0, J8M1R8, J0W1B0, J0B1H0, L0J1B0, N2A1A3),
+# 14 are duplicate, and the remaining 294 map to 246 electoral districts.
+desc "Picks the set cover for postal codes to cbc.ca riding IDs"
+task :trim_postal_codes do |t,args|
+  abort "Usage: rake #{t.name} file=postal-codes-for-districts.csv" unless args[:file]
+
+  # Get the riding IDs that each postal code covers
+  postal_to_rid = {}
+  File.read(args[:file]).split("\n").uniq.each do |postal_code| # Remove duplicate postal codes
+    begin
+      postal_to_rid[postal_code] = GovKit::CA::PostalCode::Strategy::CbcCa.new(postal_code).json_response.map{|hash| hash['rid'].to_i}
+    rescue JSON::ParserError => e # Ignore invalid postal codes
+      puts "ERROR: #{postal_code} is invalid"
+    end
+  end
+
+  # Get the minimum number of postal codes to cover all riding IDs. This is an
+  # instance of the set cover problem, which is NP-complete. We use the greedy
+  # algorithm, which is the best-possible polynomial time approximation
+  # algorithm for set cover. http://en.wikipedia.org/wiki/Set_cover_problem
+  postal_codes = []
+  until postal_to_rid.empty?
+    postal_code, rids = postal_to_rid.find{|k,v| v.size == postal_to_rid.map{|k,v| v.size}.max}
+    postal_to_rid.each{|k,v| postal_to_rid[k] -= rids}
+    postal_to_rid.reject!{|k,v| v.empty?}
+    postal_codes << postal_code
+  end
+
+  puts postal_codes.sort
+end
+
+# Use https://github.com/danielharan/pc_scraper/raw/master/data/index.csv and
+# https://github.com/danielharan/canadian-postal-code-to-electoral-districts/raw/master/pc_edid.yml
+# The YAML file may contain invalid postal codes, e.g. M5V1L6, and does not
+# contain every electoral district, e.g. 35061. 35061 corresponds to riding ID
+# 168, which contains the postal code L1H1X8.
+desc "Generates postal codes within the given list of cbc.ca riding IDs"
+task :riding_id_to_postal_code do |t,args|
+  abort "Usage: rake #{t.name} file=riding-ids.csv csv=index.csv yml=pc_edid.yml" unless args[:file] && args[:csv] && args[:yml]
+
+  # The YML file maps postal codes to electoral districts
+  yml = YAML.load_file(args[:yml])
+
+  # Get an old map of riding IDs to electoral districts
+  rid_to_edid = {}
+  CSV.foreach(args[:csv]) do |row|
+    rid_to_edid[row[1]] = row[0]
+  end
+
+  # Map riding IDs to postal codes
+  rid_to_postal = {}
+  File.read(args[:file]).split("\n").each do |riding_id|
+    match = yml.find{|k,v| v == rid_to_edid[riding_id]}
+    if match
+      rid_to_postal[riding_id] = match[0]
+    else
+      puts "ERROR: No postal code for riding ID #{riding_id}, electoral district #{rid_to_edid[riding_id]}"
+    end
+  end
+
+  puts rid_to_postal.values.sort
+end
+
+# Pass postal-code-for-districts.csv from http://www.digital-copyright.ca/pcfrf/pcfrf.tgz
+# through `rake trim_postal_codes`. This rake task will print a list of riding
+# IDs which none of the given postal codes belong to. Pass this list through
+# `rake riding_id_to_postal_code` to get a list of postal codes belonging to
+# those riding IDs. Manually add postal codes for any remaining riding IDs.
+desc "Generates YAML mapping cbc.ca riding IDs to electoral districts"
+task :riding_id_to_electoral_district do |t,args|
+  abort "Usage: rake #{t.name} file=postal-codes-for-districts.csv" unless args[:file]
+
+  def transliterate_elections_ca(string)
+    {
+      /\342\200\223/   => '-',
+      /\303\242/       => 'a',
+      /\303[\251\250]/ => 'e',
+      /\303\264/       => 'o',
+      /\303\211/       => 'E',
+      /\303\216/       => 'I',
+    }.reduce(string) do |string,map|
+      string.gsub(map[0], map[1])
+    end
+  end
+
+  # Map electoral district names to electoral district IDs
+  name_to_edid = {}
+  doc = Nokogiri::HTML(open("http://www.elections.ca/content.aspx?section=res&dir=cir/list&document=index&lang=e").read)
+  doc.css('sup').remove
+  edids = doc.css('table[summary^="List"] th.normal').map{|x| x.text.to_i}
+  doc.css('table[summary^="List"] th.normal + td').map{|x| x.text.gsub(/\s+/, ' ').strip}.each_with_index do |name,index|
+    name_to_edid[transliterate_elections_ca(name)] = edids[index]
+  end
+
+  def transliterate_cbc_ca(string)
+    {
+      / - /            => '-',
+      /\342/           => 'a',
+      /[\350\351]/     => 'e',
+      /\364/           => 'o',
+      /\311/           => 'E',
+      /\316/           => 'I',
+    }.reduce(string) do |string,map|
+      string.gsub(map[0], map[1])
+    end
+  end
+
+  # Map electoral district names to riding IDs
+  name_to_rid = {}
+  File.read(args[:file]).split("\n").each do |postal_code|
+    GovKit::CA::PostalCode::Strategy::CbcCa.new(postal_code).json_response.each do |hash|
+      name_to_rid[transliterate_cbc_ca(hash['name'])] = hash['rid'].to_i
+    end
+  end
+
+  # Can we generate a complete mapping?
+  missing = name_to_edid.keys - name_to_rid.keys
+  unless missing.empty?
+    abort "The postal codes in #{args[:file]} do not cover #{missing.size} electoral districts:\n#{missing.sort.join("\n")}\n\nThe missing cbc.ca riding IDs are:\n#{([*1..308] - name_to_rid.map{|k,v| v}.flatten).sort.join("\n")}"
+  end
+
+  # Map riding IDs to electoral districts
+  rid_to_edid = {}
+  name_to_edid.keys.each do |name|
+    rid_to_edid[name_to_rid[name]] = name_to_edid[name]
+  end
+
+  puts rid_to_edid.to_yaml
+end

metadata

@@ -0,0 +1,148 @@
+--- !ruby/object:Gem::Specification 
+name: govkit-ca
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- James McKinney
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-01 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 4
+        version: 1.4.4
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 8
+        version: 0.7.8
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        version: "2"
+  type: :development
+  version_requirements: *id004
+description: GovKit-CA lets you quickly get encapsulated Ruby objects for Canadian civic data.
+email: 
+- james@slashpoundbang.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- USAGE
+- govkit-ca.gemspec
+- lib/data/rid_to_edid.yml
+- lib/gov_kit-ca.rb
+- lib/gov_kit-ca/postal_code.rb
+- lib/gov_kit-ca/postal_code/strategy.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
+- lib/gov_kit-ca/postal_code/strategy/liberal-ca.rb
+- lib/gov_kit-ca/postal_code/strategy/ndp-ca.rb
+- lib/gov_kit-ca/postal_code/strategy/parl-gc-ca.rb
+- lib/gov_kit-ca/version.rb
+- lib/govkit-ca.rb
+- spec/postal_code_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- tasks/rid_to_edid.rb
+has_rdoc: true
+homepage: http://github.com/jpmckinney/govkit-ca
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: govkit-ca
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Easy access to Canadian civic data around the web
+test_files: 
+- spec/postal_code_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb