LiveContributorRelationship

class praw.models.reddit.live.LiveContributorRelationship(thread)

Provide methods to interact with live threads’ contributors.

__call__()

Return a RedditorList for live threads’ contributors.

Usage:

thread = reddit.live('ukaeu1ik4sw5')
for contributor in thread.contributor():
    print(contributor)

__init__(thread)

Create a LiveContributorRelationship instance.

Parameters:thread – An instance of LiveThread.

Note

This class should not be initialized directly. Instead obtain an instance via: thread.contributor where thread is a LiveThread instance.

accept_invite()

Accept an invite to contribute the live thread.

Usage:

thread = reddit.live('ydwwxneu7vsa')
thread.contributor.accept_invite()

invite(redditor, permissions=None)

Invite a redditor to be a contributor of the live thread.

Raise praw.exceptions.APIException if the invitation already exists.

Parameters:

• redditor – A redditor name (e.g., 'spez') or Redditor instance.
• 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.

Usage:

thread = reddit.live('ukaeu1ik4sw5')
redditor = reddit.redditor('spez')

# 'manage' and 'settings' permissions
thread.contributor.invite(redditor, ['manage', 'settings'])

Seealso:LiveContributorRelationship.remove_invite() to remove the invite for redditor.

leave()

Abdicate the live thread contributor position (use with care).

Usage:

thread = reddit.live('ydwwxneu7vsa')
thread.contributor.leave()

remove(redditor)

Remove the redditor from the live thread contributors.

Parameters:redditor – A redditor fullname (e.g., 't2_1w72') or Redditor instance.

Usage:

thread = reddit.live('ukaeu1ik4sw5')
redditor = reddit.redditor('spez')
thread.contributor.remove(redditor)
thread.contributor.remove('t2_1w72')  # with fullname

remove_invite(redditor)

Remove the invite for redditor.

Parameters:redditor – A redditor fullname (e.g., 't2_1w72') or Redditor instance.

Usage:

thread = reddit.live('ukaeu1ik4sw5')
redditor = reddit.redditor('spez')
thread.contributor.remove_invite(redditor)
thread.contributor.remove_invite('t2_1w72')  # with fullname

Seealso:LiveContributorRelationship.invite() to invite a redditor to be a contributor of the live thread.

update(redditor, permissions=None)

Update the contributor permissions for redditor.

Parameters:

• redditor – A redditor name (e.g., 'spez') or Redditor instance.
• 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:

thread = reddit.live('ukaeu1ik4sw5')
thread.contributor.update('spez')

To grant ‘access’ and ‘edit’ permissions (and to remove other permissions), try:

thread.contributor.update('spez', ['access', 'edit'])

To remove all permissions from the contributor, try:

subreddit.moderator.update('spez', [])

update_invite(redditor, permissions=None)

Update the contributor invite permissions for redditor.

Parameters:

• redditor – A redditor name (e.g., 'spez') or Redditor instance.
• 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:

thread = reddit.live('ukaeu1ik4sw5')
thread.contributor.update_invite('spez')

To set ‘access’ and ‘edit’ permissions (and to remove other permissions) to the invitation, try:

thread.contributor.update_invite('spez', ['access', 'edit'])

To remove all permissions from the invitation, try:

thread.contributor.update_invite('spez', [])