Usar Lint en Ren'Py para detectar errores antes de correr tu proyecto

¡Hola, creadores de novelas visuales! Bienvenidos a la séptima entrada de esta guía de Ren'Py en español. En el [post anterior] aprendimos a declarar variables y usar selecciones múltiples para crear finales diferentes según las decisiones del jugador. Hoy vamos a hablar de una herramienta muy útil en Ren'Py: **Lint**. Aprenderemos cómo usarla para detectar errores antes de correr nuestro proyecto, cómo interpretar los tipos de errores que reporta, y qué hacer si los mensajes de error están en inglés (¡aunque tu interfaz de Ren'Py esté en español!). Esto es especialmente importante para evitar problemas al compartir tu juego con otros. ¡Empecemos!

1. ¿Qué es Lint y por qué deberías usarlo?

Lint es una herramienta incluida en Ren'Py que analiza tu proyecto y busca errores potenciales antes de que lo ejecutes o lo distribuyas. Piensa en Lint como un "revisor" que lee tu código y te avisa si algo podría fallar, como imágenes que no se encuentran, variables no definidas, o errores de sintaxis.

**¿Por qué es importante?**

- Te ayuda a encontrar problemas que podrían hacer que tu juego falle al ejecutarlo.

- Es una buena práctica usarlo antes de compartir tu juego con otros, ya que algunos errores solo aparecen en ciertas plataformas (como Linux o Android).

- Te ahorra tiempo al identificar problemas antes de que los jugadores los encuentren.

2. Cómo usar Lint en Ren'Py. 

Usar Lint es muy sencillo y se hace desde el Ren'Py Launcher. Sigue estos pasos:

1. Abre el Ren'Py Launcher y selecciona tu proyecto (en nuestro caso, el proyecto con Perrito y Gatita).

2. En la pantalla principal del Launcher, busca la opción **"Check Script (Lint)"** (en español, puede aparecer como "Revisar Script (Lint)").

3. Haz clic en esa opción. Ren'Py analizará tu proyecto y generará un reporte con los errores o advertencias que encuentre.

4. Una vez que termine, el reporte aparecerá en tu pantalla. Si hay errores, también se guardarán en un archivo llamado `traceback.txt` o `errors.txt` en el directorio base de tu proyecto.

**Nota**: Si tu proyecto no se puede lanzar (por ejemplo, si hay un error grave), Lint podría fallar y mostrarte un mensaje como "Launching the project failed". En ese caso, asegúrate de que tu juego funcione correctamente al hacer clic en "Launch Project" antes de usar Lint.

3. Tipos de errores comunes que reporta Lint

Lint puede reportar muchos tipos de errores o advertencias. Aquí te explico algunos de los más comunes y cómo interpretarlos:

1. **"Could not find image" (No se pudo encontrar la imagen)**:

   - **Qué significa**: Lint no encuentra una imagen que estás intentando usar (por ejemplo, `show perrito` o `scene bg playa`).

   - **Ejemplo**: Si tienes `scene bg playa` pero el archivo `playa.png` no está en la carpeta `game`, Lint te avisará.

   - **Solución**: Asegúrate de que el archivo de imagen (como `playa.png`) esté en la carpeta `game` y que el nombre coincida exactamente (incluyendo mayúsculas y minúsculas).

2. **"Variable is not defined" (Variable no definida)**:

   - **Qué significa**: Estás usando una variable que no has definido antes.

   - **Ejemplo**: Si tienes `$ amistad += 1` pero olvidaste escribir `$ amistad = 0` al inicio, Lint reportará este error.

   - **Solución**: Define la variable con un valor inicial antes de usarla (por ejemplo, `$ amistad = 0`).

3. **"Label is not reachable" (Etiqueta no alcanzable)**:

   - **Qué significa**: Tienes un `label` al que no se puede llegar porque no hay un `jump` o `call` que lo conecte.

   - **Ejemplo**: Si tienes `label final_bueno:` pero nunca haces `jump final_bueno`, Lint te avisará.

   - **Solución**: Asegúrate de que todos los `label` tengan un camino para llegar a ellos, o elimina los que no uses.

4. **"Syntax error" (Error de sintaxis)**:

   - **Qué significa**: Hay un error en cómo escribiste el código, como una indentación incorrecta o un comando mal escrito.

   - **Ejemplo**: Si escribes `if amistad > 3` sin los dos puntos (`:`) al final, Lint reportará un error de sintaxis.

   - **Solución**: Revisa la línea que Lint señala y corrige el error (en este caso, agrega los `:` para que sea `if amistad > 3:`).

4. ¿Por qué los errores están en inglés si mi interfaz está en español?

Aunque configures el Ren'Py Launcher para que esté en español (en "Preferences" > "Language"), los mensajes de error de Lint (y de Ren'Py en general) siempre están en inglés. Esto se debe a que Ren'Py es un proyecto internacional, y los desarrolladores usan el inglés como idioma base para los mensajes técnicos.

