import logging

# Configurar el sistema de registro
# Establece el umbral para el logger en el nivel DEBUG
# Esto significa que todos los mensajes de registro en este nivel y superiores serán mostrados
logging.basicConfig(level=logging.DEBUG)

# A continuación se muestran diferentes niveles de mensajes de registro en orden creciente de severidad.

# DEBUG: Información detallada, típicamente de interés solo al diagnosticar problemas.
logging.debug("Este es un mensaje de depuración")

# INFO: Confirmación de que las cosas están funcionando como se espera.
logging.info("Este es un mensaje informativo")

# WARNING: Una indicación de que algo inesperado ocurrió, o indicativo de algún problema en el futuro cercano
# (por ejemplo, 'espacio en disco bajo'). El software sigue funcionando como se espera.
logging.warning("Este es un mensaje de advertencia")

# ERROR: Debido a un problema más grave, el software no ha podido realizar alguna función.
logging.error("Este es un mensaje de error")

# CRITICAL: Un error muy grave, indicando que el programa en sí puede no ser capaz de seguir ejecutándose.
logging.critical("Este es un mensaje crítico")

import logging  # Importar el módulo de registro para habilitar el registro de eventos, errores y mensajes informativos.

def dividir(a, b):
    """Función para dividir dos números.

    Args:
    a (float): El numerador.
    b (float): El denominador.

    Returns:
    float: El resultado de la división si tiene éxito, de lo contrario None.
    """
    logging.info(f"Dividiendo {a} por {b}")  # Registrar un mensaje informativo indicando la operación que se está realizando.

    if b == 0:  # Verificar si el denominador es cero para evitar error de división por cero.
        logging.error("Intento de división por cero")  # Registrar un mensaje de error si se intenta una división por cero.
        return None  # Devolver None para indicar que la operación falló.

    return a / b  # Realizar la división y devolver el resultado.

if __name__ == "__main__":
    # Configurar el registro para mostrar mensajes de nivel DEBUG y superiores
    logging.basicConfig(level=logging.DEBUG)

    # Probar la función dividir con entrada válida
    resultado = dividir(10, 2)
    print(f"Resultado: {resultado}")  # Imprimir el resultado de la división

    # Probar la función dividir con división por cero
    resultado = dividir(10, 0)
    print(f"Resultado: {resultado}")  # Imprimir el resultado, que debería ser None debido a la división por cero

import logging

# Crear un objeto logger con el nombre 'ejemplo_logger'
logger = logging.getLogger('ejemplo_logger')
# Establecer el nivel de registro en DEBUG. Esto significa que todos los mensajes con el nivel DEBUG y superiores serán registrados
logger.setLevel(logging.DEBUG)

# Crear un handler que imprimirá los mensajes de registro en la consola (salida estándar)
console_handler = logging.StreamHandler()
# Crear un handler que escribirá los mensajes de registro en un archivo llamado 'ejemplo.log'
file_handler = logging.FileHandler('ejemplo.log')

# Definir un formatter que especifica el formato de los mensajes de registro
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
# Establecer el formatter para el console handler
console_handler.setFormatter(formatter)
# Establecer el formatter para el file handler
file_handler.setFormatter(formatter)

# Añadir el console handler al logger. Esto significa que los mensajes de registro se mostrarán en la consola
logger.addHandler(console_handler)
# Añadir el file handler al logger. Esto significa que los mensajes de registro se escribirán en el archivo 'ejemplo.log'
logger.addHandler(file_handler)

# Registrar un mensaje informativo con el logger
logger.info('Este es un mensaje informativo')

import logging  # Importar el módulo de registro para manejar el registro
from logging.handlers import RotatingFileHandler  # Importar el RotatingFileHandler para crear un sistema de registro rotativo

# Crear un objeto logger llamado 'logger_rotativo'
logger = logging.getLogger('logger_rotativo')
# Configurar el nivel de registro en DEBUG para que todos los niveles (DEBUG, INFO, WARNING, ERROR y CRITICAL) sean registrados
logger.setLevel(logging.DEBUG)

