Registo de alterações

A primeira versão. Abrange todo o SDK de TypeScript tal como estava na 0.0.8, mais as alterações em fila depois dela: 430 métodos em 41 espaços de nomes, cada um com o seu nome de TypeScript em snake_case. Uma verificação de paridade prova que cada um deles envia exatamente o pedido que o seu equivalente em TypeScript envia, uma vez sem opções e outra com todas as opções definidas.

• —OpenEmail e AsyncOpenEmail têm um atributo para cada espaço de nomes, de emails, threads e templates a provider_imports, dns_connections e account. listAll é list_all, getActive é get_active e tempMail é temp_mail.
• —O corpo de um pedido é um dicionário cujas chaves mantêm os nomes em camelCase da API, as opções de uma chamada são argumentos nomeados em snake_case como idempotency_key= e limit=, e uma resposta volta como dicionário. Cada corpo e cada resultado tem um TypedDict em openemail.types, com o mesmo nome que em TypeScript.
• —AsyncOpenEmail tem os mesmos métodos com os mesmos argumentos, com await, e corre em asyncio e em trio.
• —Cada recurso paginado tem list para uma página, list_all para todos os itens como lista e iterate, que produz itens e só obtém a página seguinte quando lá chega.
• —Uma recusa da API lança OpenEmailApiError, com status, type, code, param e request_id, e com is_validation, is_not_found, is_rate_limited, is_step_up_required, is_retryable e as outras verificações. A ausência total de resposta lança OpenEmailNetworkError, com is_timeout quando o prazo expirou.
• —from openemail import openemail é um cliente já pronto, construído a partir de OPENEMAIL_API_KEY na primeira vez que é usado, e init configura-o uma vez no arranque. create_temp_mail e create_async_temp_mail abrem caixas descartáveis sem nenhuma credencial.
• —access_token= aceita um token de acesso OAuth ou uma função que devolva um, chamada antes de cada pedido. verify_webhook_signature verifica uma entrega em tempo constante e devolve o evento analisado. client.raw.request chega a um endpoint que ainda nenhum método envolve.
• —As leituras são repetidas perante um 408 ou um 5xx, e perante um 429 só quando traz Retry-After. timeout limita a tentativa inteira, incluindo o corpo da resposta, e uma credencial nunca é enviada por HTTP simples, exceto para um servidor nesta máquina.
• —Requer Python 3.10 ou mais recente, e depende apenas de httpx, anyio e typing-extensions.