toolkitbrazil 0.0.1

A Python module with a collection of useful tools for Brazilians (and anyone else who wants to use it)

Introduction

A Python module with a collection of useful tools for Brazilians (and anyone else who wants to use it).
Take a look at CHANGELOG.md for the changes.

Brief History

I started studying Python recently and wanted to do something that would be useful. Enjoy toolkitbrazil.

Overview

Here's a quick overview of what the library has at the moment:

• Random generation of CPF and CNPJ numbers
• CPF and CNPJ validation
• Check which state a DDD belongs to
• Returns the capital of a state
• String cleaner

Usage

import toolkitbrazil as tkb

# Remove diacritics, non alpha chars, multiple spaces and convert string to upper case
print(tkb.strClean('A héalt#hy  dìet is    esse&ntiãl  for    go(od heàlth and    nutrition  '))
# Return: 'A HEALTHY DIET IS ESSENTIAL FOR GOOD HEALTH AND NUTRITION'

# Generate a random CPF
print(tkb.rngCPF())
# Sample return: 75269169703

# Generate a random CPF of specific UF
print(tkb.rngCPF('SP'))
# Sample return: 27039729890

# Validate a CPF
print(tkb.valCPF(75269169703))
# Return: True

# Generate a random CNPJ of the headquarters (branch 0001)
print(tkb.rngCNPJ())
# Sample return: 86978319000101

# Generate a random CNPJ of a branch (any branch)
print(tkb.rngCNPJfiliais())
# Sample return: 94318840326682

# Validate a CNPJ
print(tkb.valCNPJ(86978319000101))
# Return: True

# Check the UF of the CPF
print(tkb.ufCPF(75269169703))
# Return: ['ES', 'RJ']

# Check the UF of the DDD or phone number (using first two digits of any number)
print(tkb.ufDDD(61))
# Return: ['DF', 'GO']
print(tkb.ufDDD(11987654321))
# Return: ['SP']

# Check the capital of a UF
print(tkb.ufCapital('SP'))
# Return ['SAO PAULO', 'SP']

# Validate a CPF and check its UF
print(tkb.valCPFuf(75269169703, 'SP'))
# Return False (it's a valid CPF but from another UF)

Authors

Ricardo Colombani - @coloric

How to install

$ pip install toolkitbrazil

License

MIT