{i+h,SrSSKJr SSKJrJrJrJr SSKJ r SSK J r SSK J r SS KJr SS KJr SS K Jr S S KJr S SKJr S SKJr \(aSSKr"SS5r"SS\5r"SS5r"SS5r"SS5r"SS\\5r g)zProvide the LiveThread class.) annotations) TYPE_CHECKINGAnyIterableIterator)API_PATH)_deprecate_args)cachedproperty) RedditorList)ListingGenerator)stream_generator) RedditBase) FullnameMixin)RedditorNc\rSrSrSr\SSj5rSSjrSSjrSr \ "SS5S S .SS jj5r S r SS jr SSjr\ "SS5S S .SSjj5r\ "SS5S S .SSjj5rSrg )LiveContributorRelationshipzBLiveContributorRelationship._handle_permissions..s5A!A3s)setjoinrs r _handle_permissions/LiveContributorRelationship._handle_permissionss*!,!4ug#k:J xx5555c[SRURRS9nURRR U5n[ U[5(aU$US$)zReturn a :class:`.RedditorList` for live threads' contributors. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") for contributor in thread.contributor(): print(contributor) live_contributorsidr)r formatthreadr,_redditget isinstancer )selfurltemps r __call__$LiveContributorRelationship.__call__sZ*+22dkknn2E{{""&&s+!$ 55tB47Br(cXlg)zInitialize a :class:`.LiveContributorRelationship` instance. :param thread: An instance of :class:`.LiveThread`. .. note:: This class should not be initialized directly. Instead, obtain an instance via: :meth:`.LiveThread.contributor`. Nr.r2r.s r __init__$LiveContributorRelationship.__init__-s  r(c[SRURRS9nURRR U5 g)zAccept an invite to contribute the live thread. Usage: .. code-block:: python thread = reddit.live("ydwwxneu7vsa") thread.contributor.accept_invite() live_accept_inviter+Nr r-r.r,r/postr2r3s r accept_invite)LiveContributorRelationship.accept_invite:s=+,33t{{~~3F   %r(redditorNr%c[SRURRS9n[ U5SUR U5S.nURR RX4S9 g)aInvite a redditor to be a contributor of the live thread. :param redditor: A redditor name or :class:`.Redditor` instance. :param permissions: When provided (not ``None``), permissions should be a list of strings specifying which subset of permissions to grant. An empty list ``[]`` indicates no permissions, and when not provided (``None``), indicates full permissions. :raises: :class:`.RedditAPIException` if the invitation already exists. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") redditor = reddit.redditor("spez") # "manage" and "settings" permissions thread.contributor.invite(redditor, permissions=["manage", "settings"]) .. seealso:: :meth:`.LiveContributorRelationship.remove_invite` to remove the invite for redditor. live_inviter+liveupdate_contributor_invitenametyperdataNr r-r.r,strr&r/r?r2rCrr3rKs r invite"LiveContributorRelationship.inviteHsaB}%,, ,?M333K@     0r(c[SRURRS9nURRR U5 g)zAbdicate the live thread contributor position (use with care). Usage: .. code-block:: python thread = reddit.live("ydwwxneu7vsa") thread.contributor.leave() live_leaver+Nr>r@s r leave!LiveContributorRelationship.leaveq<|$++t{{~~+>   %r(c[U[5(a UROUnSU0n[SR UR R S9nUR RRXCS9 g)akRemove the redditor from the live thread contributors. :param redditor: A redditor fullname (e.g., ``"t2_1w72"``) or :class:`.Redditor` instance. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") redditor = reddit.redditor("spez") thread.contributor.remove(redditor) thread.contributor.remove("t2_1w72") # with fullname r,live_remove_contribr+rJN r1rfullnamer r-r.r,r/r?r2rCrYrKr3s r remove"LiveContributorRelationship.removesc )38X(F(F8$$Hh,-44 4G    0r(c[U[5(a UROUnSU0n[SR UR R S9nUR RRXCS9 g)aRemove the invite for redditor. :param redditor: A redditor fullname (e.g., ``"t2_1w72"``) or :class:`.Redditor` instance. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") redditor = reddit.redditor("spez") thread.contributor.remove_invite(redditor) thread.contributor.remove_invite("t2_1w72") # with fullname .. seealso:: :meth:`.LiveContributorRelationship.invite` to invite a redditor to be a contributor of the live thread. r,live_remove_inviter+rJNrXrZs r remove_invite)LiveContributorRelationship.remove_invitesc*)38X(F(F8$$Hh+,33t{{~~3F    0r(c[SRURRS9n[ U5SUR U5S.nURR RX4S9 g)aUpdate the contributor permissions for ``redditor``. :param redditor: A redditor name or :class:`.Redditor` instance. :param permissions: When provided (not ``None``), permissions should be a list of strings specifying which subset of permissions to grant (other permissions are removed). An empty list ``[]`` indicates no permissions, and when not provided (``None``), indicates full permissions. For example, to grant all permissions to the contributor, try: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") thread.contributor.update("spez") To grant ``"access"`` and ``"edit"`` permissions (and to remove other permissions), try: .. code-block:: python thread.contributor.update("spez", permissions=["access", "edit"]) To remove all permissions from the contributor, try: .. code-block:: python subreddit.moderator.update("spez", permissions=[]) live_update_permsr+liveupdate_contributorrGrJNrLrNs r update"LiveContributorRelationship.updatesbH*+22dkknn2EM,33K@     0r(c[SRURRS9n[ U5SUR U5S.nURR RX4S9 g)aUpdate the contributor invite permissions for ``redditor``. :param redditor: A redditor name or :class:`.Redditor` instance. :param permissions: When provided (not ``None``), permissions should be a list of strings specifying which subset of permissions to grant (other permissions are removed). An empty list ``[]`` indicates no permissions, and when not provided (``None``), indicates full permissions. For example, to set all permissions to the invitation, try: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") thread.contributor.update_invite("spez") To set ``"access"`` and ``"edit"`` permissions (and to remove other permissions) to the invitation, try: .. code-block:: python thread.contributor.update_invite("spez", permissions=["access", "edit"]) To remove all permissions from the invitation, try: .. code-block:: python thread.contributor.update_invite("spez", permissions=[]) rbr+rFrGrJNrLrNs r update_invite)LiveContributorRelationship.update_invitesbH*+22dkknn2EM333K@     0r(r8)rz Iterable[str]returnrM)rizlist[praw.models.Redditor]r.praw.models.LiveThread)rCstr | praw.models.Redditorrzlist[str] | None)rCrl)__name__ __module__ __qualname____firstlineno____doc__ staticmethodr&r5r:rAr rOrSr[r_rdrg__static_attributes__rr(r rrsF66C  &Z/ )- &1,&1& &10&1P &1*14Z/ )- )1,)1& )10)1VZ/ )- )1,)1& )10)1r(rc^\rSrSrSrSr\SSj5r\SSj5r\SSj5r SSjr SSjr SS jr SSU4S jjjr U4S jrS rSS jrSSjrSSjrSrU=r$) LiveThreadiaAn individual :class:`.LiveThread` object. .. include:: ../../typical_attributes.rst ==================== ========================================================= Attribute Description ==================== ========================================================= ``created_utc`` The creation time of the live thread, in `Unix Time`_. ``description`` Description of the live thread, as Markdown. ``description_html`` Description of the live thread, as HTML. ``id`` The ID of the live thread. ``nsfw`` A ``bool`` representing whether or not the live thread is marked as NSFW. ==================== ========================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time r,c[U5$)zProvide an instance of :class:`.LiveThreadContribution`. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") thread.contrib.add("### update") )LiveThreadContributionr2s r contribLiveThread.contribs&d++r(c[U5$)aProvide an instance of :class:`.LiveContributorRelationship`. You can call the instance to get a list of contributors which is represented as :class:`.RedditorList` instance consists of :class:`.Redditor` instances. Those :class:`.Redditor` instances have ``permissions`` attributes as contributors: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") for contributor in thread.contributor(): # prints `Redditor(name="Acidtwist") ["all"]` print(contributor, contributor.permissions) )rrxs r contributorLiveThread.contributor+s +400r(c[U5$)aProvide an instance of :class:`.LiveThreadStream`. Streams are used to indefinitely retrieve new updates made to a live thread, like: .. code-block:: python for live_update in reddit.live("ta535s1hq2je").stream.updates(): print(live_update.body) Updates are yielded oldest first as :class:`.LiveUpdate`. Up to 100 historical updates will initially be returned. To only retrieve new updates starting from when the stream is created, pass ``skip_existing=True``: .. code-block:: python live_thread = reddit.live("ta535s1hq2je") for live_update in live_thread.stream.updates(skip_existing=True): print(live_update.author) )LiveThreadStreamrxs r streamLiveThread.stream=s. %%r(c[U[5(aU[U5:H$[XR5=(a [U5[U5:H$)zjReturn whether the other instance equals the current. .. note:: This comparison is case sensitive. )r1rM __class__)r2others r __eq__LiveThread.__eq__VsA eS ! !CI% %%0LSY#e*5LLr(cD[URURU5$)aReturn a lazy :class:`.LiveUpdate` instance. :param update_id: A live update ID, e.g., ``"7827987a-c998-11e4-a0b9-22000b6a88d2"``. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") update = thread["7827987a-c998-11e4-a0b9-22000b6a88d2"] update.thread # LiveThread(id="ukaeu1ik4sw5") update.id # "7827987a-c998-11e4-a0b9-22000b6a88d2" update.author # "umbrae" ) LiveUpdater/r,)r2 update_ids r __getitem__LiveThread.__getitem__bs"$,,;;r(cj[URR5[[U55- $)z(Return the hash of the current instance.)hashrrmrMrxs r __hash__LiveThread.__hash__us$DNN++,tCI>>r(c>X#4RS5S:wa Sn[U5eU(aX l[TU]XS9 g)zInitialize a :class:`.LiveThread` instance. :param reddit: An instance of :class:`.Reddit`. :param id: A live thread ID, e.g., ``"ukaeu1ik4sw5"`` Nrz(Either 'id' or '_data' must be provided._data)count TypeErrorr,superr:)r2redditr,rmsgrs r r:LiveThread.__init__ysA ;  T "a 'UR5nUSn[U5"URUS9nURR UR5 [ TU]5 g)NrKr) _fetch_datarIr/__dict__rdr_fetch)r2rKrrs r rLiveThread._fetchsN!F|T 4<)r2rr3s r addLiveThreadContribution.addsF()00DKKNN0C   FD> :r(c[SRURRS9nURRR U5 g)zClose the live thread permanently (cannot be undone). Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") thread.contrib.close() live_closer+Nr>r@s r closeLiveThreadContribution.closerUr(title descriptionnsfw resourcesN)rrrrc \UUUUS.nURU5 [SUR555(ag[URR URR 5nUR5VV s0sHupXc [Xx5OU _M n nn [SRURR S9n URR RXR5S9 URR"U R56 gs sn nf)aUpdate settings of the live thread. :param description: The live thread's description (default: ``None``). :param nsfw: Indicate whether this thread is not safe for work (default: ``None``). :param resources: Markdown formatted information that is useful for the live thread (default: ``None``). :param title: The title of the live thread (default: ``None``). Does nothing if no arguments are provided. Each setting will maintain its current value if ``None`` is specified. Additional keyword arguments can be provided to handle new settings as Reddit introduces them. Usage: .. code-block:: python thread = reddit.live("xyu8kmjvfrww") # update 'title' and 'nsfw' updated_thread = thread.contrib.update(title=new_title, nsfw=True) If Reddit introduces new settings, you must specify ``None`` for the setting you want to maintain: .. code-block:: python # update 'nsfw' and maintain new setting 'foo' thread.contrib.update(nsfw=True, foo=None) )rrrrc3(# UHoSLv M g7f)Nr)rvalues r r!0LiveThreadContribution.update..Ds<*;}*;sNlive_update_threadr+rJ)rdrvaluesrur.r/r,itemsgetattrr r-r?copy_reset_attributeskeys) r2rrrrother_settingssettingsr.keyrrKr3s r rdLiveThreadContribution.updatesZ&"   ' <(//*;< < < DKK//@'nn. .  %E A.  +,33t{{~~3F   99; 7 %%tyy{3 sD(r8rj)rrM) rrrz bool | Nonerrrrrr) rmrnrorprqr:rrr rdrsrr(r rwrwstM ; &WmV[A#' $ >4 >4 >4  >4  >4%>4B>4r(rwc4\rSrSrSrSSjrSSjrSrg) riSzProvides a :class:`.LiveThread` stream. Usually used via: .. code-block:: python for live_update in reddit.live("ta535s1hq2je").stream.updates(): print(live_update.body) cXlg)ztInitialize a :class:`.LiveThreadStream` instance. :param live_thread: The live thread associated with the stream. N live_thread)r2rs r r:LiveThreadStream.__init___s 'r(c B[URR40UD6$)aYield new updates to the live thread as they become available. :param skip_existing: Set to ``True`` to only fetch items created after the stream (default: ``False``). As with :meth:`.LiveThread.updates()`, updates are yielded as :class:`.LiveUpdate`. Updates are yielded oldest first. Up to 100 historical updates will initially be returned. Keyword arguments are passed to :func:`.stream_generator`. For example, to retrieve all new updates made to the ``"ta535s1hq2je"`` live thread, try: .. code-block:: python for live_update in reddit.live("ta535s1hq2je").stream.updates(): print(live_update.body) To only retrieve new updates starting from when the stream is created, pass ``skip_existing=True``: .. code-block:: python live_thread = reddit.live("ta535s1hq2je") for live_update in live_thread.stream.updates(skip_existing=True): print(live_update.author) )rrr)r2stream_optionss r rLiveThreadStream.updatesgs!D  0 0 8 8KNKKr(rN)rrk)rzdict[str, Any]rir)rmrnrorprqr:rrsrr(r rrSs$ '"L ."L )"Lr(rc.\rSrSrSrSSjrSrSrSrg) LiveUpdateContributionizAProvides a set of contribution functions to :class:`.LiveUpdate`.cXlg)aInitialize a :class:`.LiveUpdateContribution` instance. :param update: An instance of :class:`.LiveUpdate`. This instance can be retrieved through ``update.contrib`` where update is a :class:`.LiveUpdate` instance. E.g., .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") update = thread["7827987a-c998-11e4-a0b9-22000b6a88d2"] update.contrib # LiveUpdateContribution instance update.contrib.remove() Nrd)r2rds r r:LiveUpdateContribution.__init__s  r(c[SRURRRS9nSURR 0nURRR RXS9 g)zRemove a live update. Usage: .. code-block:: python thread = reddit.live("ydwwxneu7vsa") update = thread["6854605a-efec-11e6-b0c7-0eafac4ff094"] update.contrib.remove() live_remove_updater+r,rJNr r-rdr.r,rYr/r?r2r3rKs r r[LiveUpdateContribution.removesb+,33t{{7I7I7L7L3Mdkk**+ ""'''7r(c[SRURRRS9nSURR 0nURRR RXS9 g)aStrike a content of a live update. .. code-block:: python thread = reddit.live("xyu8kmjvfrww") update = thread["cb5fe532-dbee-11e6-9a91-0e6d74fabcc4"] update.contrib.strike() To check whether the update is stricken or not, use ``update.stricken`` attribute. .. note:: Accessing lazy attributes on updates (includes ``update.stricken``) may raise :py:class:`AttributeError`. See :class:`.LiveUpdate` for details. live_striker+r,rJNrrs r strikeLiveUpdateContribution.strikesa$}%,, 0B0B0E0E,Fdkk**+ ""'''7r(rN)rdr) rmrnrorprqr:r[rrsrr(r rrsK$8 8r(rc^\rSrSrSrSrSr\S Sj5r\ S Sj5r S S U4Sjjjr SU4Sjjr U4Sjr S rU=r$)riaAn individual :class:`.LiveUpdate` object. .. include:: ../../typical_attributes.rst =============== =================================================================== Attribute Description =============== =================================================================== ``author`` The :class:`.Redditor` who made the update. ``body`` Body of the update, as Markdown. ``body_html`` Body of the update, as HTML. ``created_utc`` The time the update was created, as `Unix Time`_. ``stricken`` A ``bool`` representing whether or not the update was stricken (see :meth:`.strike`). =============== =================================================================== .. _unix time: https://en.wikipedia.org/wiki/Unix_time r,c[U5$)zProvide an instance of :class:`.LiveUpdateContribution`. Usage: .. code-block:: python thread = reddit.live("ukaeu1ik4sw5") update = thread["7827987a-c998-11e4-a0b9-22000b6a88d2"] update.contrib # LiveUpdateContribution instance )rrxs r ryLiveUpdate.contribs&d++r(cUR$)z@Return :class:`.LiveThread` object the update object belongs to.)rrxs r r.LiveUpdate.threads||r(c>Ub[TU]XSS9 gU(a7U(a0X0l[TU]USS9 [URU5UlgSn[ U5e)a@Initialize a :class:`.LiveUpdate` instance. Either ``thread_id`` and ``update_id``, or ``_data`` must be provided. :param reddit: An instance of :class:`.Reddit`. :param thread_id: A live thread ID, e.g., ``"ukaeu1ik4sw5"``. :param update_id: A live update ID, e.g., ``"7827987a-c998-11e4-a0b9-22000b6a88d2"``. Usage: .. code-block:: python update = LiveUpdate(reddit, "ukaeu1ik4sw5", "7827987a-c998-11e4-a0b9-22000b6a88d2") update.thread # LiveThread(id="ukaeu1ik4sw5") update.id # "7827987a-c998-11e4-a0b9-22000b6a88d2" update.author # "umbrae" NT)r_fetchedrz@Either 'thread_id' and 'update_id', or '_data' must be provided.)rr:r,rur/rr)r2r thread_idrrrrs r r:LiveUpdate.__init__s\4   G V4  @ 9G G V4  0%dllI>DLTCC. r(cX>US:Xa[URUS9n[TU] X5 g)zObjectify author.author)rHN)rr/r __setattr__)r2 attributerrs r rLiveUpdate.__setattr__s(  T\\6E I-r(c>[SRURRURS9nURR U5SnUR RUR 5 [TU]%5 g)N live_focus)rrr) r r-r.r,r/r0rrdrr)r2r3rrs r rLiveUpdate._fetch se|$++dkknnPTPWPW+X   %a( U^^, r()rr,)riz.praw.models.reddit.live.LiveUpdateContribution)riru)NNN)rrrrrrrr)rrMrr)rmrnrorprqr_kindr rypropertyr.r:rrrsrrs@r rrs&I E , ,!% $'+ %!%!%! %! % %!%!N. r(r)!rq __future__rtypingrrrrconstr utilr util.cacher list.redditorr listing.generatorrrbasermixinsrrCr praw.modelsprawrrurwrrrrr(r rs#"99#((0#!o1o1dVVrp4p4f6L6Lr9898x\ \r(