Python Academy · Aula

Noções básicas de argparse

Analise argumentos da linha de comando

Noções básicas de argparse é uma aula grátis de Python Academy no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de Python Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de Python Academy inclui 4 aulas no total.

Por que argparse?

O módulo argparse (da biblioteca padrão) cria interfaces de linha de comando amigáveis. Ele analisa argumentos, valida tipos e gera automaticamente o texto de ajuda.

import argparse

parser = argparse.ArgumentParser(description='A demo tool')
print(type(parser).__name__)

Criando um analisador

Comece criando um ArgumentParser. O description aparece na ajuda gerada automaticamente.

import argparse

parser = argparse.ArgumentParser(description='Greet a user')
print('parser ready')

Argumentos posicionais

add_argument('name') define um argumento posicional obrigatório. Aqui, passamos uma lista para parse_args para que ele seja executado sem uma linha de comando real.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('name')
args = parser.parse_args(['Alice'])
print('Hello,', args.name)

Argumentos opcionais

Nomes que começam com -- são sinalizadores opcionais. Forneça um default para o caso de o usuário não informá-los.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--greeting', default='Hi')
args = parser.parse_args(['--greeting', 'Hey'])
print(args.greeting)
print(parser.parse_args([]).greeting)

Argumentos tipados

Use type=int (ou float etc.) para que argparse converta e valide o valor. Uma entrada inválida produz um erro claro.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--count', type=int, default=1)
args = parser.parse_args(['--count', '5'])
print(args.count * 2)

Sinalizadores booleanos

action='store_true' cria um sinalizador que é False por padrão e True quando está presente, perfeito para opções como --verbose.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--verbose', action='store_true')
print(parser.parse_args(['--verbose']).verbose)
print(parser.parse_args([]).verbose)

Nomes curtos e longos

Dê a um argumento uma forma curta e uma longa, como -n e --name. Ambas definem o mesmo atributo.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('-n', '--name', default='world')
print(parser.parse_args(['-n', 'Sam']).name)

Escolhas

Restrinja os valores permitidos usando choices. argparse rejeita qualquer valor que não esteja na lista.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--mode', choices=['fast', 'slow'], default='fast')
print(parser.parse_args(['--mode', 'slow']).mode)

Vários valores com nargs

nargs='+' reúne um ou mais valores em uma lista, o que é ótimo para aceitar várias entradas de uma só vez.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('files', nargs='+')
args = parser.parse_args(['a.txt', 'b.txt', 'c.txt'])
print(args.files)

Opcionais obrigatórios e ajuda

Adicione required=True para tornar obrigatório um sinalizador opcional e help= para documentá-lo na tela de uso gerada.

import argparse

parser = argparse.ArgumentParser()
parser.add_argument('--id', required=True, type=int, help='record id')
args = parser.parse_args(['--id', '7'])
print('id is', args.id)

Uma pequena ferramenta completa

Reunindo tudo: uma entrada posicional, uma opção tipada e um sinalizador formam uma CLI pequena, mas real.

import argparse

parser = argparse.ArgumentParser(description='Repeat a message')
parser.add_argument('message')
parser.add_argument('--times', type=int, default=1)
parser.add_argument('--shout', action='store_true')
args = parser.parse_args(['hello', '--times', '2', '--shout'])
text = args.message.upper() if args.shout else args.message
for _ in range(args.times):
    print(text)

Verificação rápida

Teste sua compreensão de argparse.

Recapitulação

Você aprendeu os fundamentos de argparse:

ArgumentParser com argumentos posicionais e --optional.
type, default, choices e required validam a entrada.
action='store_true' para sinalizadores; nargs para listas.
O texto de ajuda é gerado automaticamente.

Próximo tópico: subcomandos e um tratamento mais completo de opções.

Perguntas Frequentes

A aula “Noções básicas de argparse” é grátis?

Sim — o texto completo de “Noções básicas de argparse” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de Python Academy, atualize para CoddyKit PRO. O curso de Python Academy inclui 4 aulas no total.

O que vou aprender em “Noções básicas de argparse”?

Analise argumentos da linha de comando Você pratica Python Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar Python Academy?

Nenhuma experiência prévia é necessária. Python Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.

Quanto tempo leva a aula “Noções básicas de argparse”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de Python Academy?

Sim. Cada aula de Python Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para Python Academy