Add limit to list workflows

[Sushisource]

What was changed

Title

Why?

Convenience functionality since there's no take function or similar in Python for async iterators

Checklist

1. Closes [Feature Request] Support a limit parameter in replay_workflows and workflow_replay_iterator #610

2. How was this tested:
   Added test

3. Any docs updates needed?

[cretz]

Pedantic but I'd move this up above page_size. The other params aren't really ever expected to be set.

[Sushisource]

Ah, right I forgot the * meant that they couldn't be used positionally

[cretz]

The reason that we made the fetch_next_page public is because technically people don't have to use the async iteration, they can paginate using this themselves. For users using it that way, limit will not work. I am unsure if we want to make it work or if we want to say it's only when using it as an async iterable that it applies.

One option is to instead offer a general Python helper for limiting async iterables (though doesn't help the page size thing). But we can also just document that this field only works when using as an async iterable.

[Sushisource]

Hmm, honestly I'd prefer to just un-pub it but I suppose that's not really an option. I'll update the docstring to say it only applies to the iterable, since if you're doing it yourself ostensibly you don't care anyway.

[cretz]

Works for me. The reason behind making it public is I was afraid people wanted to use it outside of an async for and were afraid to invoke __anext__ themselves and understand how to handle iteration stop and such. Async iterables in Python are not as easy to use outside of loop constructs as, say, Java streams or .NET async enumerables.