whos_got_dirt 0.0.2

data/spec/cassettes/poderopedia_entity.yml

@@ -0,0 +1,43 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: http://api.poderopedia.org/visualizacion/search?alias=juan&entity=persona&user_key=dd88190daab4754b60b77c5db71b4e96
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Faraday v0.9.1
+  response:
+    status:
+      code: 200
+      message: 
+    headers:
+      date:
+      - Mon, 19 Oct 2015 19:48:08 GMT
+      server:
+      - Apache/2.2.15 (CentOS)
+      x-powered-by:
+      - web2py
+      expires:
+      - Mon, 19 Oct 2015 19:48:09 GMT
+      pragma:
+      - no-cache
+      cache-control:
+      - no-store, no-cache, must-revalidate, post-check=0, pre-check=0
+      set-cookie:
+      - session_id_api=198.48.204.118-b57a83b1-b473-40bd-a0eb-87db8846f187; Path=/
+      content-length:
+      - '3249'
+      connection:
+      - close
+      content-type:
+      - text/html; charset=utf-8
+    body:
+      encoding: UTF-8
+      string: |
+        {"person": [{"shortBio": "Abogado. Actual senador de la Uni\u00f3n Dem\u00f3crata Independiente (UDI) por la Circunscripci\u00f3n X, VII Regi\u00f3n del Maule desde 2002 por dos periodos consecutivos. \r\nAntes hab\u00eda sido diputado por el Distrito N\u00b0 31 (Alhu\u00e9, Curacav\u00ed, El Monte, Isla de Maipo, Mar\u00eda Pinto Melipilla, Pe\u00f1aflor, San Pedro y Talagante) durante tres periodos legislativos desde desde 1990 a 2002. En el a\u00f1o 2008 fue elegido presidente de su partido.  Hermano de Fernando Coloma, superintendente de Valores y Seguros durante el Gobierno de Sebasti\u00e1n Pi\u00f1era, y de Pablo Coloma, militante PPD que lider\u00f3 el Fosis bajo la presidencia de Michelle Bachelet. Su hijo Juan Antonio Coloma \u00c1lamos fue jefe territorial del ex ministro de Obras P\u00fablicas, Laurence Golborne, despu\u00e9s ejerci\u00f3 el mismo cargo en el comando del ex candidato presidencial de la UDI, Pablo Longueira y actualmente es diputado por el distrito 31. El senador Coloma est\u00e1 casado con Mar\u00eda Cecilia \u00c1lamos, hermana de Jimena \u00c1lamos, esposa del diputado UDI Ernesto Silva.", "id": 2657, "alias": "Juan Antonio Coloma"}, {"shortBio": "Senador del Partido Socialista por la 9\u00aa Circunscripci\u00f3n, Regi\u00f3n de O`Higgins,\r\ndesde 2006 a la fecha por dos periodos consecutivos. Diputado por el Distrito N\u00ba 33, Regi\u00f3n de O'Higgins, por cuatro periodo consecutivos, entre 1990 y 2006. Es hijo del ex canciller y\r\nex embajador chileno en Washington DC, Orlando Letelier del Solar, quien fue asesinado por agentes de la Direcci\u00f3n de Inteligencia Nacional (DINA), el 21 de septiembre de 1976 en Washington DC, Estados Unidos.\r\n\r\n", "id": 2671, "alias": "Juan Pablo Letelier"}, {"shortBio": "Abogado. Hijo del senador y ex presidente de la UDI, Juan Antonio Coloma. Es diputado por el Distrito N\u00ba 31, Regi\u00f3n Metropolitana (Alhue, Curacav\u00ed, El Monte, Isla De Maipo, Mar\u00eda Pinto, Melipilla, Padre Hurtado, Pe\u00f1aflor, San Pedro, Talagante), por el per\u00edodo 2014-2018. Participa en las comisiones permanentes de Constituci\u00f3n, Legislaci\u00f3n y Justicia y Derechos Humanos y Pueblos Originarios. Trabaj\u00f3 de forma determinante en el rescate de los 33 mineros atrapados en una mina de Copiap\u00f3, cuando era el hombre de confianza del ex presidenciable Laurence Golborne, llegando a ser su jefe de campa\u00f1a. Dentro de su curr\u00edculo pol\u00edtico, resalta el haber sido por 3 a\u00f1os consecutivos vicepresidente de las Juventud UDI. Adem\u00e1s de ser en el a\u00f1o 2012, la primera mayor\u00eda de la Comisi\u00f3n Pol\u00edtica del gremialismo.", "id": 2713, "alias": "Juan Antonio Coloma \u00c1lamos"}, {"shortBio": null, "id": 2768, "alias": "Juan de Dios Larra\u00edn Matte"}, {"shortBio": null, "id": 2785, "alias": "Juan Andr\u00e9s Prokurica de Las Heras"}, {"shortBio": null, "id": 2796, "alias": "Juan Tuma Masso"}, {"shortBio": null, "id": 2835, "alias": "Juana Guerrero Y\u00e1\u00f1ez"}, {"shortBio": null, "id": 2839, "alias": "Juan Arenas"}, {"shortBio": null, "id": 2889, "alias": "Juan Francisco Calder\u00f3n Quezada"}, {"shortBio": null, "id": 2898, "alias": "Juan Crist\u00f3bal Cardemil Palacios"}]}
+    http_version: 
+  recorded_at: Mon, 19 Oct 2015 19:48:08 GMT
+recorded_with: VCR 2.9.3

