feat: add polls

[AstreaTSS]

Pull Request Type

• [x] Feature addition
• [ ] Bugfix
• [x] Documentation update
• [ ] Code refactor
• [ ] Tests improvement
• [ ] CI/CD pipeline enhancement
• [ ] Other: [Replace with a description]

Description

This PR finally adds support for Discord Polls to interactions.py.

Changes

• Created poll objects.
  • A decent bit of attention went into creating polls. As such, the UX is pretty flexible.
• Added poll parameter to the various sends.
• Add poll to Message.
• Add methods of getting users for answers of polls, and for ending polls.
• Updated docs.

Related Issues

N/A

Test Scenarios

from interactions import slash_command, SlashContext, Poll, PollMedia

@slash_command()
async def test(ctx: SlashContext):
    # method 1
    poll = Poll.create("Test?", duration=1)
    poll.add_answer("Yes!")
    poll.add_answer("No.")

    # method 2
    poll = Poll.create("Test?", duration=1).add_answer("Yes!").add_answer("No.")

    # method 3
    poll = Poll.create("Test?", duration=1, answers=["Yes!", "No."])

    # method 4 (mostly for emojis)
    poll = Poll.create("Test?", duration=1, answers=[PollMedia.create(text="Yes!"), PollMedia.create(text="No.")])

    await ctx.send(poll=poll)

Python Compatibility

• [x] I've ensured my code works on Python 3.10.x
• [ ] I've ensured my code works on Python 3.11.x

Checklist

• [x] I've run the pre-commit code linter over all edited files
• [x] I've tested my changes on supported Python versions
• [ ] I've added tests for my code, if applicable
• [x] I've updated / added documentation, where applicable