feedgen.ext.podcast_entry
*************************

Extends the feedgen to produce podcasts.

copyright:
   2013-2016, Lars Kiesow <lkiesow@uos.de>

license:
   FreeBSD and LGPL, see license.* for more details.

class feedgen.ext.podcast_entry.PodcastEntryExtension

   FeedEntry extension for podcasts.

   extend_rss(entry)

      Add additional fields to an RSS item.

      Parameters:
         **feed** -- The RSS item XML element to use.

   itunes_author(itunes_author=None)

      Get or set the itunes:author of the podcast episode. The content
      of this tag is shown in the Artist column in iTunes. If the tag
      is not present, iTunes uses the contents of the <author> tag. If
      <itunes:author> is not present at the feed level, iTunes will
      use the contents of <managingEditor>.

      Parameters:
         **itunes_author** -- The author of the podcast.

      Returns:
         The author of the podcast.

   itunes_block(itunes_block=None)

      Get or set the ITunes block attribute. Use this to prevent
      episodes from appearing in the iTunes podcast directory.

      Parameters:
         **itunes_block** -- Block podcast episodes.

      Returns:
         If the podcast episode is blocked.

   itunes_duration(itunes_duration=None)

      Get or set the duration of the podcast episode. The content of
      this tag is shown in the Time column in iTunes.

      The tag can be formatted HH:MM:SS, H:MM:SS, MM:SS, or M:SS (H =
      hours, M = minutes, S = seconds). If an integer is provided (no
      colon present), the value is assumed to be in seconds. If one
      colon is present, the number to the left is assumed to be
      minutes, and the number to the right is assumed to be seconds.
      If more than two colons are present, the numbers farthest to the
      right are ignored.

      Parameters:
         **itunes_duration** -- Duration of the podcast episode.

      Returns:
         Duration of the podcast episode.

   itunes_episode(itunes_episode=None)

      Get or set the itunes:episode value for the podcast episode.

      Parameters:
         **itunes_season** -- Episode number of the podcast epiosode.

      Returns:
         Episode number of the podcast episode.

   itunes_episode_type(itunes_episode_type=None)

      Get or set the itunes:episodeType value of the item. This tag
      should be used to indicate the episode type. The three values
      for this tag are "full", "trailer" and "bonus".

      If an episode is a trailer or bonus content, use this tag.

      Specify full when you are submitting the complete content of
      your show. Specify trailer when you are submitting a short,
      promotional piece of content that represents a preview of your
      current show. Specify bonus when you are submitting extra
      content for your show (for example, behind the scenes
      information or interviews with the cast) or cross-promotional
      content for another show.

      Parameters:
         **itunes_episode_type** -- The episode type

      Returns:
         type of the episode.

   itunes_explicit(itunes_explicit=None)

      Get or the the itunes:explicit value of the podcast episode.
      This tag should be used to indicate whether your podcast episode
      contains explicit material. The three values for this tag are
      "yes", "no", and "clean".

      If you populate this tag with "yes", an "explicit" parental
      advisory graphic will appear next to your podcast artwork on the
      iTunes Store and in the Name column in iTunes. If the value is
      "clean", the parental advisory type is considered Clean, meaning
      that no explicit language or adult content is included anywhere
      in the episodes, and a "clean" graphic will appear. If the
      explicit tag is present and has any other value (e.g., "no"),
      you see no indicator — blank is the default advisory type.

      Parameters:
         **itunes_explicit** -- If the podcast episode contains
         explicit material.

      Returns:
         If the podcast episode contains explicit material.

   itunes_image(itunes_image=None)

      Get or set the image for the podcast episode. This tag specifies
      the artwork for your podcast. Put the URL to the image in the
      href attribute.  iTunes prefers square .jpg images that are at
      least 1400x1400 pixels, which is different from what is
      specified for the standard RSS image tag.  In order for a
      podcast to be eligible for an iTunes Store feature, the
      accompanying image must be at least 1400x1400 pixels.

      iTunes supports images in JPEG and PNG formats with an RGB color
      space (CMYK is not supported). The URL must end in ".jpg" or
      ".png". If the <itunes:image> tag is not present, iTunes will
      use the contents of the RSS image tag.

      If you change your podcast’s image, also change the file’s name.
      iTunes may not change the image if it checks your feed and the
      image URL is the same. The server hosting your cover art image
      must allow HTTP head requests for iTS to be able to
      automatically update your cover art.

      Parameters:
         **itunes_image** -- Image of the podcast.

      Returns:
         Image of the podcast.

   itunes_is_closed_captioned(itunes_is_closed_captioned=None)

      Get or set the is_closed_captioned value of the podcast episode.
      This tag should be used if your podcast includes a video episode
      with embedded closed captioning support. The two values for this
      tag are "yes" and "no”.

      Parameters:
         **is_closed_captioned** -- If the episode has closed
         captioning support.

      Returns:
         If the episode has closed captioning support.

   itunes_order(itunes_order=None)

      Get or set the itunes:order value of the podcast episode. This
      tag can be used to override the default ordering of episodes on
      the store.

      This tag is used at an <item> level by populating with the
      number value in which you would like the episode to appear on
      the store. For example, if you would like an <item> to appear as
      the first episode in the podcast, you would populate the
      <itunes:order> tag with “1”. If conflicting order values are
      present in multiple episodes, the store will use default
      ordering (pubDate).

      To remove the order from the episode set the order to a value
      below zero.

      Parameters:
         **itunes_order** -- The order of the episode.

      Returns:
         The order of the episode.

   itunes_season(itunes_season=None)

      Get or set the itunes:season value for the podcast episode.

      Parameters:
         **itunes_season** -- Season number of the podcast epiosode.

      Returns:
         Season number of the podcast episode.

   itunes_subtitle(itunes_subtitle=None)

      Get or set the itunes:subtitle value for the podcast episode.
      The contents of this tag are shown in the Description column in
      iTunes. The subtitle displays best if it is only a few words
      long.

      Parameters:
         **itunes_subtitle** -- Subtitle of the podcast episode.

      Returns:
         Subtitle of the podcast episode.

   itunes_summary(itunes_summary=None)

      Get or set the itunes:summary value for the podcast episode. The
      contents of this tag are shown in a separate window that appears
      when the "circled i" in the Description column is clicked. It
      also appears on the iTunes page for your podcast. This field can
      be up to 4000 characters. If <itunes:summary> is not included,
      the contents of the <description> tag are used.

      Parameters:
         **itunes_summary** -- Summary of the podcast episode.

      Returns:
         Summary of the podcast episode.

   itunes_title(itunes_title=None)

      Get or set the itunes:title value for the podcast episode.

      An episode title specific for Apple Podcasts. Don’t specify the
      episode number or season number in this tag. Also, don’t repeat
      the title of your show within your episode title.

      Parameters:
         **itunes_title** -- Episode title specific for Apple Podcasts

      Returns:
         Title specific for Apple Podcast
