File: //usr/lib/python3/dist-packages/django/utils/__pycache__/feedgenerator.cpython-310.pyc
o
3�a; � @ s� d Z ddlZddlZddlmZ ddlmZ ddlmZ ddl m
Z
ddl m Z dd � Z
d
d � Zd d
� ZG dd� d�ZG dd� d�ZG dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZeZdS )a�
Syndication feed generation library -- used for generating RSS, etc.
Sample usage:
>>> from django.utils import feedgenerator
>>> feed = feedgenerator.Rss201rev2Feed(
... title="Poynter E-Media Tidbits",
... link="http://www.poynter.org/column.asp?id=31",
... description="A group Weblog by the sharpest minds in online media/journalism/publishing.",
... language="en",
... )
>>> feed.add_item(
... title="Hello",
... link="http://www.holovaty.com/test/",
... description="Testing."
... )
>>> with open('test.rss', 'w') as fp:
... feed.write(fp, 'utf-8')
For definitions of the different versions of RSS, see:
https://web.archive.org/web/20110718035220/http://diveintomark.org/archives/2004/02/04/incompatible-rss
� N)�StringIO)�urlparse)�
iri_to_uri)�utc)�SimplerXMLGeneratorc C s* t | tj�stj�| t�� �} tj�| �S �N)�
isinstance�datetime�combine�time�email�utils�format_datetime��date� r �</usr/lib/python3/dist-packages/django/utils/feedgenerator.py� rfc2822_date" s r c C s< t | tj�stj�| t�� �} | �� | �� d u rd S d S )N�Z� )r r r
r � isoformat� utcoffsetr r r r � rfc3339_date( s r c C s8 t | �}d}|durd|�d� }d|j||j|jf S )z�
Create a TagURI.
See https://web.archive.org/web/20110514113830/http://diveintomark.org/archives/2004/05/28/howto-atom-id
r Nz,%sz%Y-%m-%dztag:%s%s:%s/%s)r �strftime�hostname�path�fragment)�urlr �bits�dr r r � get_tag_uri. s
r c @ sr e Zd ZdZ ddd�Z ddd�Zdd � Zd
d � Zd d
� Zdd� Z dd� Z
dd� Z dd� Z dd� Z
dS )�SyndicationFeedzGBase class for all syndication feeds. Subclasses should provide write()Nc K s~ dd� }| o dd� | D �} ||�t |�||�||�||�||�t |�||�| p(dt |
�|| �| p1|||
�d�
|�| _g | _d S )Nc S � | d urt | �S | S r ��str��sr r r �to_str@ � z(SyndicationFeed.__init__.<locals>.to_strc S s g | ]}t |��qS r r# ��.0�cr r r �
<listcomp>B � z,SyndicationFeed.__init__.<locals>.<listcomp>r )
�title�link� description�language� author_email� author_name� author_link�subtitle�
categories�feed_url�feed_copyright�id�ttl)r �feed�items)�selfr. r/ r0 r1 r2 r3 r4 r5 r6 r7 r8 � feed_guidr: �kwargsr' r r r �__init__= s& ��
zSyndicationFeed.__init__r c s� dd� � | o� fdd�| D �} | j �� |�t|�� |�� |�� |�t|�||� |�� | �|
|p0d| p3d� | �� |
�d�|�� dS )z�
Add an item to the feed. All args are expected to be strings except
pubdate and updateddate, which are datetime.datetime objects, and
enclosures, which is an iterable of instances of the Enclosure class.
c S r" r r# r% r r r r' ^ r( z(SyndicationFeed.add_item.<locals>.to_strc s g | ]}� |��qS r r r) �r' r r r, ` r- z,SyndicationFeed.add_item.<locals>.<listcomp>r )r. r/ r0 r2 r3 r4 �pubdate� updateddate�comments� unique_id�unique_id_is_permalink�
enclosuresr6 �item_copyrightr: N)r< �appendr )r= r. r/ r0 r2 r3 r4 rB rD rE rF r6 rH r: rC rG r? r rA r �add_itemU s* �
�zSyndicationFeed.add_itemc C s
t | j�S r )�lenr< �r= r r r � num_itemst s
zSyndicationFeed.num_itemsc C � i S )zx
Return extra attributes to place on the root (i.e. feed/channel) element.
Called from write().
r rL r r r �root_attributesw � z SyndicationFeed.root_attributesc C � dS )zd
Add elements in the root (i.e. feed/channel) element. Called
from write().
Nr �r= �handlerr r r �add_root_elements~ rP z!SyndicationFeed.add_root_elementsc C rN )zZ
Return extra attributes to place on each item (i.e. item/entry) element.
r )r= �itemr r r �item_attributes� � z SyndicationFeed.item_attributesc C rQ )zF
Add elements on each item (i.e. item/entry) element.
Nr �r= rS rU r r r �add_item_elements� rW z!SyndicationFeed.add_item_elementsc C s t d��)z�
Output the feed in the given encoding to outfile, which is a file-like
object. Subclasses should override this.
z;subclasses of SyndicationFeed must provide a write() method)�NotImplementedError)r= �outfile�encodingr r r �write� s zSyndicationFeed.writec C s t � }| �||� |�� S )zD
Return the feed in the given encoding as a string.
)r r] �getvalue)r= r\ r& r r r � writeString� s zSyndicationFeed.writeStringc C sV d}d}| j D ]}|D ]}|�|�}|r |du s ||kr |}q q|p*tj�� jtd�S )z�
Return the latest item's pubdate or updateddate. If no items
have either of these attributes this return the current UTC date/time.
N)rC rB )�tzinfo)r< �getr �utcnow�replacer )r= � latest_date� date_keysrU �date_key� item_dater r r �latest_post_date� s
��z SyndicationFeed.latest_post_date)
NNNNNNNNNN) NNNNNNNr NNNN)�__name__�
__module__� __qualname__�__doc__r@ rJ rM rO rT rV rY r] r_ rh r r r r r! ; s&
�
� r! c @ � e Zd ZdZdd� ZdS )� EnclosurezAn RSS enclosurec C s ||| _ | _t|�| _dS )z#All args are expected to be stringsN)�length� mime_typer r )r= r ro rp r r r r@ � s zEnclosure.__init__N)ri rj rk rl r@ r r r r rn � s rn c @ s8 e Zd ZdZdd� Zdd� Zdd� Zdd � Zd
d � Zd S )
�RssFeedz"application/rss+xml; charset=utf-8c C s^ t ||�}|�� |�d| �� � |�d| �� � | �|� | �|� | �|� |�d� d S )N�rss�channel) r �
startDocument� startElement�rss_attributesrO rT � write_items�endChannelElement�
endElement�r= r[ r\ rS r r r r] � s
z
RssFeed.writec C s | j dd�S )N�http://www.w3.org/2005/Atom)�versionz
xmlns:atom)�_versionrL r r r rv � s �zRssFeed.rss_attributesc C �8 | j D ]}|�d| �|�� | �||� |�d� qd S )NrU �r< ru rV rY ry rX r r r rw � �
�zRssFeed.write_itemsc C s� |� d| jd � |� d| jd � |� d| jd � | jd d ur/|� dd d| jd d�� | jd d ur?|� d| jd � | jd D ]}|� d
|� qD| jd d ur]|� d | jd � |� d
t| �� �� | jd d ury|� d| jd � d S d S )Nr. r/ r0 r7 z atom:linkr= ��rel�hrefr1 r6 �categoryr8 � copyright�
lastBuildDater: )�addQuickElementr; r rh �r= rS �catr r r rT � s �zRssFeed.add_root_elementsc C s |� d� d S )Nrs )ry rR r r r rx � s zRssFeed.endChannelElementN) ri rj rk � content_typer] rv rw rT rx r r r r rq � s
rq c @ rm )�RssUserland091Feedz0.91c C sD |� d|d � |� d|d � |d d ur |� d|d � d S d S )Nr. r/ r0 )r� rX r r r rY � s
�z$RssUserland091Feed.add_item_elementsN�ri rj rk r} rY r r r r r� � s r� c @ rm )�Rss201rev2Feedz2.0c C s� |� d|d � |� d|d � |d d ur |� d|d � |d r5|d r5|� dd|d |d f � n |d rB|� d|d � n|d rQ|� d|d d d
i� |d d ura|� d t|d �� |d
d uro|� d
|d
� |d d ur�i }t|�d�t�r�t|d ��� |d< |� d|d |� |d d ur�|� d|d � |d r�t|d �}t|�dkr�t d��|d }|� dd|j
|j |j d�� |d D ]}|� d|� q�d S ) Nr. r/ r0 r3 r2 �authorz%s (%s)z
dc:creatorzxmlns:dcz http://purl.org/dc/elements/1.1/rB �pubDaterD rE rF � isPermaLink�guidr: rG � zrRSS feed items may only have one enclosure, see http://www.rssboard.org/rss-profile#element-channel-item-enclosurer � enclosurer )r ro �typer6 r� )
r� r r ra �boolr$ �lower�listrK �
ValueErrorr ro rp )r= rS rU �
guid_attrsrG r� r� r r r rY � sL � �� �z Rss201rev2Feed.add_item_elementsNr� r r r r r� � s r� c @ s< e Zd ZdZdZdd� Zdd� Zdd� Zd d
� Zd d � Z d
S )� Atom1Feedz#application/atom+xml; charset=utf-8r{ c C sD t ||�}|�� |�d| �� � | �|� | �|� |�d� d S )Nr; )r rt ru rO rT rw ry rz r r r r] + s
zAtom1Feed.writec C s* | j d d ur| j| j d d�S d| jiS )Nr1 )�xmlnszxml:langr� )r; �nsrL r r r rO 3 s
zAtom1Feed.root_attributesc C sZ |� d| jd � |� ddd| jd d�� | jd d ur*|� ddd| jd d�� |� d| jd � |� d t| �� �� | jd
d urx|�d i � |� d | jd
� | jd
d urc|� d| jd
� | jd d urs|� d| jd � |�d � | jd d ur�|� d| jd � | jd D ] }|� ddd|i� q�| jd d ur�|� d| jd � d S d S )Nr. r/ r � alternater� r7 r= r9 �updatedr3 r� �namer2 r r4 �urir5 r6 r� �termr8 �rights)r� r; r rh ru ry r� r r r rT 9 s*
�zAtom1Feed.add_root_elementsc C r~ )N�entryr rX r r r rw O r� zAtom1Feed.write_itemsc
C s� |� d|d � |� dd|d dd�� |d d ur$|� dt|d �� |d d ur4|� d t|d �� |d
d uri|�d i � |� d |d
� |d
d urV|� d|d
� |d d urd|� d|d � |�d � |d d urt|d }n t|d |d �}|� d|� |d d ur�|� d|d ddi� |d D ]}|� ddd|j|j|jd�� q�|d D ] }|� ddd |i� q�|d d ur�|� d |d � d S d S ) Nr. r/ r r� )r� r� rB � publishedrC r� r3 r� r� r2 r r4 r� rE r9 r0 �summaryr� �htmlrG r� )r� r� ro r� r6 r� r� rH r� )r� r ru ry r r ro rp )r= rS rU rE r� r� r r r rY U s@
� �zAtom1Feed.add_item_elementsN)
ri rj rk r� r� r] rO rT rw rY r r r r r� & s r� )rl r r �ior � urllib.parser �django.utils.encodingr �django.utils.timezoner �django.utils.xmlutilsr r r r r! rn rq r� r� r� � DefaultFeedr r r r �<module> s$
x-
4b