pycondicionals 1.0.0__tar.gz

pycondicionals-1.0.0/PKG-INFO

@@ -0,0 +1,327 @@
+Metadata-Version: 2.4
+Name: pycondicionals
+Version: 1.0.0
+Summary: Librería con condicionales lógicos avanzados y puros para Python
+Author: Isaac
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# pycondicionals 🚀
+
+Una librería creada por Isaac con condicionales lógicos avanzados y puros para Python. Diseñada especialmente para hacer el código de tus aplicaciones más limpio, evitando usar demasiados `if-elif-else`.
+
+## 📦 Instalación
+
+Puedes instalar esta librería directamente desde la terminal usando pip:
+
+```bash
+pip install pycondicionals
+
+¡Ah, vale, ya te capto por completo, Isaac! Quieres el archivo README.md completo y listo para copiar y pegar, pero con todas las descripciones enfocadas en este estilo serio, corporativo y profesional que acabamos de armar.
+
+Aquí tienes el archivo README.md definitivo con la introducción, los comandos de instalación y las 22 funciones explicadas con ejemplos reales de desarrollo backend, finanzas y ciberseguridad:
+
+Markdown
+# pycondicionals 🚀
+
+¡Bienvenido a **pycondicionals**! Una librería creada por Isaac que introduce condicionales lógicos avanzados, puros y limpios para Python.
+
+Esta librería está diseñada para entornos de desarrollo profesionales, backend, automatización y análisis de datos. Te ayuda a deshacerte de bloques complejos de `if-elif-else`, transformando lógica difusa en condicionales semánticos, seguros y fáciles de mantener.
+
+---
+
+## 📦 Instalación y Uso Básico
+
+Para instalar la librería de forma pública desde PyPI, ejecuta en tu terminal:
+```bash
+pip install pycondicionals
+Para integrarla en tus módulos de Python, impórtala usando el alias estándar pc:
+
+Python
+import pycondicionals as pc
+🛠️ Manual de Funciones Explicado
+Todas las funciones de pycondicionals son condicionales puros. Esto significa que no ejecutan acciones secundarias ni modifican tus variables por detrás; simplemente analizan los datos de entrada y devuelven un valor booleano (True o False). Son ideales para su uso directo dentro de estructuras if.
+
+🧮 Condicionales Matemáticos y Numéricos
+1. pc.between(...)
+¿Qué hace?: Esta función verifica si un valor numérico se encuentra dentro de un rango específico de tolerancia. Es ideal para procesos de validación de datos financieros o parámetros de configuración del sistema.
+
+Qué poner en el paréntesis: El valor a evaluar, el límite mínimo aceptable y el límite máximo permitido.
+
+Ejemplo real:
+
+Python
+# Validamos si la tasa de interés de un crédito está dentro de los márgenes legales
+if pc.between(tasa_interes, 1.5, 24.5):
+    print("✅ La tasa de interés se encuentra dentro de los parámetros permitidos.")
+2. pc.chance(...)
+¿Qué hace?: Ejecuta una evaluación probabilística basada en un porcentaje estadístico. En entornos profesionales se utiliza para simulación de fallos (Chaos Engineering), pruebas de carga aleatorias o algoritmos de enrutamiento de tráfico A/B Testing.
+
+Qué poner en el paréntesis: Un número flotante o entero del 0 al 100 que representa el porcentaje de probabilidad de éxito.
+
+Ejemplo real:
+
+Python
+# Simulamos una tasa de error del 5% para probar la resiliencia de un microservicio
+if pc.chance(5.0):
+    print("⚠️ Simulación de fallo de red activa: Reintentando conexión...")
+3. pc.is_prime(...)
+¿Qué hace?: Determina si un número entero es primo. Su aplicación principal radica en algoritmos criptográficos, validación de claves simétricas, hash distribuidos y generación de tokens de seguridad únicos.
+
+Qué poner en el paréntesis: El número entero que se desea comprobar.
+
+Ejemplo real:
+
+Python
+# Verificación previa de un bloque numérico para criptografía RSA
+if pc.is_prime(clave_generada):
+    print("🔐 El factor numérico cumple con las propiedades criptográficas iniciales.")
+4. pc.is_multiple(...)
+¿Qué hace?: Comprueba si un número es divisible exactamente por otro sin dejar residuo. Es extremadamente útil para ejecutar scripts periódicos, paginación de bases de datos o para guardar logs de auditoría en bloques de datos específicos (por ejemplo, cada 500 peticiones).
+
+Qué poner en el paréntesis: El contador o valor actual, y el divisor objetivo.
+
+Ejemplo real:
+
+Python
+# Guardamos un respaldo del estado del sistema cada 500 transacciones procesadas
+if pc.is_multiple(total_transacciones, 500):
+    print("💾 Sincronizando checkpoint en la base de datos...")
+5. pc.is_negative(...)
+¿Qué hace?: Valida de forma rápida si un balance o indicador numérico cayó por debajo de cero. Sirve para lanzar alertas de saldos, controlar sobregiros o registrar anomalías de inventario físico.
+
+Qué poner en el paréntesis: La variable numérica que se va a inspeccionar.
+
+Ejemplo real:
+
+Python
+# Monitoreo de balance en cuentas corporativas
+if pc.is_negative(balance_cuenta):
+    print("🚨 Alerta: La cuenta presenta un saldo negativo. Bloqueando transacciones de salida.")
+6. pc.is_even(...) e pc.is_odd(...)
+¿Qué hace?: Detectan si un número es par (is_even) o impar (is_odd). En entornos backend se aplican para equilibrar cargas de trabajo mediante algoritmos Round-Robin, o para dividir el procesamiento de registros en hilos de ejecución alternos.
+
+Qué poner en el paréntesis: El número de ID o índice a evaluar.
+
+Ejemplo real:
+
+Python
+# Distribución balanceada de peticiones entre dos servidores esclavos
+if pc.is_even(id_peticion):
+    enviar_a_servidor_A()
+if pc.is_odd(id_peticion):
+    enviar_a_servidor_B()
+7. pc.is_percent(...)
+¿Qué hace?: Confirma que un valor numérico sea matemáticamente un porcentaje válido (comprendido de manera estricta entre 0 y 100). Evita errores de desbordamiento en reportes estadísticos o métricas de servidores.
+
+Qué poner en el paréntesis: El número flotante o entero a evaluar.
+
+Ejemplo real:
+
+Python
+# Validamos el dato recibido desde el sensor de uso de CPU antes de graficarlo
+if pc.is_percent(uso_cpu):
+    actualizar_dashboard_metrica(uso_cpu)
+🔠 Condicionales de Texto y Tipos de Datos
+8. pc.is_string(...) e pc.is_number(...)
+¿Qué hace?: Actúan como capas de defensa en la API o backend. Inspeccionan el tipo de dato original de una variable para prevenir errores de tipo (TypeError) antes de almacenar la información en bases de datos relacionales o hacer operaciones de negocio.
+
+Qué poner en el paréntesis: La variable entrante que deseas auditar.
+
+Ejemplo real:
+
+Python
+# Sanitización de datos en un formulario de registro antes de procesarlo
+if pc.is_string(nombre_cliente) and pc.is_number(monto_ingreso):
+    guardar_en_db(nombre_cliente, monto_ingreso)
+9. pc.is_vowel(...)
+¿Qué hace?: Determina si un carácter alfabético individual es una vocal. Se utiliza de forma profesional en motores de búsqueda, análisis lingüístico de textos (NLP), o algoritmos de indexación semántica.
+
+Qué poner en el paréntesis: Una cadena de texto con longitud exacta de 1 carácter.
+
+Ejemplo real:
+
+Python
+# Procesamiento de texto para filtros de búsqueda fonética
+if pc.is_vowel(caracter_actual):
+    incrementar_peso_silabico()
+10. pc.is_alphabetic(...)
+¿Qué hace?: Asegura que una cadena de texto contenga única y exclusivamente letras. Rechaza automáticamente caracteres especiales, números y espacios, sirviendo como filtro de seguridad contra inyecciones de código básicas en campos de nombres de usuario o códigos ISO.
+
+Qué poner en el paréntesis: La cadena de texto a auditar.
+
+Ejemplo real:
+
+Python
+if not pc.is_alphabetic(codigo_pais):
+    print("❌ Error: El código de país ISO debe contener únicamente letras de la A-Z.")
+11. pc.is_numeric_string(...)
+¿Qué hace?: Verifica si un String está formado puramente por dígitos numéricos (como un número de cuenta, un código de barras o un ID de empleado en formato texto). Te permite asegurar que la conversión mediante int() será exitosa y no tumbará el servidor web.
+
+Qué poner en el paréntesis: El string que deseas verificar.
+
+Ejemplo real:
+
+Python
+# Validación de una cadena que simula ser un número de identificación fiscal
+if pc.is_numeric_string(documento_identidad):
+    id_numerico = int(documento_identidad) # Operación completamente segura
+⏱️ Condicionales de Tiempo y Eventos
+12. pc.every(...)
+¿Qué hace?: Un temporizador lógico no bloqueante de alto rendimiento. Retorna True cada vez que transcurre el intervalo de tiempo especificado en segundos. Al no utilizar funciones bloqueantes como time.sleep(), el servidor o script puede seguir atendiendo miles de peticiones simultáneas sin perder rendimiento.
+
+Qué poner en el paréntesis: El intervalo de tiempo en segundos y una clave id_evento exclusiva para el rastreo del evento.
+
+Ejemplo real:
+
+Python
+while servidor_backend_activo:
+    # Sincroniza los tokens expirados de la memoria cada 60 segundos de forma asíncrona
+    if pc.every(60, id_evento="limpieza_sesiones_tokens"):
+        eliminar_tokens_expirados()
+13. pc.once(...)
+¿Qué hace?: Un interruptor de ejecución única con persistencia interna en memoria. Solo devolverá True la primera vez que el flujo del programa pase por la función; las siguientes evaluaciones darán False. Es óptimo para inicializar configuraciones del sistema, abrir sockets de red una sola vez o disparar alertas críticas de inicio.
+
+Qué poner en el paréntesis: Un identificador de texto único para el evento.
+
+Ejemplo real:
+
+Python
+def procesar_peticion_http(request):
+    # Dispara el logger de auditoría inicial solo con la primera llamada al servidor
+    if pc.once("inicializacion_logs_sistema"):
+        print("🚨 Auditoría: Sistema de logs corporativo conectado y escuchando...")
+🎒 Condicionales de Listas e Inventarios
+14. pc.is_any_in(...)
+¿Qué hace?: Revisa si existe una coincidencia parcial de elementos. Te dice si al menos uno de los componentes de una lista de origen se encuentra dentro de una lista de destino. Muy útil en sistemas de control de acceso basados en roles (RBAC).
+
+Qué poner en el paréntesis: La lista de elementos buscados y la lista contenedora donde se ejecutará la búsqueda.
+
+Ejemplo real:
+
+Python
+permisos_requeridos = ["ADMIN", "EDITOR"]
+# Verifica si el usuario autenticado tiene al menos uno de los permisos del endpoint
+if pc.is_any_in(permisos_requeridos, roles_usuario_actual):
+    permitir_acceso_al_modulo()
+15. pc.is_all_in(...)
+¿Qué hace?: Validador estricto de cumplimiento de listas. Devuelve True única y exclusivamente si todos los elementos requeridos de la primera lista están presentes en la segunda. Se utiliza habitualmente en validaciones de esquemas de API, listas de comprobación de despliegues (compliance) y auditoría de infraestructura.
+
+Qué poner en el paréntesis: La lista de elementos obligatorios y la lista a evaluar.
+
+Ejemplo real:
+
+Python
+archivos_obligatorios = ["config.json", "ssl.key", "database.db"]
+# Comprobamos que el servidor tenga todos sus archivos críticos antes de arrancar
+if pc.is_all_in(archivos_obligatorios, os.listdir("./app_data")):
+    print("✅ Configuración de sistema íntegra. Iniciando entorno de producción.")
+16. pc.is_ordered(...)
+¿Qué hace?: Validar si una estructura iterable (como una lista) conserva un orden secuencial estricto. Permite confirmar si los datos devueltos por una consulta de base de datos SQL o MongoDB se ordenaron correctamente a nivel de infraestructura antes de enviarlos a una aplicación cliente.
+
+Qué poner en el paréntesis: La lista a validar y opcionalmente el parámetro descendente=True.
+
+Ejemplo real:
+
+Python
+# Verificamos si los logs de marcas de tiempo vienen en estricto orden cronológico
+if pc.is_ordered(timestamps_servidor):
+    print("📈 Los registros mantienen una línea temporal coherente.")
+17. pc.has_duplicates(...)
+¿Qué hace?: Analiza colecciones de datos y te alerta si existen registros duplicados o filas repetidas. Es crucial para procesos de limpieza de datos en ciencia de datos (Data Wrangling), detección de transacciones clonadas idénticas o validaciones de correos electrónicos únicos en una base de datos.
+
+Qué poner en el paréntesis: La lista o tupla de elementos.
+
+Ejemplo real:
+
+Python
+if pc.has_duplicates(lista_correos_registro):
+    print("❌ Proceso denegado: Se detectaron registros duplicados en los correos ingresados.")
+18. pc.is_consecutive(...)
+¿Qué hace?: Evalúa una lista numérica y confirma si constituye una secuencia entera continua sin ningún tipo de interrupción o salto (1, 2, 3...). Se aplica profesionalmente para auditar que no existan saltos en las facturas correlativas emitidas por el sistema o pérdidas de paquetes de datos de red con número de secuencia.
+
+Qué poner en el paréntesis: La lista de enteros a auditar.
+
+Ejemplo real:
+
+Python
+# Verificación de auditoría fiscal en números de folios de facturas electrónicas
+if pc.is_consecutive(folios_facturación_mes):
+    print("📄 Secuencia contable correcta: No faltan folios en el lote financiero.")
+19. pc.is_empty(...)
+¿Qué hace?: Determina con precisión si una lista, diccionario, conjunto o string carece por completo de datos. Es mucho más legible y elegante en código corporativo que utilizar if len(objeto) == 0.
+
+Qué poner en el paréntesis: El contenedor o elemento de tipo texto que vas a evaluar.
+
+Ejemplo real:
+
+Python
+# Validamos el cuerpo de una petición JSON antes de procesarla
+if pc.is_empty(request_json_data):
+    print("🛑 HTTP 400: El cuerpo del payload de la API está completamente vacío.")
+20. pc.has_length(...)
+¿Qué hace?: Un validador de tamaño explícito. Retorna True si la colección contiene exactamente el número exacto de elementos requeridos. Ideal para validar estructuras estáticas de datos fijos.
+
+Qué poner en el paréntesis: La colección o texto, y la longitud numérica exacta deseada.
+
+Ejemplo real:
+
+Python
+# Verificación estructural de tramas de datos recibidas por protocolo TCP
+if pc.has_length(trama_bytes, 1024):
+    print("💾 Bloque de datos del tamaño exacto correcto. Guardando en búfer...")
+21. pc.has_element(...)
+¿Qué hace?: Proporciona un condicional funcional estandarizado para chequear la existencia de un objeto específico dentro de cualquier iterable, sustituyendo el operador nativo por una sintaxis funcional orientada a objetos.
+
+Qué poner en el paréntesis: La colección y el ítem buscado.
+
+Ejemplo real:
+
+Python
+if pc.has_element(direcciones_ip_bloqueadas, ip_cliente):
+    print("🚫 Acceso Denegado: La IP del cliente se encuentra en la lista de exclusión corporativa.")
+22. pc.has_min_length(...) y pc.has_max_length(...)
+¿Qué hace?: Validan que un texto o lista respete longitudes mínimas y máximas operacionales. Son indispensables en el manejo seguro de strings, validación de contraseñas complejas, longitudes de números telefónicos o límites en campos de comentarios para evitar desbordamientos de datos en la base de datos.
+
+Qué poner en el paréntesis: La estructura de datos o texto, y el límite numérico.
+
+Ejemplo real:
+
+Python
+# Validación de parámetros mínimos de seguridad en credenciales de usuario
+if not pc.has_min_length(password_usuario, 12):
+    print("❌ Error de seguridad: La credencial debe contener un mínimo de 12 caracteres.")
+🏗️ Estructuras Condicionales Avanzadas
+🔀 Clase pc.Switch
+¿Qué hace?: Es un motor de toma de decisiones jerárquico que reemplaza arquitecturas anidadas de if-elif-else. Permite mapear variables contra múltiples valores estáticos o colecciones de criterios en una sola llamada encadenada, mejorando drásticamente el mantenimiento del software.
+
+Ejemplo real:
+
+Python
+# Enrutamiento de flujos de pago dependiendo de la pasarela seleccionada
+codigo_respuesta = (
+    pc.Switch(metodo_pago_cliente)
+    .case("STRIPE", "Procesando cobro mediante pasarela Stripe internacional.")
+    .case(["PAYPAL", "MERCADOPAGO"], "Abriendo pasarela externa de pagos tokenizada.")
+    .default("Método de pago no soportado por el sistema.")
+    .run()
+)
+print(codigo_respuesta)
+⏳ Clase pc.Cooldown
+¿Qué hace?: Implementación del algoritmo Rate Limiting a nivel de código. Este objeto controla la frecuencia de ejecución de un bloque de código, impidiendo abusos por llamadas masivas. Es la herramienta perfecta para limitar reintentos de inicio de sesión de usuarios, restringir el envío masivo de correos electrónicos (spam) o evitar que un script sature una API externa de terceros superando los límites de la suscripción.
+
+Qué poner en el paréntesis: Los segundos obligatorios de espera entre ejecuciones.
+
+Ejemplo real:
+
+Python
+# Restringimos el envío de correos de restablecimiento de contraseña a uno cada 60 segundos
+limite_peticion_email = pc.Cooldown(60)
+
+def solicitar_recuperacion_cuenta():
+    if limite_peticion_email.ready():
+        enviar_correo_electronico()
+        print("📧 Enlace de recuperación enviado con éxito.")
+    else:
+        print(f"⏳ Petición bloqueada por seguridad. Reintente en {limite_peticion_email.tiempo_restante():.1f} segundos.")
+Desarrollado con altos estándares por Isaac. ¡Libre para usar en entornos de producción y software empresarial!

