reddit.live¶
-
class
asyncpraw.models.
LiveHelper
(reddit: asyncpraw.Reddit, _data: Optional[Dict[str, Any]])¶ Provide a set of functions to interact with LiveThreads.
-
await
__call__
(id: str, fetch: bool = False) → asyncpraw.models.LiveThread¶ Return a new instance of
LiveThread
.This method is intended to be used as:
livethread = await reddit.live("ukaeu1ik4sw5")
If you need the object fetched right away (e.g., to access attributes) you can do:
livethread = await reddit.live("ukaeu1ik4sw5", fetch=True) await livethread.close()
- Parameters
id – A live thread ID, e.g.,
ukaeu1ik4sw5
.fetch – Determines if the object is lazily loaded (default: False).
-
__init__
(reddit: asyncpraw.Reddit, _data: Optional[Dict[str, Any]])¶ Initialize a PRAWModel instance.
- Parameters
reddit – An instance of
Reddit
.
-
await
create
(title: str, description: Optional[str] = None, nsfw: bool = False, resources: str = None) → asyncpraw.models.LiveThread¶ Create a new LiveThread.
- Parameters
title – The title of the new LiveThread.
description – (Optional) The new LiveThread’s description.
nsfw – (boolean) Indicate whether this thread is not safe for work (default: False).
resources – (Optional) Markdown formatted information that is useful for the LiveThread.
- Returns
The new LiveThread object.
-
info
(ids: List[str]) → AsyncGenerator[asyncpraw.models.LiveThread, None]¶ Fetch information about each live thread in
ids
.- Parameters
ids – A list of IDs for a live thread.
- Returns
A generator that yields
LiveThread
instances.- Raises
asyncprawcore.ServerError
if invalid live threads are requested.
Requests will be issued in batches for each 100 IDs.
Note
This method doesn’t support IDs for live updates.
Warning
Unlike
Reddit.info()
, the output of this method may not reflect the order of input.Usage:
ids = ["3rgnbke2rai6hen7ciytwcxadi", "sw7bubeycai6hey4ciytwamw3a", "t8jnufucss07"] async for thread in reddit.live.info(ids): print(thread.title)
-
await
now
() → Optional[asyncpraw.models.LiveThread]¶ Get the currently featured live thread.
- Returns
The
LiveThread
object, orNone
if there is no currently featured live thread.
Usage:
thread = await reddit.live.now() # LiveThread object or None
-
classmethod
parse
(data: Dict[str, Any], reddit: asyncpraw.Reddit) → Any¶ Return an instance of
cls
fromdata
.- Parameters
data – The structured data.
reddit – An instance of
Reddit
.
-
await