cep_facil 1.0.3 → 1.0.4

data/README.md

@@ -93,6 +93,20 @@ address.valid? # true
 
 ```
 
+Você também pode checar se o endereço foi encontrado com o CEP passado da seguinte forma:
+
+```ruby
+
+address = CepFacil::API.new "53417-540", token
+
+address.found? # true
+
+address = CepFacil::API.new "00000000", token
+
+address.valid? # false
+
+```
+
 Adicionalmente, seu objeto `CepFacil::API` possui um método `full_format` e seu alias (`full_address`) que o descreve por extenso:
 
 ```ruby

data/lib/cep_facil/api.rb

@@ -4,56 +4,63 @@ require "net/http"
 module CepFacil
   class API
     attr_reader :read
-    
+
     BASE_URL = "http://www.cepfacil.com.br/service/?filiacao=%s&cep=%s&formato=%s"
     METHODS_PLACEHOLDER = {estado: :uf , type: :tipo , state: :uf , city: :cidade , neighborhood: :bairro , street: :descricao , rua: :descricao}
-    
+
     class << self
       ##
       # Removes all non-numeric caracters and limit to 8 caracters
       def parse_zip_code(zip_code)
-        return zip_code.to_s.gsub(/([^0-9]+)/,"")[0...8]   
+        return zip_code.to_s.gsub(/([^0-9]+)/,"")[0...8]
       end
     end
-    
+
     def initialize(*args)
       args = (args[0].is_a?(Hash) ? args[0] : Hash[[:cep,:token,:format].zip(args)])
       args[:format] ||= "texto"
       args[:cep] = CepFacil::API.parse_zip_code(args[:cep])
 
-      uri = URI(BASE_URL % [args[:token], args[:cep], args[:format]])      
+      uri = URI(BASE_URL % [args[:token], args[:cep], args[:format]])
       @read = Net::HTTP.get(uri)
-      @data = args[:format].to_s == "texto" ? Hash[@read.split("&").map { |i| i.split("=") } ] : @read    
-      
+      @data = args[:format].to_s == "texto" ? Hash[@read.split("&").map { |i| i.split("=") } ] : @read
+
       # OPTIMIZE: Need a better implementation
       return self
     end
-    
+
     ##
     # Returns true if the address in question is a valid one
     # returns false otherwise
     def valid?
       @data.is_a?(Hash) and @data.size > 1
     end
-    
+
     #
     # Returns the address in its extense format
     def full_format
       "#{type} #{street}, #{city} - #{state}, Brasil"
     end
-    
+
+    #
+    # Returns true if the address was found with the given zip code (CEP)
+    # returns false otherwise
+    def found?
+      self.status == "encontrado"
+    end
+
     def self.get(*args)
       self.new(*args)
     end
-    
+
     private
     #
     # Define placeholder methods for the address attributes
     # in portuguese
     def method_missing(*args)
-      return (@data[METHODS_PLACEHOLDER[args[0].to_sym].to_s] || @data[args[0].to_s]).force_encoding(Encoding::UTF_8) || super(*args) 
+      return (@data[METHODS_PLACEHOLDER[args[0].to_sym].to_s] || @data[args[0].to_s]).force_encoding(Encoding::UTF_8) || super(*args)
     end
-    
+
     alias :address :full_format
   end
 end

data/lib/cep_facil/version.rb

@@ -1,3 +1,3 @@
 module CepFacil
-  VERSION = "1.0.3" #:nodoc:
+  VERSION = "1.0.4" #:nodoc:
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cep_facil
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-16 00:00:00.000000000 Z
+date: 2012-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake