Merge pull request #2 from trelovodracir/feature/pep

Atualiza o código com Pylint e Flake8

main.py

@@ -1,3 +1,29 @@
+"""
+Este script contém uma função que recebe um nome com as palavras
+invertidas, reverte a ordem das palavras e restaura as palavras
+para a forma correta, com a primeira letra maiúscula.
+
+A função `inverter_nome(nome_invertido)` é a principal do script.
+Ela realiza as seguintes operações:
+1. Divide a string do nome invertido em palavras.
+2. Inverte a ordem das palavras.
+3. Reverte cada palavra individualmente e capitaliza a primeira
+letra de cada uma.
+
+O script também inclui um bloco de teste que demonstra o uso da
+função, invertendo o nome
+"Trelov Razec Odracir"
+para
+"Ricardo Cezar Volert".
+
+Para executar o código, basta rodar o script diretamente, que o
+nome processado será exibido no terminal.
+
+Autor: Ricardo Cezar Volert
+Data: 11-dez-2024
+"""
+
+
 def inverter_nome(nome_invertido: str) -> str:
     """
     Função que recebe um nome invertido, reverte a ordem das palavras
@@ -7,23 +33,31 @@ def inverter_nome(nome_invertido: str) -> str:
         nome_invertido (str): O nome com as palavras invertidas.
 
     Retorna:
-        str: O nome original, com a ordem correta das palavras e com a primeira letra maiúscula.
+        str: O nome original, com a ordem correta das palavras e com a
+        primeira letra maiúscula.
     """
     if not nome_invertido:
         raise ValueError("O nome fornecido não pode ser vazio.")
 
     # Divide o nome em palavras e inverte a ordem delas
     palavras = nome_invertido.split()
     palavras_invertidas = palavras[::-1]
-    
+
     # Inverte cada palavra individualmente e capitaliza a primeira letra
-    nome_original = " ".join([palavra[::-1].capitalize() for palavra in palavras_invertidas])
-
+    palavras_capitalizadas = [
+        palavra[::-1].capitalize() for palavra in palavras_invertidas
+    ]
+    nome_original = " ".join(palavras_capitalizadas)
+
     return nome_original
 
 
 # Testando o algoritmo com exemplo
 if __name__ == "__main__":
-    nome_invertido = "Trelov Razec Odracir"
-    nome_original = inverter_nome(nome_invertido)
-    print("Meu nome é:", nome_original)
+    NOME_INVERTIDO = "Trelov Razec Odracir"
+    NOME_RESULTADO = inverter_nome(NOME_INVERTIDO)
+    print(
+        "Meu nome é:", NOME_RESULTADO
+    )
+
+# End of file: main.py