Added DirectRateLimiter::until_n_ready{,_with_jitter}

[jean-airoldie]

Allows the user to wait asynchronously for n cells to be available.

Closes #9.

[jean-airoldie]

Blocked by #11.

[antifuchs]

Thanks so much for the contribution! This looks great overall, and I've left some comments. Once #11 goes in, we should be OK to merge this in, with the suggested changes.

[jean-airoldie]

Alright so here is my two cents:

For the sake of consistency between the check_all method and the until_ready for multiples cells I think both should either be named:

• check_all & until_all_ready
• check_n & until_n_ready

Personally I think that the _n version is clearer because the _all version seems to imply that we wait for all the capacity to be available.

[jean-airoldie]

Btw cool crate. Very well documented as well.

[antifuchs]

You make a good point about the naming - with the _all convention, I'd hoped to provide a check_any method as well, where the request is allowed to proceed if requested<= n > 0 cells are allowed, but that seems very confusing and probably doesn't provide as big a benefit as I'd hoped (plus, how much should this reserve? It would be confusing).

I'm ok with the _n naming on until, but the question about consistency remains. I'll rename check_all to check_n in a follow-up change to this.

Also, thanks so much for the kind words! I'm super glad you find it useful & that you like the documentation!

[antifuchs]

bors r+

[bors]

Build succeeded

• ci/circleci: ci_success