SubredditStream¶

class praw.models.reddit.subreddit.SubredditStream(subreddit)¶

Provides submission and comment streams.

__init__(subreddit)¶

Create a SubredditStream instance.

comments(**stream_options)¶

Yield new comments as they become available.

Comments are yielded oldest first. Up to 100 historical comments will initially be returned.

Keyword arguments are passed to stream_generator().

Note

While PRAW tries to catch all new comments, some high-volume streams, especially the r/all stream, may drop some comments.

For example, to retrieve all new comments made to the iama subreddit, try:

for comment in reddit.subreddit("iama").stream.comments():
    print(comment)

To only retrieve new submissions starting when the stream is created, pass skip_existing=True:

subreddit = reddit.subreddit("iama")
for comment in subreddit.stream.comments(skip_existing=True):
    print(comment)

submissions(**stream_options)¶

Yield new submissions as they become available.

Submissions are yielded oldest first. Up to 100 historical submissions will initially be returned.

Keyword arguments are passed to stream_generator().

Note

While PRAW tries to catch all new submissions, some high-volume streams, especially the r/all stream, may drop some submissions.

For example, to retrieve all new submissions made to all of Reddit, try:

for submission in reddit.subreddit("all").stream.submissions():
    print(submission)