ctfutils 1.0.0

A comprehensive functional toolkit for CTF (Capture The Flag) competitions - 87 pure functions for crypto, stego, forensics, and more

🔐 CTFUtils

Tu arsenal definitivo para dominar CTFs

¿Cansado de googlear herramientas CTF? ¡CTFUtils tiene todo lo que necesitas!

🚀 Instalación • ⚡ Inicio Rápido • 🎯 Ejemplos • 📚 Documentación

---

🎯 ¿Por qué CTFUtils?

Antes: "¿Dónde está mi script de Caesar cipher? ¿Cómo se hace LSB steganography otra vez?"

Después:

from ctfutils.crypto import caesar_brute_force
caesar_brute_force("WKLV LV HQFUBSWHG")  # ¡Boom! 💥

✅ 4 módulos completos - Crypto, Forensics, Stego, Misc
✅ 87 funciones puras - Programación funcional moderna
✅ Ejemplos reales - Casos de CTFs auténticos
✅ API simple - Sin clases, solo funciones directas

🚀 Instalación Rápida

# Clona el repo
git clone https://github.com/Oxidizerhack/ctfutils.git
cd ctfutils

# Instala y listo
pip install -e .

⚡ Inicio Rápido

# Crypto: Rompe Caesar en una línea
from ctfutils.crypto import caesar_brute_force
caesar_brute_force("KHOOR ZRUOG")  # Encuentra "HELLO WORLD"

# Stego: Oculta mensajes como un ninja
from ctfutils.stego import zero_width_encode
hidden = zero_width_encode("FLAG{hidden}")

# Forensics: Analiza archivos sospechosos
from ctfutils.forensics import get_file_signature
get_file_signature("mystery.bin")  # "PNG Image"

# Misc: Convierte todo a todo
from ctfutils.misc import decimal_to_binary
decimal_to_binary(1337)  # "10100111001"

�️ Arsenal Completo

🔐 Crypto	🔍 Forensics	🖼️ Stego	🔧 Misc
Caesar Cipher	File Analysis	Text Hiding	Base Conversion
Vigenère Cipher	Memory Dumps	Image LSB	String Manipulation
Hash Cracking	Network Logs	Zero-Width	Encoding/Decoding
Modern Crypto	Binary Analysis	Audio Stego	Math Utils

🎯 Ver todas las funciones

🔐 Crypto (ctfutils.crypto) - 18 funciones

• Cifrado Clásico: caesar_encrypt, caesar_decrypt, caesar_brute_force, vigenere_encrypt, vigenere_decrypt
• Codificación Moderna: base64_encode, base64_decode, is_base64, xor_encrypt, xor_decrypt_hex, xor_brute_force_single_byte
• Hashing: md5_hash, sha1_hash, sha256_hash, sha512_hash, identify_hash, verify_hash, hash_all_types

🔍 Forensics (ctfutils.forensics) - 15 funciones

• Análisis de Archivos: extract_strings, get_file_signature, extract_metadata, find_hidden_files, create_hex_dump
• Análisis de Red: parse_pcap_basic, extract_http_requests, extract_urls, extract_ip_addresses, extract_email_addresses, analyze_log_file
• Análisis de Memoria: find_patterns, extract_processes, find_registry_keys, extract_urls_from_memory, search_memory_strings

🖼️ Stego (ctfutils.stego) - 12 funciones

• Texto: hide_text_whitespace, extract_text_whitespace, zero_width_encode, zero_width_decode, hide_in_text_zero_width, extract_from_text_zero_width
• Imagen: hide_text_lsb, extract_text_lsb, analyze_image
• Audio: hide_text_audio, extract_text_audio, analyze_audio_spectrum

🔧 Misc (ctfutils.misc) - 42 funciones

• Encodings: hex_encode, hex_decode, binary_encode, binary_decode, base32_encode, base32_decode, url_encode, url_decode, morse_encode, morse_decode, rot_encode, atbash_encode
• Conversores: decimal_to_binary, binary_to_decimal, decimal_to_hex, hex_to_decimal, ascii_to_hex, hex_to_ascii, text_to_ascii_values, ascii_values_to_text
• String Utils: reverse_string, swap_case, remove_whitespace, chunk_string, interleave_strings, extract_numbers, extract_letters, char_frequency
• Math Utils: calculate_entropy, find_common_factors, gcd, lcm, is_prime, prime_factors
• Validación: validate_input, safe_divide, hamming_distance, levenshtein_distance
• Wordlists: generate_wordlist, bruteforce_pattern

