04. Funções, escopo e tipagem

À medida que o programa cresce, precisamos dividir responsabilidades. Funções dão nome às operações, controlam o acesso aos dados e tornam os contratos mais visíveis.

Este é o capítulo 4 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em Tipos, coleções e controle de fluxo e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Modelagem de dados e contratos.

Começando pela situação real

Nos primeiros capítulos, montamos a base do programa. Cada nova construção deve ser entendida como parte de um fluxo: o interpretador recebe instruções, os valores representam o problema e as funções organizam o trabalho. Em Funções, escopo e tipagem, observaremos como essa parte se liga ao conjunto, mantendo claros o contrato de entrada, o processamento, os efeitos e a conferência do resultado.

Ao ler os exemplos, não tente decorar chamadas isoladas. Pergunte o que entra, qual estado muda, o que sai e como a falha aparece. Essa sequência aproxima a sintaxe do problema que ela resolve e cria uma base que continuará útil quando a biblioteca ou o ambiente mudar.

Parâmetros posicionais e nomeados

O primeiro conceito do capítulo é Parâmetros posicionais e nomeados. Ele fornece a base para interpretar os demais recursos sem confundir o nome de uma ferramenta com o comportamento que ela realmente oferece.

Parâmetros posicionais e nomeados definem como chamadores associam argumentos à assinatura, inclusive limites / e *. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.

Na prática, tornar keyword-only opções que precisam de clareza e estabilidade. Transforme essa orientação em passos visíveis: defina a entrada, aplique a operação, observe a saída e registre a condição de sucesso. Assim, o código continua ligado à finalidade da tarefa.

Uma forma de conferir o entendimento é observar o seguinte critério: assinatura e testes rejeitam combinações inválidas e aceitam chamadas documentadas. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

Argumento padrão

Depois de compreender Parâmetros posicionais e nomeados, podemos avançar para Argumento padrão. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

Argumento padrão é avaliado na definição da função e reutilizado nas chamadas posteriores. Em termos simples, essa definição descreve uma promessa feita pelo programa: dadas certas condições, esperamos um comportamento específico. Antes de usar o recurso, identifique essas condições e pense no que deveria acontecer tanto no caminho normal quanto diante de uma entrada inadequada.