pycondicionals-1.0.0/README.md

@@ -0,0 +1,319 @@
+# pycondicionals 🚀
+
+Una librería creada por Isaac con condicionales lógicos avanzados y puros para Python. Diseñada especialmente para hacer el código de tus aplicaciones más limpio, evitando usar demasiados `if-elif-else`.
+
+## 📦 Instalación
+
+Puedes instalar esta librería directamente desde la terminal usando pip:
+
+```bash
+pip install pycondicionals
+
+¡Ah, vale, ya te capto por completo, Isaac! Quieres el archivo README.md completo y listo para copiar y pegar, pero con todas las descripciones enfocadas en este estilo serio, corporativo y profesional que acabamos de armar.
+
+Aquí tienes el archivo README.md definitivo con la introducción, los comandos de instalación y las 22 funciones explicadas con ejemplos reales de desarrollo backend, finanzas y ciberseguridad:
+
+Markdown
+# pycondicionals 🚀
+
+¡Bienvenido a **pycondicionals**! Una librería creada por Isaac que introduce condicionales lógicos avanzados, puros y limpios para Python.
+
+Esta librería está diseñada para entornos de desarrollo profesionales, backend, automatización y análisis de datos. Te ayuda a deshacerte de bloques complejos de `if-elif-else`, transformando lógica difusa en condicionales semánticos, seguros y fáciles de mantener.
+
+---
+
+## 📦 Instalación y Uso Básico
+
+Para instalar la librería de forma pública desde PyPI, ejecuta en tu terminal:
+```bash
+pip install pycondicionals
+Para integrarla en tus módulos de Python, impórtala usando el alias estándar pc:
+
+Python
+import pycondicionals as pc
+🛠️ Manual de Funciones Explicado
+Todas las funciones de pycondicionals son condicionales puros. Esto significa que no ejecutan acciones secundarias ni modifican tus variables por detrás; simplemente analizan los datos de entrada y devuelven un valor booleano (True o False). Son ideales para su uso directo dentro de estructuras if.
+
+🧮 Condicionales Matemáticos y Numéricos
+1. pc.between(...)
+¿Qué hace?: Esta función verifica si un valor numérico se encuentra dentro de un rango específico de tolerancia. Es ideal para procesos de validación de datos financieros o parámetros de configuración del sistema.
+
+Qué poner en el paréntesis: El valor a evaluar, el límite mínimo aceptable y el límite máximo permitido.
+
+Ejemplo real:
+
+Python
+# Validamos si la tasa de interés de un crédito está dentro de los márgenes legales
+if pc.between(tasa_interes, 1.5, 24.5):
+    print("✅ La tasa de interés se encuentra dentro de los parámetros permitidos.")
+2. pc.chance(...)
+¿Qué hace?: Ejecuta una evaluación probabilística basada en un porcentaje estadístico. En entornos profesionales se utiliza para simulación de fallos (Chaos Engineering), pruebas de carga aleatorias o algoritmos de enrutamiento de tráfico A/B Testing.
+
+Qué poner en el paréntesis: Un número flotante o entero del 0 al 100 que representa el porcentaje de probabilidad de éxito.
+
+Ejemplo real:
+
+Python
+# Simulamos una tasa de error del 5% para probar la resiliencia de un microservicio
+if pc.chance(5.0):
+    print("⚠️ Simulación de fallo de red activa: Reintentando conexión...")
+3. pc.is_prime(...)
+¿Qué hace?: Determina si un número entero es primo. Su aplicación principal radica en algoritmos criptográficos, validación de claves simétricas, hash distribuidos y generación de tokens de seguridad únicos.
+
+Qué poner en el paréntesis: El número entero que se desea comprobar.
+
+Ejemplo real:
+
+Python
+# Verificación previa de un bloque numérico para criptografía RSA
+if pc.is_prime(clave_generada):
+    print("🔐 El factor numérico cumple con las propiedades criptográficas iniciales.")
+4. pc.is_multiple(...)
+¿Qué hace?: Comprueba si un número es divisible exactamente por otro sin dejar residuo. Es extremadamente útil para ejecutar scripts periódicos, paginación de bases de datos o para guardar logs de auditoría en bloques de datos específicos (por ejemplo, cada 500 peticiones).
+
+Qué poner en el paréntesis: El contador o valor actual, y el divisor objetivo.
+
+Ejemplo real:
+
+Python
+# Guardamos un respaldo del estado del sistema cada 500 transacciones procesadas
+if pc.is_multiple(total_transacciones, 500):
+    print("💾 Sincronizando checkpoint en la base de datos...")
+5. pc.is_negative(...)
+¿Qué hace?: Valida de forma rápida si un balance o indicador numérico cayó por debajo de cero. Sirve para lanzar alertas de saldos, controlar sobregiros o registrar anomalías de inventario físico.
+
+Qué poner en el paréntesis: La variable numérica que se va a inspeccionar.
+
+Ejemplo real:
+
+Python
+# Monitoreo de balance en cuentas corporativas
+if pc.is_negative(balance_cuenta):
+    print("🚨 Alerta: La cuenta presenta un saldo negativo. Bloqueando transacciones de salida.")
+6. pc.is_even(...) e pc.is_odd(...)
+¿Qué hace?: Detectan si un número es par (is_even) o impar (is_odd). En entornos backend se aplican para equilibrar cargas de trabajo mediante algoritmos Round-Robin, o para dividir el procesamiento de registros en hilos de ejecución alternos.
+
+Qué poner en el paréntesis: El número de ID o índice a evaluar.
+
+Ejemplo real:
+
+Python
+# Distribución balanceada de peticiones entre dos servidores esclavos
+if pc.is_even(id_peticion):
+    enviar_a_servidor_A()
+if pc.is_odd(id_peticion):
+    enviar_a_servidor_B()
+7. pc.is_percent(...)
+¿Qué hace?: Confirma que un valor numérico sea matemáticamente un porcentaje válido (comprendido de manera estricta entre 0 y 100). Evita errores de desbordamiento en reportes estadísticos o métricas de servidores.
+
+Qué poner en el paréntesis: El número flotante o entero a evaluar.
+
+Ejemplo real:
+
+Python
+# Validamos el dato recibido desde el sensor de uso de CPU antes de graficarlo
+if pc.is_percent(uso_cpu):
+    actualizar_dashboard_metrica(uso_cpu)
+🔠 Condicionales de Texto y Tipos de Datos
+8. pc.is_string(...) e pc.is_number(...)
+¿Qué hace?: Actúan como capas de defensa en la API o backend. Inspeccionan el tipo de dato original de una variable para prevenir errores de tipo (TypeError) antes de almacenar la información en bases de datos relacionales o hacer operaciones de negocio.
+
+Qué poner en el paréntesis: La variable entrante que deseas auditar.
+
+Ejemplo real:
+
+Python
+# Sanitización de datos en un formulario de registro antes de procesarlo
+if pc.is_string(nombre_cliente) and pc.is_number(monto_ingreso):
+    guardar_en_db(nombre_cliente, monto_ingreso)
+9. pc.is_vowel(...)
+¿Qué hace?: Determina si un carácter alfabético individual es una vocal. Se utiliza de forma profesional en motores de búsqueda, análisis lingüístico de textos (NLP), o algoritmos de indexación semántica.
+
+Qué poner en el paréntesis: Una cadena de texto con longitud exacta de 1 carácter.
+
+Ejemplo real:
+
+Python
+# Procesamiento de texto para filtros de búsqueda fonética
+if pc.is_vowel(caracter_actual):
+    incrementar_peso_silabico()
+10. pc.is_alphabetic(...)
+¿Qué hace?: Asegura que una cadena de texto contenga única y exclusivamente letras. Rechaza automáticamente caracteres especiales, números y espacios, sirviendo como filtro de seguridad contra inyecciones de código básicas en campos de nombres de usuario o códigos ISO.
+
+Qué poner en el paréntesis: La cadena de texto a auditar.
+
+Ejemplo real:
+
+Python
+if not pc.is_alphabetic(codigo_pais):
+    print("❌ Error: El código de país ISO debe contener únicamente letras de la A-Z.")
+11. pc.is_numeric_string(...)
+¿Qué hace?: Verifica si un String está formado puramente por dígitos numéricos (como un número de cuenta, un código de barras o un ID de empleado en formato texto). Te permite asegurar que la conversión mediante int() será exitosa y no tumbará el servidor web.
+
+Qué poner en el paréntesis: El string que deseas verificar.
+
+Ejemplo real:
+
+Python
+# Validación de una cadena que simula ser un número de identificación fiscal
+if pc.is_numeric_string(documento_identidad):
+    id_numerico = int(documento_identidad) # Operación completamente segura
+⏱️ Condicionales de Tiempo y Eventos
+12. pc.every(...)
+¿Qué hace?: Un temporizador lógico no bloqueante de alto rendimiento. Retorna True cada vez que transcurre el intervalo de tiempo especificado en segundos. Al no utilizar funciones bloqueantes como time.sleep(), el servidor o script puede seguir atendiendo miles de peticiones simultáneas sin perder rendimiento.
+
+Qué poner en el paréntesis: El intervalo de tiempo en segundos y una clave id_evento exclusiva para el rastreo del evento.
+
+Ejemplo real:
+
+Python
+while servidor_backend_activo:
+    # Sincroniza los tokens expirados de la memoria cada 60 segundos de forma asíncrona
+    if pc.every(60, id_evento="limpieza_sesiones_tokens"):
+        eliminar_tokens_expirados()
+13. pc.once(...)
+¿Qué hace?: Un interruptor de ejecución única con persistencia interna en memoria. Solo devolverá True la primera vez que el flujo del programa pase por la función; las siguientes evaluaciones darán False. Es óptimo para inicializar configuraciones del sistema, abrir sockets de red una sola vez o disparar alertas críticas de inicio.
+
+Qué poner en el paréntesis: Un identificador de texto único para el evento.
+
+Ejemplo real:
+
+Python
+def procesar_peticion_http(request):
+    # Dispara el logger de auditoría inicial solo con la primera llamada al servidor
+    if pc.once("inicializacion_logs_sistema"):
+        print("🚨 Auditoría: Sistema de logs corporativo conectado y escuchando...")
+🎒 Condicionales de Listas e Inventarios
+14. pc.is_any_in(...)
+¿Qué hace?: Revisa si existe una coincidencia parcial de elementos. Te dice si al menos uno de los componentes de una lista de origen se encuentra dentro de una lista de destino. Muy útil en sistemas de control de acceso basados en roles (RBAC).
+
+Qué poner en el paréntesis: La lista de elementos buscados y la lista contenedora donde se ejecutará la búsqueda.
+
+Ejemplo real:
+
+Python
+permisos_requeridos = ["ADMIN", "EDITOR"]
+# Verifica si el usuario autenticado tiene al menos uno de los permisos del endpoint
+if pc.is_any_in(permisos_requeridos, roles_usuario_actual):
+    permitir_acceso_al_modulo()
+15. pc.is_all_in(...)
+¿Qué hace?: Validador estricto de cumplimiento de listas. Devuelve True única y exclusivamente si todos los elementos requeridos de la primera lista están presentes en la segunda. Se utiliza habitualmente en validaciones de esquemas de API, listas de comprobación de despliegues (compliance) y auditoría de infraestructura.
+
+Qué poner en el paréntesis: La lista de elementos obligatorios y la lista a evaluar.
+
+Ejemplo real:
+
+Python
+archivos_obligatorios = ["config.json", "ssl.key", "database.db"]
+# Comprobamos que el servidor tenga todos sus archivos críticos antes de arrancar
+if pc.is_all_in(archivos_obligatorios, os.listdir("./app_data")):
+    print("✅ Configuración de sistema íntegra. Iniciando entorno de producción.")
+16. pc.is_ordered(...)
+¿Qué hace?: Validar si una estructura iterable (como una lista) conserva un orden secuencial estricto. Permite confirmar si los datos devueltos por una consulta de base de datos SQL o MongoDB se ordenaron correctamente a nivel de infraestructura antes de enviarlos a una aplicación cliente.
+
+Qué poner en el paréntesis: La lista a validar y opcionalmente el parámetro descendente=True.
+
+Ejemplo real:
+
+Python
+# Verificamos si los logs de marcas de tiempo vienen en estricto orden cronológico
+if pc.is_ordered(timestamps_servidor):
+    print("📈 Los registros mantienen una línea temporal coherente.")
+17. pc.has_duplicates(...)
+¿Qué hace?: Analiza colecciones de datos y te alerta si existen registros duplicados o filas repetidas. Es crucial para procesos de limpieza de datos en ciencia de datos (Data Wrangling), detección de transacciones clonadas idénticas o validaciones de correos electrónicos únicos en una base de datos.
+
+Qué poner en el paréntesis: La lista o tupla de elementos.
+
+Ejemplo real:
+
+Python
+if pc.has_duplicates(lista_correos_registro):
+    print("❌ Proceso denegado: Se detectaron registros duplicados en los correos ingresados.")
+18. pc.is_consecutive(...)
+¿Qué hace?: Evalúa una lista numérica y confirma si constituye una secuencia entera continua sin ningún tipo de interrupción o salto (1, 2, 3...). Se aplica profesionalmente para auditar que no existan saltos en las facturas correlativas emitidas por el sistema o pérdidas de paquetes de datos de red con número de secuencia.
+
+Qué poner en el paréntesis: La lista de enteros a auditar.
+
+Ejemplo real:
+
+Python
+# Verificación de auditoría fiscal en números de folios de facturas electrónicas
+if pc.is_consecutive(folios_facturación_mes):
+    print("📄 Secuencia contable correcta: No faltan folios en el lote financiero.")
+19. pc.is_empty(...)
+¿Qué hace?: Determina con precisión si una lista, diccionario, conjunto o string carece por completo de datos. Es mucho más legible y elegante en código corporativo que utilizar if len(objeto) == 0.
+
+Qué poner en el paréntesis: El contenedor o elemento de tipo texto que vas a evaluar.
+
+Ejemplo real:
+
+Python
+# Validamos el cuerpo de una petición JSON antes de procesarla
+if pc.is_empty(request_json_data):
+    print("🛑 HTTP 400: El cuerpo del payload de la API está completamente vacío.")
+20. pc.has_length(...)
+¿Qué hace?: Un validador de tamaño explícito. Retorna True si la colección contiene exactamente el número exacto de elementos requeridos. Ideal para validar estructuras estáticas de datos fijos.
+
+Qué poner en el paréntesis: La colección o texto, y la longitud numérica exacta deseada.
+
+Ejemplo real:
+
+Python
+# Verificación estructural de tramas de datos recibidas por protocolo TCP
+if pc.has_length(trama_bytes, 1024):
+    print("💾 Bloque de datos del tamaño exacto correcto. Guardando en búfer...")
+21. pc.has_element(...)
+¿Qué hace?: Proporciona un condicional funcional estandarizado para chequear la existencia de un objeto específico dentro de cualquier iterable, sustituyendo el operador nativo por una sintaxis funcional orientada a objetos.
+
+Qué poner en el paréntesis: La colección y el ítem buscado.
+
+Ejemplo real:
+
+Python
+if pc.has_element(direcciones_ip_bloqueadas, ip_cliente):
+    print("🚫 Acceso Denegado: La IP del cliente se encuentra en la lista de exclusión corporativa.")
+22. pc.has_min_length(...) y pc.has_max_length(...)
+¿Qué hace?: Validan que un texto o lista respete longitudes mínimas y máximas operacionales. Son indispensables en el manejo seguro de strings, validación de contraseñas complejas, longitudes de números telefónicos o límites en campos de comentarios para evitar desbordamientos de datos en la base de datos.
+
+Qué poner en el paréntesis: La estructura de datos o texto, y el límite numérico.
+
+Ejemplo real:
+
+Python
+# Validación de parámetros mínimos de seguridad en credenciales de usuario
+if not pc.has_min_length(password_usuario, 12):
+    print("❌ Error de seguridad: La credencial debe contener un mínimo de 12 caracteres.")
+🏗️ Estructuras Condicionales Avanzadas
+🔀 Clase pc.Switch
+¿Qué hace?: Es un motor de toma de decisiones jerárquico que reemplaza arquitecturas anidadas de if-elif-else. Permite mapear variables contra múltiples valores estáticos o colecciones de criterios en una sola llamada encadenada, mejorando drásticamente el mantenimiento del software.
+
+Ejemplo real:
+
+Python
+# Enrutamiento de flujos de pago dependiendo de la pasarela seleccionada
+codigo_respuesta = (
+    pc.Switch(metodo_pago_cliente)
+    .case("STRIPE", "Procesando cobro mediante pasarela Stripe internacional.")
+    .case(["PAYPAL", "MERCADOPAGO"], "Abriendo pasarela externa de pagos tokenizada.")
+    .default("Método de pago no soportado por el sistema.")
+    .run()
+)
+print(codigo_respuesta)
+⏳ Clase pc.Cooldown
+¿Qué hace?: Implementación del algoritmo Rate Limiting a nivel de código. Este objeto controla la frecuencia de ejecución de un bloque de código, impidiendo abusos por llamadas masivas. Es la herramienta perfecta para limitar reintentos de inicio de sesión de usuarios, restringir el envío masivo de correos electrónicos (spam) o evitar que un script sature una API externa de terceros superando los límites de la suscripción.
+
+Qué poner en el paréntesis: Los segundos obligatorios de espera entre ejecuciones.
+
+Ejemplo real:
+
+Python
+# Restringimos el envío de correos de restablecimiento de contraseña a uno cada 60 segundos
+limite_peticion_email = pc.Cooldown(60)
+
+def solicitar_recuperacion_cuenta():
+    if limite_peticion_email.ready():
+        enviar_correo_electronico()
+        print("📧 Enlace de recuperación enviado con éxito.")
+    else:
+        print(f"⏳ Petición bloqueada por seguridad. Reintente en {limite_peticion_email.tiempo_restante():.1f} segundos.")
+Desarrollado con altos estándares por Isaac. ¡Libre para usar en entornos de producción y software empresarial!