Total: 87 funciones puras 🚀

🎯 Ejemplos

🔓 Caesar Cipher Brute Force

from ctfutils.crypto import caesar_brute_force

# Mensaje interceptado en CTF
encrypted = "WKLV LV D VHFUHW PHVVDJH"

# Rompe el cipher automáticamente 
solutions = caesar_brute_force(encrypted)

# Encuentra "THIS IS A SECRET MESSAGE"
print(solutions[3])  # ¡Boom! 💥

🕵️ Análisis Forense Express

from ctfutils.forensics import get_file_signature, extract_strings

# Archivo sospechoso
file_type = get_file_signature("mystery.bin")  # "PNG Image"
strings = extract_strings("mystery.bin", min_length=6)  # ["hidden_flag"]

🥷 Esteganografía Ninja

from ctfutils.stego import zero_width_encode, zero_width_decode

# Oculta un flag en caracteres invisibles
hidden = zero_width_encode("FLAG{invisible}")

# Nadie sospecha nada... 😏
print(len(hidden))  # Solo caracteres zero-width

# Extrae el flag
flag = zero_width_decode(hidden)  # "FLAG{invisible}"

🧪 Testing

Todas las funciones probadas y funcionando:

# Prueba completa de todas las funciones
python test_completo.py

# Corre los tests unitarios
python -m pytest tests/ -v

# Ver cobertura
python -m pytest tests/ --cov=ctfutils

📊 Ver resultados de tests

📦 MÓDULO CRYPTO
✅ Caesar: 'HELLO' → 'KHOOR'
✅ Vigenere: 'SECRET' + KEY → 'CIABIR'
✅ Base64: 'test' → 'dGVzdA=='
✅ MD5: 'password' → '5f4dcc3b5aa765d6...'

📦 MÓDULO STEGO
✅ Whitespace Stego: Oculto 'SECRET'
✅ Zero-Width: 'HI' → 8 caracteres invisibles

📦 MÓDULO MISC
✅ Hex Encode: 'CTF' → '435446'
✅ Dec to Bin: 42 → '00101010'
✅ Entropy: 'aaabbc' → 1.4591

📦 MÓDULO FORENSICS
✅ Extract URLs: ['https://example.com']
✅ Extract IPs: ['192.168.1.100']

======================== ✅ ALL TESTS PASSED ========================

📚 Documentación

• Ejemplos Prácticos - Casos reales de CTF
• API Reference - Documentación completa
• Guías de Uso - Tutoriales paso a paso

🤝 Contribuir

¿Encontraste un bug? ¿Tienes una idea genial?

# Fork, clone, código, commit, push, PR
git clone https://github.com/Oxidizerhack/Pgr2_Practica7.git
cd ctfutils
# Haz tu magia ✨
git commit -m "feat: nueva herramienta épica"

Construido con ❤️ para la comunidad CTF

📧 Contacto • 🐛 Issues • 💡 Features

Licencia MIT - Úsalo, modifícalo, compártelo

---

📦 Instalación desde PyPI

Una vez que la librería esté publicada en PyPI, podrás instalarla fácilmente:

🚀 Instalación Simple

# Instalar desde PyPI
pip install ctfutils

🔧 Instalación con Dependencias de Desarrollo

# Para contribuidores y desarrolladores
pip install ctfutils[dev]

🐍 Uso después de la instalación

# Importar funciones directamente
from ctfutils.crypto import caesar_brute_force, base64_decode
from ctfutils.stego import zero_width_encode
from ctfutils.forensics import extract_strings
from ctfutils.misc import hex_encode, calculate_entropy

# ¡Listo para usar en tus CTFs!
result = caesar_brute_force("ENCRYPTED_TEXT")
entropy = calculate_entropy("suspicious_data")

📋 Comandos de Publicación (para maintainers)

# 1. Generar distribución
python -m build

# 2. Verificar paquete
python -m twine check dist/*

# 3. Subir a PyPI
python -m twine upload dist/*

# 4. Verificar instalación
pip install ctfutils