twfy 1.0.1 → 1.1.0

metadata

@@ -1,95 +1,175 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: twfy
-version: !ruby/object:Gem::Version 
-  version: 1.0.1
+version: !ruby/object:Gem::Version
+  version: 1.1.0
 platform: ruby
-authors: 
-- Bruce Williams
+authors:
+- Tom Hipkin
 - Martin Owen
+- Bruce Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2008-08-03 00:00:00 +01:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: json
+date: 2013-11-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
-- !ruby/object:Gem::Dependency 
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
   name: paginator
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
   type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
-    version: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.2'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
   type: :development
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.7.0
-    version: 
-description: Ruby library to interface with the TheyWorkForYou API. TheyWorkForYou.com is  "a non-partisan, volunteer-run website which aims to make it easy for people to keep tabs on their elected and unelected representatives in Parliament."
-email: bruce@codefluency.com
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby library to interface with the TheyWorkForYou API.
+email:
+- brwcodes@gmail.com
+- tomhipkin@gmail.com
 executables: []
-
 extensions: []
-
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-files: 
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
 - History.txt
-- Manifest.txt
-- README.txt
+- LICENSE.txt
+- README.md
 - Rakefile
-- lib/data_element.rb
 - lib/twfy.rb
-- test/test_twfy.rb
-- test/test_twfy_chain.rb
-- test/api_key
-has_rdoc: true
-homepage: http://twfy.rubyforge.org
+- lib/twfy/api.rb
+- lib/twfy/client.rb
+- lib/twfy/commands.rb
+- lib/twfy/constituency.rb
+- lib/twfy/data_element.rb
+- lib/twfy/geometry.rb
+- lib/twfy/mp.rb
+- lib/twfy/validation.rb
+- lib/twfy/version.rb
+- test/fixtures/vcr_cassettes/client_test.yml
+- test/fixtures/vcr_cassettes/data_element_test.yml
+- test/lib/twfy/client_test.rb
+- test/lib/twfy/data_element_test.rb
+- test/test_helper.rb
+- twfy.gemspec
+homepage: http://github.com/bruce/twfy
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
-rdoc_options: 
-- --main
-- README.txt
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: twfy
-rubygems_version: 1.2.0
+rubyforge_project: 
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 2
-summary: Ruby library to interface with the TheyWorkForYou(.com) API; an information source on Parliament
-test_files: 
-- test/test_twfy.rb
-- test/test_twfy_chain.rb
+specification_version: 4
+summary: Ruby library to interface with the TheyWorkForYou API. TheyWorkForYou.com
+  is a non-partisan, volunteer-run website which aims to make it easy for people to
+  keep tabs on their elected and unelected representatives in Parliament.
+test_files:
+- test/fixtures/vcr_cassettes/client_test.yml
+- test/fixtures/vcr_cassettes/data_element_test.yml
+- test/lib/twfy/client_test.rb
+- test/lib/twfy/data_element_test.rb
+- test/test_helper.rb

data/Manifest.txt

@@ -1,9 +0,0 @@
-History.txt
-Manifest.txt
-README.txt
-Rakefile
-lib/data_element.rb
-lib/twfy.rb
-test/test_twfy.rb
-test/test_twfy_chain.rb
-test/api_key

data/README.txt

