Estruturando o programa: o esqueleto que já funciona

Por que começar pelo esqueleto

Existe um jeito amador e um jeito profissional de começar um programa de 100 linhas. O amador escreve a primeira funcionalidade completa, depois a segunda, e vai emendando; quando algo quebra, não sabe se o problema é da parte nova ou da cola entre as partes. O profissional desenha primeiro a estrutura: quais funções vão existir, o que cada uma faz e como o fluxo passa por elas. Só depois preenche uma por vez. Essa estrutura vazia mas funcional tem nome: esqueleto.

O ganho prático aparece já na próxima aula: quando você implementar adicionar_tarefa e algo der errado, vai saber com certeza que o problema está dentro daquela função, porque todo o resto já rodava antes. Esse isolamento de suspeitos é o que faz programadores experientes parecerem rápidos ao caçar erros. Não é mágica, é estrutura.

pass

Palavra do Python que significa não faça nada. Serve de corpo temporário para uma função que precisa existir mas ainda não tem lógica, porque uma função com corpo vazio de verdade seria erro de sintaxe.

As sete funções e o loop principal

Crie o arquivo gerenciador.py na sua pasta de projetos (ou uma sessão limpa no Playground) e digite o esqueleto completo abaixo. São as sete funções do programa e o loop principal. Repare que os nomes contam a história sozinhos: quem lê mostrar_menu, adicionar_tarefa ou salvar_tarefas sabe o que esperar sem abrir a função. Nomear bem é metade da organização.

# gerenciador.py - versão 1: o esqueleto

def mostrar_menu():
    print("\n=== MINHAS TAREFAS ===")
    print("1. Adicionar tarefa")
    print("2. Listar tarefas")
    print("3. Concluir tarefa")
    print("4. Remover tarefa")
    print("5. Sair")

def adicionar_tarefa(tarefas):
    print("(adicionar tarefa: em construção)")

def listar_tarefas(tarefas):
    print("(listar tarefas: em construção)")

def concluir_tarefa(tarefas):
    print("(concluir tarefa: em construção)")

def remover_tarefa(tarefas):
    print("(remover tarefa: em construção)")

def salvar_tarefas(tarefas):
    pass

def carregar_tarefas():
    return []

tarefas = []

while True:
    mostrar_menu()
    opcao = input("Escolha uma opção: ")
    if opcao == "1":
        adicionar_tarefa(tarefas)
    elif opcao == "2":
        listar_tarefas(tarefas)
    elif opcao == "3":
        concluir_tarefa(tarefas)
    elif opcao == "4":
        remover_tarefa(tarefas)
    elif opcao == "5":
        print("Até logo!")
        break
    else:
        print("Opção inválida. Digite um número de 1 a 5.")

O esqueleto completo: 7 funções, a lista tarefas e o loop principal. Ele já roda de ponta a ponta.

Três decisões desse código merecem explicação. Primeira: quase todas as funções recebem tarefas como parâmetro, em vez de mexer numa variável solta. É a lição do módulo 13: função que recebe o que precisa é mais fácil de entender e de testar. Segunda: a comparação usa opcao == "1" com aspas, porque input sempre devolve texto, como o módulo 5 martelou. Terceira: mostrar_menu não recebe nada, porque só imprime; e carregar_tarefas devolve uma lista vazia por enquanto, para a aula 5 ter onde encaixar a leitura do arquivo sem mudar o formato.

Repare também no salvar_tarefas com pass no corpo. O Python não aceita função sem corpo, e pass é o jeito oficial de dizer por enquanto, nada. As outras funções vazias usam um print de em construção em vez de pass por um motivo prático: quando você rodar o esqueleto e escolher uma opção, quer ver uma resposta na tela confirmando que o despacho do menu chamou a função certa.

Rodando o esqueleto

Hora do teste. Rode o programa e passeie pelo menu: escolha 1, 2, 3 e 4 e confira se cada opção responde com a sua mensagem de em construção. Digite algo inválido, como 9 ou banana, e confira a mensagem de opção inválida. Por fim, escolha 5 e veja o programa se despedir e encerrar. A sessão deve se parecer com isto:

=== MINHAS TAREFAS ===
1. Adicionar tarefa
2. Listar tarefas
3. Concluir tarefa
4. Remover tarefa
5. Sair
Escolha uma opção: 1
(adicionar tarefa: em construção)

=== MINHAS TAREFAS ===
1. Adicionar tarefa
2. Listar tarefas
3. Concluir tarefa
4. Remover tarefa
5. Sair
Escolha uma opção: banana
Opção inválida. Digite um número de 1 a 5.

=== MINHAS TAREFAS ===
1. Adicionar tarefa
2. Listar tarefas
3. Concluir tarefa
4. Remover tarefa
5. Sair
Escolha uma opção: 5
Até logo!

O esqueleto em ação: menu, despacho, opção inválida tratada e saída limpa. Tudo antes de qualquer lógica de tarefa.

Se a sua sessão bateu com essa, parabéns: o fluxo inteiro do programa está pronto e testado. Daqui em diante, cada aula só troca o miolo de duas funções, e o resto permanece intocado. Se não bateu, os suspeitos de sempre estão na lista abaixo.