evoluxbr/open-cnl

Biblioteca para ler e consultar o banco de dados CNL (Código Nacional de Localidade) seguindo especificações da ANATEL (Agência Nacional de Telecomunicações).

OpenCNL

Biblioteca para ler e consultar o banco de dados CNL (Código Nacional de Localidade) seguindo especificações da ANATEL (Agência Nacional de Telecomunicações).

Instalação

pip install open-cnl

Importando a base da ANATEL

Você pode fazer o download do banco de dados atualizado do site da ANATEL e importar para um banco de dados SQLite3.

Terminal

python -m open_cnl.open_cnl_importer ./cnl_anatel.sqlite3

Python

from open_cnl.open_cnl_importer import OpenCNLImporter

open_cnl_importer = OpenCNLImporter('./cnl_anatel.sqlite3')
open_cnl_importer.importar_base()

Exemplo prático

Vamos utilizar como exemplo o telefone da prefeitura municipal de Natal/RN: (84) 3211-8243. Veja este código no arquivo exemplo.py.

from open_cnl.open_cnl import OpenCNL

# Inicializamos a classe que se
# conecta ao banco de dados
cnl = OpenCNL('./cnl_anatel.sqlite3')

# Pesquisando por um número de Natal/RN
localidade = cnl.pesquisar_localidade('843211', '8243')

Os dados retornados estarão num dicionário no seguinte formato:

{
    'prestadora': u'TELEMAR NORTE LESTE S.A.',
    'nome_da_localidade': u'NATAL',
    'hemisferio': u'S',
    'numero_da_faixa_final': u'8999',
    'sigla_cnl_da_area_local': u'NTL',
    'numero_da_faixa_inicial': u'8000',
    'longitude': u'351232',
    'prefixo': u'843211',
    'codigo_da_area_de_tarifacao': u'842',
    'latitude': u'547419',
    'codigo_cnl': u'84000',
    'sigla_uf': u'RN',
    'nome_do_municipio': u'NATAL',
    'sigla_cnl': u'NTL'
}

Caso uma localidade não seja encontrada será retornado o valor None.

JSON

Na inicialização da classe podemos definir o parâmetro as_json como True. O padrão desse argumento é False e quando verdadeiro, permite que os dados sejam retornados em uma string no formato JSON.

from open_cnl.open_cnl import OpenCNL

cnl = OpenCNL('./cnl_anatel.sqlite3')
cnl.pesquisar_localidade('843211', '8243', as_json=True)

Autor

Victor Torres [email protected]

Contribuidores

• Stefan Yohansson [email protected]
• João Vitor Gomes [email protected]

open-cnl's Issues

Identificar DDD, prefixo e sufixo automaticamente

Utilizar libphonenumbers para isso. Dá pra identificar que é um número fixo e construir prefixo (com DDD) e sufixo automaticamente. Dessa forma podemos passar o número completo como parâmetro ao invés de ter que dividir ele antes.

Disparar exceções quando algo der errado

Atualmente existem vários pedaços do código que não verificam muita coisa, como por exemplo se um arquivo já existe antes de escrever nele. Temos de verificar essas coisas e gerar exceções nesses casos.

Retornar todas as informações da base de dados

Atualmente a biblioteca verifica se dois números (prefixo com ddd + sufixo) fazem parte de uma mesma localidade, ou seja, se uma ligação partindo do primeiro número pro segundo número é do tipo VC1 ou se é do tipo VC2, VC3 ou outro.

O que a biblioteca deveria fazer é disponibilizar uma API para acessar os dados extraídos do banco de dados da ANATEL e o utilizador pode utilizar esses dados da melhor forma possível, inclusive verificando a localidade e modalidade de tarifa entre dois números.

Problema ao extrair zip da base

Um erro é gerado ao extrair o arquivo ZIP da base da anatel

 try:
    arquivo_txt = self.extrair_base_do_arquivo_zip(arquivo_zip)
except Exception:
    raise ErroAoExtrairBaseDaANATEL

Distribuir uma base SQLite já importada

Os dados já estão disponíveis, mas não estamos passando para o usuário.