100 Días de Código en Python — Día 82: Proyecto de portafolio — el traductor de código Morse (y cómo salir del "infierno de los tutoriales")

📝 Contenido original del curso#

Los próximos 20 proyectos están diseñados para consolidar todo lo aprendido, pero sobre todo son una prueba de fuego. Uno de los mayores peligros para quien aprende por su cuenta es quedarse atrapado en el "infierno de los tutoriales" (tutorial hell): solo saber hacer lo que el tutorial enseña, sin llegar a ser un desarrollador completo.

La salida es construir proyectos por tu cuenta, sin guía. Te vas a atascar muchas veces, vas a sufrir y quizá dudes de ti. La frase clave: "esto le pasa a todo el mundo". No estás solo: cualquier profesional te dirá que su primer proyecto desde cero fue de lo más difícil y también de lo más gratificante. Tendrás que usar todas las herramientas a tu alcance: Google, StackOverflow, YouTube, libros y tus apuntes. Si no te rindes, saldrás siendo mejor desarrollador.

Estos 20 proyectos te llevan de desarrollador junior (que depende de tutoriales) a profesional (que depende de sí mismo), y construyen tu portafolio: por primera vez, todo el código será tuyo. Puedes protegerlo con derechos de autor, subirlo a GitHub para mostrarlo a reclutadores o crear tu propia empresa con él.

"¡Buena suerte! Nos vemos del otro lado. — Tu amiga, Angela".

📖 Explicación (adaptación)#

¿Cómo se ve el "infierno de los tutoriales"?

Cambio de roles en este bloque: hasta ahora, el curso te daba el problema y el camino. Desde hoy te da solo el problema. Este tutorial te ayuda a pensar el camino, pero las decisiones y el código son tuyos.

🏫 Para el aula: en estos proyectos, el docente acompaña con preguntas más que con respuestas. Es normal (y deseable) que dos estudiantes entreguen programas distintos para el mismo enunciado.

📝 Contenido original del curso#

Instrucciones de la tarea (tiempo estimado: 60 minutos).

Usa lo que has aprendido para crear un programa de texto (de línea de comandos) que reciba cualquier texto (String) y lo convierta a código Morse.

Ya creaste muchos programas de texto en los Días 1 a 10: revisa esos proyectos si no recuerdas cómo son.

Referencia: entrada de Wikipedia sobre el código Morse (se abre en otra pestaña).

El diseño, la funcionalidad y el estilo del código dependen totalmente de ti. "Ahora eres tú quien decide".

Pregunta de la tarea — Momento de reflexión: este es un lugar para escribir tu experiencia al completar el proyecto, para descubrir cómo mejorar como desarrollador. Escribe cómo abordaste el proyecto; qué fue difícil y qué fácil; cómo podrías mejorar en el próximo; cuál fue tu mayor aprendizaje; y qué harías distinto si lo hicieras de nuevo. "Este es tu diario de desarrollador. No hay respuestas correctas o incorrectas, solo aprendizajes".

📖 Qué es el código Morse (adaptación)#

El código Morse representa cada letra con una secuencia de puntos (señales cortas) y rayas (señales largas). Se usó en el telégrafo desde el siglo XIX y aún se usa en radioafición y en señales de emergencia. El ejemplo más famoso:

S O S  ->  ... --- ...

En el alfabeto Morse internacional, las letras más frecuentes en inglés tienen los códigos más cortos (E = ., T = -), una idea de compresión que reaparece en informática.

🔍 Antes de programar#

Responde por escrito antes de abrir el editor:

Descomposición en partes#

Traductor Morse
├── 1. Datos: tabla de equivalencias (letras, números, signos)
├── 2. Preparar el texto: mayúsculas, tildes, espacios de más
├── 3. Traducir: carácter por carácter, palabra por palabra
├── 4. Manejar lo desconocido: ¿omitir?, ¿avisar?, ¿marcar con "?"?
├── 5. Interfaz: pedir el texto, mostrar el resultado, repetir o salir
└── 6. Pruebas: casos normales, bordes y errores

Pseudocódigo (algoritmo en español)#

MIENTRAS el usuario quiera seguir:
    pedir un texto
    SI el texto está vacío: avisar y volver a pedir
    convertir el texto a mayúsculas
    PARA cada palabra del texto:
        PARA cada carácter de la palabra:
            SI el carácter está en la tabla: agregar su código
            SI NO: decidir qué hacer (sección 4)
        separar los códigos de las letras con un espacio
    separar las palabras con " / "
    mostrar el resultado

