Giter VIP home page Giter VIP logo

cep-detail's Introduction

cep-detail

Pacote desenvolvido em JavaScript que realiza pesquisa de detalhes do CEP e busca de CEP através de endereço.

Instalação

npm install cep-detail

Usando

Após instalar o pacote, realize a importação dele no arquivo em que desejar utilizar os serviços do pacote. Veja formas de fazer isso:

import cep from 'cep-detail';

async function getCepInfo() {
    const details = await cep.getCepDetail('números_do_cep_como_string');
    const number = await cep.getCepNumber('sigla_da_UF', 'nome_da_cidade', 'nome_do_logradouro')
}

Ou

import { getCepDetail, getCepNumber } from 'cpf-authenticator';

async function getCepInfo() {
    const details = await getCepDetail('números_do_cep_como_string');
    const number = await getCepNumber('sigla_da_UF', 'nome_da_cidade', 'nome_do_logradouro')
}

O retorno da função getCEpDetail será um objeto com a seguinte estrutura:

retorno = [{
    bairro: "nome_do_bairro",
    cep: "número_do_cep",
    complemento: "complemento_caso_houver",
    gia: "gia_caso_houver",
    ibge: "número_ibge",
    localidade: "nome_da_cidade",
    logradouro: "nome_do_logradouro",
    uf: "sigla_da_uf",
    unidade: "número_da_unidade_caso_houver",
}]

A função getCepNumber retornará um array de objetos, cada objeto terá a seguinte estrutura:

retorno = [{
    bairro: "nome_do_bairro",
    cep: "número_do_cep",
    complemento: "complemento_caso_houver",
    gia: "gia_caso_houver",
    ibge: "número_ibge",
    localidade: "nome_da_cidade",
    logradouro: "nome_do_logradouro",
    uf: "sigla_da_uf",
    unidade: "número_da_unidade_caso_houver",
},{
    bairro: "nome_do_bairro",
    cep: "número_do_cep",
    complemento: "complemento_caso_houver",
    gia: "gia_caso_houver",
    ibge: "número_ibge",
    localidade: "nome_da_cidade",
    logradouro: "nome_do_logradouro",
    uf: "sigla_da_uf",
    unidade: "número_da_unidade_caso_houver",
},{
    ...
}]

Note que caso o logradouro possuir mais de um CEP, esta função retornará um conjunto dos possíveis CEPs.

Configuração para Desenvolvimento

Para fazer a instalação das dependências, baixe os arquivos que compõe o projeto. Será necessário ter o NodeJS instalado na sua máquina. No terminal, acesse a pasta em que os arquivos estão e digite o seguinte código:

npm install

Será feito a instalação de todas as dependências do projeto.

Histórico de lançamentos

  • 1.0.3
    • Adição do README.md.
    • Correção de bug no retorno da função getCepDetail.
  • 1.0.2
    • Versão inicial.

Meta

Rilton Moreira – [email protected]

Contribuindo

  1. Faça o fork do projeto (https://github.com/RiltonSM/cep-detail/fork)
  2. Crie uma branch para sua modificação (git checkout -b feature/fooBar)
  3. Faça o commit (git commit -am 'Add some fooBar')
  4. Push (git push origin feature/fooBar)
  5. Crie um novo Pull Request

cep-detail's People

Contributors

riltonsm avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.