tide-exemplo.py

'''
Olá Katia e Douglas,

Este é um exemplo de código que vocês podem explorar com os alunos.

Algumas dicas:

  * Todo conteúdo entre dois grupos de três aspas são comentários, outro jeito
    de escrever um comentário é com o simbolo #, irei usar bastante eles neste
    programa para descrever em detalhes o funcionamento.
  * Cada função tem uma pequena descrição, na forma de comentário, que embora
    não seja obrigatório é muito importante para quem for ler o código entender.
  * Vá para a ÚLTIMA linha de arquivo para começar a LER o código.

'''

def desafio():
   '''
   Função Desafio, apresenta e captura as respostas dos usuários avaliando se
   ele acertou ou não.

   As perguntas são armazenadas num tipo de dados chamado 'tuplas',
   são semelhantes a uma lista, contudo elas são imutáveis, ninguém pode alterá-las
   depois de definidas.

   perguntas = () # tupla vazia

   - ou -

   perguntas = (("pergunta","opções","resposta"),) # uma pergunta

   - ou -

   perguntas = (("pergunta1","opções1","resposta1"),
                ("pergunta2","opções2","resposta2"),) # duas perguntas 

   Note que:
   
   - pergunta é uma frase.
   - "opções" é uma frase com cada item delimitados pelo caractere de quebra de linha ('\n')
   exemplo:
      1 - aaaa\n2 - bbbb\n3 - cccc
   depois de executado no print() será:
      1 - aaaa
      2 - bbbb
      3 - cccc
   - resposta é um número 1,2,3,... dependendo da quantidade de itens de 'opções'
   - indexação:
   perguntas[0] é o grupo ("pergunta1","opções1","resposta1")
   perguntas[1] é o grupo ("pergunta2","opções2","resposta2")
   ... assim por diante ...

   cada item do grupo pode ser acessado com uma nova indexação:
   perguntas[0][0] = "pergunta1"
   perguntas[0][1] = "opções1"
   perguntas[0][2] = "resposta1"
   
   Lembrando: textos são sempre "entre aspas"

   isto é um texto <-- ERRO
   "isto é um texto" <-- OK
   
   a indexação de listas, tuplas, strings começa com 0, o primeiro item é acessado com o
   índice 0.

   '''
   perguntas = (("Em que ano surgiu o funk carioca?","1 - 1960\n2 - 1980\n3 - 2000","2"),
                ("Sobre o que falavam as primeiras letras de funk?","1 - Amor não correspondido\n2 - Sexo e erotismo\n3 - Drogas, armas e favela","3"),)
   print("Vamo ver se você esta por dentro?")
   # bloco com a primeira pergunta
   print("A) " + perguntas[0][0])
   print(perguntas[0][1])
   resposta = input("# ")
   if resposta == perguntas[0][2]:
     print("Resposta Correta")
   else:
     print("Resposta errada. O Funk carioca surgiu nos anos 80, inspirado em um ritmo da Flórida, o Miami Bass.")
   # bloco com a segunda pergunta
   print("B) " + perguntas[1][0])
   print(perguntas[1][1])
   resposta = input("# ")
   if resposta == perguntas[1][2]:
     print("Resposta Correta")
   else:
     print("Resposta errada. Inicialmente, as letras de funk falavam sobre a vida na favela.")
     print("Os temas drogas, armas e violência estavam sempre presentes nas músicas.")

def menu():
  '''
  Menu de opções do programa
  '''
  print("1) O que é o projeto")
  print("2) Quem participa")
  print("3) Letras criadas")
  print("4) Desafio")

def título():
  '''
  Título do nosso projeto!
  '''
  print("Funk Também é Cultura! Navegue e conheça:")


def início():
    '''
    A primeira função do programa é responsável pelos menus gerais e receper a
    opção do usuário, tão logo a execução começa já temos outra função sendo
    chamada, veja o conteúdo das funções "título" e "menu".
    '''
    título()
    menu()
    # o input aguarda por um valor do usuário
    opção = input("escolha uma opção (1-4): ")
    # e precisamos lembrar que este valor é um texto, estará sempre aspas
    # caso precise transformar em num número (inteiro ou fracionario) precisamos
    # converter
    if opção == '1':
      print("Em desenvolvimento")
    elif opção == '2':
      print("Em desenvolvimento")
    elif opção == '3':
      print("Em desenvolvimento")
    elif opção == '4':
      '''
      É a opção que realmente faz alguma coisa neste exemplo, vá dar uma olhada na função
      desafio()
      '''
      desafio()
    else:
      print("Você escolheu uma opção inválida!")
      menu()

'''
as funções foram definidas e aqui é o "ponto de partida", a primeira função
a ser executada é a função início, vá lá. ^^
'''
início()
#^^^^^^^