# Crear un handler de archivo rotativo que escribirá en 'registro_rotativo.log'
# maxBytes=2000 significa que cada archivo de registro puede contener hasta 2000 bytes
# backupCount=5 significa que el handler conservará hasta 5 archivos de registro de respaldo antes de sobrescribir el más antiguo
rotating_handler = RotatingFileHandler('registro_rotativo.log', maxBytes=2000, backupCount=5)

# Definir un formato para los mensajes de registro
# El formato incluye la marca de tiempo, el nombre del logger, el nivel de registro y el mensaje
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
# Aplicar el formatter al handler rotativo
rotating_handler.setFormatter(formatter)

# Añadir el handler rotativo al logger para que sepa cómo manejar el registro
logger.addHandler(rotating_handler)

# Generar 100 mensajes de depuración
for i in range(100):
    # Cada mensaje de depuración contendrá el índice del bucle
    logger.debug(f"Mensaje de depuración {i}")

import logging

# Crea un objeto logger con el nombre 'web_scraper_logger'
web_scraper_logger = logging.getLogger('web_scraper')

# Define el nivel de logging a DEBUG. Esto significa que todos los mensajes con el nivel DEBUG y superior serán registrados
web_scraper_logger.setLevel(logging.DEBUG)

# Crea handlers que imprimirán mensajes de log en la consola (salida estándar) y escribirán mensajes de log en un archivo llamado 'web_scraper.log'
console_handler = logging.StreamHandler()
file_handler = logging.FileHandler('web_scraper.log')

# Define un formatter que especifica el formato de los mensajes de log
formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')

# Define el formatter para el console handler y para el file handler
console_handler.setFormatter(formatter)
file_handler.setFormatter(formatter)

# Añade el console handler al logger. Esto significa que los mensajes de log se mostrarán en la consola
web_scraper_logger.addHandler(console_handler)
# Añade el file handler al logger. Esto significa que los mensajes de log se escribirán en el archivo 'web_scraper.log'
web_scraper_logger.addHandler(file_handler)

import requests  # Importa la biblioteca requests para hacer solicitudes HTTP
from bs4 import BeautifulSoup  # Importa la clase BeautifulSoup de la biblioteca bs4 para analizar contenido HTML 

def buscar_titulo(url):
    """
    Función para obtener el título de una página web dado su URL.

    Args:
        url (str): La URL de la página web a ser scrapeada.

    Retorna:
        str o None: El título de la página web, o None si ocurre un error.
    """

    # Registra el inicio del proceso de scraping web
    web_scraper_logger.info(f"Iniciando el scraping de la URL: {url}")

    try:
        # Envía una solicitud GET a la URL especificada
        respuesta = requests.get(url)

        # Lanza una excepción HTTPError para códigos de respuesta 4xx o 5xx
        respuesta.raise_for_status()
    except requests.RequestException as e:
        # Registra el error si la solicitud HTTP falla
        web_scraper_logger.error(f"Fallo en la solicitud HTTP: {e}")
        return None

    try:
        # Analiza el contenido HTML de la respuesta usando BeautifulSoup
        sopa = BeautifulSoup(respuesta.content, 'html.parser')

        # Extrae el contenido de la etiqueta <title>
        titulo = sopa.title.string

        # Registra un mensaje indicando la extracción exitosa del título
        web_scraper_logger.info(f"Título obtenido con éxito: {titulo}")
        return titulo
    except Exception as e:
        # Registra cualquier error que ocurra durante el análisis de HTML o extracción del título
        web_scraper_logger.error(f"Fallo al analizar HTML o extraer título: {e}")
        return None

if __name__ == '__main__':
    urls = [
        'https://www.python.org',
        'https://www.example.com',
        'https://urlinexistente.com.br'  # Una URL que causará una solicitud fallida
    ]

    for url in urls:
        titulo = buscar_titulo(url)
        if titulo:
            web_scraper_logger.debug(f"Título scrapeado para {url}: {titulo}")
        else:
            web_scraper_logger.warning(f"Ningún título encontrado para {url}")