o 2g@sXdZddlmZddlmZddlmZddlmZGdd d eZ Gd d d eZ d S) zProvide poll-related classes.) annotations)Any)cachedproperty)PRAWBasec@s$eZdZdZd ddZd ddZdS) PollOptiona=Class to represent one option of a poll. If ``submission`` is a poll :class:`.Submission`, access the poll's options like so: .. code-block:: python poll_data = submission.poll_data # By index -- print the first option print(poll_data.options[0]) # By ID -- print the option with ID "576797" print(poll_data.option("576797")) .. include:: ../../typical_attributes.rst ============== ================================================= Attribute Description ============== ================================================= ``id`` ID of the poll option. ``text`` The text of the poll option. ``vote_count`` The number of votes the poll option has received. ============== ================================================= returnstrcCsd|jdS)z?Return an object initialization representation of the instance.zPollOption(id=))idselfrO/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/reddit/poll.py__repr__&szPollOption.__repr__cCs|jS)z2Return a string version of the PollData, its text.)textr rrr__str__*szPollOption.__str__N)r r )__name__ __module__ __qualname____doc__rrrrrrr s rcs:eZdZdZedddZdfd d ZdddZZS)PollDataaClass to represent poll data on a poll submission. If ``submission`` is a poll :class:`.Submission`, access the poll data like so: .. code-block:: python poll_data = submission.poll_data print(f"There are {poll_data.total_vote_count} votes total.") print("The options are:") for option in poll_data.options: print(f"{option} ({option.vote_count} votes)") print(f"I voted for {poll_data.user_selection}.") .. include:: ../../typical_attributes.rst ======================== ========================================================= Attribute Description ======================== ========================================================= ``options`` A list of :class:`.PollOption` of the poll. ``total_vote_count`` The total number of votes cast in the poll. ``user_selection`` The poll option selected by the authenticated user (possibly ``None``). ``voting_end_timestamp`` Time the poll voting closes, represented in `Unix Time`_. ======================== ========================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time r PollOption | NonecCs|jdurdS||jS)zGet the user's selection in this poll, if any. :returns: The user's selection as a :class:`.PollOption`, or ``None`` if there is no choice. N)_user_selectionoptionr rrruser_selectionMs  zPollData.user_selection attributer valuercsD|dkrt|trfdd|D}n|dkrd}t||dS)z9Objectify the options attribute, and save user_selection.optionscsg|]}tj|qSr)r_reddit).0rr rr \sz(PollData.__setattr__..rrN) isinstancelistsuper __setattr__)rrr __class__r rr&Ys zPollData.__setattr__ option_idrcCs2|jD] }|j|kr|Sqd|d}t|)zGet the option with the specified ID. :param option_id: The ID of a poll option, as a ``str``. :returns: The specified :class:`.PollOption`. :raises: :py:class:`KeyError` if no option exists with the specified ID. zNo poll option with ID .)rr KeyError)rr)rmsgrrrras  zPollData.option)r r)rr rr)r)r r r) rrrrrrr&r __classcell__rrr'rr/s   rN) r __future__rtypingrutilrbaserrrrrrrs    $