Adicionando valor de parâmetro padrão com o tipo hint no Python

Se eu tiver uma função como esta:

def foo(name, opts={}):
  pass

E eu quero adicionar dicas de tipo aos parâmetros, como faço isso? A maneira que assumi me dá um erro de sintaxe:

def foo(name: str, opts={}: dict) -> str:
  pass

O seguinte não gera um erro de sintaxe, mas não parece a maneira intuitiva de lidar com este caso:

def foo(name: str, opts: dict={}) -> str:
  pass

Não consigo encontrar nada na typingdocumentação ou em uma pesquisa no Google.

Edit: Eu não sabia como os argumentos padrão funcionavam no Python, mas, para o bem desta pergunta, vou manter os exemplos acima. Em geral, é muito melhor fazer o seguinte:

def foo(name: str, opts: dict=None) -> str:
  if not opts:
    opts={}
  pass

Seu segundo caminho está correto.

def foo(opts: dict = {}):
    pass

print(foo.__annotations__)

isso gera

{'opts': <class 'dict'>}

É verdade que não está listado no PEP 484 , mas as dicas de tipo são uma aplicação de anotações de funções, documentadas no PEP 3107. A seção de sintaxe deixa claro que os argumentos das palavras-chave funcionam com as anotações de funções dessa maneira.

Eu desaconselho fortemente o uso de argumentos de palavras-chave mutáveis. Mais informações aqui .

Se você estiver usando digitação (introduzido no Python 3.5), poderá usar typing.Optional, onde Optional[X]é equivalente Union[X, None]. É usado para sinalizar que o valor explícito de Noneé permitido. Desde a digitação .

def foo(arg: Optional[int] = None) -> None:
    ...

Eu vi recentemente essa frase:

def foo(name: str, opts: dict=None) -> str:
    opts = {} if not opts else opts
    pass