Python Palavras-chave

As palavras-chave (keywords) são as palavras que fazem parte da própria língua do Python: if, for, def, return… São como as palavras de um formulário que você não pode apagar: elas já têm um papel fixo, e por isso não podem ser usadas como nome de variável, função ou classe. No Python 3.14 são 35, mais 4 palavras-chave "suaves" que só são especiais em certos lugares. Esta página lista todas, com o que cada uma faz e o link para a aula. A regra dos nomes está na aula Nomes de Variáveis.

A lista oficial, perguntada ao Python

O módulo keyword ("palavra-chave") guarda a lista oficial. kwlist são as palavras reservadas; softkwlist, as suaves:

import keyword

print(keyword.kwlist)
print(len(keyword.kwlist))
print(keyword.softkwlist)

$ python3 kw.py
['False', 'None', 'True', 'and', 'as', 'assert', 'async', 'await', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']
35
['_', 'case', 'match', 'type']

O mesmo módulo responde se uma palavra é reservada: keyword.iskeyword("for") deu True, keyword.iskeyword("print") deu False (print é uma função, não uma palavra-chave) e keyword.iskeyword("match") deu False, porque match é suave: quem responde True para ela é keyword.issoftkeyword("match").

A ajuda embutida também mostra a lista, em colunas:

$ python3 -c 'help("keywords")'

Here is a list of the Python keywords.  Enter any keyword to get more help.

False               class               from                or
None                continue            global              pass
True                def                 if                  raise
and                 del                 import              return
as                  elif                in                  try
assert              else                is                  while
async               except              lambda              with
await               finally             nonlocal            yield
break               for                 not

"Aqui está a lista das palavras-chave do Python. Digite qualquer uma para ter mais ajuda": no modo interativo, help("for") mostra a explicação (em inglês) de cada uma.

Valores

Lógica e comparação

Decisões

Repetições

Funções

Classes e módulos

Erros

def f():
    try:
        return 1
    finally:
        return 2
print(f())

$ python3 fim.py
/home/ana/fim.py:5: SyntaxWarning: 'return' in a 'finally' block
  return 2
2

Arquivos, apagar e esperar

As palavras-chave suaves: match, case, type e _

As palavras-chave suaves (soft keywords) só são especiais em certo lugar. Fora dele, são nomes comuns. Elas entraram depois que muita gente já tinha variáveis chamadas match ou type; tornar essas palavras proibidas quebraria esses programas.

As três primeiras trabalhando juntas:

def ponto(p):
    match p:
        case (0, 0):
            return "origem"
        case (x, 0):
            return f"no eixo x, em {x}"
        case _:
            return "outro lugar"

print(ponto((0, 0)), ponto((3, 0)), ponto((1, 2)))

$ python3 ponto.py
origem no eixo x, em 3 outro lugar

E a prova de que, fora desses lugares, elas são nomes comuns: este trecho rodou sem erro e mostrou 5 e depois ok texto 9.

match = 5
print(match)
case = "ok"; type = "texto"; _ = 9
print(case, type, _)

Poder não quer dizer dever: type também é o nome da função type(), que descobre o tipo de um valor, e uma variável type a esconde (veja o quadro abaixo). Já a frase type Nota = float não atrapalha a função: depois dela, print(type(7.5)) continuou mostrando <class 'float'>, e print(Nota.__value__) mostrou <class 'float'>.

O que não é palavra-chave (mas parece)

print, input, len, list, str, int, type, sum, max… são funções embutidas, não palavras-chave. O Python deixa você usar esses nomes para uma variável, e é justamente esse o perigo: a variável toma o lugar da função.

print = "Bom dia"
print("Olá, Ana!")

$ python3 sombra.py
Traceback (most recent call last):
  File "/home/ana/sombra.py", line 2, in <module>
    print("Olá, Ana!")
    ~~~~~^^^^^^^^^^^^^
TypeError: 'str' object is not callable

Quando dá errado: uma palavra-chave como nome

A Ana quis guardar a turma numa variável chamada class:

aluna = "Ana"
class = "3A"
print(aluna, class)

$ python3 turma.py
  File "/home/ana/turma.py", line 2
    class = "3A"
          ^
SyntaxError: invalid syntax

As mensagens reais de cada caso, colhidas com python3 -c '…' no computador da Ana:

Experimente

import keyword

for palavra in ["for", "print", "match", "True", "lista"]:
    if keyword.iskeyword(palavra):
        tipo = "palavra-chave: não pode ser nome"
    elif keyword.issoftkeyword(palavra):
        tipo = "palavra-chave suave: especial só em certos lugares"
    else:
        tipo = "nome livre"
    print(f"{palavra:8} {tipo}")

print(len(keyword.kwlist), "palavras-chave e", len(keyword.softkwlist), "suaves")

No computador da Ana, sem mudar nada, a saída foi:

$ python3 livre.py
for      palavra-chave: não pode ser nome
print    nome livre
match    palavra-chave suave: especial só em certos lugares
True     palavra-chave: não pode ser nome
lista    nome livre
35 palavras-chave e 4 suaves

aluna = "Ana"
class = "3A"
print(aluna, class)

aluna = "Ana"
turma = "3A"
print(aluna, turma)

Resumo

• O Python 3.14 tem 35 palavras-chave (keyword.kwlist) e 4 suaves (keyword.softkwlist: match, case, type, _).
• Uma palavra-chave não pode ser nome de variável, função ou classe: o resultado é SyntaxError, antes de o programa rodar.
• As suaves só são especiais no lugar delas (match …:, case …:, type X = …); fora dali, são nomes comuns.
• Só True, False e None começam com maiúscula.
• print, list, input, type não são palavras-chave: o Python aceita esses nomes para variáveis, mas a variável esconde a função. Evite.
• Dúvida? keyword.iskeyword("palavra") responde, e help("for") explica cada uma.