DomainListing
*************

class praw.models.DomainListing(reddit: Reddit, domain: str)

   Provide a set of functions to interact with domain listings.

   __init__(reddit: Reddit, domain: str)

      Initialize a DomainListing instance.

      Parameters:
         * **reddit** – An instance of Reddit.

         * **domain** – The domain for which to obtain listings.

   controversial(time_filter: str = 'all', **generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Any]

      Return a "ListingGenerator" for controversial submissions.

      Parameters:
         **time_filter** – Can be one of: all, day, hour, month, week,
         year (default: all).

      Raises:
         "ValueError" if "time_filter" is invalid.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      This method can be used like:

         reddit.domain("imgur.com").controversial("week")
         reddit.multireddit("samuraisam", "programming").controversial("day")
         reddit.redditor("spez").controversial("month")
         reddit.redditor("spez").comments.controversial("year")
         reddit.redditor("spez").submissions.controversial("all")
         reddit.subreddit("all").controversial("hour")

   hot(**generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Any]

      Return a "ListingGenerator" for hot items.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      This method can be used like:

         reddit.domain("imgur.com").hot()
         reddit.multireddit("samuraisam", "programming").hot()
         reddit.redditor("spez").hot()
         reddit.redditor("spez").comments.hot()
         reddit.redditor("spez").submissions.hot()
         reddit.subreddit("all").hot()

   new(**generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Any]

      Return a "ListingGenerator" for new items.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      This method can be used like:

         reddit.domain("imgur.com").new()
         reddit.multireddit("samuraisam", "programming").new()
         reddit.redditor("spez").new()
         reddit.redditor("spez").comments.new()
         reddit.redditor("spez").submissions.new()
         reddit.subreddit("all").new()

   classmethod parse(data: Dict[str, Any], reddit: Reddit) -> Any

      Return an instance of "cls" from "data".

      Parameters:
         * **data** – The structured data.

         * **reddit** – An instance of "Reddit".

   random_rising(**generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Submission]

      Return a "ListingGenerator" for random rising submissions.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      For example, to get random rising submissions for subreddit
      "r/test":

         for submission in reddit.subreddit("test").random_rising():
             print(submission.title)

   rising(**generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Submission]

      Return a "ListingGenerator" for rising submissions.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      For example, to get rising submissions for subreddit "r/test":

         for submission in reddit.subreddit("test").rising():
             print(submission.title)

   top(time_filter: str = 'all', **generator_kwargs: Union[str, int, Dict[str, str]]) -> Iterator[Any]

      Return a "ListingGenerator" for top submissions.

      Parameters:
         **time_filter** – Can be one of: all, day, hour, month, week,
         year (default: all).

      Raises:
         "ValueError" if "time_filter" is invalid.

      Additional keyword arguments are passed in the initialization of
      "ListingGenerator".

      This method can be used like:

         reddit.domain("imgur.com").top("week")
         reddit.multireddit("samuraisam", "programming").top("day")
         reddit.redditor("spez").top("month")
         reddit.redditor("spez").comments.top("year")
         reddit.redditor("spez").submissions.top("all")
         reddit.subreddit("all").top("hour")
