Vamos por partes. Primeiro, vamos ver o que a /
faz.
Se você declara uma função como essa:
def f(a, b):
print(a, b)
É possível chamá-la de várias maneiras diferentes:
# passando os parâmetros posicionais
f(1, 2) # 1 2
# usando os nomes dos parâmetros
f(a=1, b=2) # 1 2
# usando os nomes, podemos inclusive passá-los em qualquer ordem
f(b=2, a=1) # 1 2
Mas se usarmos a /
na declaração dos parâmetros (recurso que foi adicionado no Python 3.8), isso quer dizer que todos os argumentos antes da /
não podem ser passados usando-se os nomes. Veja a diferença para o exemplo anterior:
def f(a, b, /): # "a" e "b" não podem ser passados com nomes
print(a, b)
# passando os parâmetros posicionais, funciona
f(1, 2) # 1 2
# usando os nomes, dá erro
f(a=1, b=2) # TypeError: f() got some positional-only arguments passed as keyword arguments: 'a, b'
E qualquer parâmetro que estiver depois da /
pode ser passado com ou sem o nome:
def f(a, b, /, c, d):
print(a, b, c, d)
# "c" e "d" podem ser passados posicionalmente
f(1, 2, 3, 4) # 1 2 3 4
# "c" e "d" podem ser passados com os nomes
f(1, 2, c=3, d=4) # 1 2 3 4
f(1, 2, d=4, c=3) # 1 2 3 4
# "a" e "b" não podem ser passados com nomes
f(a=1, b=2, c=3, d=4) # TypeError: f() got some positional-only arguments passed as keyword arguments: 'a, b'
Agora, se usarmos keyword arguments:
def foo(name, **kwds):
print(name, kwds)
Ao chamar foo(1, **{'name' : 2})
, no fundo é o mesmo que fazer foo(1, name=2)
(veja este exemplo na documentação). Mas como o primeiro parâmetro se chama name
, então é como se eu estivesse fazendo foo(name=1, name=2)
. Daí a mensagem de erro: "foo() got multiple values for argument 'name'", pois ele entende que estou passando dois valores diferentes para name
.
Já usando a /
:
def foo(name, /, **kwds):
print(name, kwds)
foo(1, **{'name' : 2}) # 1 {'name': 2}
foo(1, name=2) # 1 {'name': 2}
Agora funciona porque, como a /
indica que o parâmetro name
é apenas posicional, o nome dele (name
) pode ser usado nos keyword arguments, sem a possibilidade de "colisão" de nomes.
Inclusive este exemplo é citado na documentação:
Since the parameters to the left of /
are not exposed as possible keywords, the parameters names remain available for use in **kwargs
:
>>> def f(a, b, /, **kwargs):
... print(a, b, kwargs)
...
>>> f(10, 20, a=1, b=2, c=3) # a and b are used in two ways
10 20 {'a': 1, 'b': 2, 'c': 3}
Em tradução livre: "Como os parâmetros à esquerda da /
não são expostos como keywords, os seus nomes ficam disponíveis para serem usados em **kwargs
".
O primeiro a
recebe o valor 10
, mas como ele é um parâmetro apenas posicional (graças à /
), não há ambiguidade na chamada: eu sei que o a=1
refere-se ao kwargs
, já que o primeiro a
não pode ser chamado pelo nome.