`?iF dZddlZddlZddlZddlmZddlmZddlm Z ddl m Z ddl m Z dZd Zd Zd ZGd d ZGddZGddZGddeZGddeZGddeZGddeZeZy)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 blog by the sharpest minds in online journalism.", ... 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)flatatt) iri_to_uri)SimplerXMLGeneratorct|tjs2tjj|tj}tj j |SN) isinstancedatetimecombinetimeemailutilsformat_datetimedates l/home/cursorai/projects/django-cronjob-utils/venv/lib/python3.12/site-packages/django/utils/feedgenerator.py rfc2822_dater$sE dH-- .  ((x}}? ;; & &t ,,ct|tjs2tjj|tj}|j |j dzSdzS)NZ)r r r r isoformat utcoffsetrs r rfc3339_dater*sV dH-- .  ((x}}? >> dnn&6&>s GGB GGrct|}d}|d|jdz}d|j|d|jd|jS)z Create a TagURI. See https://web.archive.org/web/20110514113830/http://diveintomark.org/archives/2004/05/28/howto-atom-id rz,%sz%Y-%m-%dztag::/)rstrftimehostnamepathfragment)urlrbitsds r get_tag_urir&0sG C=D A  DMM*- -#}}aDMM JJrctj}|jtd|j |S)z Return the given stylesheet's mimetype tuple, using a slightly custom version of Python's mimetypes.guess_type(). ztext/xsl xsl text/xsl xslt) mimetypes MimeTypesreadfpr guess_type)r# mimetypedbs r_guess_stylesheet_mimetyper->s9 $$&J h>?@   %%rcDeZdZdZddZedZedZdZdZ y) StylesheetzAn RSS stylesheetc.||_||_||_yr )_url _mimetypemedia)selfr#mimetyper3s r__init__zStylesheet.__init__Qs ! rc,t|jSr )rr1r4s rr#zStylesheet.urlXs$))$$rch|jdk(rt|jdS|jS)Nrr)r2r-r#r8s rr5zStylesheet.mimetype\s, >>R -dhh7: :~~rct|j|j|jd}t |j S)N)hreftyper3)rr1r5r3rstrip)r4attrss r__str__zStylesheet.__str__bs8tyy)MMZZ  u~##%%rcZt|j|j|jfSr )reprr#r5r3r8s r__repr__zStylesheet.__repr__js TXXt}}djj9::rN)rscreen) __name__ __module__ __qualname____doc__r6propertyr#r5r?rBrrr/r/Ns<%% &;rr/ceZdZdZ ddZ ddZdZdZdZdZ d Z d Z d Z d Z d Zy)SyndicationFeedzGBase class for all syndication feeds. Subclasses should provide write()Nc d}d}| xr| Dcgc] }t|c}} |Ct|ttfrtd|j|Dcgc] }|| }}||t |||||||||t |||| xsdt | || | xs||| |d||_g|_ycc}wcc}w)Nc | t|S|Sr strss rto_strz(SyndicationFeed.__init__..to_str]3q6 1 1rc<t|tr|St|Sr )r r/rPs r to_stylesheetz/SyndicationFeed.__init__..to_stylesheets"1j11 Dz!} Drz"stylesheets should be a list, not rI)titlelink descriptionlanguage author_email author_name author_linksubtitle categoriesfeed_urlfeed_copyrightidttl stylesheets)rOr r/ TypeError __class__rfeeditems)r4rVrWrXrYrZr[r\r]r^r_r` feed_guidrbrckwargsrRrUcrQs rr6zSyndicationFeed.__init__qs$ 2 E @Z$@ZSVZ$@  "+ C'8989N9N8OP6AA[=+[KAE]t$!+.x("<0!+.%k2x($*"8,$^4#t#;&   " 5%ABs CC!c 6d}| xr| Dcgc] }|| c}} |jj||t|||||||t||||||| | |xsd| xsd|| || d|ycc}w)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 | t|S|Sr rNrPs rrRz(SyndicationFeed.add_item..to_strrSrrI)rVrWrXrZr[r\pubdate updateddatecomments unique_idunique_id_is_permalink enclosuresr^item_copyrightrbN)rgappendr)r4rVrWrXrZr[r\rmrorprqr^rsrbrnrrrirRrjs radd_itemzSyndicationFeed.add_items2 2 C $C 1VAY $C  "4(%k2 &| 4%k2)+6"*"8,#I.*@(.B(.B"("8c{  !  %DsBc,t|jSr )lenrgr8s r num_itemszSyndicationFeed.num_itemss4::rciS)zx Return extra attributes to place on the root (i.e. feed/channel) element. Called from write(). rIr8s rroot_attributeszSyndicationFeed.root_attributes  rcy)zd Add elements in the root (i.e. feed/channel) element. Called from write(). NrIr4handlers radd_root_elementsz!SyndicationFeed.add_root_elementss rcy)zE Add stylesheet(s) to the feed. Called from write(). NrIr}s radd_stylesheetszSyndicationFeed.add_stylesheets rciS)zb Return extra attributes to place on each item (i.e. item/entry) element. rI)r4items ritem_attributeszSyndicationFeed.item_attributesr{rcy)zF Add elements on each item (i.e. item/entry) element. NrIr4r~rs radd_item_elementsz!SyndicationFeed.add_item_elementsrrctd)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)r4outfileencodings rwritezSyndicationFeed.writes " I  rcZt}|j|||jS)zD Return the feed in the given encoding as a string. )rrgetvalue)r4rrQs r writeStringzSyndicationFeed.writeStrings% J 1hzz|rcd}d}|jD]'}|D] }|j|}|s|||kDs|}")|xs.tjjtjS)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)rnrm)tz)rggetr nowUTC)r4 latest_date date_keysrdate_key item_dates rlatest_post_datez SyndicationFeed.latest_post_date sn  . JJD% HHX. "*i+.E&/ &Dh//33x||3DDr) NNNNNNNNNNN) NNNNNNNrINNNN)rDrErFrGr6rurxrzrrrrrrrrIrrrKrKnsM 2r# !0 d    ErrKceZdZdZdZy) EnclosurezAn RSS enclosurecB||c|_|_t||_y)z#All args are expected to be stringsN)length mime_typerr#)r4r#rrs rr6zEnclosure.__init__!s&,i# T^c?rN)rDrErFrGr6rIrrrrs #rrc4eZdZdZdZdZdZdZdZdZ y) RssFeedz"application/rss+xml; charset=utf-8cjt||d}|j|j||jd|j |jd|j |j ||j||j||jdy)NTshort_empty_elementsrsschannel) r startDocumentr startElementrss_attributesrzr write_itemsendChannelElement endElementr4rrr~s rrz RssFeed.write*s%gxdS W%UD$7$7$9:Y(<(<(>? w' ! w'5!rc |jddS)Nhttp://www.w3.org/2005/Atom)versionz xmlns:atom)_versionr8s rrzRssFeed.rss_attributes7s}}7  rc|jD]F}|jd|j||j|||j dHy)Nrrgrrrrrs rrzRssFeed.write_items=sIJJD  )=)=d)C D  " "7D 1   v &rcX|jdxsgD]}|jd|y)Nrczxml-stylesheet)rfprocessingInstruction)r4r~ stylesheets rrzRssFeed.add_stylesheetsCs.))M28b8J  ) )*:J G9rc|jd|jd|jd|jd|jd|jd|jd#|jddd|jdd|jd|jd|jd|jd D]}|jd ||jd |jd |jd |jd t|j|jd |jd|jdyy)NrVrWrXr_z atom:linkr4relr;rYr^categoryr` copyright lastBuildDaterb)addQuickElementrfrrr4r~cats rrzRssFeed.add_root_elementsGsA7);< &(9: tyy/GH 99Z ,  # #T6499Z;P#Q  99Z ,  # #J *0E F99\*C  # #J 4+ 99% & 2  # #K;K1L Md>S>S>U1VW 99U  '  # #E499U+; < (rc&|jdy)Nr)rr}s rrzRssFeed.endChannelElementYs9%rN) rDrErF content_typerrrrrrrIrrrr's&7L " ' H=$&rrceZdZdZdZy)RssUserland091Feedz0.91c|jd|d|jd|d|d|jd|dyy)NrVrWrX)rrs rrz$RssUserland091Feed.add_item_elements`sOg7V 5   *  # #M4 3F G +rNrDrErFrrrIrrrr]s HHrrceZdZdZdZy)Rss201rev2Feedz2.0c|jd|d|jd|d|d|jd|d|dr$|dr|jd|dd|ddn8|dr|jd|dn|dr|jd |dd d i|d |jd t|d |d|jd|d|dVi}t|jdtrt |dj |d<|jd|d||d|jd|d|drat|d}t|dkDr td|d}|jdd|j|j|jd|dD]}|jd|y)NrVrWrXr[rZauthorz ()z dc:creatorzxmlns:dcz http://purl.org/dc/elements/1.1/rmpubDaterorprq isPermaLinkguidrbrrzrRSS feed items may only have one enclosure, see http://www.rssboard.org/rss-profile#element-channel-item-enclosurer enclosurer)r#rr<r^r) rrr rboolrOlowerlistrw ValueErrorr#rr)r4r~r guid_attrsrrrrs rrz Rss201rev2Feed.add_item_elementsksg7V 5   *  # #M4 3F G  4#7  # #tN';T-=PQ . !  # #Hd>.B C -  # #]#?@   ? &  # #I|DO/L M   '  # #JZ0@ A   (J$((#;1JKyy'3''tyy/GH   x ( 99Z ,  # #J *0E F99\*C  # #JVSM B+ 99% & 2  # #Hdii8H.I J 3rc|jD]F}|jd|j||j|||j dHy)Nentryrrs rrzAtom1Feed.write_itemssIJJD  $*>*>t*D E  " "7D 1   w 'rc Z|jd|d|jdd|ddd|d|jdt|d|d|jd t|d|d l|jd i|jd |d |d |jd|d |d|jd|d|jd |d|d}nt |d|d}|jd||d|jd|dddi|dD]8}|jddd|j |j |jd:|dD]}|jddd|i|d|jd|dyy)NrVrWrr)r;rrm publishedrnrr[rrrZrr\rrprarXsummaryr<htmlrrr)rr;rr<r^rrrsr)rrrrr&r#rr)r4r~rrprrs rrzAtom1Feed.add_item_elementssg7T&\+,VW  ? &  # #Kd9o1N O   *  # #I|Drs0 !&,5- H K & ;;@mEmE`##3&o3&lHH95W95xeFeFT r