Organizando programas com funções

Do bloco único às peças com nome

Até o módulo passado, os seus programas eram um bloco único: 30 ou 40 linhas corridas, de cima a baixo. Nesse tamanho, ainda dá para segurar tudo na cabeça. Mas o gerenciador de tarefas do módulo 16 passa das 80 linhas, e programas reais passam de milhares. Ninguém lê um texto sem parágrafos, e ninguém mantém um programa sem divisões. A técnica para dividir tem nome, decomposição, e a ferramenta é a que você acabou de dominar: a função. A pergunta-guia é simples: quais tarefas este programa executa? Cada resposta vira uma função.

nome = input("Qual é o seu nome? ")
nota1 = float(input("Primeira nota: "))
nota2 = float(input("Segunda nota: "))
media = (nota1 + nota2) / 2
if media >= 7:
    situacao = "Aprovado"
else:
    situacao = "Em recuperação"
print(f"{nome}: média {media:.1f} - {situacao}")

O bloco único: funciona, mas as tarefas ficam coladas umas nas outras, sem fronteira.

Esse programa tem três tarefas escondidas nele: pedir os dados, calcular a média e decidir a situação. No bloco único, elas se misturam, e mudar uma exige cuidado para não pisar nas outras. A versão organizada dá um nome e uma casa para cada tarefa, e deixa a costura entre elas para o final do arquivo.

A versão organizada, lado a lado

def pedir_nota(rotulo):
    return float(input(f"{rotulo}: "))

def calcular_media(nota1, nota2):
    return (nota1 + nota2) / 2

def definir_situacao(media):
    if media >= 7:
        return "Aprovado"
    return "Em recuperação"

# Programa principal
nome = input("Qual é o seu nome? ")
nota1 = pedir_nota("Primeira nota")
nota2 = pedir_nota("Segunda nota")
media = calcular_media(nota1, nota2)
situacao = definir_situacao(media)
print(f"{nome}: média {media:.1f} - {situacao}")

Mesmo comportamento, outra arquitetura: peças nomeadas em cima, roteiro embaixo.

Leia só o programa principal, da linha do comentário para baixo, e repare no efeito: ele virou um roteiro. Pede o nome, pede duas notas, calcula a média, define a situação, mostra o resultado. Dá para entender o programa inteiro sem abrir nenhuma função, do mesmo jeito que dá para entender um sumário sem ler os capítulos. E cada função segue as regras das aulas anteriores: calcular_media e definir_situacao são cálculo puro com return, sem print; a exibição ficou no principal, no final. A regra da aula 5 aplicada na prática.

Tem um bônus escondido na função pedir_nota: ela eliminou uma repetição. No bloco único, a linha do float com input aparecia duas vezes; agora existe uma vez, com o rótulo como parâmetro. Se amanhã você quiser validar a nota digitada, blindagem que o módulo 14 ensina, mexe num lugar só. Decomposição e reaproveitamento andam juntos: quando as tarefas ganham casa própria, as duplicatas ficam visíveis e caem.

As regras de ouro e o caminho para o projeto final

Três regras resumem a aula. Primeira: uma função, uma tarefa. Se você precisa da palavra e para descrever o que a função faz, tipo calcula a média E imprime o relatório, são duas funções disfarçadas de uma. Segunda: o nome carrega a explicação. Um bom nome, como definir_situacao, dispensa comentário; um nome vago, como processar, obriga o leitor a abrir o corpo. Terceira: o programa principal coordena, as funções executam. O principal não faz conta nem toma decisão de negócio; ele chama, conecta e exibe.

1. Liste as tarefas do programa em português, uma frase por tarefa.
2. Transforme cada tarefa em uma função com nome de verbo: pedir_nota, calcular_media.
3. Escreva as funções no topo do arquivo, com return nas que produzem valor.
4. Monte o programa principal no final, conectando as chamadas na ordem.
5. Releia só o principal: se ele conta a história sozinho, a organização está boa.

Guarde esse ritual de cinco passos: ele é literalmente o roteiro do projeto final. O gerenciador de tarefas do módulo 16 nasce como uma lista de tarefas em português (adicionar, listar, concluir, remover, salvar) e cada item vira uma função. Antes disso, a próxima aula é o seu ensaio geral: um programa de notas escolares com três funções e um principal, construído do zero, peça por peça.