@@ -1,108 +0,0 @@
-twfy
-    by Bruce Williams (http://codefluency.com)
-    and Martin Owen (http://martinowen.net)
-
-== DESCRIPTION:
-  
-Ruby library to interface with the TheyWorkForYou API.
-
-From their website:
-
-"TheyWorkForYou.com is a non-partisan, volunteer-run website which aims to make it easy
-for people to keep tabs on their elected and unelected representatives in Parliament."
-
-== FEATURES/PROBLEMS:
-  
-All services [currently] provided by the API are supported.
-
-The Ruby API closely mirrors that of TWFY, with the exception that the client
-methods are in lowercase and don't include the 'get' prefix.
-
-Some examples:
-
-getComments:: comments
-getMPs:: mps
-getMPInfo:: mp_info
-
-Please submit bug reports to the RubyForge tracker via the project's homepage at
-http://rubyforge.org/projects/twfy
-
-== SYNOPSIS:
-
-Use is very easy.  
-
-=== Get a Client
-
-  require 'twfy'
-  client = Twfy::Client.new(<YOUR API KEY HERE>)
-
-Note that the Twfy::Client constructor in version 1.0.1 of the binding requires an API Key
-string. If you don't have one they are available at http://www.theyworkforyou.com/api/key
-
-=== Call API methods directly on client
-
-  puts client.constituency(:postcode=>'IP6 9PN').name
-  # => Central Suffolk & North Ipswich
-
-  mp = client.mp(:postcode=>'IP6 9PN')
-  puts mp.full_name
-  # => Michael Lord
-
-  # Get a *lot* of info about this MP
-  info = client.mp_info(:id=>mp.person_id)
-
-  # Get a sorted list of all the parties in the House of Lords
-  client.lords.map{|l| l.party}.uniq.sort
-	#=> ["Bishop", "Conservative", "Crossbench", "DUP", "Green", "Labour", "Liberal Democrat", "Other"]
-
-  # Get number of debates in the House of Commons mentioning 'Iraq'
-  number = client.debates(:type=>'commons',:search=>'Iraq').info['total_results']
-
-=== Daisy chaining
-
-A few methods on the client return non-OpenStruct instances that support daisy chaining.  Using these to access related data more naturally (with caching).
-
-Here are some examples
-
-  # Get the MP for the last constituency (if you sort them alphabetically) 
-  mp = client.constituencies.sort_by{|c| c.name }.last.mp
-  # get the geometry information for that constituency (coming from the MP)
-  geometry = mp.constituency.geometry
-
-  # An overkill example showing caching (no services are called here, since
-  # the results have already been cached from above)
-  mp = mp.constituency.mp.constituency.geometry.constituency.mp
-
-  # These return equivalent results (Note how much easier the first is)
-  info1 = mp.info # this is cached for subsequent calls
-  info2 = client.mp_info(:id=>mp.person_id)
-
-  # Get pages of debates mentioning 'medicine'
-  debates1 = mp.debates(:search=>'medicine')
-  debates2 = mp.debates(:search=>'medicine', :page=>2)
-  
-See http://www.theyworkforyou.com/api/docs for API documentation.
-
-Please note that data pulled from the API is licensed separately;
-see the LICENSE portion of this README for further details.
-
-== REQUIREMENTS:
-
-+ json library (available as a gem)
-
-== INSTALL:
-
-No special instructions.
-
-== LICENSE:
-
-This library uses the MIT License
-Copyright (c) 2006 Bruce Williams
-
-Data is licensed separately:
-
-The TheyWorkForYou license statement, from their website (http://www.theyworkforyou.com/api/), is:
-
-To use parliamentary material yourself (that's data returned from getDebates, getWrans, and getWMS), you will need to get a Parliamentary Licence from the Office of Public Sector Information. Our own data - lists of MPs, Lords, constituencies and so on - is available under the Creative Commons Attribution-ShareAlike license version 2.5.
-
-Non-commercial use is free, please contact us for commercial use.

data/lib/data_element.rb

@@ -1,101 +0,0 @@
-require 'uri'
-require 'date'
-
-module Twfy
-  
-  class DataElement
-    @@conversions = {}
-    class << self
-      def convert(*fields,&block)
-        fields.each do |field|
-          @@conversions[field] = block 
-        end
-      end
-      def convert_to_date(*fields)
-        fields.each do |field|
-          convert field do |d|
-            Date.parse(d)
-          end
-        end
-      end
-    end
-    
-    attr_reader :client
-    def initialize(client, data={})
-      @client = client
-      data.each do |field,value|
-        instance_variable_set("@#{field}", convert(field, value))
-        unless self.respond_to?(field)
-          self.class.send(:define_method, field) do
-            instance_variable_get("@#{field}")
-          end
-        end
-      end
-    end
-    
-    def convert(field, value)
-      if conversion = @@conversions[field.to_sym]
-        args = [value]
-        args.unshift self if conversion.arity == 2
-        conversion.call(*args)
-      else
-        value
-      end
-    end
-    
-  end
-  
-  class MP < DataElement
-    
-    convert_to_date :entered_house, :left_house
-    convert :image do |value|
-      URI.parse("http://theyworkforyou.com#{value}")
-    end
-    convert :constituency do |source,value|
-      Constituency.new(source.client, :name => value, :mp => source)
-    end
-    
-    def in_office?
-      @left_reason == 'still_in_office'
-    end
-    
-    def info
-      @info ||= @client.mp_info(:id => @person_id)
-    end
-    
-    def debates(params={})
-      @debates ||= {}
-      @debates[params] ||= @client.debates(params.merge(:person=>@person_id, :type=>'commons'))
-    end
-    
-    def comments(params={})
-      @comments ||= {}
-      @comments[params] ||= @client.comments(params.merge(:pid=>@person_id))
-    end
-    
-  end
-  
-  class Constituency < DataElement
-    
-    def initialize(*args)
-      super
-    end
-    def geometry
-      @geometry ||= @client.geometry(:name=>@name)
-    end
-    
-    def mp
-      @mp ||= @client.mp(:constituency=>@name)
-    end
-    
-  end
-  
-  class Geometry < DataElement
-    
-    convert :constituency do |source,value|
-      Constituency.new(source.client, :name => value, :geometry => source)
-    end
-    
-  end
-  
-end

data/test/api_key

@@ -1 +0,0 @@
-B47i8vFYfgWvAa89eYErLWPF