ibge-ruby 1.0.2

data/spec/lib/ibge/municipio_spec.rb

@@ -0,0 +1,228 @@
+describe IBGE::Municipio do
+  shared_examples_for 'objeto' do
+    it 'deve retornar o nome Jijoca de Jericoacoara' do
+      expect(subject.nome).to eq('Jijoca de Jericoacoara')
+    end
+
+    it 'deve retornar o ID 2307254' do
+      expect(subject.id).to eq('2307254')
+    end
+
+    it 'deve retornar a microrregião, que é um objeto IBGE::Microrregiao' do
+      expect(subject.microrregiao).to be_an IBGE::Microrregiao
+    end
+  end
+
+  shared_examples_for 'array' do |tamanho|
+    it 'deve retornar um Array<IBGE::Municipio>' do
+      aggregate_failures do
+        is_expected.to be_an Array
+        expect(subject.first).to be_an IBGE::Municipio
+      end
+    end
+  end
+
+  describe '.obter_municipios' do
+    subject do
+      VCR.use_cassette('municipio/obter_municipios') do
+        IBGE::Municipio.obter_municipios
+      end
+    end
+
+    it_has_behavior 'array'
+  end
+
+  describe '.municipios_por_id' do
+    context 'recebendo um array de IDs (["2307254", "2302206"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_id:2307254|2302206', erb: { param: '2307254%7C2302206' }) do
+          IBGE::Municipio.municipios_por_id(%w(2307254 2302206))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID ("2307254") como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_id:2307254', erb: { param: '2307254' }) do
+          IBGE::Municipio.municipios_por_id('2307254')
+        end
+      end
+
+      it_has_behavior 'objeto'
+    end
+  end
+
+  describe '.municipios_por_uf' do
+    context 'recebendo um array de siglas (["BA", "CE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_uf:BA|CE', erb: { param: 'BA%7CCE' }) do
+          IBGE::Municipio.municipios_por_uf(%w(BA CE)).first(20)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([29, 23]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_uf:BA|CE', erb: { param: '29%7C23' }) do
+          IBGE::Municipio.municipios_por_uf([29, 23]).first(20)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (CE) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_uf:CE', erb: { param: 'CE' }) do
+          IBGE::Municipio.municipios_por_uf('CE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (23) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_uf:CE', erb: { param: 23 }) do
+          IBGE::Municipio.municipios_por_uf(23)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.municipios_por_regiao' do
+    context 'recebendo um array de siglas (["N", "NE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao:N|NE', erb: { param: 'N%7CNE' }) do
+          IBGE::Municipio.municipios_por_regiao(%w(N NE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([1, 2]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao:N|NE', erb: { param: '1%7C2' }) do
+          IBGE::Municipio.municipios_por_regiao([1, 2])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao:NE', erb: { param: 2 }) do
+          IBGE::Municipio.municipios_por_regiao(2)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (NE) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao:NE', erb: { param: 'NE' }) do
+          IBGE::Municipio.municipios_por_regiao('NE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.municipios_por_regiao_imediata' do
+    context 'recebendo um array de IDs ([230001, 230002]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao_imediata:230001|230002', erb: { param: '230001%7C230002' }) do
+          IBGE::Municipio.municipios_por_regiao_imediata([230001, 230002])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (230001) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao_imediata:230001', erb: { param: '230001' }) do
+          IBGE::Municipio.municipios_por_regiao_imediata(230001)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.municipios_por_regiao_intermediaria' do
+    context 'recebendo um array de IDs ([2301, 2302]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao_intermediaria:2301|2302', erb: { param: '2301%7C23017' }) do
+          IBGE::Municipio.municipios_por_regiao_intermediaria([2301, 2302])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2301) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_regiao_intermediaria:2301', erb: { param: '2301' }) do
+          IBGE::Municipio.municipios_por_regiao_intermediaria(2301)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.municipios_por_mesorregiao' do
+    context 'recebendo um array de IDs ([2303, 2304]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_mesorregiao:2303|2304', erb: { param: '2303%7C2304' }) do
+          IBGE::Municipio.municipios_por_mesorregiao([2303, 2304])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2303) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_mesorregiao:2303', erb: { param: '2303' }) do
+          IBGE::Municipio.municipios_por_mesorregiao(2303)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.municipios_por_microrregiao' do
+    context 'recebendo um array de IDs ([23016, 23017]) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_microrregiao:23016|23017', erb: { param: '23016%7C23017' }) do
+          IBGE::Municipio.municipios_por_microrregiao([23016, 23017])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (23016) como parâmetro' do
+      subject do
+        VCR.use_cassette('municipio/municipios_por_microrregiao:23016', erb: { param: '23016' }) do
+          IBGE::Municipio.municipios_por_microrregiao(23016)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+end

data/spec/lib/ibge/pais_spec.rb

