cep_facil 0.0.1

data/.gitignore

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

data/Gemfile

@@ -0,0 +1,2 @@
+source "http://rubygems.org"
+gemspec

data/README.md

@@ -0,0 +1,69 @@
+CepFácil
+===========
+
+Wrapper Ruby for the service at cepfacil.com.br
+
+Installation
+------------
+
+In the `Gemfile`
+
+```ruby
+
+gem `cep_facil`
+
+```
+
+Or via RubyGems, directly:
+
+  gem install cep_facil
+  
+
+Usage
+-----
+
+```ruby
+require "cep_facil"
+cep = "5417-540"
+token = "1234567890" # get yours at cepfacil.com.br
+result = CepFacil.get_address(cep, token)
+# Returns the address referent to that zip code.
+result[:city]
+# Returns the city referent to that zip code.
+```
+
+The response is a Hash object that contains 6 keys: cep, type, state, city, neighborhood, description.
+
+There are three formats for one to store Brazilian zip codes (CEPS):
+
+* "12345-678"
+* "12345678"
+* 12345678 # Don't use this one, really.
+
+CepFácil works with the three of them.
+
+AUTHOR
+------
+
+* Rodrigo Vieira - rodrigovieira1994@gmail.com - http://www.rodrigoalvesvieira.com
+
+LICENCE
+-------
+
+Copyright (c) 2012 Rodrigo Vieira. http://www.rodrigoalvesvieira.com/
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to use, copy and modify copies of the Software, 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/Rakefile

@@ -0,0 +1,24 @@
+# coding: utf-8
+#require "bundler/gem_tasks"
+
+require 'rake'
+require 'rdoc/task'
+require 'fileutils'
+
+task :test => :spec
+
+task :default => :spec
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = '--backtrace --color'
+end
+
+desc 'Generate documentation for CepFacil.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'CepFácil'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README.md')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/cep_facil.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "cep_facil/version"
+
+Gem::Specification.new do |s|
+  s.name        = "cep_facil"
+  s.version     = CepFacil::VERSION
+  s.authors     = ["Rodrigo Vieira"]
+  s.email       = ["rodrigo@atela.com.br"]
+  s.homepage    = "https://github.com/rodrigoalvesvieira/cep_facil"
+  s.summary     = %q{Wrapper para o serviço cepfacil.com.br}
+  s.description = %q{Wrapper Ruby para o serviço cepfacil.com.br}
+  s.rubyforge_project = "cep_facil"
+  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_dependency("rspec", ">=2")
+end

data/lib/cep_facil/version.rb

@@ -0,0 +1,3 @@
+module CepFacil
+  VERSION = "0.0.1"
+end

data/lib/cep_facil.rb

@@ -0,0 +1,57 @@
+# coding: utf-8
+require "cep_facil/version"
+require "net/http"
+
+module CepFacil
+  
+  # Recebe o CEP e o Token (obtenha o seu em http://cepfacil.com.br) e 
+  # retorna o endereço reference ao CEP passado. 
+  #
+  # == Exemplo 
+  # require "cep_facil"
+  # cep = "5417-540"
+  # token = "1234567890"
+  # CepFacil.get_address(cep, token)
+  # Retorna o endereço daquele cep em forma de Hash.
+  # Esse hash tem 6 chaves: cep, type, state, city, neighborhood, description
+  
+  # Algumas pessoas guardam o CEP na forma "22222222", outras como "22222-222"
+  # outras até como inteiro.
+  # O método CepFacil.get_address aceita as três formas.
+  
+  def self.get_address(zip_code, token)
+    zip_code = zip_code.to_s
+    
+    if zip_code.match(/^[0-9]{5}[-]?[0-9]{3}/)
+      zip_code.gsub!("-", "")
+      @uri = URI.parse "http://www.cepfacil.com.br/service/?filiacao=#{token}&cep=#{zip_code}&formato=texto"
+    else
+      @uri = URI.parse "http://www.cepfacil.com.br/service/?filiacao=#{token}&cep=#{zip_code}&formato=texto"
+    end
+    
+    http = Net::HTTP.new(@uri.host, @uri.port)
+    call = Net::HTTP::Get.new(@uri.request_uri)
+    
+    response = http.request(call)
+    response.body
+    
+    pattern = /^([a-z]+)\=/
+    result = response.body.split("&")
+    
+    type = result[2].gsub!(pattern, "")
+    state = result[3].gsub!(pattern, "")
+    city = result[4].gsub!(pattern, "")
+    neighborhood = result[5].gsub!(pattern, "")
+    description = result[6].gsub!(pattern, "")
+    
+    address = {
+      cep: zip_code,
+      type: type,
+      state: state,
+      city: city,
+      neighborhood: neighborhood,
+      description: description
+    }
+  
+  end
+end

data/spec/cep_facil_spec.rb

@@ -0,0 +1,9 @@
+require File.expand_path('spec/spec_helper')
+
+describe CepFacil do
+ 
+  it "has a version" do
+    CepFacil::VERSION.should =~ /^\d+\.\d+\.\d+$/
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift 'lib'
+require 'cep_facil'

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification
+name: cep_facil
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Rodrigo Vieira
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &70128918947180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '2'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70128918947180
+description: Wrapper Ruby para o serviço cepfacil.com.br
+email:
+- rodrigo@atela.com.br
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- README.md
+- Rakefile
+- cep_facil.gemspec
+- lib/cep_facil.rb
+- lib/cep_facil/version.rb
+- spec/cep_facil_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/rodrigoalvesvieira/cep_facil
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: cep_facil
+rubygems_version: 1.8.13
+signing_key: 
+specification_version: 3
+summary: Wrapper para o serviço cepfacil.com.br
+test_files:
+- spec/cep_facil_spec.rb
+- spec/spec_helper.rb