0
respostas

Hora da prática: docstrings

minha resposta:

Crie uma docstring para a função exibir_nome_do_programa()

'''Essa função exibe um logo estilizado do programa
    Input - 
    Output - printa o logo estilizado na tela
    '''

Crie uma docstring para a função exibir_opcoes()

'''Essa função exibe todas as opções do programa
    Input - 
    Output - exibe na tela as opções
    1 - cadastrar restaurantes
    2 - listar restaurantes
    3 - alternar estado do restaurante
    4 - Sair
    '''

Crie uma docstring para a função finalizar_app()

'''Essa função exibe uma mensagem quando o programa é encerrado
    Input - 
    Output - exibe o texto: Finalizando programa
    '''

Crie uma docstring para a função opcao_invalida()

 '''Essa função mostra uma mensagem quando a opção selecionada no menu não é válida
    Input - 
    Output - Exibe na tela a mensagem: Opção Inválida, em seguida chama a função voltar_ao_menu_principal()
    '''

Crie uma docstring para a função exibir_subtitulo(texto)

 '''Essa função limpa a tela e exibe um texto personalizado para cada função do programa
    INPUT - texto a ser exibido
    OUTPUT - limpa a tela e exibe o texto
    '''

Crie uma docstring para a função cadastrar_novo_restaurante()

 '''Essa função é responsável por cadastrar um novo restaurante
    
    INPUT - Nome do restaurante, categoria
    OUTPUT - Adiciona o restaurante ao dicionário restaurantes, exibe uma mensagem informando o sucesso da operação e chama a função voltar_ao_menu_principal()
 '''

Crie uma docstring para a função listar_restaurantes()

'''
Essa função lista todos os restaurantes cadastrados na tela
INPUT - 
OUTPUT - exibe todos os restaurantes presentes no dicionário restaurantes e em seguida chama a função voltar_ao_menu_principal()
'''

Crie uma docstring para a função alternar_estado_restaurante()

'''Essa função altera o estado (ativa/desativa um restaurante selecionado
    INPUT - nome do restaurante
    OUTPUT - se encontrado, troca o valor lógico da chave: ativo, senão, exibe uma mensagem informando que o restaurante não foi encontrado
    Ao final, chama a função voltar_ao_menu_principal() '''

Crie uma docstring para a função escolher_opcao()

'''Essa função trata a seleção das opções no menu pelo usuário
    INPUT - um numero inteiro
    OUTPUT - chama as funções equivalentes a cada número inserido (1 - cadastrar_novo_restaurante(), 2 - listar_restaurantes(), 3 - alternar_estado(), 4 - finalizar_app(), outro valor: opçao_invalida())'''

Crie uma docstring para a função main()

'''Função inicial do programa
    INPUT - 
    OUTPUT - limpa a tela do terminal usando a bib os
    chama a função exibir_nome()
    chama a função exibir_opcoes()
    chama a função escolher_opcao()
    '''