[Queue] QueueClient.receive_messages() doesn't react to `messages_per_page` parameter

• Package Name: azure-storage-queue
• Python Version: Python 3.7

Describe the bug When calling the function “receive_messages()”, all messages will return no matter what value I set messages_per_page

[annatisch]

Hi @evelyn-ys - The iterator does not dequeue all the messages before splitting into pages - instead, they are retrieved in batches, or “pages” at a time. So if you only wish to dequeue the first 5 messages - you would not loop the iterator to completion. For example, you could call next() like this to pull only one page at a time:

page_size = 5
page_iter = client.receive_messages(messages_per_page=page_size).by_page()

single_page = next(page_iter)
assert len(single_page) <= 5
for message in single_page:
    print(message)

[tasherif-msft]

Hi @evelyn-ys , just wanted to inform you that I have just created a PR that makes it much simpler to pop one message from the queue. Here’s the PR: #14855 This will give you the ability to retrieve one message at a time without lots of code overhead to do so 😃