PollActions¶

from xeepy.actions.polls import PollActions

class PollActions:
    def __init__(
        self,
        browser_manager: BrowserManager,
        rate_limiter: Optional[RateLimiter] = None
    )

async def create_poll(
    self,
    question: str,
    options: List[str],
    duration_minutes: int = 1440
) -> Tweet

async def vote(
    self,
    tweet_url: str,
    option_index: int
) -> bool

async def get_poll_results(
    self,
    tweet_url: str
) -> PollResults

@dataclass
class PollResults:
    question: str                    # Poll question
    options: List[PollOption]        # Options with votes
    total_votes: int                 # Total vote count
    end_time: datetime               # When poll ends
    is_final: bool                   # Whether poll has ended
    voted_option: Optional[int]      # User's vote (if voted)

@dataclass
class PollOption:
    text: str                        # Option text
    votes: int                       # Vote count
    percentage: float                # Vote percentage

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        poll = await x.poll.create_poll(
            "What's your favorite programming language?",
            ["Python", "JavaScript", "Rust", "Go"],
            duration_minutes=1440  # 24 hours
        )

        print(f"Poll created: https://x.com/i/status/{poll.id}")

asyncio.run(main())

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        poll = await x.poll.create_poll(
            "Quick vote: Coffee or Tea?",
            ["☕ Coffee", "🍵 Tea"],
            duration_minutes=5
        )

        print(f"Quick poll created! Ends in 5 minutes.")

asyncio.run(main())

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        poll = await x.poll.create_poll(
            "What feature should we build next?",
            ["Dark mode", "Mobile app", "API access", "Integrations"],
            duration_minutes=10080  # 7 days
        )

        print(f"Poll running for 7 days!")

asyncio.run(main())

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        success = await x.poll.vote(
            "https://x.com/user/status/123456789",
            option_index=0  # Vote for first option
        )

        print("Vote recorded!" if success else "Failed to vote")

asyncio.run(main())

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        results = await x.poll.get_poll_results(
            "https://x.com/user/status/123456789"
        )

        print(f"Question: {results.question}")
        print(f"Total votes: {results.total_votes}")
        print(f"Status: {'Ended' if results.is_final else 'Active'}")
        print()

        for i, option in enumerate(results.options):
            bar = "█" * int(option.percentage / 5) + "░" * (20 - int(option.percentage / 5))
            print(f"  {option.text}")
            print(f"    {bar} {option.percentage:.1f}% ({option.votes} votes)")

asyncio.run(main())

from xeepy import Xeepy
import asyncio

async def monitor_poll(tweet_url: str, interval: int = 300):
    """Monitor poll results in real-time."""
    async with Xeepy() as x:
        while True:
            results = await x.poll.get_poll_results(tweet_url)

            print(f"\n[{datetime.now().strftime('%H:%M:%S')}] Poll Update")
            print(f"Total votes: {results.total_votes}")

            for option in results.options:
                print(f"  {option.text}: {option.percentage:.1f}%")

            if results.is_final:
                print("\nPoll has ended!")
                break

            await asyncio.sleep(interval)

asyncio.run(monitor_poll("https://x.com/user/status/123"))

from xeepy import Xeepy

async def main():
    async with Xeepy() as x:
        poll = await x.poll.create_poll(
            "Rate today's presentation:",
            ["🌟🌟🌟🌟🌟 Excellent", "🌟🌟🌟🌟 Great", "🌟🌟🌟 Good", "🌟🌟 Needs work"],
            duration_minutes=60
        )

        print("Rating poll created!")

asyncio.run(main())

from xeepy import Xeepy

async def ab_test(options: list, duration_hours: int = 24):
    """Run A/B test with a poll."""
    async with Xeepy() as x:
        poll = await x.poll.create_poll(
            "Which headline do you prefer?",
            options,
            duration_minutes=duration_hours * 60
        )

        print(f"A/B test started. Poll ID: {poll.id}")
        print(f"Check results in {duration_hours} hours.")

        return poll.id

options = [
    "A: 10 Tips to Boost Productivity",
    "B: How I 10x'd My Productivity"
]
asyncio.run(ab_test(options))

from xeepy import Xeepy
import json

async def export_poll_results(tweet_url: str, output_file: str):
    async with Xeepy() as x:
        results = await x.poll.get_poll_results(tweet_url)

        data = {
            "question": results.question,
            "total_votes": results.total_votes,
            "is_final": results.is_final,
            "end_time": results.end_time.isoformat(),
            "options": [
                {
                    "text": opt.text,
                    "votes": opt.votes,
                    "percentage": opt.percentage
                }
                for opt in results.options
            ]
        }

        with open(output_file, "w") as f:
            json.dump(data, f, indent=2)

        print(f"Results exported to {output_file}")

asyncio.run(export_poll_results("https://x.com/user/status/123", "poll_results.json"))