Brasil Interface - Cli

Sumário

• Brasil Interface - Cli
  • Sumário
  • Descrição
  • Instalação
  • Como usar
  • Utils CLI
    • CPF
      • Validar CPF
      • Gerar CPF
      • Aplicar máscara em CPF
      • Remover máscara de CPF
      • Verificar estado de origem de CPF
    • CNPJ
      • Validar CNPJ
      • Gerar CNPJ
      • Aplicar máscara em CNPJ
      • Remover máscara de CNPJ
    • PIS
      • Validar PIS
      • Gerar PIS
      • Aplicar máscara em PIS
      • Remover máscara de PIS
    • CNH
      • Validar CNH
      • Gerar CNH
    • RG
      • Validar RG
      • Gerar RG
      • Aplicar máscara em RG
      • Remover máscara de RG
  • Sdks CLI
    • Cep Aberto
      • Pesquisar CEP por número de CEP
      • Pesquisar CEP por Coordenadas
      • Pesquisar CEP por Endereço
      • Pesquisar CEP por Estado
      • Atualizar uma lista de ceps
  • Como contribuir
  • Contribuidores
  • Autor
  • Licença

Descrição

Este projeto foi desenvolvido para facilitar o acesso de desenvolvedores as funcionalidades presentes nas libs do projeto Brasil Interface.

Instalação

yarn global add @brasil-interface/cli

ou

npm install -g @brasil-interface/cli

Como usar

Ao instalar a cli, você terá acesso a um comando chamado brasili. Este comando possui alguns sub-comandos que são as funcionalidades disponíveis na cli. Para saber mais sobre cada funcionalidade, basta executar o comando brasili --help e você verá uma lista com todos os sub-comandos disponíveis e uma breve descrição sobre cada um deles. Para saber mais sobre cada sub-comando, basta executar o comando brasili <sub-comando> --help e você verá uma descrição mais detalhada sobre o sub-comando.

Utils CLI

Os comandos tendem a seguir o mesmo padrão de nomenclatura dos sub-comandos. Então para fins de brevidade, o maior detalhamento será feito apenas para o sub-comando cpf, e para os outros comandos apenas haverá maior detalhamento caso haja alguma particularidade ou um novo comando seja adicionado.

CPF

Note que todos os comandos terão algumas opções em comum, para fins de brevidade, estas opções serão listadas aqui:

Validar CPF

brasili cpf validate [...cpfs] -i <input_file> -o <output_file>

Validar um único CPF:

brasili cpf validate 04379547060

Validar uma lista de CPFs:

brasili cpf validate 04379547060,04379547061,04379547062

ou ainda:

Validar uma lista de CPFs em formato JSON:

brasili cpf validate '["04379547060","04379547061"]'

Validar uma lista de CPFs em formato JSON e salvar o resultado em um arquivo:

brasili cpf validate '["04379547060","04379547061"]' -o cpf-validation.json

Validar uma lista de CPFs a partir de um arquivo:

// cpf-list.txt
04379547060,04379547061

brasili cpf validate -i cpf-list.txt

O resultado de qualquer uma das validações acima será uma lista de objetos com o CPF e o resultado da validação:

[
  {
    "cpf": "04379547060",
    "valid": true
  },
  {
    "cpf": "04379547061",
    "valid": false
  }
]

Gerar CPF

brasili cpf generate -a <amount> -o <output_file> --mask

Gerar um único CPF:

brasili cpf generate

Gerar uma lista de CPFs:

brasili cpf generate -a 3

Gerar uma lista de CPFs e salvar o resultado em um arquivo:

brasili cpf generate -a 3 -o cpf-list.txt

O resultado de qualquer uma das gerações acima será um array de CPFs:

["04379547060","04379547061","04379547062"]

Aplicar máscara em CPF

brasili cpf mask [...cpfs] -i <input_file> -o <output_file> --sensitive

Aplicar máscara em um único CPF:

brasili cpf mask 04379547060

Aplicar máscara em uma lista de CPFs:

brasili cpf mask 04379547060,04379547061,04379547062

ou ainda:

Aplicar máscara em uma lista de CPFs em formato JSON:

brasili cpf mask '["04379547060","04379547061"]'

Aplicar máscara em uma lista de CPFs em formato JSON e salvar o resultado em um arquivo:

brasili cpf mask '["04379547060","04379547061"]' -o cpf-mask.json

Aplicar máscara em uma lista de CPFs a partir de um arquivo:

// cpf-list.txt
04379547060,04379547061

brasili cpf mask -i cpf-list.txt

O resultado de qualquer uma das aplicações de máscara acima será uma lista de objetos com o CPF e o resultado da aplicação de máscara:

[
  {
    "cpf": "043.795.470-60",
    "masked": true
  },
  {
    "cpf": "043.795.470-61",
    "masked": true
  }
]

Remover máscara de CPF

brasili cpf unmask [...cpfs] -i <input_file> -o <output_file>

Remover máscara de um único CPF:

brasili cpf unmask 043.795.470-60

Remover máscara de uma lista de CPFs:

brasili cpf unmask 043.795.470-60,043.795.470-61,043.795.470-62

ou ainda:

Remover máscara de uma lista de CPFs em formato JSON:

brasili cpf unmask '["043.795.470-60","043.795.470-61"]'

Remover máscara de uma lista de CPFs em formato JSON e salvar o resultado em um arquivo:

brasili cpf unmask '["043.795.470-60","043.795.470-61"]' -o cpf-unmask.json

Remover máscara de uma lista de CPFs a partir de um arquivo:

// cpf-list.txt
043.795.470-60,043.795.470-61

brasili cpf unmask -i cpf-list.txt

