
    {i                     @    S r SSKJr  SSKJr  SSKJr   " S S5      rg)	z Provide the GildableMixin class.    )warn   )API_PATH)_deprecate_argsc            
       f    \ rS rSrSr\" SSS5      SSSS	.S\S\S\S
\4S jj5       r	S
\4S jr
Srg)GildableMixin	   z)Interface for classes that can be gilded.	gild_typeis_anonymousmessagegid_2TN)r
   r   r   returnc                h    SUUU R                   US.nU R                  R                  [        S   US9$ )a  Award the author of the item.

:param gild_type: Type of award to give. See table below for currently know
    global award types.
:param is_anonymous: If ``True``, the authenticated user's username will not be
    revealed to the recipient.
:param message: Message to include with the award.

:returns: A dict containing info similar to what is shown below:

    .. code-block:: python

        {
            "subreddit_balance": 85260,
            "treatment_tags": [],
            "coins": 8760,
            "gildings": {"gid_1": 0, "gid_2": 1, "gid_3": 0},
            "awarder_karma_received": 4,
            "all_awardings": [
                {
                    "giver_coin_reward": 0,
                    "subreddit_id": None,
                    "is_new": False,
                    "days_of_drip_extension": 0,
                    "coin_price": 75,
                    "id": "award_9663243a-e77f-44cf-abc6-850ead2cd18d",
                    "penny_donate": 0,
                    "coin_reward": 0,
                    "icon_url": "https://www.redditstatic.com/gold/awards/icon/SnooClappingPremium_512.png",
                    "days_of_premium": 0,
                    "icon_height": 512,
                    "tiers_by_required_awardings": None,
                    "icon_width": 512,
                    "static_icon_width": 512,
                    "start_date": None,
                    "is_enabled": True,
                    "awardings_required_to_grant_benefits": None,
                    "description": "For an especially amazing showing.",
                    "end_date": None,
                    "subreddit_coin_reward": 0,
                    "count": 1,
                    "static_icon_height": 512,
                    "name": "Bravo Grande!",
                    "icon_format": "APNG",
                    "award_sub_type": "PREMIUM",
                    "penny_price": 0,
                    "award_type": "global",
                    "static_icon_url": "https://i.redd.it/award_images/t5_q0gj4/59e02tmkl4451_BravoGrande-Static.png",
                }
            ],
        }


.. warning::

    Requires the authenticated user to own Reddit Coins. Calling this method
    will consume Reddit Coins.

To award the gold award anonymously do:

.. code-block:: python

    comment = reddit.comment("dkk4qjd")
    comment.award()

    submission = reddit.submission("8dmv8z")
    submission.award()

To award the platinum award with the message 'Nice!' and reveal your username to
the recipient do:

.. code-block:: python

    comment = reddit.comment("dkk4qjd")
    comment.award(gild_type="gild_3", message="Nice!", is_anonymous=False)

    submission = reddit.submission("8dmv8z")
    submission.award(gild_type="gild_3", message="Nice!", is_anonymous=False)

.. include:: awards.txt

json)api_typer
   r   thing_idr   award_thing)params)fullname_redditpostr   )selfr
   r   r   r   s        \/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/reddit/mixins/gildable.pyawardGildableMixin.award   s@    v "(
 ||  -!8 HH    c                 @    [        S[        SS9  U R                  5       $ )z=Alias for :meth:`.award` to maintain backwards compatibility.z%'.gild' has been renamed to '.award'.   )category
stacklevel)r   DeprecationWarningr   )r   s    r   gildGildableMixin.gildo   s!    3'	

 zz|r    )__name__
__module____qualname____firstlineno____doc__r   strbooldictr   r"   __static_attributes__r$   r   r   r   r   	   sl    3[.)< !!`I `I 	`I
 `I 
`I =`IDd r   r   N)r)   warningsr   constr   utilr   r   r$   r   r   <module>r1      s    &   $m mr   