Feat/batched_gather_return_exceptions

[giuliano-macedo]

Fixes #66.

Qual o propósito deste pull request?

Adiciona parâmetro return_exceptions no batched_gather para o usuário ter um controle melhor das excessões quando usando essa função.
Também foi adicionado os @overload para ter um type checking retrocompativel e também condizente quando setando o return_exceptions = True.

Como esta mudança deve ser testada?

Testes unitários cobrem o uso em runtime, porém o teste de tipagem estática utilizando o mypy com o seguinte código, também testa essa PR:

reveal_type(batched_gather(sleep_and_return, [1,1,1], 2))
reveal_type(batched_gather(sleep_and_return, [1,1,1], 2, False))
reveal_type(batched_gather(sleep_and_return, [1,1,1], 2, True))

b:bool
reveal_type(batched_gather(sleep_and_return, [1,1,1], 2, b))

Resultado esperado:

note: Revealed type is "typing.AsyncIterator[builtins.list[builtins.float*]]"
note: Revealed type is "typing.AsyncIterator[builtins.list[builtins.float*]]"
note: Revealed type is "typing.AsyncIterator[builtins.list[Union[builtins.Exception, builtins.float*]]]"
note: Revealed type is "typing.AsyncIterator[builtins.list[builtins.float*]]"

Tipo das mudanças

• Nova funcionalidade (mudança, sem quebra de contrato, que adiciona um nova funcionalidade)

[giuliano-macedo]

I wrote this type: ignore because i was getting: Overloaded function implementation cannot produce return type of signature 2 and it doesn't make a lot of sense to me, it seems to be related to this bug, but I'm not sure.