.\" Man page generated from reStructuredText .\" by the Docutils 0.22.3 manpage writer. . . .nr rst2man-indent-level 0 . .de1 rstReportMargin \\$1 \\n[an-margin] level \\n[rst2man-indent-level] level margin: \\n[rst2man-indent\\n[rst2man-indent-level]] - \\n[rst2man-indent0] \\n[rst2man-indent1] \\n[rst2man-indent2] .. .de1 INDENT .\" .rstReportMargin pre: . RS \\$1 . nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin] . nr rst2man-indent-level +1 .\" .rstReportMargin post: .. .de UNINDENT . RE .\" indent \\n[an-margin] .\" old: \\n[rst2man-indent\\n[rst2man-indent-level]] .nr rst2man-indent-level -1 .\" new: \\n[rst2man-indent\\n[rst2man-indent-level]] .in \\n[rst2man-indent\\n[rst2man-indent-level]]u .. .TH "PYFEEDGEN.TEX" "1" "Dec 14, 2025" "1.0" "python-feedgen" .SH NAME pyFeedGen.tex \- pyFeedGen Documentation .SS Table of Contents .INDENT 0.0 .IP \(bu 2 Feedgenerator .INDENT 2.0 .IP \(bu 2 Installation .IP \(bu 2 Create a Feed .IP \(bu 2 Generate the Feed .IP \(bu 2 Add Feed Entries .IP \(bu 2 Extensions .IP \(bu 2 Testing the Generator .UNINDENT .IP \(bu 2 Module documentation .IP \(bu 2 Indices and tables .UNINDENT .sp This module can be used to generate web feeds in both ATOM and RSS format. It has support for extensions. Included is for example an extension to produce Podcasts. .sp It is licensed under the terms of both, the FreeBSD license and the LGPLv3+. Choose the one which is more convenient for you. For more details have a look at license.bsd and license.lgpl. .sp More details about the project: .INDENT 0.0 .IP \(bu 2 Repository \% .IP \(bu 2 Documentation \% .IP \(bu 2 Python Package Index \% .UNINDENT .SH INSTALLATION .sp \fBPrebuild packages\fP .sp If your distribution includes this project as package, like Fedora Linux does, you can simply use your package manager to install the package. For example: .INDENT 0.0 .INDENT 3.5 .sp .EX $ dnf install python3\-feedgen .EE .UNINDENT .UNINDENT .sp \fBUsing pip\fP .sp You can also use pip to install the feedgen module. Simply run: .INDENT 0.0 .INDENT 3.5 .sp .EX $ pip install feedgen .EE .UNINDENT .UNINDENT .SH CREATE A FEED .sp To create a feed simply instantiate the FeedGenerator class and insert some data: .INDENT 0.0 .INDENT 3.5 .sp .EX from feedgen.feed import FeedGenerator fg = FeedGenerator() fg.id(\(aqhttp://lernfunk.de/media/654321\(aq) fg.title(\(aqSome Testfeed\(aq) fg.author( {\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjohn@example.de\(aq} ) fg.link( href=\(aqhttp://example.com\(aq, rel=\(aqalternate\(aq ) fg.logo(\(aqhttp://ex.com/logo.jpg\(aq) fg.subtitle(\(aqThis is a cool feed!\(aq) fg.link( href=\(aqhttp://larskiesow.de/test.atom\(aq, rel=\(aqself\(aq ) fg.language(\(aqen\(aq) .EE .UNINDENT .UNINDENT .sp Note that for the methods which set fields that can occur more than once in a feed you can use all of the following ways to provide data: .INDENT 0.0 .IP \(bu 2 Provide the data for that element as keyword arguments .IP \(bu 2 Provide the data for that element as dictionary .IP \(bu 2 Provide a list of dictionaries with the data for several elements .UNINDENT .sp Example: .INDENT 0.0 .INDENT 3.5 .sp .EX fg.contributor( name=\(aqJohn Doe\(aq, email=\(aqjdoe@example.com\(aq ) fg.contributor({\(aqname\(aq:\(aqJohn Doe\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}) fg.contributor([{\(aqname\(aq:\(aqJohn Doe\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}, ...]) .EE .UNINDENT .UNINDENT .SH GENERATE THE FEED .sp After that you can generate both RSS or ATOM by calling the respective method: .INDENT 0.0 .INDENT 3.5 .sp .EX atomfeed = fg.atom_str(pretty=True) # Get the ATOM feed as string rssfeed = fg.rss_str(pretty=True) # Get the RSS feed as string fg.atom_file(\(aqatom.xml\(aq) # Write the ATOM feed to a file fg.rss_file(\(aqrss.xml\(aq) # Write the RSS feed to a file .EE .UNINDENT .UNINDENT .SH ADD FEED ENTRIES .sp To add entries (items) to a feed you need to create new FeedEntry objects and append them to the list of entries in the FeedGenerator. The most convenient way to go is to use the FeedGenerator itself for the instantiation of the FeedEntry object: .INDENT 0.0 .INDENT 3.5 .sp .EX fe = fg.add_entry() fe.id(\(aqhttp://lernfunk.de/media/654321/1\(aq) fe.title(\(aqThe First Episode\(aq) fe.link(href=\(dqhttp://lernfunk.de/feed\(dq) .EE .UNINDENT .UNINDENT .sp The FeedGenerator\(aqs method \fIadd_entry(...)\fP will generate a new FeedEntry object, automatically append it to the feeds internal list of entries and return it, so that additional data can be added. .SH EXTENSIONS .sp The FeedGenerator supports extensions to include additional data into the XML structure of the feeds. Extensions can be loaded like this: .INDENT 0.0 .INDENT 3.5 .sp .EX fg.load_extension(\(aqsomeext\(aq, atom=True, rss=True) .EE .UNINDENT .UNINDENT .sp This example would try to load the extension “someext” from the file \fIext/someext.py\fP\&. It is required that \fIsomeext.py\fP contains a class named “SomextExtension” which is required to have at least the two methods \fIextend_rss(...)\fP and \fIextend_atom(...)\fP\&. Although not required, it is strongly suggested to use \fIBaseExtension\fP from \fIext/base.py\fP as superclass. .sp \fIload_extension(\(aqsomeext\(aq, ...)\fP will also try to load a class named “SomextEntryExtension” for every entry of the feed. This class can be located either in the same file as SomextExtension or in \fIext/someext_entry.py\fP which is suggested especially for large extensions. .sp The parameters \fIatom\fP and \fIrss\fP control if the extension is used for ATOM and RSS feeds respectively. The default value for both parameters is \fITrue\fP, meaning the extension is used for both kinds of feeds. .sp \fBExample: Producing a Podcast\fP .sp One extension already provided is the podcast extension. A podcast is an RSS feed with some additional elements for ITunes. .sp To produce a podcast simply load the \fIpodcast\fP extension: .INDENT 0.0 .INDENT 3.5 .sp .EX from feedgen.feed import FeedGenerator fg = FeedGenerator() fg.load_extension(\(aqpodcast\(aq) \&... fg.podcast.itunes_category(\(aqTechnology\(aq, \(aqPodcasting\(aq) \&... fe = fg.add_entry() fe.id(\(aqhttp://lernfunk.de/media/654321/1/file.mp3\(aq) fe.title(\(aqThe First Episode\(aq) fe.description(\(aqEnjoy our first episode.\(aq) fe.enclosure(\(aqhttp://lernfunk.de/media/654321/1/file.mp3\(aq, 0, \(aqaudio/mpeg\(aq) \&... fg.rss_str(pretty=True) fg.rss_file(\(aqpodcast.xml\(aq) .EE .UNINDENT .UNINDENT .sp If the FeedGenerator class is used to load an extension, it is automatically loaded for every feed entry as well. You can, however, load an extension for a specific FeedEntry only by calling \fIload_extension(...)\fP on that entry. .sp Even if extensions are loaded, they can be temporarily disabled during the feed generation by calling the generating method with the keyword argument \fIextensions\fP set to \fIFalse\fP\&. .sp \fBCustom Extensions\fP .sp If you want to load custom extensions which are not part of the feedgen package, you can use the method \fIregister_extension\fP instead. You can directly pass the classes for the feed and the entry extension to this method meaning that you can define them everywhere. .SH TESTING THE GENERATOR .sp You can test the module by simply executing: .INDENT 0.0 .INDENT 3.5 .sp .EX $ python \-m feedgen .EE .UNINDENT .UNINDENT .sp If you want to have a look at the code for this test to have a working code example for a whole feed generation process, you can find it in the __main__.py \%\&. .SH API DOCUMENTATION .SS feedgen .sp This module can be used to generate web feeds in both ATOM and RSS format. It has support for extensions. Included is for example an extension to produce Podcasts. .INDENT 0.0 .TP .B copyright 2013 by Lars Kiesow .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .SS Create a Feed .sp To create a feed simply instantiate the FeedGenerator class and insert some data: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> from feedgen.feed import FeedGenerator >>> fg = FeedGenerator() >>> fg.id(\(aqhttp://lernfunk.de/media/654321\(aq) >>> fg.title(\(aqSome Testfeed\(aq) >>> fg.author( {\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjohn@example.de\(aq} ) >>> fg.link( href=\(aqhttp://example.com\(aq, rel=\(aqalternate\(aq ) >>> fg.logo(\(aqhttp://ex.com/logo.jpg\(aq) >>> fg.subtitle(\(aqThis is a cool feed!\(aq) >>> fg.link( href=\(aqhttp://larskiesow.de/test.atom\(aq, rel=\(aqself\(aq ) >>> fg.language(\(aqen\(aq) .EE .UNINDENT .UNINDENT .sp Note that for the methods which set fields that can occur more than once in a feed you can use all of the following ways to provide data: .INDENT 0.0 .IP \(bu 2 Provide the data for that element as keyword arguments .IP \(bu 2 Provide the data for that element as dictionary .IP \(bu 2 Provide a list of dictionaries with the data for several elements .UNINDENT .sp Example: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> fg.contributor(name=\(aqJohn Doe\(aq, email=\(aqjdoe@example.com\(aq ) >>> fg.contributor({\(aqname\(aq:\(aqJohn Doe\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}) >>> fg.contributor([{\(aqname\(aq:\(aqJohn\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}, …]) .EE .UNINDENT .UNINDENT .SS Generate the Feed .sp After that you can generate both RSS or ATOM by calling the respective method: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> atomfeed = fg.atom_str(pretty=True) # Get the ATOM feed as string >>> rssfeed = fg.rss_str(pretty=True) # Get the RSS feed as string >>> fg.atom_file(\(aqatom.xml\(aq) # Write the ATOM feed to a file >>> fg.rss_file(\(aqrss.xml\(aq) # Write the RSS feed to a file .EE .UNINDENT .UNINDENT .SS Add Feed Entries .sp To add entries (items) to a feed you need to create new FeedEntry objects and append them to the list of entries in the FeedGenerator. The most convenient way to do this, is to call the method add_entry(...) like this: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> fe = fg.add_entry() >>> fe.id(\(aqhttp://lernfunk.de/media/654321/1\(aq) >>> fe.title(\(aqThe First Episode\(aq) .EE .UNINDENT .UNINDENT .sp The FeedGenerator\(aqs method add_entry(...) will automatically create a new FeedEntry object, append it to the feeds internal list of entries and return it, so that additional data can be added. .SS Extensions .sp The FeedGenerator supports extension to include additional data into the XML structure of the feeds. Extensions can be loaded like this: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> fg.load_extension(\(aqsomeext\(aq, atom=True, rss=True) .EE .UNINDENT .UNINDENT .sp This will try to load the extension “someext” from the file \fIext/someext.py\fP\&. It is required that \fIsomeext.py\fP contains a class named “SomextExtension” which is required to have at least the two methods \fIextend_rss(...)\fP and \fIextend_atom(...)\fP\&. Although not required, it is strongly suggested to use BaseExtension from \fIext/base.py\fP as superclass. .sp \fIload_extension(\(aqsomeext\(aq, ...)\fP will also try to load a class named “SomextEntryExtension” for every entry of the feed. This class can be located either in the same file as SomextExtension or in \fIext/someext_entry.py\fP which is suggested especially for large extensions. .sp The parameters \fIatom\fP and \fIrss\fP tell the FeedGenerator if the extensions should only be used for either ATOM or RSS feeds. The default value for both parameters is true which means that the extension would be used for both kinds of feeds. .sp \fBExample: Producing a Podcast\fP .sp One extension already provided is the podcast extension. A podcast is an RSS feed with some additional elements for ITunes. .sp To produce a podcast simply load the \fIpodcast\fP extension: .INDENT 0.0 .INDENT 3.5 .sp .EX >>> from feedgen.feed import FeedGenerator >>> fg = FeedGenerator() >>> fg.load_extension(\(aqpodcast\(aq) \&... >>> fg.podcast.itunes_category(\(aqTechnology\(aq, \(aqPodcasting\(aq) \&... >>> fg.rss_str(pretty=True) >>> fg.rss_file(\(aqpodcast.xml\(aq) .EE .UNINDENT .UNINDENT .sp Of cause the extension has to be loaded for the FeedEntry objects as well but this is done automatically by the FeedGenerator for every feed entry if the extension is loaded for the whole feed. You can, however, load an extension for a specific FeedEntry by calling \fIload_extension(...)\fP on that entry. But this is a rather uncommon use. .sp Of cause you can still produce a normal ATOM or RSS feed, even if you have loaded some plugins by temporary disabling them during the feed generation. This can be done by calling the generating method with the keyword argument \fIextensions\fP set to \fIFalse\fP\&. .SS Testing the Generator .sp You can test the module by simply executing: .INDENT 0.0 .INDENT 3.5 .sp .EX $ python \-m feedgen .EE .UNINDENT .UNINDENT .sp Contents: .SS feedgen.feed .INDENT 0.0 .TP .B copyright 2013\-2020, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.feed.FeedGenerator FeedGenerator for generating ATOM and RSS feeds. .INDENT 7.0 .TP .B add_entry(feedEntry=None, order=\(aqprepend\(aq) This method will add a new entry to the feed. If the feedEntry argument is omitted a new Entry object is created automatically. This is the preferred way to add new entries to a feed. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBfeedEntry\fP \-\- FeedEntry object to add. .IP \(bu 2 \fBorder\fP \-\- If \fIprepend\fP is chosen, the entry will be inserted at the beginning of the feed. If \fIappend\fP is chosen, the entry will be appended to the feed. (default: \fIprepend\fP). .UNINDENT .TP .B Returns FeedEntry object created or passed to this function. .UNINDENT .sp Example: .INDENT 7.0 .INDENT 3.5 .sp .EX \&... >>> entry = feedgen.add_entry() >>> entry.title(\(aqFirst feed entry\(aq) .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B add_item(item=None) This method will add a new item to the feed. If the item argument is omitted a new FeedEntry object is created automatically. This is just another name for add_entry(...) .UNINDENT .INDENT 7.0 .TP .B atom_file(filename, extensions=True, pretty=False, encoding=\(aqUTF\-8\(aq, xml_declaration=True) Generates an ATOM feed and write the resulting XML to a file. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBfilename\fP \-\- Name of file to write or a file\-like object or a URL. .IP \(bu 2 \fBextensions\fP \-\- Enable or disable the loaded extensions for the xml generation (default: enabled). .IP \(bu 2 \fBpretty\fP \-\- If the feed should be split into multiple lines and properly indented. .IP \(bu 2 \fBencoding\fP \-\- Encoding used in the XML file (default: UTF\-8). .IP \(bu 2 \fBxml_declaration\fP \-\- If an XML declaration should be added to the output (Default: enabled). .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B atom_str(pretty=False, extensions=True, encoding=\(aqUTF\-8\(aq, xml_declaration=True) Generates an ATOM feed and returns the feed XML as string. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBpretty\fP \-\- If the feed should be split into multiple lines and properly indented. .IP \(bu 2 \fBextensions\fP \-\- Enable or disable the loaded extensions for the xml generation (default: enabled). .IP \(bu 2 \fBencoding\fP \-\- Encoding used in the XML file (default: UTF\-8). .IP \(bu 2 \fBxml_declaration\fP \-\- If an XML declaration should be added to the output (Default: enabled). .UNINDENT .TP .B Returns String representation of the ATOM feed. .UNINDENT .sp \fBReturn type:\fP The return type may vary between different Python versions and your encoding parameters passed to this method. For details have a look at the lxml documentation \% .UNINDENT .INDENT 7.0 .TP .B author(author=None, replace=False, **kwargs) Get or set author data. An author element is a dictionary containing a name, an email address and a URI. Name is mandatory for ATOM, email is mandatory for RSS. .sp This method can be called with: .INDENT 7.0 .IP \(bu 2 the fields of an author as keyword arguments .IP \(bu 2 the fields of an author as a dictionary .IP \(bu 2 a list of dictionaries containing the author fields .UNINDENT .sp An author has the following fields: .INDENT 7.0 .IP \(bu 2 \fIname\fP conveys a human\-readable name for the person. .IP \(bu 2 \fIuri\fP contains a home page for the person. .IP \(bu 2 \fIemail\fP contains an email address for the person. .UNINDENT .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBauthor\fP \-\- Dictionary or list of dictionaries with author data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of authors as dictionaries. .UNINDENT .sp Example: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> feedgen.author({\(aqname\(aq:\(aqJohn Doe\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}] >>> feedgen.author([{\(aqname\(aq:\(aqMr. X\(aq},{\(aqname\(aq:\(aqMax\(aq}]) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}, {\(aqname\(aq:\(aqJohn Doe\(aq}, {\(aqname\(aq:\(aqMax\(aq}] >>> feedgen.author(name=\(aqJohn Doe\(aq, email=\(aqjdoe@example.com\(aq, replace=True) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B category(category=None, replace=False, **kwargs) Get or set categories that the feed belongs to. .sp This method can be called with: .INDENT 7.0 .IP \(bu 2 the fields of a category as keyword arguments .IP \(bu 2 the fields of a category as a dictionary .IP \(bu 2 a list of dictionaries containing the category fields .UNINDENT .sp A categories has the following fields: .INDENT 7.0 .IP \(bu 2 \fIterm\fP identifies the category .IP \(bu 2 \fIscheme\fP identifies the categorization scheme via a URI. .IP \(bu 2 \fIlabel\fP provides a human\-readable label for display .UNINDENT .sp If a label is present it is used for the RSS feeds. Otherwise the term is used. The scheme is used for the domain attribute in RSS. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcategory\fP \-\- Dict or list of dicts with data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of category data. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B cloud(domain=None, port=None, path=None, registerProcedure=None, protocol=None) Set or get the cloud data of the feed. It is an RSS only attribute. It specifies a web service that supports the rssCloud interface which can be implemented in HTTP\-POST, XML\-RPC or SOAP 1.1. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBdomain\fP \-\- The domain where the webservice can be found. .IP \(bu 2 \fBport\fP \-\- The port the webservice listens to. .IP \(bu 2 \fBpath\fP \-\- The path of the webservice. .IP \(bu 2 \fBregisterProcedure\fP \-\- The procedure to call. .IP \(bu 2 \fBprotocol\fP \-\- Can be either HTTP\-POST, XML\-RPC or SOAP 1.1. .UNINDENT .TP .B Returns Dictionary containing the cloud data. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B contributor(contributor=None, replace=False, **kwargs) Get or set the contributor data of the feed. This is an ATOM only value. .sp This method can be called with: \- the fields of an contributor as keyword arguments \- the fields of an contributor as a dictionary \- a list of dictionaries containing the contributor fields .sp An contributor has the following fields: \- \fIname\fP conveys a human\-readable name for the person. \- \fIuri\fP contains a home page for the person. \- \fIemail\fP contains an email address for the person. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcontributor\fP \-\- Dictionary or list of dictionaries with contributor data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of contributors as dictionaries. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B copyright(copyright=None) Get or set the copyright notice for content in the channel. This RSS value will also set the atom:rights value. .INDENT 7.0 .TP .B Parameters \fBcopyright\fP \-\- The copyright notice. .TP .B Returns The copyright notice. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B description(description=None) Set and get the description of the feed. This is an RSS only element which is a phrase or sentence describing the channel. It is mandatory for RSS feeds. It is roughly the same as atom:subtitle. Thus setting this will also set atom:subtitle. .INDENT 7.0 .TP .B Parameters \fBdescription\fP \-\- Description of the channel. .TP .B Returns Description of the channel. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B docs(docs=None) Get or set the docs value of the feed. This is an RSS only value. It is a URL that points to the documentation for the format used in the RSS file. It is probably a pointer to [1]. It is for people who might stumble across an RSS file on a Web server 25 years from now and wonder what it is. .sp [1]: \% .INDENT 7.0 .TP .B Parameters \fBdocs\fP \-\- URL of the format documentation. .TP .B Returns URL of the format documentation. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B entry(entry=None, replace=False) Get or set feed entries. Use the add_entry() method instead to automatically create the FeedEntry objects. .sp This method takes both a single FeedEntry object or a list of objects. .INDENT 7.0 .TP .B Parameters \fBentry\fP \-\- FeedEntry object or list of FeedEntry objects. .TP .B Returns List ob all feed entries. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B generator(generator=None, version=None, uri=None) Get or set the generator of the feed which identifies the software used to generate the feed, for debugging and other purposes. Both the uri and version attributes are optional and only available in the ATOM feed. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBgenerator\fP \-\- Software used to create the feed. .IP \(bu 2 \fBversion\fP \-\- Version of the software. .IP \(bu 2 \fBuri\fP \-\- URI the software can be found. .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B icon(icon=None) Get or set the icon of the feed which is a small image which provides iconic visual identification for the feed. Icons should be square. This is an ATOM only value. .INDENT 7.0 .TP .B Parameters \fBicon\fP \-\- URI of the feeds icon. .TP .B Returns URI of the feeds icon. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B id(id=None) Get or set the feed id which identifies the feed using a universally unique and permanent URI. If you have a long\-term, renewable lease on your Internet domain name, then you can feel free to use your website\(aqs address. This field is for ATOM only. It is mandatory for ATOM. .INDENT 7.0 .TP .B Parameters \fBid\fP \-\- New Id of the ATOM feed. .TP .B Returns Id of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B image(url=None, title=None, link=None, width=None, height=None, description=None) Set the image of the feed. This element is roughly equivalent to atom:logo. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBurl\fP \-\- The URL of a GIF, JPEG or PNG image. .IP \(bu 2 \fBtitle\fP \-\- Describes the image. The default value is the feeds title. .IP \(bu 2 \fBlink\fP \-\- URL of the site the image will link to. The default is to use the feeds first alternate link. .IP \(bu 2 \fBwidth\fP \-\- Width of the image in pixel. The maximum is 144. .IP \(bu 2 \fBheight\fP \-\- The height of the image. The maximum is 400. .IP \(bu 2 \fBdescription\fP \-\- Title of the link. .UNINDENT .TP .B Returns Data of the image as dictionary. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B item(item=None, replace=False) Get or set feed items. This is just another name for entry(...) .UNINDENT .INDENT 7.0 .TP .B language(language=None) Get or set the language of the feed. It indicates the language the channel is written in. This allows aggregators to group all Italian language sites, for example, on a single page. This is an RSS only field. However, this value will also be used to set the xml:lang property of the ATOM feed node. The value should be an IETF language tag. .INDENT 7.0 .TP .B Parameters \fBlanguage\fP \-\- Language of the feed. .TP .B Returns Language of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B lastBuildDate(lastBuildDate=None) Set or get the lastBuildDate value which indicates the last time the content of the channel changed. .sp The value can either be a string which will automatically be parsed or a datetime.datetime object. In any case it is necessary that the value include timezone information. .sp This will set both atom:updated and rss:lastBuildDate. .INDENT 7.0 .TP .B Default value If not set, lastBuildDate has as value the current date and time. .UNINDENT .INDENT 7.0 .TP .B Parameters \fBlastBuildDate\fP \-\- The modification date. .TP .B Returns Modification date as datetime.datetime .UNINDENT .UNINDENT .INDENT 7.0 .TP .B link(link=None, replace=False, **kwargs) Get or set link data. An link element is a dict with the fields href, rel, type, hreflang, title, and length. Href is mandatory for ATOM. .sp This method can be called with: .INDENT 7.0 .IP \(bu 2 the fields of a link as keyword arguments .IP \(bu 2 the fields of a link as a dictionary .IP \(bu 2 a list of dictionaries containing the link fields .UNINDENT .sp A link has the following fields: .INDENT 7.0 .IP \(bu 2 \fIhref\fP is the URI of the referenced resource (typically a Web page) .IP \(bu 2 \fIrel\fP contains a single link relationship type. It can be a full URI, or one of the following predefined values (default=alternate): .INDENT 2.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 \fIalternate\fP an alternate representation of the entry or feed, for example a permalink to the html version of the entry, or the front page of the weblog. .IP \(bu 2 \fIenclosure\fP a related resource which is potentially large in size and might require special handling, for example an audio or video recording. .IP \(bu 2 \fIrelated\fP an document related to the entry or feed. .IP \(bu 2 \fIself\fP the feed itself. .IP \(bu 2 \fIvia\fP the source of the information provided in the entry. .UNINDENT .UNINDENT .UNINDENT .IP \(bu 2 \fItype\fP indicates the media type of the resource. .IP \(bu 2 \fIhreflang\fP indicates the language of the referenced resource. .IP \(bu 2 \fItitle\fP human readable information about the link, typically for display purposes. .IP \(bu 2 \fIlength\fP the length of the resource, in bytes. .UNINDENT .sp RSS only supports one link with URL only. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBlink\fP \-\- Dict or list of dicts with data. .IP \(bu 2 \fBreplace\fP \-\- If old links are to be replaced (default: False) .UNINDENT .TP .B Returns Current set of link data .UNINDENT .sp Example: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> feedgen.link( href=\(aqhttp://example.com/\(aq, rel=\(aqself\(aq) [{\(aqhref\(aq:\(aqhttp://example.com/\(aq, \(aqrel\(aq:\(aqself\(aq}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B load_extension(name, atom=True, rss=True) Load a specific extension by name. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBname\fP \-\- Name of the extension to load. .IP \(bu 2 \fBatom\fP \-\- If the extension should be used for ATOM feeds. .IP \(bu 2 \fBrss\fP \-\- If the extension should be used for RSS feeds. .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B logo(logo=None) Get or set the logo of the feed which is a larger image which provides visual identification for the feed. Images should be twice as wide as they are tall. This is an ATOM value but will also set the rss:image value. .INDENT 7.0 .TP .B Parameters \fBlogo\fP \-\- Logo of the feed. .TP .B Returns Logo of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B managingEditor(managingEditor=None) Set or get the value for managingEditor which is the email address for person responsible for editorial content. This is a RSS only value. .INDENT 7.0 .TP .B Parameters \fBmanagingEditor\fP \-\- Email address of the managing editor. .TP .B Returns Email address of the managing editor. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B pubDate(pubDate=None) Set or get the publication date for the content in the channel. For example, the New York Times publishes on a daily basis, the publication date flips once every 24 hours. That\(aqs when the pubDate of the channel changes. .sp The value can either be a string which will automatically be parsed or a datetime.datetime object. In any case it is necessary that the value include timezone information. .sp This will set both atom:updated and rss:lastBuildDate. .INDENT 7.0 .TP .B Parameters \fBpubDate\fP \-\- The publication date. .TP .B Returns Publication date as datetime.datetime .UNINDENT .UNINDENT .INDENT 7.0 .TP .B rating(rating=None) Set and get the PICS rating for the channel. It is an RSS only value. .UNINDENT .INDENT 7.0 .TP .B register_extension(namespace, extension_class_feed=None, extension_class_entry=None, atom=True, rss=True) Registers an extension by class. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBnamespace\fP \-\- namespace for the extension .IP \(bu 2 \fBextension_class_feed\fP \-\- Class of the feed extension to load. .IP \(bu 2 \fBextension_class_entry\fP \-\- Class of the entry extension to load .IP \(bu 2 \fBatom\fP \-\- If the extension should be used for ATOM feeds. .IP \(bu 2 \fBrss\fP \-\- If the extension should be used for RSS feeds. .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B remove_entry(entry) Remove a single entry from the feed. This method accepts both the FeedEntry object to remove or the index of the entry as argument. .INDENT 7.0 .TP .B Parameters \fBentry\fP \-\- Entry or index of entry to remove. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B remove_item(item) Remove a single item from the feed. This is another name for remove_entry. .UNINDENT .INDENT 7.0 .TP .B rights(rights=None) Get or set the rights value of the feed which conveys information about rights, e.g. copyrights, held in and over the feed. This ATOM value will also set rss:copyright. .INDENT 7.0 .TP .B Parameters \fBrights\fP \-\- Rights information of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B rss_file(filename, extensions=True, pretty=False, encoding=\(aqUTF\-8\(aq, xml_declaration=True) Generates an RSS feed and write the resulting XML to a file. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBfilename\fP \-\- Name of file to write or a file\-like object or a URL. .IP \(bu 2 \fBextensions\fP \-\- Enable or disable the loaded extensions for the xml generation (default: enabled). .IP \(bu 2 \fBpretty\fP \-\- If the feed should be split into multiple lines and properly indented. .IP \(bu 2 \fBencoding\fP \-\- Encoding used in the XML file (default: UTF\-8). .IP \(bu 2 \fBxml_declaration\fP \-\- If an XML declaration should be added to the output (Default: enabled). .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B rss_str(pretty=False, extensions=True, encoding=\(aqUTF\-8\(aq, xml_declaration=True) Generates an RSS feed and returns the feed XML as string. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBpretty\fP \-\- If the feed should be split into multiple lines and properly indented. .IP \(bu 2 \fBextensions\fP \-\- Enable or disable the loaded extensions for the xml generation (default: enabled). .IP \(bu 2 \fBencoding\fP \-\- Encoding used in the XML file (default: UTF\-8). .IP \(bu 2 \fBxml_declaration\fP \-\- If an XML declaration should be added to the output (Default: enabled). .UNINDENT .TP .B Returns String representation of the RSS feed. .UNINDENT .sp \fBReturn type:\fP The return type may vary between different Python versions and your encoding parameters passed to this method. For details have a look at the lxml documentation \% .UNINDENT .INDENT 7.0 .TP .B skipDays(days=None, replace=False) Set or get the value of skipDays, a hint for aggregators telling them which days they can skip This is an RSS only value. .sp This method can be called with a day name or a list of day names. The days are represented as strings from \(aqMonday\(aq to \(aqSunday\(aq. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBhours\fP \-\- List of days the feedreaders should not check the feed. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of days the feedreaders should not check the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B skipHours(hours=None, replace=False) Set or get the value of skipHours, a hint for aggregators telling them which hours they can skip. This is an RSS only value. .sp This method can be called with an hour or a list of hours. The hours are represented as integer values from 0 to 23. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBhours\fP \-\- List of hours the feedreaders should not check the feed. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of hours the feedreaders should not check the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B subtitle(subtitle=None) Get or set the subtitle value of the channel which contains a human\-readable description or subtitle for the feed. This ATOM property will also set the value for rss:description. .INDENT 7.0 .TP .B Parameters \fBsubtitle\fP \-\- The subtitle of the feed. .TP .B Returns The subtitle of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B textInput(title=None, description=None, name=None, link=None) Get or set the value of textInput. This is an RSS only field. The purpose of the element is something of a mystery. You can use it to specify a search engine box. Or to allow a reader to provide feedback. Most aggregators ignore it. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBtitle\fP \-\- The label of the Submit button in the text input area. .IP \(bu 2 \fBdescription\fP \-\- Explains the text input area. .IP \(bu 2 \fBname\fP \-\- The name of the text object in the text input area. .IP \(bu 2 \fBlink\fP \-\- The URL of the CGI script that processes text input requests. .UNINDENT .TP .B Returns Dictionary containing textInput values. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B title(title=None) Get or set the title value of the feed. It should contain a human readable title for the feed. Often the same as the title of the associated website. Title is mandatory for both ATOM and RSS and should not be blank. .INDENT 7.0 .TP .B Parameters \fBtitle\fP \-\- The new title of the feed. .TP .B Returns The feeds title. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B ttl(ttl=None) Get or set the ttl value. It is an RSS only element. ttl stands for time to live. It\(aqs a number of minutes that indicates how long a channel can be cached before refreshing from the source. .INDENT 7.0 .TP .B Parameters \fBttl\fP \-\- Integer value indicating how long the channel may be cached. .TP .B Returns Time to live. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B updated(updated=None) Set or get the updated value which indicates the last time the feed was modified in a significant way. .sp The value can either be a string which will automatically be parsed or a datetime.datetime object. In any case it is necessary that the value include timezone information. .sp This will set both atom:updated and rss:lastBuildDate. .INDENT 7.0 .TP .B Default value If not set, updated has as value the current date and time. .UNINDENT .INDENT 7.0 .TP .B Parameters \fBupdated\fP \-\- The modification date. .TP .B Returns Modification date as datetime.datetime .UNINDENT .UNINDENT .INDENT 7.0 .TP .B webMaster(webMaster=None) Get and set the value of webMaster, which represents the email address for the person responsible for technical issues relating to the feed. This is an RSS only value. .INDENT 7.0 .TP .B Parameters \fBwebMaster\fP \-\- Email address of the webmaster. .TP .B Returns Email address of the webmaster. .UNINDENT .UNINDENT .UNINDENT .SS feedgen.entry .INDENT 0.0 .TP .B copyright 2013\-2020, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.entry.FeedEntry FeedEntry call representing an ATOM feeds entry node or an RSS feeds item node. .INDENT 7.0 .TP .B atom_entry(extensions=True) Create an ATOM entry and return it. .UNINDENT .INDENT 7.0 .TP .B author(author=None, replace=False, **kwargs) Get or set author data. An author element is a dict containing a name, an email address and a uri. Name is mandatory for ATOM, email is mandatory for RSS. .sp This method can be called with: \- the fields of an author as keyword arguments \- the fields of an author as a dictionary \- a list of dictionaries containing the author fields .sp An author has the following fields: \- \fIname\fP conveys a human\-readable name for the person. \- \fIuri\fP contains a home page for the person. \- \fIemail\fP contains an email address for the person. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBauthor\fP \-\- Dict or list of dicts with author data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .UNINDENT .sp Example: .INDENT 7.0 .INDENT 3.5 .sp .EX >>> author({\(aqname\(aq:\(aqJohn Doe\(aq, \(aqemail\(aq:\(aqjdoe@example.com\(aq}) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}] >>> author([{\(aqname\(aq: \(aqMr. X\(aq}, {\(aqname\(aq: \(aqMax\(aq}]) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}, {\(aqname\(aq:\(aqJohn Doe\(aq}, {\(aqname\(aq:\(aqMax\(aq}] >>> author(name=\(aqJohn Doe\(aq, email=\(aqjdoe@example.com\(aq, replace=True) [{\(aqname\(aq:\(aqJohn Doe\(aq,\(aqemail\(aq:\(aqjdoe@example.com\(aq}] .EE .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B category(category=None, replace=False, **kwargs) Get or set categories that the entry belongs to. .sp This method can be called with: \- the fields of a category as keyword arguments \- the fields of a category as a dictionary \- a list of dictionaries containing the category fields .sp A categories has the following fields: \- \fIterm\fP identifies the category \- \fIscheme\fP identifies the categorization scheme via a URI. \- \fIlabel\fP provides a human\-readable label for display .sp If a label is present it is used for the RSS feeds. Otherwise the term is used. The scheme is used for the domain attribute in RSS. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcategory\fP \-\- Dict or list of dicts with data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of category data. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B comments(comments=None) Get or set the value of comments which is the URL of the comments page for the item. This is a RSS only value. .INDENT 7.0 .TP .B Parameters \fBcomments\fP \-\- URL to the comments page. .TP .B Returns URL to the comments page. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B content(content=None, src=None, type=None) Get or set the content of the entry which contains or links to the complete content of the entry. Content must be provided for ATOM entries if there is no alternate link, and should be provided if there is no summary. If the content is set (not linked) it will also set rss:description. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcontent\fP \-\- The content of the feed entry. .IP \(bu 2 \fBsrc\fP \-\- Link to the entries content. .IP \(bu 2 \fBtype\fP \-\- If type is CDATA content would not be escaped. .UNINDENT .TP .B Returns Content element of the entry. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B contributor(contributor=None, replace=False, **kwargs) Get or set the contributor data of the feed. This is an ATOM only value. .sp This method can be called with: \- the fields of an contributor as keyword arguments \- the fields of an contributor as a dictionary \- a list of dictionaries containing the contributor fields .sp An contributor has the following fields: \- \fIname\fP conveys a human\-readable name for the person. \- \fIuri\fP contains a home page for the person. \- \fIemail\fP contains an email address for the person. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcontributor\fP \-\- Dictionary or list of dictionaries with contributor data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of contributors as dictionaries. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B description(description=None, isSummary=False) Get or set the description value which is the item synopsis. Description is an RSS only element. For ATOM feeds it is split in summary and content. The isSummary parameter can be used to control which ATOM value is set when setting description. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBdescription\fP \-\- Description of the entry. .IP \(bu 2 \fBisSummary\fP \-\- If the description should be used as content or summary. .UNINDENT .TP .B Returns The entries description. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B enclosure(url=None, length=None, type=None) Get or set the value of enclosure which describes a media object that is attached to the item. This is a RSS only value which is represented by link(rel=enclosure) in ATOM. ATOM feeds can furthermore contain several enclosures while RSS may contain only one. That is why this method, if repeatedly called, will add more than one enclosures to the feed. However, only the last one is used for RSS. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBurl\fP \-\- URL of the media object. .IP \(bu 2 \fBlength\fP \-\- Size of the media in bytes. .IP \(bu 2 \fBtype\fP \-\- Mimetype of the linked media. .UNINDENT .TP .B Returns Data of the enclosure element. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B guid(guid=None, permalink=False) Get or set the entries guid which is a string that uniquely identifies the item. This will also set atom:id. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBguid\fP \-\- Id of the entry. .IP \(bu 2 \fBpermalink\fP \-\- If this is a permanent identifier for this item .UNINDENT .TP .B Returns Id and permalink setting of the entry. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B id(id=None) Get or set the entry id which identifies the entry using a universally unique and permanent URI. Two entries in a feed can have the same value for id if they represent the same entry at different points in time. This method will also set rss:guid with permalink set to False. Id is mandatory for an ATOM entry. .INDENT 7.0 .TP .B Parameters \fBid\fP \-\- New Id of the entry. .TP .B Returns Id of the entry. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B link(link=None, replace=False, **kwargs) Get or set link data. An link element is a dict with the fields href, rel, type, hreflang, title, and length. Href is mandatory for ATOM. .sp This method can be called with: \- the fields of a link as keyword arguments \- the fields of a link as a dictionary \- a list of dictionaries containing the link fields .sp A link has the following fields: .INDENT 7.0 .IP \(bu 2 \fIhref\fP is the URI of the referenced resource (typically a Web page) .IP \(bu 2 \fIrel\fP contains a single link relationship type. It can be a full URI, or one of the following predefined values (default=alternate): .INDENT 2.0 .INDENT 3.5 .INDENT 0.0 .IP \(bu 2 \fIalternate\fP an alternate representation of the entry or feed, for example a permalink to the html version of the entry, or the front page of the weblog. .IP \(bu 2 \fIenclosure\fP a related resource which is potentially large in size and might require special handling, for example an audio or video recording. .IP \(bu 2 \fIrelated\fP an document related to the entry or feed. .IP \(bu 2 \fIself\fP the feed itself. .IP \(bu 2 \fIvia\fP the source of the information provided in the entry. .UNINDENT .UNINDENT .UNINDENT .IP \(bu 2 \fItype\fP indicates the media type of the resource. .IP \(bu 2 \fIhreflang\fP indicates the language of the referenced resource. .IP \(bu 2 \fItitle\fP human readable information about the link, typically for display purposes. .IP \(bu 2 \fIlength\fP the length of the resource, in bytes. .UNINDENT .sp RSS only supports one link with nothing but a URL. So for the RSS link element the last link with rel=alternate is used. .sp RSS also supports one enclusure element per entry which is covered by the link element in ATOM feed entries. So for the RSS enclusure element the last link with rel=enclosure is used. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBlink\fP \-\- Dict or list of dicts with data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of link data. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B load_extension(name, atom=True, rss=True) Load a specific extension by name. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBname\fP \-\- Name of the extension to load. .IP \(bu 2 \fBatom\fP \-\- If the extension should be used for ATOM feeds. .IP \(bu 2 \fBrss\fP \-\- If the extension should be used for RSS feeds. .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B pubDate(pubDate=None) Get or set the pubDate of the entry which indicates when the entry was published. This method is just another name for the published(...) method. .UNINDENT .INDENT 7.0 .TP .B pubdate(pubDate=None) Get or set the pubDate of the entry which indicates when the entry was published. This method is just another name for the published(...) method. .sp pubdate(…) is deprecated and may be removed in feedgen ≥ 0.8. Use pubDate(…) instead. .UNINDENT .INDENT 7.0 .TP .B published(published=None) Set or get the published value which contains the time of the initial creation or first availability of the entry. .sp The value can either be a string which will automatically be parsed or a datetime.datetime object. In any case it is necessary that the value include timezone information. .INDENT 7.0 .TP .B Parameters \fBpublished\fP \-\- The creation date. .TP .B Returns Creation date as datetime.datetime .UNINDENT .UNINDENT .INDENT 7.0 .TP .B register_extension(namespace, extension_class_entry=None, atom=True, rss=True) Register a specific extension by classes to a namespace. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBnamespace\fP \-\- namespace for the extension .IP \(bu 2 \fBextension_class_entry\fP \-\- Class of the entry extension to load. .IP \(bu 2 \fBatom\fP \-\- If the extension should be used for ATOM feeds. .IP \(bu 2 \fBrss\fP \-\- If the extension should be used for RSS feeds. .UNINDENT .UNINDENT .UNINDENT .INDENT 7.0 .TP .B rights(rights=None) Get or set the rights value of the entry which conveys information about rights, e.g. copyrights, held in and over the entry. This ATOM value will also set rss:copyright. .INDENT 7.0 .TP .B Parameters \fBrights\fP \-\- Rights information of the feed. .TP .B Returns Rights information of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B rss_entry(extensions=True) Create a RSS item and return it. .UNINDENT .INDENT 7.0 .TP .B source(url=None, title=None) Get or set the source for the current feed entry. .sp Note that ATOM feeds support a lot more sub elements than title and URL (which is what RSS supports) but these are currently not supported. Patches are welcome. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBurl\fP \-\- Link to the source. .IP \(bu 2 \fBtitle\fP \-\- Title of the linked resource .UNINDENT .TP .B Returns Source element as dictionaries. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B summary(summary=None, type=None) Get or set the summary element of an entry which conveys a short summary, abstract, or excerpt of the entry. Summary is an ATOM only element and should be provided if there either is no content provided for the entry, or that content is not inline (i.e., contains a src attribute), or if the content is encoded in base64. This method will also set the rss:description field if it wasn\(aqt previously set or contains the old value of summary. .INDENT 7.0 .TP .B Parameters \fBsummary\fP \-\- Summary of the entries contents. .TP .B Returns Summary of the entries contents. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B title(title=None) Get or set the title value of the entry. It should contain a human readable title for the entry. Title is mandatory for both ATOM and RSS and should not be blank. .INDENT 7.0 .TP .B Parameters \fBtitle\fP \-\- The new title of the entry. .TP .B Returns The entriess title. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B ttl(ttl=None) Get or set the ttl value. It is an RSS only element. ttl stands for time to live. It\(aqs a number of minutes that indicates how long a channel can be cached before refreshing from the source. .INDENT 7.0 .TP .B Parameters \fBttl\fP \-\- Integer value representing the time to live. .TP .B Returns Time to live of of the entry. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B updated(updated=None) Set or get the updated value which indicates the last time the entry was modified in a significant way. .sp The value can either be a string which will automatically be parsed or a datetime.datetime object. In any case it is necessary that the value include timezone information. .INDENT 7.0 .TP .B Parameters \fBupdated\fP \-\- The modification date. .TP .B Returns Modification date as datetime.datetime .UNINDENT .UNINDENT .UNINDENT .SS feedgen.util .sp This file contains helper functions for the feed generator module. .INDENT 0.0 .TP .B copyright 2013, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B feedgen.util.ensure_format(val, allowed, required, allowed_values=None, defaults=None) Takes a dictionary or a list of dictionaries and check if all keys are in the set of allowed keys, if all required keys are present and if the values of a specific key are ok. .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBval\fP \-\- Dictionaries to check. .IP \(bu 2 \fBallowed\fP \-\- Set of allowed keys. .IP \(bu 2 \fBrequired\fP \-\- Set of required keys. .IP \(bu 2 \fBallowed_values\fP \-\- Dictionary with keys and sets of their allowed values. .IP \(bu 2 \fBdefaults\fP \-\- Dictionary with default values. .UNINDENT .TP .B Returns List of checked dictionaries. .UNINDENT .UNINDENT .INDENT 0.0 .TP .B feedgen.util.formatRFC2822(date) Make sure the locale setting do not interfere with the time format. .UNINDENT .SS feedgen.ext.base .sp Basic FeedGenerator extension which does nothing but provides all necessary methods. .INDENT 0.0 .TP .B copyright 2013, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.base.BaseEntryExtension Basic FeedEntry extension. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.base.BaseExtension Basic FeedGenerator extension. .INDENT 7.0 .TP .B extend_atom(feed) Extend an ATOM feed xml structure containing all previously set fields. .INDENT 7.0 .TP .B Parameters \fBfeed\fP \-\- The feed xml root element. .TP .B Returns The feed root element. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B extend_ns() Returns a dict that will be used in the namespace map for the feed. .UNINDENT .INDENT 7.0 .TP .B extend_rss(feed) Extend a RSS feed xml structure containing all previously set fields. .INDENT 7.0 .TP .B Parameters \fBfeed\fP \-\- The feed xml root element. .TP .B Returns The feed root element. .UNINDENT .UNINDENT .UNINDENT .SS feedgen.ext.dc .sp Extends the FeedGenerator to add Dubline Core Elements to the feeds. .sp Descriptions partly taken from \% .INDENT 0.0 .TP .B copyright 2013\-2017, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.dc.DcBaseExtension Dublin Core Elements extension for podcasts. .INDENT 7.0 .TP .B dc_contributor(contributor=None, replace=False) Get or set the dc:contributor which is an entity responsible for making contributions to the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcontributor\fP \-\- Contributor or list of contributors. .IP \(bu 2 \fBreplace\fP \-\- Replace already set contributors (default: False). .UNINDENT .TP .B Returns List of contributors. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_coverage(coverage=None, replace=True) Get or set the dc:coverage which indicated the spatial or temporal topic of the resource, the spatial applicability of the resource, or the jurisdiction under which the resource is relevant. .sp Spatial topic and spatial applicability may be a named place or a location specified by its geographic coordinates. Temporal topic may be a named period, date, or date range. A jurisdiction may be a named administrative entity or a geographic place to which the resource applies. Recommended best practice is to use a controlled vocabulary such as the Thesaurus of Geographic Names [TGN]. Where appropriate, named places or time periods can be used in preference to numeric identifiers such as sets of coordinates or date ranges. .sp References: [TGN] \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcoverage\fP \-\- Coverage of the feed. .IP \(bu 2 \fBreplace\fP \-\- Replace already set coverage (default: True). .UNINDENT .TP .B Returns Coverage of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_creator(creator=None, replace=False) Get or set the dc:creator which is an entity primarily responsible for making the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBcreator\fP \-\- Creator or list of creators. .IP \(bu 2 \fBreplace\fP \-\- Replace already set creators (default: False). .UNINDENT .TP .B Returns List of creators. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_date(date=None, replace=True) Get or set the dc:date which describes a point or period of time associated with an event in the lifecycle of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBdate\fP \-\- Date or list of dates. .IP \(bu 2 \fBreplace\fP \-\- Replace already set dates (default: True). .UNINDENT .TP .B Returns List of dates. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_description(description=None, replace=True) Get or set the dc:description which is an account of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBdescription\fP \-\- Description or list of descriptions. .IP \(bu 2 \fBreplace\fP \-\- Replace already set descriptions (default: True). .UNINDENT .TP .B Returns List of descriptions. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_format(format=None, replace=True) Get or set the dc:format which describes the file format, physical medium, or dimensions of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBformat\fP \-\- Format of the resource or list of formats. .IP \(bu 2 \fBreplace\fP \-\- Replace already set format (default: True). .UNINDENT .TP .B Returns Format of the resource. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_identifier(identifier=None, replace=True) Get or set the dc:identifier which should be an unambiguous reference to the resource within a given context. .sp For more inidentifierion see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBidentifier\fP \-\- Identifier of the resource or list of identifiers. .IP \(bu 2 \fBreplace\fP \-\- Replace already set identifier (default: True). .UNINDENT .TP .B Returns Identifiers of the resource. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_language(language=None, replace=True) Get or set the dc:language which describes a language of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBlanguage\fP \-\- Language or list of languages. .IP \(bu 2 \fBreplace\fP \-\- Replace already set languages (default: True). .UNINDENT .TP .B Returns List of languages. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_publisher(publisher=None, replace=False) Get or set the dc:publisher which is an entity responsible for making the resource available. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBpublisher\fP \-\- Publisher or list of publishers. .IP \(bu 2 \fBreplace\fP \-\- Replace already set publishers (default: False). .UNINDENT .TP .B Returns List of publishers. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_relation(relation=None, replace=False) Get or set the dc:relation which describes a related resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBrelation\fP \-\- Relation or list of relations. .IP \(bu 2 \fBreplace\fP \-\- Replace already set relations (default: False). .UNINDENT .TP .B Returns List of relations. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_rights(rights=None, replace=False) Get or set the dc:rights which may contain information about rights held in and over the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBrights\fP \-\- Rights information or list of rights information. .IP \(bu 2 \fBreplace\fP \-\- Replace already set rights (default: False). .UNINDENT .TP .B Returns List of rights information. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_source(source=None, replace=False) Get or set the dc:source which is a related resource from which the described resource is derived. .sp The described resource may be derived from the related resource in whole or in part. Recommended best practice is to identify the related resource by means of a string conforming to a formal identification system. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBsource\fP \-\- Source or list of sources. .IP \(bu 2 \fBreplace\fP \-\- Replace already set sources (default: False). .UNINDENT .TP .B Returns List of sources. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_subject(subject=None, replace=False) Get or set the dc:subject which describes the topic of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBsubject\fP \-\- Subject or list of subjects. .IP \(bu 2 \fBreplace\fP \-\- Replace already set subjects (default: False). .UNINDENT .TP .B Returns List of subjects. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_title(title=None, replace=True) Get or set the dc:title which is a name given to the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBtitle\fP \-\- Title or list of titles. .IP \(bu 2 \fBreplace\fP \-\- Replace already set titles (default: False). .UNINDENT .TP .B Returns List of titles. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B dc_type(type=None, replace=False) Get or set the dc:type which describes the nature or genre of the resource. .sp For more information see: \% .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBtype\fP \-\- Type or list of types. .IP \(bu 2 \fBreplace\fP \-\- Replace already set types (default: False). .UNINDENT .TP .B Returns List of types. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B extend_atom(atom_feed) Extend an Atom feed with the set DC fields. .INDENT 7.0 .TP .B Parameters \fBatom_feed\fP \-\- The feed root element .TP .B Returns The feed root element .UNINDENT .UNINDENT .INDENT 7.0 .TP .B extend_ns() Returns a dict that will be used in the namespace map for the feed. .UNINDENT .INDENT 7.0 .TP .B extend_rss(rss_feed) Extend a RSS feed with the set DC fields. .INDENT 7.0 .TP .B Parameters \fBrss_feed\fP \-\- The feed root element .TP .B Returns The feed root element. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.dc.DcEntryExtension Dublin Core Elements extension for podcasts. .INDENT 7.0 .TP .B extend_atom(entry) Add dc elements to an atom item. Alters the item itself. .INDENT 7.0 .TP .B Parameters \fBentry\fP \-\- An atom entry element. .TP .B Returns The entry element. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B extend_rss(item) Add dc elements to a RSS item. Alters the item itself. .INDENT 7.0 .TP .B Parameters \fBitem\fP \-\- A RSS item element. .TP .B Returns The item element. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.dc.DcExtension Dublin Core Elements extension for podcasts. .UNINDENT .SS feedgen.ext.podcast .sp Extends the FeedGenerator to produce podcasts. .INDENT 0.0 .TP .B copyright 2013, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.podcast.PodcastExtension FeedGenerator extension for podcasts. .INDENT 7.0 .TP .B extend_ns() Returns a dict that will be used in the namespace map for the feed. .UNINDENT .INDENT 7.0 .TP .B extend_rss(rss_feed) Extend an RSS feed root with set itunes fields. .INDENT 7.0 .TP .B Returns The feed root element. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_author(itunes_author=None) Get or set the itunes:author. 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 tag. If is not present at the feed level, iTunes will use the contents of . .INDENT 7.0 .TP .B Parameters \fBitunes_author\fP \-\- The author of the podcast. .TP .B Returns The author of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_block(itunes_block=None) Get or set the ITunes block attribute. Use this to prevent the entire podcast from appearing in the iTunes podcast directory. .INDENT 7.0 .TP .B Parameters \fBitunes_block\fP \-\- Block the podcast. .TP .B Returns If the podcast is blocked. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_category(itunes_category=None, replace=False, **kwargs) Get or set the ITunes category which appears in the category column and in iTunes Store Browser. .sp The (sub\-)category has to be one from the values defined at \% .sp This method can be called with: .INDENT 7.0 .IP \(bu 2 the fields of an itunes_category as keyword arguments .IP \(bu 2 the fields of an itunes_category as a dictionary .IP \(bu 2 a list of dictionaries containing the itunes_category fields .UNINDENT .sp An itunes_category has the following fields: .INDENT 7.0 .IP \(bu 2 \fIcat\fP name for a category. .IP \(bu 2 \fIsub\fP name for a subcategory, child of category .UNINDENT .sp If a podcast has more than one subcategory from the same category, the category is called more than once. .sp Likei the parameter: .INDENT 7.0 .INDENT 3.5 .sp .EX [{\(dqcat\(dq:\(dqArts\(dq,\(dqsub\(dq:\(dqDesign\(dq},{\(dqcat\(dq:\(dqArts\(dq,\(dqsub\(dq:\(dqFood\(dq}] .EE .UNINDENT .UNINDENT .sp …would become: .INDENT 7.0 .INDENT 3.5 .sp .EX .EE .UNINDENT .UNINDENT .INDENT 7.0 .TP .B Parameters .INDENT 7.0 .IP \(bu 2 \fBitunes_category\fP \-\- Dictionary or list of dictionaries with itunes_category data. .IP \(bu 2 \fBreplace\fP \-\- Add or replace old data. .UNINDENT .TP .B Returns List of itunes_categories as dictionaries. .UNINDENT .sp \-\-\- .sp \fBImportant note about deprecated parameter syntax:\fP Old version of the feedgen did only support one category plus one subcategory which would be passed to this ducntion as first two parameters. For compatibility reasons, this still works but should not be used any may be removed at any time. .UNINDENT .INDENT 7.0 .TP .B itunes_complete(itunes_complete=None) Get or set the itunes:complete value of the podcast. This tag can be used to indicate the completion of a podcast. .sp If you populate this tag with \(dqyes\(dq, you are indicating that no more episodes will be added to the podcast. If the tag is present and has any other value (e.g. “no”), it will have no effect on the podcast. .INDENT 7.0 .TP .B Parameters \fBitunes_complete\fP \-\- If the podcast is complete. .TP .B Returns If the podcast is complete. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_explicit(itunes_explicit=None) Get or the the itunes:explicit value of the podcast. This tag should be used to indicate whether your podcast contains explicit material. The three values for this tag are \(dqyes\(dq, \(dqno\(dq, and \(dqclean\(dq. .sp If you populate this tag with \(dqyes\(dq, an \(dqexplicit\(dq 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 \(dqclean\(dq, the parental advisory type is considered Clean, meaning that no explicit language or adult content is included anywhere in the episodes, and a \(dqclean\(dq graphic will appear. If the explicit tag is present and has any other value (e.g., \(dqno\(dq), you see no indicator — blank is the default advisory type. .INDENT 7.0 .TP .B Parameters \fBitunes_explicit\fP \-\- If the podcast contains explicit material. .TP .B Returns If the podcast contains explicit material. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_image(itunes_image=None) Get or set the image for the podcast. 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. .sp iTunes supports images in JPEG and PNG formats with an RGB color space (CMYK is not supported). The URL must end in \(dq.jpg\(dq or \(dq.png\(dq. If the tag is not present, iTunes will use the contents of the RSS image tag. .sp 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. .INDENT 7.0 .TP .B Parameters \fBitunes_image\fP \-\- Image of the podcast. .TP .B Returns Image of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_new_feed_url(itunes_new_feed_url=None) Get or set the new\-feed\-url property of the podcast. This tag allows you to change the URL where the podcast feed is located .sp After adding the tag to your old feed, you should maintain the old feed for 48 hours before retiring it. At that point, iTunes will have updated the directory with the new feed URL. .INDENT 7.0 .TP .B Parameters \fBitunes_new_feed_url\fP \-\- New feed URL. .TP .B Returns New feed URL. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_owner(name=None, email=None) Get or set the itunes:owner of the podcast. This tag contains information that will be used to contact the owner of the podcast for communication specifically about the podcast. It will not be publicly displayed. .INDENT 7.0 .TP .B Parameters \fBitunes_owner\fP \-\- The owner of the feed. .TP .B Returns Data of the owner of the feed. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_subtitle(itunes_subtitle=None) Get or set the itunes:subtitle value for the podcast. 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. .INDENT 7.0 .TP .B Parameters \fBitunes_subtitle\fP \-\- Subtitle of the podcast. .TP .B Returns Subtitle of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_summary(itunes_summary=None) Get or set the itunes:summary value for the podcast. The contents of this tag are shown in a separate window that appears when the \(dqcircled i\(dq 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 \fI\fP is not included, the contents of the tag are used. .INDENT 7.0 .TP .B Parameters \fBitunes_summary\fP \-\- Summary of the podcast. .TP .B Returns Summary of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_type(itunes_type=None) Get or set the itunes:type value of the podcast. This tag should be used to indicate the type of your podcast. The two values for this tag are \(dqepisodic\(dq and \(dqserial\(dq. .sp If your show is Serial you must use this tag. .sp Specify episodic when episodes are intended to be consumed without any specific order. Apple Podcasts will present newest episodes first and display the publish date (required) of each episode. If organized into seasons, the newest season will be presented first \- otherwise, episodes will be grouped by year published, newest first. .INDENT 7.0 .INDENT 3.5 Specify serial when episodes are intended to be consumed in sequential order. Apple Podcasts will present the oldest episodes first and display the episode numbers (required) of each episode. If organized into seasons, the newest season will be presented first and numbers must be given for each episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B Parameters \fBitunes_type\fP \-\- The type of the podcast .TP .B Returns type of the pdocast. .UNINDENT .UNINDENT .UNINDENT .SS feedgen.ext.podcast_entry .sp Extends the feedgen to produce podcasts. .INDENT 0.0 .TP .B copyright 2013\-2016, Lars Kiesow <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.podcast_entry.PodcastEntryExtension FeedEntry extension for podcasts. .INDENT 7.0 .TP .B extend_rss(entry) Add additional fields to an RSS item. .INDENT 7.0 .TP .B Parameters \fBfeed\fP \-\- The RSS item XML element to use. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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 tag. If is not present at the feed level, iTunes will use the contents of . .INDENT 7.0 .TP .B Parameters \fBitunes_author\fP \-\- The author of the podcast. .TP .B Returns The author of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_block(itunes_block=None) Get or set the ITunes block attribute. Use this to prevent episodes from appearing in the iTunes podcast directory. .INDENT 7.0 .TP .B Parameters \fBitunes_block\fP \-\- Block podcast episodes. .TP .B Returns If the podcast episode is blocked. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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. .sp 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. .INDENT 7.0 .TP .B Parameters \fBitunes_duration\fP \-\- Duration of the podcast episode. .TP .B Returns Duration of the podcast episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_episode(itunes_episode=None) Get or set the itunes:episode value for the podcast episode. .INDENT 7.0 .TP .B Parameters \fBitunes_season\fP \-\- Episode number of the podcast epiosode. .TP .B Returns Episode number of the podcast episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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 \(dqfull\(dq, \(dqtrailer\(dq and \(dqbonus\(dq. .sp If an episode is a trailer or bonus content, use this tag. .sp 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. .INDENT 7.0 .TP .B Parameters \fBitunes_episode_type\fP \-\- The episode type .TP .B Returns type of the episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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 \(dqyes\(dq, \(dqno\(dq, and \(dqclean\(dq. .sp If you populate this tag with \(dqyes\(dq, an \(dqexplicit\(dq 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 \(dqclean\(dq, the parental advisory type is considered Clean, meaning that no explicit language or adult content is included anywhere in the episodes, and a \(dqclean\(dq graphic will appear. If the explicit tag is present and has any other value (e.g., \(dqno\(dq), you see no indicator — blank is the default advisory type. .INDENT 7.0 .TP .B Parameters \fBitunes_explicit\fP \-\- If the podcast episode contains explicit material. .TP .B Returns If the podcast episode contains explicit material. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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. .sp iTunes supports images in JPEG and PNG formats with an RGB color space (CMYK is not supported). The URL must end in \(dq.jpg\(dq or \(dq.png\(dq. If the tag is not present, iTunes will use the contents of the RSS image tag. .sp 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. .INDENT 7.0 .TP .B Parameters \fBitunes_image\fP \-\- Image of the podcast. .TP .B Returns Image of the podcast. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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 \(dqyes\(dq and \(dqno”. .INDENT 7.0 .TP .B Parameters \fBis_closed_captioned\fP \-\- If the episode has closed captioning support. .TP .B Returns If the episode has closed captioning support. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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. .sp This tag is used at an 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 to appear as the first episode in the podcast, you would populate the tag with “1”. If conflicting order values are present in multiple episodes, the store will use default ordering (pubDate). .sp To remove the order from the episode set the order to a value below zero. .INDENT 7.0 .TP .B Parameters \fBitunes_order\fP \-\- The order of the episode. .TP .B Returns The order of the episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_season(itunes_season=None) Get or set the itunes:season value for the podcast episode. .INDENT 7.0 .TP .B Parameters \fBitunes_season\fP \-\- Season number of the podcast epiosode. .TP .B Returns Season number of the podcast episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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. .INDENT 7.0 .TP .B Parameters \fBitunes_subtitle\fP \-\- Subtitle of the podcast episode. .TP .B Returns Subtitle of the podcast episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B 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 \(dqcircled i\(dq 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 is not included, the contents of the tag are used. .INDENT 7.0 .TP .B Parameters \fBitunes_summary\fP \-\- Summary of the podcast episode. .TP .B Returns Summary of the podcast episode. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B itunes_title(itunes_title=None) Get or set the itunes:title value for the podcast episode. .sp 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. .INDENT 7.0 .TP .B Parameters \fBitunes_title\fP \-\- Episode title specific for Apple Podcasts .TP .B Returns Title specific for Apple Podcast .UNINDENT .UNINDENT .UNINDENT .SS feedgen.ext.torrent .sp Extends the FeedGenerator to produce torrent feeds. .INDENT 0.0 .TP .B copyright 2016, Raspbeguy <\%> .TP .B license FreeBSD and LGPL, see license.* for more details. .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.torrent.TorrentEntryExtension FeedEntry extension for torrent feeds .INDENT 7.0 .TP .B contentlength(torrent_contentlength=None) Get or set the size of the target file. .INDENT 7.0 .TP .B Parameters \fBtorrent_contentlength\fP \-\- The target file size. .TP .B Returns The target file size. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B extend_rss(entry) Add additional fields to an RSS item. .INDENT 7.0 .TP .B Parameters \fBfeed\fP \-\- The RSS item XML element to use. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B filename(torrent_filename=None) Get or set the name of the torrent file. .INDENT 7.0 .TP .B Parameters \fBtorrent_filename\fP \-\- The name of the torrent file. .TP .B Returns The name of the torrent file. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B infohash(torrent_infohash=None) Get or set the hash of the target file. .INDENT 7.0 .TP .B Parameters \fBtorrent_infohash\fP \-\- The target file hash. .TP .B Returns The target hash file. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B peers(torrent_peers=None) Get or set the number od peers .INDENT 7.0 .TP .B Parameters \fBtorrent_infohash\fP \-\- The peers number. .TP .B Returns The peers number. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B seeds(torrent_seeds=None) Get or set the number of seeds. .INDENT 7.0 .TP .B Parameters \fBtorrent_seeds\fP \-\- The seeds number. .TP .B Returns The seeds number. .UNINDENT .UNINDENT .INDENT 7.0 .TP .B verified(torrent_verified=None) Get or set the number of verified peers. .INDENT 7.0 .TP .B Parameters \fBtorrent_infohash\fP \-\- The verified peers number. .TP .B Returns The verified peers number. .UNINDENT .UNINDENT .UNINDENT .INDENT 0.0 .TP .B class feedgen.ext.torrent.TorrentExtension FeedGenerator extension for torrent feeds. .INDENT 7.0 .TP .B extend_ns() Returns a dict that will be used in the namespace map for the feed. .UNINDENT .UNINDENT .INDENT 0.0 .IP \(bu 2 Index \%<> .IP \(bu 2 Module Index \%<> .IP \(bu 2 Search Page \%<> .UNINDENT .SH Author Lars Kiesow .SH Copyright 2013-2016, Lars Kiesow .\" End of generated man page.