version 1.3.0

Author: NLGS2907

README.md

@@ -18,7 +18,15 @@ de la Facultad de Ingeniería de la UBA, aunque puede utilizarse para cualquier
 
 <hr/>
 
-* [**Enlace de Invitación**](https://discord.com/api/oauth2/authorize?client_id=889312376036425810&permissions=292057984064&scope=bot)
+* [**Enlace de Invitación**](https://discord.com/api/oauth2/authorize?client_id=889312376036425810&permissions=294205467712&scope=bot%20applications.commands)
+
+* **[Dependencias](requirements.txt)**
+  - [python-dotenv](https://pypi.org/project/python-dotenv/)
+  - [discord.py](https://pypi.org/project/discord.py/) (rama `master`)
+  - [imgur-python](https://pypi.org/project/imgur-python/)
+
+* **[Licencia MIT](LICENSE)**
+
 * **índice**
   - [Cómo Ejecutar](#cómo-ejecutar)
   - [Changelog](#changelog)
@@ -48,8 +56,9 @@ cd run
 
 |       Version     |
 |     :---------:   |
-|**[v1.2.1](#v121)**| 
-|  [v1.2.0](#v120)  | 
+|**[v1.3.0](#v130)**|
+|  [v1.2.1](#v121)  |
+|  [v1.2.0](#v120)  |
 |  [v1.1.0](#v110)  |
 |  [v1.0.4](#v104)  |
 |  [v1.0.3](#v103)  |
@@ -59,6 +68,16 @@ cd run
 
 <hr/>
 
+## v1.3.0
+
+* Puesto que [discord.py](https://github.com/Rapptz/discord.py) ha continuado su mantenimiento, y las *features* que promete traer son preferidas, **se ha decidido en buena fe volver a usar esta librería.**
+
+* **Agregados los *slash commands*.**
+
+* **Agregado nuevo comando `reboot`.** Ahora se puede reiniciar el bot sin tener que apagarlo manualmente.
+
+<hr style="height:4px" />
+
 ### v1.2.1
 
 * **Simplificados algunos imports en las pruebas y en el main.** No deberían tener nombres redundantes.

guia/2c2019/guia_2.json

@@ -121,7 +121,9 @@
         "campos": {
 
         },
-        "pie": "Nota: Hacerlo usando y sin usar la ecuación Σ 𝑛 𝑖=1 𝑖 = 𝑛 (𝑛 + 1)/2. ¿Cuál realiza más operaciones?"
+        "pie": [
+            "Nota: Hacerlo usando y sin usar la ecuación Σ 𝑛 𝑖=1 𝑖 = 𝑛 (𝑛 + 1)/2. ¿Cuál realiza más operaciones?"
+        ]
     },
     "8": {
         "titulo": [

requirements.txt

@@ -1,3 +1,3 @@
 python-dotenv
-py-cord<=2.0.0b4
+git+https://github.com/Rapptz/discord.py
 imgur-python

src/main/ahorcado/ahorcado.py

@@ -30,14 +30,19 @@ def cargar_palabras(nombre_archivo: str) -> list[str]:
         return lineas
 
 
-    def __init__(self, frase: Optional[str]=None, **opciones) -> None:
+    def __init__(self,
+                 *,
+                 frase: Optional[str]=None,
+                 vidas_maximas: int=7,
+                 id_mensaje_padre: int = int) -> None:
         """
         Inicializa una instancia de tipo 'Ahorcado'.
         """
 
         frase_magica = (frase if frase else choice(Ahorcado.cargar_palabras(WORDS_PATH)))
-        self.maximos_intentos = opciones.get("vidas_maximas", 7)
+        self.maximos_intentos = vidas_maximas
         self.intentos = self.maximos_intentos
+        self.id_mensaje_padre: int = id_mensaje_padre
 
         self.display_id = 0  # Es inicializado después con el primer mensaje
 

src/main/archivos/archivos.py

@@ -5,7 +5,7 @@
 from json import dump, load
 from os import listdir
 from os.path import isdir, isfile, join, splitext
-from typing import Optional
+from typing import List, Optional
 
 from ..constantes import EXT, GUIA_PATH, PROPERTIES_PATH
 
@@ -47,14 +47,27 @@ def actualizar_guia(nueva_version: str, guild_id: str) -> None:
     guardar_json(propiedades, PROPERTIES_PATH)
 
 
-def lista_carpetas(carpeta: str=GUIA_PATH) -> list[str]:
+def lista_carpetas(carpeta: str) -> list[str]:
     """
     Devuelve una lista de todas las carpetas que se encuentran en un
     directorio dado.
     """
     return [dir for dir in listdir(carpeta) if isdir(join(carpeta, dir))]
 
 
+def lista_archivos(ruta: str, ext: Optional[str]=None) -> List[str]:
+    """
+    Busca en la ruta especificada si hay archivos, y devuelve una lista
+    con los nombres de los que encuentre.
+
+    Si `ext` no es `None`, entonces probará buscando archivos con esa extensión.
+    `ext` NO debe tener un punto (`.`) adelante, es decir que `"py"` será automáticamente
+    tratado como `.py`.
+    """
+
+    return [file for file in listdir(ruta) if (file.endswith(f".{ext}") if ext else True)]
+
+
 def version_es_valida(version: str, carpeta: str=GUIA_PATH) -> bool:
     """
     Verifica que la versión especificada existe dentro del directorio de
@@ -85,7 +98,7 @@ def cargar_guia(version: str, carpeta: str=GUIA_PATH) -> Optional[DiccionarioGui
     sub-diccionario tiene los pares clave valor en donde la clave es el numero
     de ejercicio y el valor el enunciado del mismo, ya formateado.
 
-    Lanza una excepción si la versión pasada no es válida.
+    Devuelve `None` si la versión pasada no es válida.
     """
 
     if not version_es_valida(version, carpeta):

src/main/auxiliar/__init__.py

@@ -3,3 +3,4 @@
 """
 
 from .auxiliar import *
+from .singleton import *

src/main/auxiliar/auxiliar.py

@@ -2,45 +2,66 @@
 Módulo para funciones auxiliares
 """
 
-from typing import Optional
+from typing import TYPE_CHECKING
 
-from discord import Embed, Message
-from discord.ext.commands import Bot, Context
-from discord.ui import View
+from discord import Interaction, Message, Thread
+from discord.app_commands import check as appcheck
 
 from ..archivos import cargar_json
 from ..constantes import (ALGORITMOS_ESSAYA_ID, DEFAULT_PREFIX,
                           PROPERTIES_PATH, ROL_DIEGO_ID, ROL_DOCENTE_ID)
 
+if TYPE_CHECKING:
 
-def es_rol_valido(ctx: Context) -> bool:
+    from ..lector import Lector
+
+
+def es_rol_valido():
     """
     Verifica si está en el servidor del curso, y si es así,
     si se tienen los roles correspondientes.
     """
 
-    return not all((ctx.guild.id == ALGORITMOS_ESSAYA_ID,
-               all([role.id not in (ROL_DIEGO_ID, ROL_DOCENTE_ID) for role in ctx.author.roles])))
+    def predicado(interaction: Interaction) -> bool:
+        """
+        Crea el check correspondiente.
+        """
+
+        return not all((interaction.guild.id == ALGORITMOS_ESSAYA_ID,
+                        all([role.id not in (ROL_DIEGO_ID, ROL_DOCENTE_ID)
+                             for role in interaction.user.roles])))
+
+    return appcheck(predicado)
+
+
+def es_hilo():
+    """
+    Verifica si la interacción ocurrió en un hilo.
+    """
+
+    def predicado(interaction: Interaction) -> bool:
+        """
+        Crea el check correspondiente.
+        """
+
+        return isinstance(interaction.channel, Thread)
+
+    return appcheck(predicado)
 
 
-async def mandar_dm(ctx: Context,
-                    contenido: Optional[str]=None,
-                    vista: Optional[View]=None,
-                    embed: Optional[Embed]=None) -> None:
+def get_prefijo_por_id(guild_id: int) -> str:
     """
-    Manda un mensaje por privado.
+    Devuelve el prefijo de invocación de comandos dependiendo
+    del guild donde se esté.
     """
 
-    await ctx.author.create_dm()
-    mensaje_enviado = await ctx.author.dm_channel.send(content=contenido, view=vista, embed=embed)
-    vista.msg = mensaje_enviado
-    await ctx.message.delete()
+    return cargar_json(PROPERTIES_PATH)["prefijos"].get(str(guild_id), DEFAULT_PREFIX)
 
 
-def get_prefijo(_bot: Bot, mensaje: Message) -> str:
+def get_prefijo(_bot: "Lector", mensaje: Message) -> str:
     """
     Se fija en el diccionario de prefijos y devuelve el que
     corresponda al servidor de donde se convoca el comando.
     """
 
-    return cargar_json(PROPERTIES_PATH)["prefijos"].get(str(mensaje.guild.id), DEFAULT_PREFIX)
+    return get_prefijo_por_id(mensaje.guild.id)

src/main/auxiliar/singleton.py

@@ -0,0 +1,21 @@
+"""
+Módulo que contiene la metaclase para objetos con patrón singleton.
+"""
+
+class Singleton(type):
+    """
+    Metaclase 'Singleton'.
+    """
+
+    _instancias = {}
+
+    def __call__(cls, *args, **kwargs):
+        """
+        Llama a este objeto como si fuera una función.
+        """
+
+        if cls not in cls._instancias:
+
+            cls._instancias[cls] = super(Singleton, cls).__call__(*args, **kwargs)
+
+        return cls._instancias[cls]