o 2g-@s|dZddlmZddlmZmZddlmZddlm Z ddl m Z dd l m Z dd lmZer4dd lZGd d d e Zd S)zProvide the draft class.) annotations) TYPE_CHECKINGAny)API_PATH)ClientException) RedditBase) Subreddit) UserSubredditNc seZdZdZdZedddddddddddd d-ddZ d.d/fdd Zd0dd Zfd!d"Z d#d$Z ddddddddd%d1d)d*Z dddddddddddd d2d+d,Z Z S)3DraftakA class that represents a Reddit submission draft. .. include:: ../../typical_attributes.rst ========================== ====================================================== Attribute Description ========================== ====================================================== ``link_flair_template_id`` The link flair's ID. ``link_flair_text`` The link flair's text content, or ``None`` if not flaired. ``modified`` Time the submission draft was modified, represented in `Unix Time`_. ``original_content`` Whether the submission draft will be set as original content. ``selftext`` The submission draft's selftext. ``None`` if a link submission draft. ``spoiler`` Whether the submission will be marked as a spoiler. ``subreddit`` Provides an instance of :class:`.Subreddit` or :class:`.UserSubreddit` (if set). ``title`` The title of the submission draft. ``url`` The URL the submission draft links to. ========================== ====================================================== .. _unix time: https://en.wikipedia.org/wiki/Unix_time idN flair_id flair_textis_public_linknsfworiginal_contentselftext send_repliesspoiler subreddittitleurlr str | Nonerr bool | Nonerrrrrr8praw.models.Subreddit | praw.models.UserSubreddit | Nonerr draft_kwargsrreturndict[str, Any]c  Ks^|p| ||||dur dnd||||| d } | r(| | j| jdr#dndd| | | S)Nmarkdownlink) bodyrrrkindrrrrru_profiler)rtarget)updatefullname display_name startswith)clsrrrrrrrrrrrrdatar-P/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/reddit/draft.py _prepare_data/s*   zDraft._prepare_datareddit praw.Reddit_datacs||fddkrd}t|d}|r||_n#t|dkr:|ddkr+|d|d<n |dd kr8|d|d <d }tj|||d dS) z&Initialize a :class:`.Draft` instance.Nrz0Exactly one of 'id' or '_data' must be provided.Fr#r r"rr!rT)r2_fetched)count TypeErrorr lenpopsuper__init__)selfr0r r2msgfetched __class__r-r.r9Zs   zDraft.__init__strcCsh|jr)|jr d|jjnd}|jrd|jnd}|jjd|j||dS|jjd|jdS)z?Return an object initialization representation of the instance.z subreddit=z title=z(id=))r3rr)rr>__name__r )r:rrr-r-r.__repr__ls zDraft.__repr__csN|jD]}|j|jkr|j|jtdSqd|j}t|)Nz@The currently authenticated user not have a draft with an ID of )_redditdraftsr __dict__r'r8_fetchr)r:draftr;r=r-r.rGvs   z Draft._fetchcCs|jjtdd|jiddS)zDelete the :class:`.Draft`. Example usage: .. code-block:: python draft = reddit.drafts("124862bc-e1e9-11eb-aa4f-e68667a77cbb") draft.delete() rHdraft_id)paramsN)rDdeleterr )r:r-r-r.rKs z Draft.delete)rrrrrrrr>str | praw.models.Subreddit | praw.models.UserSubreddit | None submit_kwargspraw.models.SubmissioncKs|j| d<|js|sd} t| d|fd|fd|fd|fd|fd|fd |ffD]\} } | p2t|| d } | d ur;| | | <q't|trH|j|}n t|ttfrR|}n|j}|j d i| S) aSubmit a draft. :param flair_id: The flair template to select (default: ``None``). :param flair_text: If the template's ``flair_text_editable`` value is ``True``, this value will set a custom text (default: ``None``). ``flair_id`` is required when ``flair_text`` is provided. :param nsfw: Whether or not the submission should be marked NSFW (default: ``None``). :param selftext: The Markdown formatted content for a ``text`` submission. Use an empty string, ``""``, to make a title-only submission (default: ``None``). :param spoiler: Whether or not the submission should be marked as a spoiler (default: ``None``). :param subreddit: The subreddit to submit the draft to. This accepts a subreddit display name, :class:`.Subreddit` object, or :class:`.UserSubreddit` object. :param title: The title of the submission (default: ``None``). :param url: The URL for a ``link`` submission (default: ``None``). :returns: A :class:`.Submission` object for the newly created submission. .. note:: Parameters set here will override their respective :class:`.Draft` attributes. Additional keyword arguments are passed to the :meth:`.Subreddit.submit` method. For example, to submit a draft as is: .. code-block:: python draft = reddit.drafts("5f87d55c-e4fb-11eb-8965-6aeb41b0880e") submission = draft.submit() For example, to submit a draft but use a different title than what is set: .. code-block:: python draft = reddit.drafts("5f87d55c-e4fb-11eb-8965-6aeb41b0880e") submission = draft.submit(title="New Title") .. seealso:: - :meth:`~.Subreddit.submit` to submit url posts and selftexts - :meth:`~.Subreddit.submit_gallery`. to submit more than one image in the same post - :meth:`~.Subreddit.submit_image` to submit images - :meth:`~.Subreddit.submit_poll` to submit polls - :meth:`~.Subreddit.submit_video` to submit videos and videogifs rIzN'subreddit' must be set on the Draft instance or passed as a keyword argument.rrrrrrrNr-) r r ValueErrorgetattr isinstancer?rDr r submit)r:rrrrrrrrrMr;key attributevalue _subredditr-r-r.rRs, B    z Draft.submitc Ksvt| tr |j| } |jd||||||||| | | d | } |j| d<|jjtd| d}||j |j dS)aUpdate the :class:`.Draft`. .. note:: Only provided values will be updated. :param flair_id: The flair template to select. :param flair_text: If the template's ``flair_text_editable`` value is ``True``, this value will set a custom text. ``flair_id`` is required when ``flair_text`` is provided. :param is_public_link: Whether to enable public viewing of the draft before it is submitted. :param nsfw: Whether the draft should be marked NSFW. :param original_content: Whether the submission should be marked as original content. :param selftext: The Markdown formatted content for a text submission draft. Use ``None`` to make a title-only submission draft. ``selftext`` can not be provided if ``url`` is provided. :param send_replies: When ``True``, messages will be sent to the submission author when comments are made to the submission. :param spoiler: Whether the submission should be marked as a spoiler. :param subreddit: The subreddit to create the draft for. This accepts a subreddit display name, :class:`.Subreddit` object, or :class:`.UserSubreddit` object. :param title: The title of the draft. :param url: The URL for a ``link`` submission draft. ``url`` can not be provided if ``selftext`` is provided. Additional keyword arguments can be provided to handle new parameters as Reddit introduces them. For example, to update the title of a draft do: .. code-block:: python draft = reddit.drafts("5f87d55c-e4fb-11eb-8965-6aeb41b0880e") draft.update(title="New title") rr rH)r,Nr-) rQr?rDrr/r putrrGrFr')r:rrrrrrrrrrrrr, _new_draftr-r-r.r's* 9   z Draft.update)rrrrrrrrrrrrrrrrrrrrrrrrrr)NN)r0r1r rr2r)rr?)rrrrrrrrrrrrLrrrrrMrrrN)rrrrrrrrrrrrrrrrrrLrrrrrr)rB __module__ __qualname____doc__ STR_FIELD classmethodr/r9rCrGrKrRr' __classcell__r-r-r=r.r sT+   ]r )r[ __future__rtypingrrconstr exceptionsrbaser rr user_subredditr praw.modelsprawr r-r-r-r.s