1
resposta

Hora da prática: docstrings

def exibir_nome_do_programa():
    """Exibe o nome estilizado do programa na tela."""
    
    
    def exibir_opcoes():
    """Exibe as opções disponíveis no menu principal."""
    
    def finalizar_app():
    """Exibe uma mensagem de finalização do aplicativo."""
    
    def voltar_ao_menu_principal():
    """
    Pausa a execução e aguarda o usuário pressionar uma tecla para voltar ao menu principal.
    
    Outputs:
    - Retorna ao menu principal ao chamar a função main().
    """
    
    def opcao_invalida():
    """
    Exibe uma mensagem de erro para opção inválida e retorna ao menu principal.
    
    Outputs:
    - Exibe a mensagem "Opção inválida!".
    - Retorna ao menu principal.
    """
    
    def exibir_subtitulo(texto):
    """
    Exibe um subtítulo estilizado na tela, limpando o conteúdo anterior.

    Inputs:
    - texto (str): O texto a ser exibido como subtítulo.
    """
    
    def cadastar_novo_restaurante():
    """
    Cadastra um novo restaurante na lista.
    
    Inputs:
    - O usuário fornece o nome do restaurante.
    - O usuário fornece a categoria do restaurante.

    Outputs:
    - Adiciona um novo dicionário à lista 'restaurantes'.
    - Exibe uma mensagem de sucesso no console.
    """
    
    def listar_restaurantes():
    """
    Lista todos os restaurantes cadastrados de forma formatada.

    Outputs:
    - Exibe uma tabela com o Nome, Categoria e Status de cada restaurante.
    """
    
    def alternar_estado_restaurante():
    """
    Altera o estado (ativo/desativado) de um restaurante específico.

    Inputs:
    - O usuário fornece o nome do restaurante que deseja alterar.

    Outputs:
    - Modifica o valor da chave 'ativo' no dicionário do restaurante correspondente.
    - Exibe uma mensagem de sucesso ou de erro se o restaurante não for encontrado.
    """
    
    def escolher_opcoes():
    """
    Captura a escolha do usuário e direciona para a função correspondente.

    Inputs:
    - O usuário fornece um número de 1 a 4.

    Outputs:
    - Chama a função associada à opção escolhida pelo usuário.
    """
    
    def main():
    """
    Função principal que inicia a execução do programa.
    """

Garanta sua matrícula hoje e ganhe + 2 meses grátis

Continue sua jornada tech com ainda mais tempo para aprender e evoluir

Quero aproveitar agora
1 resposta

Olá! Como vai?

Parabéns pela resolução da atividade!

Observei que você explorou o uso de docstrings para documentar cada função com clareza, utilizou muito bem a estrutura modular para organizar o fluxo do programa e ainda compreendeu a importância do encapsulamento de funcionalidades para manter o código limpo e reutilizável.

Uma dica para evoluir ainda mais é garantir que todas as funções estejam fora da função exibir_nome_do_programa, pois atualmente elas estão aninhadas dentro dela. Assim:

def exibir_nome_do_programa():
    """Exibe o nome estilizado do programa na tela."""

def exibir_opcoes():
    """Exibe as opções disponíveis no menu principal."""

# E assim por diante

Isso faz com que cada função seja acessível de forma independente, facilitando a manutenção e o uso em diferentes partes do programa.

Fico à disposição! E se precisar, conte sempre com o apoio do fórum.

Abraço e bons estudos!

AluraConte com o apoio da comunidade Alura na sua jornada. Abraços e bons estudos!