data/spec/renderer_spec.rb

@@ -0,0 +1,48 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+module WhosGotDirt
+  RSpec.describe Renderer do
+    describe '#initialize' do
+      it 'should set the template' do
+        expect(Renderer.new('name' => 'John Smith').template).to eq('name' => 'John Smith')
+      end
+    end
+
+    describe '#result' do
+      it 'should render a result' do
+        expect(Renderer.new({
+          'id' => 123,
+          'name' => '/fn',
+          'identifiers' => [{
+            'identifier' => '/id',
+            'scheme' => 'ACME',
+          }],
+          'delete' => '/blank',
+        }).result({
+          'id' => 456,
+          'fn' => 'John Smith',
+          'blank' => nil,
+        })).to eq({
+          'id' => 123,
+          'name' => 'John Smith',
+          'identifiers' => [{
+            'identifier' => 456,
+            'scheme' => 'ACME',
+          }],
+        })
+      end
+
+      it 'should render a result using lambdas' do
+        expect(Renderer.new({
+          'lambda' => lambda{|data|
+            ['key', 'value']
+          },
+        }).result({
+          'lambda' => 123,
+        })).to eq({
+          'key' => 'value',
+        })
+      end
+    end
+  end
+end

data/spec/request_spec.rb

@@ -0,0 +1,205 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+module WhosGotDirt
+  RSpec.describe Request do
+    let :klass do
+      Class.new(Request) do
+        @base_url = 'https://api.example.com/endpoint'
+
+        def to_s
+          "#{base_url}?#{to_query(input)}"
+        end
+
+        def and_operator
+          ','
+        end
+
+        def or_operator
+          '|'
+        end
+      end
+    end
+
+    let :instance do
+      klass.new(q: 'foo', bar: false, baz: nil)
+    end
+
+    describe '.to_query' do
+      it 'should return a query string' do
+        expect(klass.to_query(foo: '/', bar: false, baz: nil)).to eq('foo=%2F&bar=false&baz=')
+      end
+    end
+
+    describe '#initialize' do
+      it 'should set the query and parameters' do
+        expect(instance.input).to eq('q' => 'foo', 'bar' => false, 'baz' => nil)
+      end
+
+      it 'should accept no arguments' do
+        expect{klass.new}.to_not raise_error
+      end
+    end
+
+    describe '.base_url' do
+      it 'should return the base URL' do
+        expect(klass.base_url).to eq('https://api.example.com/endpoint')
+      end
+    end
+
+    describe '#base_url' do
+      it 'should return the base URL' do
+        expect(instance.base_url).to eq('https://api.example.com/endpoint')
+      end
+    end
+
+    describe '#equal' do
+      it 'should return a criterion' do
+        expect(klass.new('source' => 'John Smith').equal('target', 'source')).to eq('target' => 'John Smith')
+      end
+
+      it 'should return a criterion when input is overridden' do
+        expect(klass.new(nil).equal('target', 'source', input: {'source' => 'John Smith'})).to eq('target' => 'John Smith')
+      end
+
+      it 'should return a criterion when value is transformed' do
+        expect(klass.new('source' => 'John Smith').equal('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'JOHN SMITH')
+      end
+
+      it 'should accept valid values' do
+        expect(klass.new('source' => true).equal('target', 'source', valid: [true, false])).to eq('target' => true)
+      end
+
+      it 'should ignore invalid values' do
+        expect(klass.new('source' => 'John Smith').equal('target', 'source', valid: [true, false])).to eq({})
+      end
+    end
+
+    describe '#match' do
+      let :fuzzy do
+        {'source~=' => 'Smith John'}
+      end
+
+      let :exact do
+        fuzzy.merge('source' => 'John Smith')
+      end
+
+      it 'should return a criterion' do
+        expect(klass.new(fuzzy).match('target', 'source')).to eq('target' => 'Smith John')
+      end
+
+      it 'should return a criterion when input is overridden' do
+        expect(klass.new(nil).match('target', 'source', input: fuzzy)).to eq('target' => 'Smith John')
+      end
+
+      it 'should return a criterion when value is transformed' do
+        expect(klass.new(fuzzy).match('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'SMITH JOHN')
+        expect(klass.new(exact).match('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'JOHN SMITH')
+      end
+
+      it 'should prioritize exact match' do
+        expect(klass.new(exact).match('target', 'source')).to eq('target' => 'John Smith')
+      end
+    end
+
+    describe '#one_of' do
+      let :many do
+        {'source|=' => ['one', 'two']}
+      end
+
+      let :one do
+        many.merge('source' => 'three')
+      end
+
+      it 'should return a criterion' do
+        expect(klass.new(many).one_of('target', 'source')).to eq('target' => 'one|two')
+      end
+
+      it 'should return a criterion when input is overridden' do
+        expect(klass.new(nil).one_of('target', 'source', input: many)).to eq('target' => 'one|two')
+      end
+
+      it 'should return a criterion when values are transformed' do
+        expect(klass.new(many).one_of('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'ONE|TWO')
+        expect(klass.new(one).one_of('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'THREE')
+      end
+
+      it 'should prioritize exact match' do
+        expect(klass.new(one).one_of('target', 'source')).to eq('target' => 'three')
+      end
+    end
+
+    describe '#all_of' do
+      let :many do
+        {
+          'a:source' => 'one',
+          'b:source' => 'two',
+        }
+      end
+
+      let :one do
+        many.merge('source' => 'three')
+      end
+
+      it 'should return a criterion' do
+        expect(klass.new(many).all_of('target', 'source')).to eq('target' => 'one,two')
+      end
+
+      it 'should return a criterion when input is overridden' do
+        expect(klass.new(nil).all_of('target', 'source', input: many)).to eq('target' => 'one,two')
+      end
+
+      it 'should return a criterion when values are transformed' do
+        expect(klass.new(many).all_of('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'ONE,TWO')
+        expect(klass.new(one).all_of('target', 'source', transform: lambda{|v| v.upcase})).to eq('target' => 'THREE')
+      end
+
+      it 'should prioritize exact match' do
+        expect(klass.new(one).all_of('target', 'source')).to eq('target' => 'three')
+      end
+    end
+
+    describe '#date_range' do
+      let :strict do
+        {
+          'source>' => '2010-01-02',
+          'source<' => '2010-01-05',
+        }
+      end
+
+      let :nonstrict do
+        strict.merge({
+          'source>=' => '2010-01-03',
+          'source<=' => '2010-01-04',
+        })
+      end
+
+      let :exact do
+        nonstrict.merge({
+          'source' => '2010-01-01',
+        })
+      end
+
+      it 'should return a criterion' do
+        expect(klass.new(strict).date_range('target', 'source')).to eq('target' => '2010-01-02:2010-01-05')
+      end
+
+      it 'should return a criterion when input is overridden' do
+        expect(klass.new(nil).date_range('target', 'source', input: strict)).to eq('target' => '2010-01-02:2010-01-05')
+      end
+
+      it 'should prioritize or-equal dates' do
+        expect(klass.new(nonstrict).date_range('target', 'source')).to eq('target' => '2010-01-03:2010-01-04')
+      end
+
+      it 'should prioritize exact date' do
+        expect(klass.new(exact).date_range('target', 'source')).to eq('target' => '2010-01-01:2010-01-01')
+      end
+    end
+
+    describe '#to_s' do
+      it 'should return the query as a string' do
+        expect(instance.to_s).to eq('https://api.example.com/endpoint?q=foo&bar=false&baz=')
+      end
+    end
+  end
+end

data/spec/requests/entity/corp_watch_spec.rb

@@ -0,0 +1,99 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Entity
+  RSpec.describe CorpWatch do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(CorpWatch.new(name: 'ACME Inc.').to_s).to eq('http://api.corpwatch.org/companies.json?company_name=ACME+Inc.')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'company_name', 'name', ['ACME Inc.', 'Inc. ACME']
+      end
+
+      context 'when given a limit' do
+        include_examples 'equal', 'limit', 'limit', 5
+      end
+
+      context 'when given an IRS identifier' do
+        it 'should return a criterion' do
+          expect(CorpWatch.new({
+            'identifiers' => [{
+              'identifier' => '911653725',
+              'scheme' => 'IRS Employer Identification Number',
+            }],
+          }).convert).to eq('irs_number' => '911653725')
+        end
+      end
+
+      context 'when given an SEC identifier' do
+        it 'should return a criterion' do
+          expect(CorpWatch.new({
+            'identifiers' => [{
+              'identifier' => '37996',
+              'scheme' => 'SEC Central Index Key',
+            }],
+          }).convert).to eq('cik' => '37996')
+        end
+      end
+
+      context 'when given a contact detail' do
+        include_examples 'contact_details', 'raw_address', 'address', ['52 London', 'London 52']
+      end
+
+      context 'when given an API key' do
+        include_examples 'equal', 'key', 'corp_watch_api_key', 123
+      end
+
+      context 'when given an industry code' do
+        include_examples 'equal', 'sic_code', 'industry_code', '2011'
+      end
+
+      context 'when given a sector code' do
+        include_examples 'equal', 'sic_sector', 'sector_code', '4100'
+      end
+
+      context 'when given a "substring_match all" flag' do
+        include_examples 'equal', 'substring_match', 'substring_match', 1, valid: [1]
+      end
+
+      context 'when given a country code' do
+        include_examples 'equal', 'country_code', 'country_code', 'us', transformed: 'US'
+      end
+
+      context 'when given a country subdivision code' do
+        include_examples 'equal', 'subdiv_code', 'subdiv_code', 'or', transformed: 'OR'
+      end
+
+      context 'when given a year' do
+        include_examples 'equal', 'year', 'year', '2005'
+      end
+
+      context 'when given a minimum year' do
+        include_examples 'equal', 'min_year', 'year>=', '2003'
+      end
+
+      context 'when given a maximum year' do
+        include_examples 'equal', 'max_year', 'year<=', '2007'
+      end
+
+      context 'when given a source type' do
+        include_examples 'equal', 'source_type', 'source_type', 'filers'
+      end
+
+      context 'when given a number of children' do
+        include_examples 'equal', 'num_children', 'num_children', 3
+      end
+
+      context 'when given a number of parents' do
+        include_examples 'equal', 'num_parents', 'num_parents', 2
+      end
+
+      context 'when given a root company identifier' do
+        include_examples 'equal', 'top_parent_id', 'top_parent_id', 'cw_7324'
+      end
+    end
+  end
+end

data/spec/requests/entity/little_sis_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Entity
+  RSpec.describe LittleSis do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(LittleSis.new(name: 'ACME Inc.').to_s).to eq('https://api.littlesis.org/entities.xml?q=ACME+Inc.')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'q', 'name', ['ACME Inc.', 'Inc. ACME']
+      end
+
+      context 'when given a classification' do
+        include_examples 'one_of', 'type_ids', 'classification', [1, 2], ','
+      end
+
+      context 'when given a limit' do
+        include_examples 'equal', 'num', 'limit', 5
+      end
+
+      context 'when given an API key' do
+        include_examples 'equal', '_key', 'little_sis_api_key', 123
+      end
+
+      context 'when given a "search all" flag' do
+        include_examples 'equal', 'search_all', 'search_all', 1, valid: [1]
+      end
+    end
+  end
+end

data/spec/requests/entity/open_corporates_spec.rb

@@ -0,0 +1,81 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Entity
+  RSpec.describe OpenCorporates do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(OpenCorporates.new(name: 'ACME Inc.').to_s).to eq('https://api.opencorporates.com/companies/search?q=ACME+Inc.&order=score')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'q', 'name', ['ACME Inc.', 'Inc. ACME']
+      end
+
+      context 'when given a classification' do
+        include_examples 'equal', 'company_type', 'classification', 'Private Limited Company'
+      end
+
+      context 'when given a creation timestamp' do
+        include_examples 'equal', 'created_since', 'created_at>=', '2010-01-01'
+      end
+
+      context 'when given a founding date' do
+        include_examples 'date_range', 'incorporation_date', 'founding_date'
+      end
+
+      context 'when given a founding date' do
+        include_examples 'date_range', 'dissolution_date', 'dissolution_date'
+      end
+
+      context 'when given a contact detail' do
+        include_examples 'contact_details', 'registered_address', 'address', ['52 London', 'London 52']
+      end
+
+      context 'when given a limit' do
+        it 'should return a per-page limit' do
+          expect(OpenCorporates.new('limit' => 5).convert).to eq('per_page' => 5)
+        end
+
+        it 'should override the default authenticated per-page limit' do
+          expect(OpenCorporates.new('limit' => 5, 'open_corporates_api_key' => 123).convert).to eq('per_page' => 5, 'api_token' => 123)
+        end
+      end
+
+      context 'when given an API key' do
+        it 'should return an API key parameter' do
+          expect(OpenCorporates.new('open_corporates_api_key' => 123).convert).to eq('api_token' => 123, 'per_page' => 100)
+        end
+      end
+
+      context 'when given a jurisdiction' do
+        include_examples 'one_of', 'jurisdiction_code', 'jurisdiction_code', ['GB', 'IE'], '|', transformed: ['gb', 'ie']
+      end
+
+      context 'when given a country' do
+        include_examples 'one_of', 'country_code', 'country_code', ['GB', 'IE'], '|', transformed: ['gb', 'ie']
+      end
+
+      context 'when given a status' do
+        include_examples 'equal', 'current_status', 'current_status', 'Dissolved'
+      end
+
+      context 'when given an industry' do
+        include_examples 'one_of', 'industry_codes', 'industry_code', ['be_nace_2008-66191', 'be_nace_2008-66199'], '|'
+      end
+
+      context 'when given an inactivity status' do
+        include_examples 'equal', 'inactive', 'inactive', true, valid: [true, false]
+      end
+
+      context 'when given a branch status' do
+        include_examples 'equal', 'branch', 'branch', true, valid: [true, false]
+      end
+
+      context 'when given a nonprofit status' do
+        include_examples 'equal', 'nonprofit', 'nonprofit', true, valid: [true, false]
+      end
+    end
+  end
+end

data/spec/requests/entity/open_duka_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Entity
+  RSpec.describe OpenDuka do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(OpenDuka.new(name: 'ACME Inc.').to_s).to eq('http://www.openduka.org/index.php/api/search?term=ACME+Inc.')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'term', 'name', ['ACME Inc.', 'Inc. ACME']
+      end
+
+      context 'when given an API key' do
+        include_examples 'equal', 'key', 'open_duka_api_key', 123
+      end
+    end
+  end
+end

data/spec/requests/entity/poderopedia_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Entity
+  RSpec.describe Poderopedia do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(Poderopedia.new(name: 'ACME Inc.').to_s).to eq('http://api.poderopedia.org/visualizacion/search?alias=ACME+Inc.')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'alias', 'name', ['ACME Inc.', 'Inc. ACME']
+      end
+
+      context 'when given an API key' do
+        include_examples 'equal', 'user_key', 'poderopedia_api_key', 123
+      end
+    end
+  end
+end

data/spec/requests/list/little_sis_spec.rb

@@ -0,0 +1,25 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::List
+  RSpec.describe LittleSis do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(LittleSis.new(name: 'forbes').to_s).to eq('https://api.littlesis.org/lists.xml?q=forbes')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'q', 'name', ['forbes', 'forbe']
+      end
+
+      context 'when given a limit' do
+        include_examples 'equal', 'num', 'limit', 5
+      end
+
+      context 'when given an API key' do
+        include_examples 'equal', '_key', 'little_sis_api_key', 123
+      end
+    end
+  end
+end

data/spec/requests/list/open_corporates_spec.rb

@@ -0,0 +1,33 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::List
+  RSpec.describe OpenCorporates do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(OpenCorporates.new(name: 'barclays').to_s).to eq('https://api.opencorporates.com/corporate_groupings/search?q=barclays')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'q', 'name', ['barclays', 'bayclay']
+      end
+
+      context 'when given a limit' do
+        it 'should return a per-page limit' do
+          expect(OpenCorporates.new('limit' => 5).convert).to eq('per_page' => 5)
+        end
+
+        it 'should override the default authenticated per-page limit' do
+          expect(OpenCorporates.new('limit' => 5, 'open_corporates_api_key' => 123).convert).to eq('per_page' => 5, 'api_token' => 123)
+        end
+      end
+
+      context 'when given an API key' do
+        it 'should return an API key parameter' do
+          expect(OpenCorporates.new('open_corporates_api_key' => 123).convert).to eq('api_token' => 123, 'per_page' => 100)
+        end
+      end
+    end
+  end
+end

data/spec/requests/relation/open_corporates_spec.rb

@@ -0,0 +1,53 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module WhosGotDirt::Requests::Relation
+  RSpec.describe OpenCorporates do
+    describe '#to_s' do
+      it 'should return the URL to request' do
+        expect(OpenCorporates.new(subject: [name: 'John Smith']).to_s).to eq('https://api.opencorporates.com/officers/search?q=John+Smith&order=score')
+      end
+    end
+
+    describe '#convert' do
+      context 'when given a name' do
+        include_examples 'match', 'q', 'name', ['Smith John', 'John Smith'], scope: 'subject'
+      end
+
+      context 'when given a birth date' do
+        include_examples 'date_range', 'date_of_birth', 'birth_date', scope: 'subject'
+      end
+
+      context 'when given a contact detail' do
+        include_examples 'contact_details', 'address', 'address', ['52 London', 'London 52'], scope: 'subject'
+      end
+
+      context 'when given a limit' do
+        it 'should return a per-page limit' do
+          expect(OpenCorporates.new('limit' => 5).convert).to eq('per_page' => 5)
+        end
+
+        it 'should override the default authenticated per-page limit' do
+          expect(OpenCorporates.new('limit' => 5, 'open_corporates_api_key' => 123).convert).to eq('per_page' => 5, 'api_token' => 123)
+        end
+      end
+
+      context 'when given an API key' do
+        it 'should return an API key parameter' do
+          expect(OpenCorporates.new('open_corporates_api_key' => 123).convert).to eq('api_token' => 123, 'per_page' => 100)
+        end
+      end
+
+      context 'when given a jurisdiction' do
+        include_examples 'one_of', 'jurisdiction_code', 'jurisdiction_code', ['GB', 'IE'], '|', transformed: ['gb', 'ie']
+      end
+
+      context 'when given a role' do
+        include_examples 'equal', 'position', 'role', 'ceo'
+      end
+
+      context 'when given an inactivity status' do
+        include_examples 'equal', 'inactive', 'inactive', false, valid: [true, false]
+      end
+    end
+  end
+end