@@ -0,0 +1,62 @@
+describe IBGE::Pais do
+  shared_examples_for 'pais' do
+    it 'deve retornar o nome Brasil' do
+      expect(subject.first.nome).to eq('Brasil')
+    end
+
+    it 'deve retornar o ID (M49) 76' do
+      expect(subject.first.id['M49']).to eq(76)
+    end
+
+    it 'deve retornar a sigla (ISO-ALPHA-2) BR' do
+      expect(subject.first.id['ISO-ALPHA-2']).to eq('BR')
+    end
+
+    it 'deve retornar América do sul como região intermediária' do
+      expect(subject.first.regiao_intermediaria['nome']).to eq('América do sul')
+    end
+  end
+
+  shared_examples_for 'array' do
+    it 'deve retornar um Array<IBGE::Pais>' do
+      aggregate_failures do
+        is_expected.to be_an Array
+        expect(subject.first).to be_an IBGE::Pais
+      end
+    end
+  end
+
+  describe '.obter_paises' do
+    subject do
+      VCR.use_cassette('pais/obter_paises') do
+        IBGE::Pais.obter_paises
+      end
+    end
+
+    it_has_behavior 'array'
+  end
+
+  describe '.paises_por_identificador' do
+    context 'recebendo um array de IDs ([76, 300]) como parâmetro' do
+      subject do
+        VCR.use_cassette('pais/paises_por_identificador:76|300', erb: { param: '76%7C300' }) do
+          IBGE::Pais.paises_por_identificador([76, 300])
+        end
+      end
+
+      it_has_behavior 'array'
+      it_has_behavior 'pais'
+    end
+
+    context 'recebendo um ID (76) como parâmetro' do
+      subject do
+        VCR.use_cassette('pais/paises_por_identificador:76', erb: { param: 76 }) do
+          IBGE::Pais.paises_por_identificador(76)
+        end
+      end
+
+      it_has_behavior 'array'
+      it_has_behavior 'pais'
+    end
+  end
+end

data/spec/lib/ibge/regiao_imediata_spec.rb

