A união de tipos `X | None`
`X | None` descreve um valor do tipo `X` ou o valor `None`. Em `-> str | None`, descreve o valor devolvido por uma função, não um valor predefinido.
CKTIS / Python
Sintaxe, operadores e conceitos de programação. Encontra uma explicação, consulta um exemplo e continua a aprender.
`X | None` descreve um valor do tipo `X` ou o valor `None`. Em `-> str | None`, descreve o valor devolvido por uma função, não um valor predefinido.
Usa `X | None` para aceitar um valor do tipo `X` ou `None`. Se a classe for definida mais adiante, coloca a anotação inteira entre aspas ou usa a importação de `__future__`.
Usa `setUp()` para que cada teste comece com dados novos. Depois verifica valores com `assertEqual()` e uma exceção esperada com `assertRaises()`.
Verifica várias entradas num único método de teste, identifica os subtestes que falham e distingue uma asserção de igualdade de uma verificação de exceções.
Execute uma suite de testes ou um caso de teste individual e use o `TestResult` devolvido para criar um resumo próprio sem analisar o relatório em texto.
Na definição de uma função, `*args` recolhe os argumentos posicionais excedentes num tuplo. Numa chamada, `*` desempacota um iterável em argumentos posicionais.
Em Python 3.12, `*args` recolhe os argumentos posicionais excedentes num tuplo e `**kwargs` os argumentos nomeados sem correspondência num dicionário. Numa chamada, os mesmos símbolos desempacotam argumentos.
Na definição de uma função, `*items` reúne os argumentos posicionais restantes num tuplo. Numa chamada, `*values` faz o contrário: passa os elementos de um iterável como argumentos posicionais separados.
Encapsula um logger existente em `logging.LoggerAdapter` com um campo `team` para que as chamadas a `info`, `warning` e `error` partilhem o mesmo contexto de equipa.
Usa `write()` para escrever texto em memória por partes, `read()` para ler a partir da posição atual e `getvalue()` para obter todo o conteúdo do buffer sem voltar ao início.
AssertionError é uma exceção integrada lançada quando a condição de uma instrução assert é falsa. As asserções verificam pressupostos internos do programa, não se destinam à validação obrigatória de entradas: a otimização pode removê-las.
Exception é a classe base integrada do Python para exceções comuns. Permite definir tipos de erro personalizados e capturá-los em conjunto, mas não abrange todos os descendentes de BaseException.
IndexError é uma exceção integrada que é lançada quando se tenta aceder a um elemento de uma sequência usando um índice fora do intervalo. Saiba quais são os limites dos índices válidos, a diferença entre indexação e slicing e como capturar esta exceção.
KeyError significa que uma chave pedida não foi encontrada num mapping, como um dict. Aprende a diferença entre o acesso com parênteses retos e get(), e a tratar chaves em falta sem ocultar erros não relacionados.
NameError significa que o Python não conseguiu encontrar um nome utilizado nos âmbitos disponíveis. Verifique a ortografia, a ordem das atribuições e as importações. Distinga NameError de AttributeError. UnboundLocalError é uma subclasse de NameError.
StopIteration assinala o esgotamento de um iterador durante next(). O seu atributo value pode conter o valor devolvido por um gerador. Terminar um gerador com return é diferente de deixar que um StopIteration explicitamente lançado escape do seu código.
TimeoutError indica que uma operação ultrapassou o seu limite de tempo. No Python 3.14, asyncio.TimeoutError é um alias obsoleto da mesma classe, não uma exceção distinta. Capture TimeoutError e distinga um tempo limite excedido do cancelamento normal de uma tarefa.
TypeError significa que uma operação ou função recebeu um objeto de tipo inadequado. Saiba em que difere de ValueError e como o tratar sem ocultar o problema subjacente.
UnboundLocalError ocorre quando uma função lê uma variável local à qual, nesse momento, não está associado qualquer valor. É uma subclasse de NameError; uma causa frequente é uma atribuição que oculta uma variável de um âmbito exterior.
ValueError indica que um argumento tem o tipo correto, mas um valor inaceitável. Saiba em que difere de TypeError e como lançar e capturar esta exceção.
ZeroDivisionError é uma exceção integrada gerada quando uma divisão ou uma operação de resto utiliza um divisor igual a zero. Trate-a com except ZeroDivisionError quando o programa puder responder de forma adequada a esse caso.
Devolve o valor absoluto de um número ou o módulo de um complexo.
Obtém um iterador assíncrono por `__aiter__` sem aguardar um valor.
Verifica o valor lógico dos elementos até ao primeiro falso.