Phone Number Analysis

analizar_telefono()

Interactive function that analyzes international phone numbers and extracts comprehensive information including carrier, location, validity, and formatting.

Function Signature

def analizar_telefono() -> None

Parameters

This function takes no parameters. It prompts the user interactively for input.

Input Methods

The function supports two input methods:

Option 1

string

Complete number with country codeUser enters the full international number with + prefix (e.g., “+593 99 123 4567”)

Option 2

string

Separate partsUser enters country code and number separately:

Country code without + (e.g., “593”)
Phone number (e.g., “991234567”)

Input Format Examples

# Valid input formats
"+1 650 253 0000"        # US number
"+44 20 7031 3000"       # UK number
"+593 99 123 4567"       # Ecuador number
"+86 138 0013 8000"      # China number
"+52 55 1234 5678"       # Mexico number

Return Value

return

None

This function does not return a value. It prints results to the console and saves them to a file.

Output Data

The function extracts and displays the following information:

Validation Status

es_valido

boolean

Whether the number is valid according to phone number rules. Displayed with green checkmark (✓) or red cross (✗).

es_posible

boolean

Whether the number is possible (has correct length). Displayed with green checkmark (✓) or yellow warning (!).

Number Formats

formato_internacional

string

International format (e.g., “+1 650-253-0000”)

formato_e164

string

E.164 format - standardized international format (e.g., “+16502530000”)

formato_nacional

string

National format as dialed within the country (e.g., “(650) 253-0000”)

Geographic Information

pais

string

Country or region name in Spanish (from geocoder)

region

string

Region name in English (from geocoder)

country_code

integer

Numeric country calling code (e.g., 1 for US, 44 for UK)

national_number

integer

The national number portion without country code

Carrier Information

operador

string

Mobile carrier/operator name in Spanish. Returns “Desconocido” if not found.

Number Type

tipo_numero

integer

Numeric type code from phonenumbers library:

0: Fijo (Fixed line)
1: Móvil (Mobile)
2: Fijo o Móvil (Fixed line or mobile)
3: Gratuito (Toll-free)
4: Tarifa Premium (Premium rate)
5: Costo Compartido (Shared cost)
6: VoIP
7: Número Personal (Personal number)
8: Pager
9: UAN (Universal Access Number)
10: Desconocido (Unknown)

Timezone

zonas_horarias

list[string]

List of timezone identifiers for the phone number’s location (e.g., [“America/New_York”, “America/Detroit”])

Code Example

from tracker import analizar_telefono

# Interactive analysis
analizar_telefono()

# User will be prompted:
# [1] Ingresar número completo con código
# [2] Ingresar por partes
# Opción: 1
# Número completo (con +): +1 650 253 0000

# Output will show:
# ✓ Número válido
# ✓ Número posible
# 
# Formatos:
#   Internacional: +1 650-253-0000
#   E.164: +16502530000
#   Nacional: (650) 253-0000
# 
# Ubicación:
#   País/Región: Estados Unidos
#   Código: +1
# 
# Información adicional:
#   Operador: Desconocido
#   Tipo: Fijo
#   Zona horaria: America/Los_Angeles

Side Effects

Creates Resultados_Tracker/ directory if it doesn’t exist
Saves detailed results to: Telefono_{country_code}{national_number}_{timestamp}.txt
Prints formatted output to console with colored text
Displays interactive prompts for user input
Calls pausar() at the end to wait for user acknowledgment

Validation Logic

The function performs comprehensive validation:

Format validation: Ensures the input can be parsed as a phone number
Validity check: Uses phonenumbers library’s is_valid_number() to check against numbering plans
Possibility check: Uses is_possible_number() to verify the number length is possible

Exception Handling

phonenumbers.phonenumberutil.NumberParseException

exception

Raised when the phone number cannot be parsed. Function catches this and displays:[!] Error al parsear número: {exception_message}

Exception

exception

Any other exception is caught and displayed as:[!] Error: {exception_message}

Usage in Code

# Direct call - interactive mode
from tracker import analizar_telefono
analizar_telefono()

# For programmatic validation without user interaction,
# use validar_telefono() instead
from tracker import validar_telefono

es_valido = validar_telefono("+1 650 253 0000")
if es_valido:
    print("Número válido")

validar_telefono()

Validates whether a phone number is valid according to international numbering plans. This is a non-interactive utility function.

Function Signature

def validar_telefono(numero_completo: str) -> bool

Parameters

numero_completo

string

required

