11. Interfaces de linha de comando

Uma automação precisa receber instruções de quem a executa. A interface de linha de comando transforma argumentos em uma conversa previsível entre usuário e programa.

Este é o capítulo 11 de 25 da apostila Python para Automação e Scripts. Ele aproveita a base construída em Formatos de dados e configuração e dá mais um passo no desenvolvimento da automação. Ao final, estaremos preparados para estudar Configuração, ambiente e segredos.

Começando pela situação real

Agora o programa começa a conversar com pessoas e com o ambiente. Argumentos, configuração, registros e testes tornam seu comportamento previsível para quem executa e para quem precisa corrigir um problema. Em Interfaces de linha de comando, 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.

ArgumentParser

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

ArgumentParser define opções posicionais e nomeadas e produz ajuda e erros de uso consistentes. 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, declarar tipo, required, choices e help conforme o contrato. 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: --help documenta a interface e entradas inválidas são rejeitadas. Esse critério deve aparecer em um teste, em uma saída controlada ou em outro efeito que possa ser reproduzido.

Argumento posicional e opção

Depois de compreender ArgumentParser, podemos avançar para Argumento posicional e opção. As duas ideias se conectam porque uma automação precisa preservar o contrato à medida que os dados percorrem novas etapas.

Argumento posicional e opção distingue valores normalmente obrigatórios pela posição de flags configuráveis com nomes explícitos. 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.