SubmissionFlair

class praw.models.reddit.submission.SubmissionFlair(submission)

Provide a set of functions pertaining to Submission flair.

__init__(submission)

Create a SubmissionFlair instance.

Parameters:submission – The submission associated with the flair functions.
choices()

Return list of available flair choices.

Choices are required in order to use select().

Example:

choices = submission.flair.choices()
select(flair_template_id, text=None)

Select flair for submission.

Parameters:
  • flair_template_id – The flair template to select. The possible flair_template_id values can be discovered through choices().
  • text – If the template’s flair_text_editable value is True, this value will set a custom text (default: None).

For example, to select an arbitrary editable flair text (assuming there is one) and set a custom value try:

choices = submission.flair.choices()
template_id = next(x for x in choices
                   if x['flair_text_editable'])['flair_template_id']
submission.flair.select(template_id, 'my custom value')