Complete international phone number with country code. Should include + prefix (e.g., “+1 650 253 0000”).

Return Value

is_valid

boolean

Returns True if the number is valid according to the phonenumbers library validation rules, False otherwise.

Validation Process

Parses the input string into a PhoneNumber object using phonenumbers.parse()
Validates against international numbering plans using phonenumbers.is_valid_number()
Returns False if any exception occurs during parsing or validation

Code Example

from tracker import validar_telefono

# Valid numbers
print(validar_telefono("+1 650 253 0000"))      # True - US number
print(validar_telefono("+44 20 7031 3000"))     # True - UK number
print(validar_telefono("+593 99 123 4567"))     # True - Ecuador number

# Invalid numbers
print(validar_telefono("+1 123"))               # False - Too short
print(validar_telefono("+999 123 456 7890"))    # False - Invalid country code
print(validar_telefono("6502530000"))           # False - Missing country code
print(validar_telefono("invalid"))              # False - Not a number

# Usage in conditional logic
numero = input("Ingrese número de teléfono: ")

if validar_telefono(numero):
    print("Número válido, procediendo con el análisis...")
    # Continue with processing
else:
    print("Número inválido, por favor verifique el formato")

Exception Handling

Exception

exception

Any exception during parsing or validation is caught silently and the function returns False. This includes:

NumberParseException - Invalid format or unparseable input
AttributeError - None or invalid type passed
Any other exception from the phonenumbers library

Best Practices

Always include the + prefix in the phone number string
Validate before analysis - Use this function before calling analizar_telefono() programmatically
Handle False gracefully - Provide user feedback when validation fails
Use for bulk validation - This function is suitable for validating lists of numbers

Integration Example

from tracker import validar_telefono, analizar_telefono

def procesar_numeros(lista_numeros):
    """Process a list of phone numbers"""
    validos = []
    invalidos = []
    
    for numero in lista_numeros:
        if validar_telefono(numero):
            validos.append(numero)
        else:
            invalidos.append(numero)
    
    print(f"Números válidos: {len(validos)}")
    print(f"Números inválidos: {len(invalidos)}")
    
    return validos, invalidos

# Example usage
numeros = [
    "+1 650 253 0000",
    "+44 20 7031 3000",
    "invalid-number",
    "+593 99 123 4567"
]

validos, invalidos = procesar_numeros(numeros)
print(f"Números válidos: {validos}")
print(f"Números inválidos: {invalidos}")

Dependencies

Both phone methods require the phonenumbers library:

pip install phonenumbers

The library provides:

phonenumbers.parse() - Parse string to PhoneNumber object
phonenumbers.is_valid_number() - Validate against numbering plans
phonenumbers.is_possible_number() - Check if length is possible
phonenumbers.format_number() - Format in various standards
geocoder - Geographic location information
carrier - Mobile carrier/operator information
timezone - Timezone information for the number

Get Started

Features

Usage Guide

API Reference

Resources

Phone Number Analysis

analizar_telefono()

Function Signature

Parameters

Input Methods

Input Format Examples

Return Value

Output Data

Validation Status

Number Formats

Geographic Information

Carrier Information

Number Type

Timezone

Code Example

Side Effects

Validation Logic

Exception Handling

Usage in Code

validar_telefono()

Function Signature

Parameters

Return Value

Validation Process

Code Example

Exception Handling

Best Practices

Integration Example

Dependencies

Build docs developers (and LLMs) love

Get Started

Features

Usage Guide

API Reference

Resources

​analizar_telefono()

​Function Signature

​Parameters

​Input Methods

​Input Format Examples

​Return Value

​Output Data

​Validation Status

​Number Formats

​Geographic Information

​Carrier Information

​Number Type

​Timezone

​Code Example

​Side Effects

​Validation Logic

​Exception Handling

​Usage in Code

​validar_telefono()

​Function Signature

​Parameters

​Return Value

​Validation Process

​Code Example

​Exception Handling

​Best Practices

​Integration Example

​Dependencies

Build docs developers (and LLMs) love

analizar_telefono()

Function Signature

Parameters

Input Methods

Input Format Examples

Return Value

Output Data

Validation Status

Number Formats

Geographic Information

Carrier Information

Number Type

Timezone

Code Example

Side Effects

Validation Logic

Exception Handling

Usage in Code

validar_telefono()

Function Signature

Parameters

Return Value

Validation Process

Code Example

Exception Handling

Best Practices

Integration Example

Dependencies