**¿Cómo lidiar con esto?**

- **Traduce los mensajes clave**: Busca las palabras comunes en los errores (como "image", "variable", "label") y aprende su significado. Por ejemplo:

  - "image" = imagen

  - "variable" = variable

  - "label" = etiqueta

  - "syntax" = sintaxis

- **Usa un traductor**: Si no entiendes un mensaje, copia y pégalo en un traductor como Google Translate. Por ejemplo, "Could not find image (bg playa)" se traduce como "No se pudo encontrar la imagen (bg playa)".

- **Busca ayuda en la comunidad**: Si no entiendes un error, puedes buscarlo en foros como Lemma Soft o preguntar en la comunidad de Ren'Py en Discord. Muchos usuarios estarán felices de ayudarte.

5. Consejos para no sentirte abrumado por Lint. 

Lint puede parecer intimidante al principio, especialmente si reporta muchos errores o advertencias. Aquí tienes algunos consejos para manejarlo:

1. **No te preocupes por los "falsos positivos"**:

   - A veces, Lint reporta problemas que en realidad no afectan tu juego. Por ejemplo, podría decir que una imagen no se encuentra, pero si tu juego funciona bien al ejecutarlo, puedes ignorar esa advertencia.

   - Prueba tu juego después de usar Lint para confirmar si los errores son reales.

2. **Corrige los errores uno por uno**:

   - Si Lint reporta muchos errores, no intentes solucionarlos todos a la vez. Comienza con el primero de la lista, corrígelo, y vuelve a ejecutar Lint. A veces, un error puede causar otros, y al corregir el primero, los demás desaparecen.

3. **Usa Lint regularmente**:

   - No esperes hasta el final de tu proyecto para usar Lint. Ejecútalo cada vez que hagas cambios grandes en tu código. Esto te ayudará a detectar problemas temprano.

4. **Guarda una copia de seguridad**:

   - Antes de hacer cambios grandes para corregir errores, guarda una copia de tu proyecto. Así, si algo sale mal, puedes regresar a la versión anterior.

6. Ejemplo práctico: Usar Lint con nuestro proyecto. 

Vamos a usar el proyecto que hemos estado construyendo (con Perrito y Gatita) para probar Lint. Aquí está el código que usamos en el post anterior:

```

define perrito = Character("Perrito", color="#00B7EB")

define gatita = Character("Gatita", color="#FF69B4")

label start:

    scene bg playa

    show perrito at left

    show gatita at right

    $ amistad = 0

    perrito "¡Hola, Gatita! ¿Quieres construir un castillo de arena conmigo?"

    menu:

        "¡Claro, suena divertido!":

            $ amistad += 2

            gatita "¡Genial! Vamos a hacerlo."

        "No, prefiero tomar el sol.":

            $ amistad -= 1

            gatita "Hmph, qué aburrido..."

        "¡No seas tonto, Perrito!":

            $ amistad -= 3

            gatita "¡Oye, no seas grosero!"

    perrito "¿Trajiste algo para compartir? Yo tengo un helado."

    menu:

        "Sí, tengo unas galletas para compartir.":

            $ amistad += 2

            gatita "¡Qué rico! Gracias por compartir."

        "No, no traje nada.":

            $ amistad -= 1

            gatita "Oh... Bueno, está bien."

    if amistad >= 3:

        perrito "¡Fue un día increíble, Gatita!"

        gatita "Sí, me la pasé muy bien contigo. ¡Hagámoslo de nuevo!"

        "Final bueno: Perrito y Gatita se hicieron grandes amigos."

    elif amistad > 0:

        perrito "Bueno, estuvo bien, ¿no?"

        gatita "Sí, supongo... Pero podría haber sido mejor."

        "Final neutral: Perrito y Gatita pasaron un día decente."

    else:

        perrito "Creo que no nos llevamos muy bien..."

        gatita "Hmph, no quiero volver a la playa contigo."

        "Final malo: Perrito y Gatita no se hicieron amigos."

    return

```

1. **Ejecuta Lint**: Sigue los pasos de la sección 2 para usar Lint en este proyecto.

2. **Interpreta los resultados**:

   - Si todo está bien, Lint debería decir "No problems found" (No se encontraron problemas).

   - Si falta el archivo `playa.png`, Lint reportará "Could not find image (bg playa)". En ese caso, asegúrate de que `playa.png` esté en la carpeta `game`.

   - Si tienes un error de sintaxis (por ejemplo, olvidaste los `:` después de un `if`), Lint lo señalará con un mensaje como "Syntax error".

 7. ¡Tu turno!

Abre el Ren'Py Launcher, ejecuta Lint en tu proyecto y revisa el reporte. ¿Encontraste algún error? Si sí, intenta corregirlo usando las recomendaciones de este post. ¿Te resultó difícil entender los mensajes en inglés? Comparte tu experiencia en los comentarios. En la próxima entrada, aprenderemos a posicionar personajes en diferentes lugares de la pantalla. ¡Nos leemos el 7 de abril!