teletools 0.0.2

Python Utility Functions Library for Call Details Records ( CDRs ) from Brazilian Telecommunications Carriers

Sumário

1. Teletools
2. Bibliotecas e ferramentas
3. Instalação
4. Uso básico
5. Fontes de dados
6. Referências

Teletools

Teletools é um conjunto de bibliotecas e ferramentas de apoio para pré-processamento e análise de arquivos CDR (Detalhes de Registros de Chamadas) de operadoras brasileiras.

Bibliotecas e ferramentas

Bibliotecas Python

Biblioteca	Descrição
cipher	Biblioteca para criptografar e descriptografar arquivos no formato .gpg
database	Biblioteca para conexão e operações a banco de dados auxiliares de CDR.
preprocessing	Biblioteca para limpeza e preparação de dados
utils	Biblioteca com ferramentas diversas e comuns

Ferramentas de Linha de Comando

Ferramenta	Descrição
Cipher	Cliente de linha de comando para criptografar e descriptografar arquivos no formato .gpg
ABR Loader	Cliente de linha de comando para importação de dados da ABR Telecom (portabilidade e numeração)

Infraestrutura

Aplicação	Descrição
CDR Stage Database	Banco de dados PostgreSQL conteinerizado e customizado para pré-processamento e análise de CDR

Instalação

As bibliotecas e ferramentas foram desenvolvidas para serem executadas em um servidor rodando Redhat Enterprise Linux 9, contudo, embora não testado, podem ser executadas em computadores com outras distribuições Linux ou Windows que atendam aos pré-requisitos.

Pré-requisitos para instalação:

• Python 3.13+ com gerenciador de pacotes UV
• Instância de banco de dados Teletools CDR Stage Database
• GnuPG ou Gpg4win

Procedimento para instalação:

Em um projeto Python gerenciado pelo UV:

$ uv add teletools

Em um ambiente virtual Python gerenciado pelo UV:

# Crie o ambiente virtual
$ uv venv ~/teletools --python=3.13

# Ative o ambiente virtual
$ source ~/teletools/bin/activate

# Instale teletools
(teletools) $ uv pip install teletools

💡 Utilize essa opção para utilizar os clientes de linha de comando

Documentação Adicional

• Teletools CDR Stage Database - Banco de dados PostgreSQL conteinerizado para análise de CDR
• Teletools ABR Loader - Cliente de importação de dados ABR Telecom (PIP e NSAPN)
• Teletools Database API - Biblioteca Python para consulta de dados de telecomunicações

Referências

• UV Short Guide