O resultado de qualquer uma das remoções de máscara acima será uma lista de objetos com o CPF e o resultado da remoção de máscara:

[
  {
    "cpf": "04379547060",
    "unmasked": true
  },
  {
    "cpf": "04379547061",
    "unmasked": true
  }
]

Verificar estado de origem de CPF

brasili cpf get-estados [...cpfs] -i <input_file> -o <output_file>

Pesquisar estado de origem de um único CPF:

brasili cpf get-estados 04379547060

Pesquisar estado de origem de uma lista de CPFs:

brasili cpf get-estados 04379547060,04379547061,04379547062

ou ainda:

Pesquisar estado de origem de uma lista de CPFs em formato JSON:

brasili cpf get-estados '["04379547060","04379547061"]'

Pesquisar estado de origem de uma lista de CPFs em formato JSON e salvar o resultado em um arquivo:

brasili cpf get-estados '["04379547060","04379547061"]' -o cpf-estados.json

Pesquisar estado de origem de uma lista de CPFs a partir de um arquivo:

// cpf-list.txt
04379547060,04379547061

brasili cpf get-estados -i cpf-list.txt

O resultado de qualquer uma das pesquisas de estado de origem acima será uma lista de objetos com o CPF e uma lista dos estados de origem:

[
  {
    "cpf": "04379547060",
    "estado": ["SP"]
  },
  {
    "cpf": "04379547061",
    "estado": ["SP"]
  }
]

CNPJ

Note que todos os comandos terão algumas opções em comum, para fins de brevidade, estas opções serão listadas aqui:

Validar CNPJ

brasili cnpj validate [...cnpjs] -i <input_file> -o <output_file>

Gerar CNPJ

brasili cnpj generate [...cnpjs] -i <input_file> -o <output_file> -a <amount> --mask

Aplicar máscara em CNPJ

brasili cnpj mask [...cnpjs] -i <input_file> -o <output_file> --sensitive

Remover máscara de CNPJ

brasili cnpj unmask [...cnpjs] -i <input_file> -o <output_file>

PIS

Note que todos os comandos terão algumas opções em comum, para fins de brevidade, estas opções serão listadas aqui:

Validar PIS

brasili pis validate [...pis] -i <input_file> -o <output_file>

Gerar PIS

brasili pis generate -a <amount> -o <output_file> --mask

Aplicar máscara em PIS

brasili pis mask [...pis] -i <input_file> -o <output_file> --sensitive

Remover máscara de PIS

brasili pis unmask [...pis] -i <input_file> -o <output_file>

CNH

Validar CNH

brasili cnh validate [...cnhs] -i <input_file> -o <output_file>

Gerar CNH

brasili cnh generate -a <amount> -o <output_file>

RG

O RG tem uma particularidade que é o fato de que ele não possui um padrão nacional. Cada estado possui seu próprio padrão de RG. Por isso, para executar comandos relacionados ao rg é necessário informar o estado de origem do RG. Para isso, basta informar a sigla do estado de origem do RG logo após a lista de RGs.

Note que todos os comandos terão algumas opções em comum, para fins de brevidade, estas opções serão listadas aqui:

Validar RG

brasili rg validate [...rgs] <estado> -i <input_file> -o <output_file>

Gerar RG

brasili rg generate <estado> -a <amount> -o <output_file> --mask

Aplicar máscara em RG

brasili rg mask [...rgs] <estado> -i <input_file> -o <output_file> --sensitive

Remover máscara de RG

brasili rg unmask [...rgs] <estado> -i <input_file> -o <output_file>

Sdks CLI

Cep Aberto

Esta funcionalidade permite que você faça consultas de CEPs utilizando a API do Cep Aberto, para checar o wrapper utilizado, acesse o package @brasil-interface/sdks deste projeto.

Note que todos os comandos terão algumas opções em comum, para fins de brevidade, estas opções serão listadas aqui:

Pesquisar CEP por número de CEP

brasili cep-aberto get-by-number <cep> --token <token> -o <output_file> -c

Em caso de sucesso o resultado será algo como:

{
  "cep": "01001-000",
  "logradouro": "Praça da Sé",
  "complemento": "lado ímpar",
  "bairro": "Sé",
  "cidade": {
    "nome": "São Paulo",
    "ddd": 11,
    "ibge": "3550308"
  },
  "estado": {
    "sigla": "SP"
  },
  "altitude": 760.0,
  "latitude": "-23.5503",
  "longitude": "-46.6342"
}

Pesquisar CEP por Coordenadas

brasili cep-aberto get-by-coordinates <latitude> <longitude> --token <token> -o <output_file> -c

Em caso de sucesso o JSON será o mesmo da pesquisa por CEP.

Pesquisar CEP por Endereço

brasili cep-aberto get-by-address <state> <city> [street] [neighborhood] --token <token> -o <output_file> -c

Em caso de sucesso o JSON será o mesmo da pesquisa por CEP.

Pesquisar CEP por Estado

brasili cep-aberto get-cities-by-state <state> --token <token> -o <output_file> -c

Em caso de sucesso o resultado será uma lista de objetos com o nome das cidades:

[
  {
    "nome": "São Paulo",
  },
  {
    "nome": "São Pedro",
  },
  {
    "nome": "São Pedro do Turvo",
  }
]

Atualizar uma lista de ceps

brasili cep-aberto update-ceps <cepList> --token <token> -i <input_file> -o <output_file> -c

Em caso de sucesso o resultado será uma lista de strings com os ceps atualizados:

[
  "01001-000",
  "01002-000",
  "01003-000"
]

Como contribuir

Leia o arquivo CONTRIBUTING.md no repositório principal.

Contribuidores

• Pietro Bondioli

Autor

• Pietro Bondioli

Licença

MIT