@@ -0,0 +1,162 @@
+describe IBGE::RegiaoImediata do
+  shared_examples_for 'objeto' do
+    it 'deve retornar o nome Fortaleza' do
+      expect(subject.nome).to eq('Fortaleza')
+    end
+
+    it 'deve retornar o ID 230001' do
+      expect(subject.id).to eq(230001)
+    end
+
+    it 'deve retornar a região intermediária, que é um objeto IBGE::RegiaoIntermediaria' do
+      expect(subject.regiao_intermediaria).to be_an IBGE::RegiaoIntermediaria
+    end
+  end
+
+  shared_examples_for 'array' do
+    it 'deve retornar um Array<IBGE::RegiaoImediata>' do
+      aggregate_failures do
+        is_expected.to be_an Array
+        expect(subject.first).to be_an IBGE::RegiaoImediata
+      end
+    end
+  end
+
+  describe '.obter_regioes_imediatas' do
+    subject do
+      VCR.use_cassette('regiao_imediata/obter_regioes_imediatas') do
+        IBGE::RegiaoImediata.obter_regioes_imediatas
+      end
+    end
+
+    it_has_behavior 'array'
+  end
+
+  describe '.regioes_imediatas_por_id' do
+    context 'recebendo um array de IDs ([230001, 230002]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_id:230001|230002', erb: { param: '230001%7C230002' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_id([230001, 230002])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (230001) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_id:230001', erb: { param: '230001' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_id(230001)
+        end
+      end
+
+      it_has_behavior 'objeto'
+    end
+  end
+
+  describe '.regioes_imediatas_por_uf' do
+    context 'recebendo um array de siglas (["BA", "CE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_uf:BA|CE', erb: { param: 'BA%7CCE' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_uf(%w(BA CE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([29, 23]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_uf:BA|CE', erb: { param: '29%7C23' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_uf([29, 23])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (CE) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_uf:CE', erb: { param: 'CE' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_uf('CE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (23) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_uf:CE', erb: { param: 23 }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_uf(23)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.regioes_imediatas_por_regiao' do
+    context 'recebendo um array de siglas (["N", "NE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_regiao:N|NE', erb: { param: 'N%7CNE' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_regiao(%w(N NE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([1, 2]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_regiao:N|NE', erb: { param: '1%7C2' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_regiao([1, 2])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_regiao:NE', erb: { param: 2 }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_regiao(2)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (NE) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_regiao:NE', erb: { param: 'NE' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_regiao('NE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.regioes_imediatas_por_intermediaria' do
+    context 'recebendo um array de IDs ([2301, 2302]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_intermediaria:2301|2302', erb: { param: '2301%7C23017' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_intermediaria([2301, 2302])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2301) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_imediata/regioes_imediatas_por_intermediaria:2301', erb: { param: '2301' }) do
+          IBGE::RegiaoImediata.regioes_imediatas_por_intermediaria(2301)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+end

data/spec/lib/ibge/regiao_intermediaria_spec.rb

@@ -0,0 +1,140 @@
+describe IBGE::RegiaoIntermediaria do
+  shared_examples_for 'objeto' do
+    it 'deve retornar o nome Fortaleza' do
+      expect(subject.nome).to eq('Fortaleza')
+    end
+
+    it 'deve retornar o ID 2301' do
+      expect(subject.id).to eq(2301)
+    end
+
+    it 'deve retornar a UF, que é um objeto IBGE::UF' do
+      expect(subject.uf).to be_an IBGE::UF
+    end
+  end
+
+  shared_examples_for 'array' do
+    it 'deve retornar um Array<IBGE::RegiaoIntermediaria>' do
+      aggregate_failures do
+        is_expected.to be_an Array
+        expect(subject.first).to be_an IBGE::RegiaoIntermediaria
+      end
+    end
+  end
+
+  describe '.obter_regioes_intermediarias' do
+    subject do
+      VCR.use_cassette('regiao_intermediaria/obter_regioes_intermediarias') do
+        IBGE::RegiaoIntermediaria.obter_regioes_intermediarias
+      end
+    end
+
+    it_has_behavior 'array'
+  end
+
+  describe '.regioes_intermediarias_por_id' do
+    context 'recebendo um array de IDs ([2301, 2302]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_id:2301|2302', erb: { param: '2301%7C2302' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_id([2301, 2302])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2301) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_id:2301', erb: { param: '2301' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_id(2301)
+        end
+      end
+
+      it_has_behavior 'objeto'
+    end
+  end
+
+  describe '.regioes_intermediarias_por_uf' do
+    context 'recebendo um array de siglas (["BA", "CE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_uf:BA|CE', erb: { param: 'BA%7CCE' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_uf(%w(BA CE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([29, 23]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_uf:BA|CE', erb: { param: '29%7C23' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_uf([29, 23])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (CE) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_uf:CE', erb: { param: 'CE' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_uf('CE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (23) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_uf:CE', erb: { param: 23 }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_uf(23)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+
+  describe '.regioes_intermediarias_por_regiao' do
+    context 'recebendo um array de siglas (["N", "NE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_regiao:N|NE', erb: { param: 'N%7CNE' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_regiao(%w(N NE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([1, 2]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_regiao:N|NE', erb: { param: '1%7C2' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_regiao([1, 2])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um ID (2) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_regiao:NE', erb: { param: 2 }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_regiao(2)
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo uma sigla (NE) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao_intermediaria/regioes_intermediarias_por_regiao:NE', erb: { param: 'NE' }) do
+          IBGE::RegiaoIntermediaria.regioes_intermediarias_por_regiao('NE')
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+  end
+end

data/spec/lib/ibge/regiao_spec.rb

@@ -0,0 +1,90 @@
+describe IBGE::Regiao do
+  describe '.obter_regioes' do
+    subject do
+      VCR.use_cassette('regiao/obter_regioes') do
+        IBGE::Regiao.obter_regioes
+      end
+    end
+
+    it 'deve retornar um Array<IBGE::Regiao>' do
+      aggregate_failures do
+        is_expected.to be_an Array
+        expect(subject.first).to be_an IBGE::Regiao
+      end
+    end
+  end
+
+  describe '.regioes_por_identificador' do
+    shared_examples_for 'array' do
+      it 'deve retornar um Array' do
+        is_expected.to be_an Array
+      end
+
+      it 'deve possuir o tamanho 2' do
+        expect(subject.size).to eq(2)
+      end
+
+      it 'deve retornar as siglas NE e N' do
+        expect(subject.map(&:sigla)).to eq(['N', 'NE'])
+      end
+    end
+
+    context 'recebendo um array de siglas (["N", "NE"]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao/regioes_por_identificador:N|NE', erb: { param: 'N%7CNE' }) do
+          IBGE::Regiao.regioes_por_identificador(%w(N NE))
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    context 'recebendo um array de IDs ([1, 2]) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao/regioes_por_identificador:N|NE', erb: { param: '1%7C2' }) do
+          IBGE::Regiao.regioes_por_identificador([1, 2])
+        end
+      end
+
+      it_has_behavior 'array'
+    end
+
+    shared_examples_for 'objeto' do
+      it 'deve retornar um objeto IBGE::Regiao' do
+        is_expected.to be_an IBGE::Regiao
+      end
+
+      it 'deve retornar o nome Nordeste' do
+        expect(subject.nome).to eq('Nordeste')
+      end
+
+      it 'deve retornar o ID 2' do
+        expect(subject.id).to eq(2)
+      end
+
+      it 'deve retornar a sigla NE' do
+        expect(subject.sigla).to eq('NE')
+      end
+    end
+    
+    context 'recebendo uma sigla (NE) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao/regioes_por_identificador:NE', erb: { param: 'NE' }) do
+          IBGE::Regiao.regioes_por_identificador('NE')
+        end
+      end
+
+      it_has_behavior 'objeto'
+    end
+
+    context 'recebendo um ID (2) como parâmetro' do
+      subject do
+        VCR.use_cassette('regiao/regioes_por_identificador:NE', erb: { param: 2 }) do
+          IBGE::Regiao.regioes_por_identificador(2)
+        end
+      end
+
+      it_has_behavior 'objeto'
+    end
+  end
+end