🔎 Ejemplo explicado: construir la tabla sin escribir 26 líneas#

LETRAS = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
CODIGOS = (".- -... -.-. -.. . ..-. --. .... .. .--- -.- .-.. -- -. --- "
           ".--. --.- .-. ... - ..- ...- .-- -..- -.-- --..").split()

MORSE = dict(zip(LETRAS, CODIGOS))
MORSE['S']    # '...'
MORSE['O']    # '---'
len(MORSE)    # 26

• .split() sin argumentos separa por espacios y crea una lista de 26 códigos.
• zip empareja la primera letra con el primer código, la segunda con el segundo…
• dict(...) convierte esos pares en un diccionario.

¿Cómo sabes que no te equivocaste al copiar? Con pruebas (sección 6): por ejemplo, assert len(set(CODIGOS)) == 26 comprueba que no repetiste ningún código.

⚠️ Tu turno: esta tabla solo tiene letras. Los números (0–9) y algunos signos (., ,, ?) también tienen código Morse: agrégalos consultando la referencia del curso.

Un fragmento útil: quitar tildes#

import unicodedata

def quitar_tildes(texto):
    descompuesto = unicodedata.normalize('NFD', texto)    # "á" -> "a" + tilde
    return ''.join(c for c in descompuesto if unicodedata.category(c) != 'Mn')

quitar_tildes('Canción ÁRBOL pingüino')    # 'Cancion ARBOL pinguino'

NFD separa cada letra de su tilde, y la categoría 'Mn' corresponde a esas marcas. Pero cuidado: verificado, quitar_tildes('año') devuelve 'ano': la ñ también pierde su "tilde" y la palabra cambia de significado. Esa es una decisión de diseño (sección 4).

⚠️ Errores frecuentes#

Problema#

Crear un programa de consola que convierta cualquier texto en código Morse.

Contexto#

Imagina que el club de radioafición o el grupo scout del colegio necesita practicar mensajes en Morse y quiere una herramienta sencilla para comprobar sus traducciones.

Objetivo#

Un programa propio, organizado en funciones, probado y documentado, publicado en GitHub.

Requisitos funcionales#

1. Pedir un texto al usuario y mostrar su traducción.
2. Aceptar mayúsculas y minúsculas.
3. Traducir letras y números (y, si quieres, signos de puntuación).
4. Separar letras y palabras de forma que el resultado se pueda leer (y traducir de vuelta).
5. Manejar caracteres desconocidos sin que el programa se detenga.
6. Permitir traducir varios textos sin reiniciar el programa, y salir cuando el usuario quiera.

Restricciones técnicas#

• La traducción en una función que recibe un texto y devuelve otro (sin print ni input dentro).
• La tabla de equivalencias en un diccionario.
• Nombres descriptivos y un comentario en cada decisión de diseño.
• El proyecto en un repositorio de GitHub con README.md (Día 70).

Planificación#

1. Comprender el problema (sección 1). 2. Entradas: un texto. 3. Procesos: normalizar → traducir → unir. 4. Salidas: el texto en Morse. 5. Dividir el problema (sección 2). 6. Diseñar: tomar las decisiones de la sección 4. 7. Implementar por versiones. 8. Probar (sección 6). 9. Corregir. 10. Mejorar con los retos.

Construcción paso a paso#

Versión 1 — Una letra. Crea el diccionario y traduce una sola letra escrita por el usuario. Prueba con S, o (minúscula) y ñ. ¿Qué pasa con cada una?

Versión 2 — Una palabra. Crea la función a_morse(palabra) que recorre la palabra con un for, acumula los códigos en una lista y los une con ' '.join(...). Esqueleto:

def a_morse(texto):
    """Devuelve el texto traducido a código Morse."""
    codigos = []
    for caracter in texto.upper():
        ...    # tu código: ¿qué haces si el carácter está en MORSE? ¿y si no?
    return ' '.join(codigos)

Versión 3 — Frases. Separa el texto en palabras, traduce cada una y únelas con tu separador de palabras. Prueba con "hola mundo" y con espacios de más: " hola mundo ".