pycondicionals-1.0.0/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "pycondicionals"
+version = "1.0.0"
+authors = [{ name = "Isaac" }]
+description = "Librería con condicionales lógicos avanzados y puros para Python"
+readme = "README.md"
+requires-python = ">=3.8"
+[tool.hatch.build.targets.wheel]
+packages = ["."]

pycondicionals-1.0.0/src/__init__.py

@@ -0,0 +1,280 @@
+import random
+import time
+
+# ==========================================
+# --- CONDICIONALES NUMÉRICOS Y MATEMÁTICOS ---
+# ==========================================
+
+def between(valor, minimo, maximo, inclusivo=True):
+    """Verifica si un número está dentro de un rango."""
+    try:
+        val, mini, maxi = float(valor), float(minimo), float(maximo)
+        if inclusivo:
+            return mini <= val <= maxi
+        return mini < val < maxi
+    except (ValueError, TypeError):
+        return False
+
+def chance(porcentaje_exito):
+    """Condicional probabilístico basado en azar (0 a 100)."""
+    try:
+        pct = float(porcentaje_exito)
+        pct = max(0.0, min(100.0, pct))
+        return random.uniform(0, 100) <= pct
+    except (ValueError, TypeError):
+        return False
+
+def is_prime(n):
+    """Condicional matemático: Devuelve True si el número es primo."""
+    try:
+        n = int(n)
+        if n <= 1: return False
+        if n == 2: return True
+        if n % 2 == 0: return False
+        for i in range(3, int(n**0.5) + 1, 2):
+            if n % i == 0: return False
+        return True
+    except (ValueError, TypeError):
+        return False
+
+def is_multiple(valor, divisor):
+    """Devuelve True si 'valor' es divisible exactamente por 'divisor'."""
+    try:
+        return float(valor) % float(divisor) == 0
+    except (ValueError, TypeError, ZeroDivisionError):
+        return False
+
+def is_negative(valor):
+    """Devuelve True si el número es menor que cero."""
+    try:
+        return float(valor) < 0
+    except (ValueError, TypeError):
+        return False
+
+def is_even(valor):
+    """Devuelve True si el número es par."""
+    try:
+        return int(valor) % 2 == 0
+    except (ValueError, TypeError):
+        return False
+
+def is_odd(valor):
+    """Devuelve True si el número es impar."""
+    try:
+        return int(valor) % 2 != 0
+    except (ValueError, TypeError):
+        return False
+
+def is_percent(valor):
+    """Devuelve True si el número está entre 0 y 100 inclusive."""
+    try:
+        return 0.0 <= float(valor) <= 100.0
+    except (ValueError, TypeError):
+        return False
+
+
+# ==========================================
+# --- CONDICIONALES DE TIPO DE DATO ---
+# ==========================================
+
+def is_string(variable):
+    """Devuelve True si la variable contiene texto pura (str)."""
+    return isinstance(variable, str)
+
+def is_number(variable):
+    """Devuelve True si la variable es un número (int o float)."""
+    return isinstance(variable, (int, float)) and not isinstance(variable, bool)
+
+
+# ==========================================
+# --- CONDICIONALES DE TEXTO (STRINGS) ---
+# ==========================================
+
+def is_vowel(caracter):
+    """Devuelve True si el carácter ingresado es una vocal."""
+    try:
+        char = str(caracter).lower()
+        return len(char) == 1 and char in 'aeiouáéíóúü'
+    except (ValueError, TypeError):
+        return False
+
+def is_alphabetic(texto):
+    """Devuelve True si el texto contiene únicamente letras (sin números ni símbolos)."""
+    if not isinstance(texto, str): return False
+    return texto.isalpha()
+
+def is_numeric_string(texto):
+    """Devuelve True si el string está compuesto únicamente de números."""
+    if not isinstance(texto, str): return False
+    return texto.isdigit()
+
+
+# ==========================================
+# --- CONDICIONALES DE TIEMPO ---
+# ==========================================
+
+_tiempos_every = {}
+
+def every(segundos, id_evento="defecto", reset=False):
+    """Condicional de tiempo: True solo si ya pasó el intervalo indicado."""
+    global _tiempos_every
+    if reset:
+        if id_evento in _tiempos_every: del _tiempos_every[id_evento]
+        return False
+        
+    tiempo_actual = time.time()
+    tiempo_anterior = _tiempos_every.get(id_evento, 0)
+    
+    if tiempo_actual - tiempo_anterior >= segundos:
+        _tiempos_every[id_evento] = tiempo_actual
+        return True
+    return False
+
+_eventos_unicos = set()
+
+def once(id_evento, reset=False):
+    """Condicional único: True solo la primera vez que se evalúa."""
+    global _eventos_unicos
+    if reset:
+        if id_evento in _eventos_unicos: _eventos_unicos.remove(id_evento)
+        return False
+        
+    if id_evento not in _eventos_unicos:
+        _eventos_unicos.add(id_evento)
+        return True
+    return False
+
+
+# ==========================================
+# --- CONDICIONALES DE LISTAS Y COLECCIONES ---
+# ==========================================
+
+def is_any_in(lista_buscar, lista_destino):
+    """Devuelve True si al menos un elemento está en la lista destino."""
+    try:
+        return any(item in lista_destino for item in lista_buscar)
+    except TypeError:
+        return False
+
+def is_all_in(lista_buscar, lista_destino):
+    """Devuelve True si todos los elementos requeridos están en la lista destino."""
+    try:
+        return all(item in lista_destino for item in lista_buscar)
+    except TypeError:
+        return False
+
+def is_ordered(lista, descendente=False):
+    """Devuelve True si la lista está perfectamente ordenada."""
+    try:
+        if len(lista) <= 1: return True
+        if descendente:
+            return all(lista[i] >= lista[i + 1] for i in range(len(lista) - 1))
+        return all(lista[i] <= lista[i + 1] for i in range(len(lista) - 1))
+    except TypeError:
+        return False
+
+def has_duplicates(lista):
+    """Devuelve True si hay elementos repetidos en la lista."""
+    try:
+        return len(lista) != len(set(lista))
+    except TypeError:
+        return False
+
+def is_consecutive(lista):
+    """Devuelve True si la lista de números sigue una secuencia perfecta sin saltos."""
+    try:
+        if not lista: return False
+        lista_ordenada = sorted(lista)
+        return all(lista_ordenada[i] + 1 == lista_ordenada[i + 1] for i in range(len(lista_ordenada) - 1))
+    except (TypeError, ValueError):
+        return False
+
+def is_empty(coleccion):
+    """Devuelve True si la lista, diccionario o texto no tiene elementos."""
+    try:
+        return len(coleccion) == 0
+    except TypeError:
+        return False
+
+def has_length(coleccion, longitud_requerida):
+    """Devuelve True si la colección tiene exactamente el tamaño indicado."""
+    try:
+        return len(coleccion) == int(longitud_requerida)
+    except (TypeError, ValueError):
+        return False
+
+def has_element(coleccion, elemento):
+    """Devuelve True si el elemento indicado se encuentra dentro de la colección."""
+    try:
+        return elemento in coin-collection if hasattr(coleccion, 'append') else elemento in coleccion
+    except TypeError:
+        return elemento in coleccion
+
+def has_min_length(coleccion, minimo):
+    """Devuelve True si la colección tiene una longitud igual o mayor al mínimo."""
+    try:
+        return len(coleccion) >= int(minimo)
+    except (TypeError, ValueError):
+        return False
+
+def has_max_length(coleccion, maximo):
+    """Devuelve True si la colección tiene una longitud igual o menor al máximo."""
+    try:
+        return len(coleccion) <= int(maximo)
+    except (TypeError, ValueError):
+        return False
+
+
+# ==========================================
+# --- ESTRUCTURAS CONDICIONALES COMPLEJAS ---
+# ==========================================
+
+class Switch:
+    """Clase para evaluar un valor contra múltiples casos ordenados."""
+    def __init__(self, valor_a_evaluar):
+        self.valor = valor_a_evaluar
+        self.casos = []
+        self.defecto = None
+
+    def case(self, condicion, resultado_o_funcion):
+        self.casos.append((condicion, resultado_o_funcion))
+        return self
+
+    def default(self, resultado_o_funcion):
+        self.defecto = resultado_o_funcion
+        return self
+
+    def run(self):
+        for condicion, resultado in self.casos:
+            coincide = False
+            if callable(condicion):
+                try: coincide = condicion(self.valor)
+                except Exception: coincide = False
+            elif isinstance(condicion, list):
+                coincide = self.valor in condicion
+            else:
+                coincide = self.valor == condicion
+
+            if coincide:
+                return resultado() if callable(resultado) else resultado
+        
+        return self.defecto() if callable(self.defecto) else self.defecto
+
+class Cooldown:
+    """Condicional de recarga para controlar la frecuencia de eventos."""
+    def __init__(self, tiempo_espera):
+        self.tiempo_espera = tiempo_espera
+        self.ultimo_uso = 0
+
+    def ready(self):
+        ahora = time.time()
+        if ahora - self.ultimo_uso >= self.tiempo_espera:
+            self.ultimo_uso = ahora
+            return True
+        return False
+        
+    def reset(self):
+        self.ultimo_uso = 0
+        
+    def tiempo_restante(self):
+        return max(0.0, self.tiempo_espera - (time.time() - self.ultimo_uso))