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')
