FjN9TdZddlmZddlmZmZddlmZerddlm Z GddZ y) z&Provide the SubredditStylesheet class.) annotations) TYPE_CHECKINGAny)API_PATH)modelsceZdZdZddZddZddZddZddZddZ ddZ dd Z dd Z dd Z dd Zd dddZddZd dZd d d!dZd dZd"dZd dZd"dZd"dZy )#SubredditStylesheetaProvides a set of stylesheet functions to a :class:`.Subreddit`. For example, to add the css data ``.test{color:blue}`` to the existing stylesheet: .. code-block:: python subreddit = reddit.subreddit("test") stylesheet = subreddit.stylesheet() stylesheet.stylesheet += ".test{color:blue}" subreddit.stylesheet.update(stylesheet.stylesheet) ctdj|j}|jjj |S)zReturn the :class:`.Subreddit`'s stylesheet. To be used as: .. code-block:: python stylesheet = reddit.subreddit("test").stylesheet() about_stylesheet subreddit)rformatr _redditgetselfurls e/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/subreddit/stylesheet.py__call__zSubredditStylesheet.__call__s<)*11DNN1K~~%%))#..c||_y)aInitialize a :class:`.SubredditStylesheet` instance. :param subreddit: The :class:`.Subreddit` associated with the stylesheet. An instance of this class is provided as: .. code-block:: python reddit.subreddit("test").stylesheet Nr )rr s r__init__zSubredditStylesheet.__init__(s #rctdj|j}|jjj ||y)Nstructured_stylesr data)rrr rpatch)r style_datars r_update_structured_stylesz-SubredditStylesheet._update_structured_styles6s<*+22T^^2L $$Sz$:rc.ddi}|j|y)zRemove the current :class:`.Subreddit` (redesign) banner image. Succeeds even if there is no banner image. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_banner() bannerBackgroundImageNrrrs r delete_bannerz!SubredditStylesheet.delete_banner:s(, &&t,rc0ddd}|j|y)aIRemove the current :class:`.Subreddit` (redesign) banner additional image. Succeeds even if there is no additional image. Will also delete any configured hover image. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_banner_additional_image() r")bannerPositionedImagesecondaryBannerPositionedImageNr#r$s rdelete_banner_additional_imagez2SubredditStylesheet.delete_banner_additional_imageIs*,rR &&t,rc.ddi}|j|y)aRemove the current :class:`.Subreddit` (redesign) banner hover image. Succeeds even if there is no hover image. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_banner_hover_image() r(r"Nr#r$s rdelete_banner_hover_imagez-SubredditStylesheet.delete_banner_hover_imageYs1"5 &&t,rctdj|j}|jjj |y)zRemove the current :class:`.Subreddit` header image. Succeeds even if there is no header image. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_header() delete_sr_headerr Nrrr rpostrs r delete_headerz!SubredditStylesheet.delete_headerh9)*11DNN1K ##C(rctdj|j}|jjj |d|iy)zRemove the named image from the :class:`.Subreddit`. Succeeds even if the named image does not exist. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_image("smile") delete_sr_imager img_namerNr.)rnamers r delete_imagez SubredditStylesheet.delete_imagewsC()004>>0J ##Cz4.@#Arc.ddi}|j|y)a$Remove the current :class:`.Subreddit` (redesign) mobile banner. Succeeds even if there is no mobile banner. For example: .. code-block:: python subreddit = reddit.subreddit("test") subreddit.stylesheet.delete_banner_hover_image() mobileBannerImager"Nr#r$s rdelete_mobile_bannerz(SubredditStylesheet.delete_mobile_banners$R( &&t,rctdj|j}|jjj |y)zRemove the current :class:`.Subreddit` mobile header. Succeeds even if there is no mobile header. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_mobile_header() r-r Nr.rs rdelete_mobile_headerz(SubredditStylesheet.delete_mobile_headerr1rctdj|j}|jjj |y)zRemove the current :class:`.Subreddit` mobile icon. Succeeds even if there is no mobile icon. For example: .. code-block:: python reddit.subreddit("test").stylesheet.delete_mobile_icon() delete_sr_iconr Nr.rs rdelete_mobile_iconz&SubredditStylesheet.delete_mobile_icons9'(//$../I ##C(rN)reasoncd||d}tdj|j}|jjj ||y)aoUpdate the :class:`.Subreddit`'s stylesheet. :param stylesheet: The CSS for the new stylesheet. :param reason: The reason for updating the stylesheet. For example: .. code-block:: python reddit.subreddit("test").stylesheet.update( "p { color: green; }", reason="color text green" ) save)opr?stylesheet_contentssubreddit_stylesheetr rNr.)r stylesheetr?rrs rupdatezSubredditStylesheet.updatesJzR-.555O ##Cd#3rc>|j|j|dS)aUpload an image to the :class:`.Subreddit`. :param media: The :class:`.StylesheetImage` to upload. :param name: The name to use for the image. If an image already exists with the same name, it will be replaced. :returns: A dictionary containing a link to the uploaded image under the key ``img_src``. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetImage reddit.subreddit("test").stylesheet.upload(StylesheetImage("img.png"), name="smile") img)r5 upload_type_uploadr )rmediar5s ruploadzSubredditStylesheet.uploads2}}T^^$E}JJrchd}|j|j|}|j||iy)aUpload an image for the :class:`.Subreddit`'s (redesign) banner image. :param media: The :class:`.StylesheetAsset` to upload. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetAsset reddit.subreddit("test").stylesheet.upload_banner(StylesheetAsset("banner.png")) r! image_typeNrKr rrrLrP image_urls r upload_bannerz!SubredditStylesheet.upload_banners2(- MM$..ZMH  && I'>?r)alignci}||dvr d}t|||d<d}|j|j|}||i}|r|j||j |y)ajUpload an image for the :class:`.Subreddit`'s (redesign) additional image. :param media: The :class:`.StylesheetAsset` to upload. :param align: Either ``"left"``, ``"centered"``, or ``"right"``. (default: ``"left"``). :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetAsset subreddit = reddit.subreddit("test") subreddit.stylesheet.upload_banner_additional_image(StylesheetAsset("banner.png")) N>leftrightcenteredz>'align' argument must be either 'left', 'centered', or 'right'bannerPositionedImagePositionr'rO) ValueErrorrKr rFr)rrLrU alignmentmsgrPrSrs rupload_banner_additional_imagez2SubredditStylesheet.upload_banner_additional_imagesv:  99V o%9>I5 6, MM$..ZMH  ),    i ( &&z2rchd}|j|j|}|j||iy)aNUpload an image for the :class:`.Subreddit`'s (redesign) additional image. :param media: The :class:`.StylesheetAsset` to upload. Fails if the :class:`.Subreddit` does not have an additional image defined. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetAsset subreddit = reddit.subreddit("test") subreddit.stylesheet.upload_banner_hover_image(StylesheetAsset("banner.png")) r(rONrQrRs rupload_banner_hover_imagez-SubredditStylesheet.upload_banner_hover_image%s2.6 MM$..ZMH  && I'>?rc<|j|jdS)a5Upload an image to be used as the :class:`.Subreddit`'s header image. :param media: The :class:`.StylesheetImage` to upload. :returns: A dictionary containing a link to the uploaded image under the key ``img_src``. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetImage reddit.subreddit("test").stylesheet.upload_header(StylesheetImage("header.png")) headerrIrJrrLs r upload_headerz!SubredditStylesheet.upload_header@.}}T^^}BBrchd}|j|j|}|j||iy)aFUpload an image for the :class:`.Subreddit`'s (redesign) mobile banner. :param media: The :class:`.StylesheetAsset` to upload. For example: .. code-block:: python from praw.models import StylesheetAsset subreddit = reddit.subreddit("test") subreddit.stylesheet.upload_mobile_banner(StylesheetAsset("banner.png")) Fails if the :class:`.Subreddit` does not have an additional image defined. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. r8rONrQrRs rupload_mobile_bannerz(SubredditStylesheet.upload_mobile_bannerYs2.) MM$..ZMH  && I'>?rc<|j|jdS)a=Upload an image to be used as the :class:`.Subreddit`'s mobile header. :param media: The :class:`.StylesheetImage` to upload. :returns: A dictionary containing a link to the uploaded image under the key ``img_src``. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetImage reddit.subreddit("test").stylesheet.upload_mobile_header(StylesheetImage("header.png")) bannerrcrJrds rupload_mobile_headerz(SubredditStylesheet.upload_mobile_headertrfrc<|j|jdS)a7Upload an image to be used as the :class:`.Subreddit`'s mobile icon. :param media: The :class:`.StylesheetImage` to upload. :returns: A dictionary containing a link to the uploaded image under the key ``img_src``. :raises: ``prawcore.TooLarge`` if the overall request body is too large. :raises: :class:`.RedditAPIException` if there are other issues with the uploaded image. Unfortunately the exception info might not be very specific, so try through the website with the same image to see what the problem actually might be. For example: .. code-block:: python from praw.models import StylesheetImage reddit.subreddit("test").stylesheet.upload_mobile_icon(StylesheetImage("icon.png")) iconrcrJrds rupload_mobile_iconz&SubredditStylesheet.upload_mobile_icons.}}T^^}@@r)returnzmodels.Stylesheet)r zmodels.SubredditroNone)rzdict[str, str | Any]rorp)rorp)r5strrorp)rErqr? str | Nonerorp)rLmodels.StylesheetImager5rqrodict[str, str])rLmodels.StylesheetAssetrorp)rLrurUrrrorp)rLrsrort)__name__ __module__ __qualname____doc__rrrr%r)r+r0r6r9r;r>rFrMrTr^r`rerhrkrnrrr r s  / #; -- - ) B- ) )?C4&K6@:! )3%)3  )3  )3V@6C2@6C2Arr N) ry __future__rtypingrr praw.constrprawrr rzrrrs%,"%WAWAr