fix typos and comment code

main.py

@@ -8,17 +8,16 @@ from src.funcoes import (
     senhas
 )
 def programa():
+    #Roda o programa e todas as funções
+    #necessárias para seu funcionamento
     senha_com_nome = listas()
-
     senhas_ou_nomes = senhas(senha_com_nome)
 
     listadesenhas = senhas_ou_nomes[0]
     listadenomes = senhas_ou_nomes[1]
 
     combinaciones = combinations()
-
     combinacoes_cripto = criptografaCombinacoes(combinaciones)
-
     comparador = comparatd(combinaciones, combinacoes_cripto, listadesenhas, listadenomes)
 
 def main():

src/encrypt.py

@@ -1,6 +1,7 @@
 import hashlib, base64
 
 def codificar_senha(senha):
+    #Retorna a variável de entrada codificada
     senha_encoded = senha.encode('utf-8')
     digest = hashlib.sha512(senha_encoded).digest()
     digest_b64_encoded = base64.b64encode(digest)

src/funcoes.py

@@ -1,7 +1,11 @@
 from src.generic import escrever_arquivo
 from itertools import product
+from os import system as sys
+
 
 def listas():
+    #Retorna o conteúdo de "usuarios_senhascodificadas.txt"
+    #em duas listas, separados por usuário e senha
     i = 0
     vazio = ''
     arquivo = open('usuarios_senhascodificadas.txt', 'r', encoding='utf-8')
@@ -20,6 +24,8 @@ def listas():
     return vet
 
 def senhas(senha_com_nome):
+    #Retorna duas listas separadas
+    #provenientes do listas()
     listadesenhas = []
     listadenomes = []
     for i in range(len(senha_com_nome)):
@@ -29,6 +35,8 @@ def senhas(senha_com_nome):
     return listadesenhas, listadenomes
 
 def combinations():
+    #Gera todas as combinações de palavras possíveis
+    #com as palavras do arquivo "palavras.txt"
     from rich.progress import track
     from src.generic import lista
     lista = lista()
@@ -60,6 +68,8 @@ def combinations():
     return listafinal
 
 def criptografaCombinacoes(combinacoes):
+    #Criptografa todas as combinações geradas
+    #pela função combinations()
     from rich.progress import track
     from src.encrypt import codificar_senha
     senhascodificadas = []
@@ -70,6 +80,10 @@ def criptografaCombinacoes(combinacoes):
 def comparatd(muchograndelistadepossibilidades, senhasgeradas, senhasdoarquivo, listadenomes):
     from rich.progress import track
     listaresultados = []
+    #Compara a senha criptografada com as existentes
+    #no arquivo "usuarios_senhascodificadas.txt";
+    #Se existir, escreve no arquivo "senhas_quebradas.txt"
+    #o nome do usuário e a senha descriptografada
     def testapredefinido(senha, pos):
         for i in range(len(senhasdoarquivo)):
             if senhasdoarquivo[i] == senha:
@@ -83,8 +97,14 @@ def comparatd(muchograndelistadepossibilidades, senhasgeradas, senhasdoarquivo,
     senhascrackeadas = listaresultados
     x = set(listadenomes) - set(senhascrackeadas)
 
+    if len(listaresultados) < 1:
+        sys("cls || clear")
+        print("\tNenhuma senha pode ser descoberta. Insira palavras no arquivo 'usuarios_senhascodificadas.txt'")
+    elif len(listaresultados) >= 1:
         print(f'\n\tSucesso!\n\n\t{len(listaresultados)} senha(s) foram descoberta(s). Essas informações foram salvas em "senhas_quebradas.txt"')
     
+    #Determina se houve senhas não encontradas, e
+    #insere as mesmas no arquivo "senhas_nao_quebradas.txt"
     if len(x) < 1:
         return None
 
@@ -95,5 +115,5 @@ def comparatd(muchograndelistadepossibilidades, senhasgeradas, senhasdoarquivo,
     for i in range(len(listafinal)):
         escrever_arquivo('senhas_nao_quebradas.txt', listafinal[i]+'\n')
     
-    print(f"\t{len(x)} senha(s) não puderam ser descobertas com a wordlist dada. As senhas criptografadas estão em 'senhas_nao_quebradas'")
+    print(f"\t{len(x)} senha(s) não puderam ser descobertas com a wordlist dada. As senhas criptografadas estão em 'senhas_nao_quebradas.txt'")
     

src/generic.py

@@ -1,14 +1,12 @@
-def senhas_para_arquivo(senha):
-    with open('senhas_quebradas.txt', 'a') as arquivo:
-        arquivo.write(senha+'\n')
-        arquivo.close()
-
 def escrever_arquivo(arquivo, string):
+    #Adiciona uma string em um arquivo
+    #Se o arquivo não existir, ele é criado
     with open(arquivo, 'a') as arquivo:
         arquivo.write(string)
         arquivo.close()
 
 def lista():
+    #Retorna o conteúdo de "palavras.txt"
     i = 0
     vazio = ''
     arquivo = open('palavras.txt', 'r', encoding='utf-8')

src/init.py

@@ -1,9 +1,9 @@
-import os
+from os import system as sys
 from src.constants import WARNING, INTRO
 
 def inicio():
     #Início do programa e indrodução para o usuário
-    os.system("cls || clear")
+    sys("cls || clear")
     input(INTRO["mainintro"])
 
     # Verifica por atualizações, e avisa o usuário caso encontre alguma
@@ -12,7 +12,7 @@ def inicio():
         data = requests.get("https://raw.githubusercontent.com/nanometer5088/quebrando-senhas/main/VERSION")
         version = open('VERSION', 'r', encoding='utf=8')
         if version.readline().rstrip() < (data.text):
-            os.system("cls || clear")
+            sys("cls || clear")
             input(WARNING["newversion"])
         version.close()
     except requests.exceptions.ConnectionError:
@@ -23,10 +23,10 @@ def inicio():
     # o programa ao finalizar
     try:
         from rich.progress import track
-        os.system("cls || clear")
+        sys("cls || clear")
     except ModuleNotFoundError:
-        os.system("cls || clear")
+        sys("cls || clear")
         input(WARNING["libraries"])
-        os.system("pip install -r requirements.txt --user")
-        os.system("cls || clear")
+        sys("pip install -r requirements.txt --user")
+        sys("cls || clear")
         return "instalado"