Versión 4 — Lo desconocido. Aplica tu decisión para tildes, ñ, números, signos y caracteres desconocidos. Ningún texto debe detener el programa.

Versión 5 — Interfaz. Un bucle while que pide textos hasta que el usuario escriba, por ejemplo, salir. Muestra un mensaje de bienvenida con instrucciones.

Versión final — Calidad. Pruebas automáticas, README.md, docstrings, publicación en GitHub y diario del desarrollador (sección 7).

Pruebas#

🧪 Prueba y depuración#

def a_morse(texto):
    for letra in texto:
        codigo = MORSE[letra]
        return codigo

mensaje = input("Texto: ")
print(a_morse(mensaje))

Encuentra cuatro problemas: el return dentro del bucle solo traduce la primera letra; no se convierte a mayúsculas (KeyError con minúsculas); un espacio produce KeyError: ' '; y no se manejan caracteres desconocidos. Corrígelo sin mirar una solución completa: usa los mensajes de error como guía.

⭐ Extensión del proyecto#

• 🟢 Reto 1 — Aplicación: agrega los números y 5 signos de puntuación.
• 🟡 Reto 2 — Ampliación: la traducción inversa (Morse → texto) con un diccionario invertido: {codigo: letra for letra, codigo in MORSE.items()}. Comprueba que a_texto(a_morse(x)) devuelve x (en mayúsculas).
• 🟠 Reto 3 — Desafío: reproduce el sonido del Morse. Investiga cómo generar un tono con la biblioteca estándar (por ejemplo, winsound.Beep en Windows) o crea un archivo de audio con el módulo wave. Respeta las duraciones: raya = 3 puntos; espacio entre letras = 3 puntos; entre palabras = 7.
• 🔴 Reto 4 — Pensamiento computacional: el Morse usa códigos cortos para las letras más frecuentes en inglés. Cuenta la frecuencia de las letras en un texto largo en español (por ejemplo, un capítulo de un libro de dominio público) y diseña tu propia asignación de códigos. ¿Cuántos símbolos ahorrarías con tu código frente al internacional para ese texto?

Situación#

Tu curso quiere un "mensajero" de consola que traduzca mensajes a varios sistemas de codificación y permita comparar su longitud.

Requisitos#

1. Un menú que permita elegir: Morse, cifrado César (Día 8), binario (el código de cada carácter en 8 bits: format(ord(c), '08b')) y, si quieres, braille en Unicode.
2. Cada sistema en su propia función, con la misma "forma": recibe un texto y devuelve otro.
3. Una opción que muestre, para un mismo mensaje, cuántos símbolos ocupa en cada sistema.
4. Pruebas con assert para cada función.

Decisiones que debes tomar (y justificar)#

• ¿Cómo organizas el código para que agregar un sistema nuevo sea fácil? (Pista: un diccionario {'morse': a_morse, 'cesar': a_cesar, ...} que guarde funciones.)
• ¿Cuáles de estos sistemas son cifrados (ocultan el mensaje) y cuáles solo codificaciones (lo representan de otra forma)?

Casos de prueba#

• Todas las funciones devuelven texto y ninguna usa print ni input.
• El mensaje vacío no produce errores en ningún sistema.

Conceptuales#

1. ¿Qué es el "infierno de los tutoriales" y qué estrategia propone el curso para salir de él?
2. ¿Por qué un diccionario es la estructura adecuada para la tabla Morse?
3. ¿Por qué la función de traducción debe devolver el resultado en lugar de imprimirlo?
4. ¿Por qué hace falta un separador entre letras en Morse?
5. ¿Qué diferencia hay entre codificar y cifrar?

Análisis de código#

' / '.join(' '.join(MORSE[c] for c in palabra) for palabra in "SOS SOS".split())

¿Qué devuelve? Explica qué hace cada join.

Predicción#

¿Qué imprime print(dict(zip("ABC", [".-", "-...", "-.-."]))["B"])? ¿Y si la lista tuviera solo 2 elementos y pidieras "C"?

Depuración#

"Mi traductor funciona con HOLA pero se detiene con Hola, mundo". Da dos causas posibles.

Modificación#

Cambia tu programa para que los caracteres desconocidos se muestren como [?] y, al final, se informe cuántos hubo.

Creación#

Escribe es_morse_valido(texto) que devuelva True si un texto contiene solo puntos, rayas, espacios y /, y False en caso contrario.