ó ù¢TQc@sidZddlmZddlZyddlmZWn!ek rYddlmZnXddlmZddl m Z m Z ddl m Z ddl mZdd lmZdd lmZd „Zd „Zd „Zdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZdefd„ƒYZeZdS(uí 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: http://web.archive.org/web/20110718035220/http://diveintomark.org/archives/2004/02/04/incompatible-rss iÿÿÿÿ(tunicode_literalsN(turlparse(tSimplerXMLGenerator(t force_textt iri_to_uri(t datetime_safe(tsix(tStringIO(tis_awarec CsÝd}d}tj|ƒ}||jƒ}||jd}|jd||fƒ}tjsp|jdƒ}nt|ƒrÑ|j j |ƒ}|j dd|j d}t |dƒ\}} |d|| fS|dSdS(NuJanuFebuMaruApruMayuJunuJuluAuguSepuOctuNovuDecuMonuTueuWeduThuuFriuSatuSuniu%s, %%d %s %%Y %%H:%%M:%%S uutf-8ii<u %+03d%02du-0000( uJanuFebuMaruApruMayuJunuJuluAuguSepuOctuNovuDec(uMonuTueuWeduThuuFriuSatuSun(Rt new_datetimetweekdaytmonthtstrftimeRtPY3tdecodeRttzinfot utcoffsettdaystsecondstdivmod( tdatetmonthsRtdowR ttime_strtoffsetttimezonethourtminute((s3../Django//lib/python/django/utils/feedgenerator.pyt rfc2822_date&s  cCs¦tj|ƒ}|jdƒ}tjs9|jdƒ}nt|ƒrš|jj|ƒ}|j dd|j d}t |dƒ\}}|d||fS|dSdS(Nu%Y-%m-%dT%H:%M:%Suutf-8ii<u %+03d:%02duZ( RR R RR RRRRRRR(RRRRRR((s3../Django//lib/python/django/utils/feedgenerator.pyt rfc3339_date;s  cCsZt|ƒ}d}|dk r=dtj|ƒjdƒ}nd|j||j|jfS(uˆ Creates a TagURI. See http://web.archive.org/web/20110514113830/http://diveintomark.org/archives/2004/05/28/howto-atom-id uu,%su%Y-%m-%dutag:%s%s:%s/%sN(RtNoneRR R thostnametpathtfragment(turlRtbitstd((s3../Django//lib/python/django/utils/feedgenerator.pyt get_tag_uriIs   tSyndicationFeedc Bs¤eZdZd d d d d d d d d d d„ Zd d d d d d d d d d d„ Zd„Zd„Zd„Zd„Z d„Z d„Z d „Z d „Z RS( uGBase class for all syndication feeds. Subclasses should provide write()cKsd„}| r1g| D]}t|ƒ^q} n| dk rLt| ƒ} ni ||ƒd6t|ƒd6||ƒd6||ƒd6||ƒd6||ƒd6t|ƒd6||ƒd 6| pÀdd 6t| ƒd 6|| ƒd 6| pç|d 6| d6|_|jj|ƒg|_dS(NcSst|dtƒS(Nt strings_only(RtTrue(ts((s3../Django//lib/python/django/utils/feedgenerator.pytZsutitleulinku descriptionulanguageu author_emailu author_nameu author_linkusubtitleu categoriesufeed_urlufeed_copyrightuiduttl((RRRtfeedtupdatetitems(tselfttitletlinkt descriptiontlanguaget author_emailt author_namet author_linktsubtitlet categoriestfeed_urltfeed_copyrightt feed_guidtttltkwargst to_unicodetc((s3../Django//lib/python/django/utils/feedgenerator.pyt__init__Ws* "              cKs d„}| r1g| D]}||ƒ^q} n| dk rLt| ƒ} ni ||ƒd6t|ƒd6||ƒd6||ƒd6||ƒd6t|ƒd6|d6||ƒd 6|| ƒd 6| d 6| pÎdd 6|| ƒd 6| d6}|j|ƒ|jj|ƒdS(uß Adds an item to the feed. All args are expected to be Python Unicode objects except pubdate, which is a datetime.datetime object, and enclosure, which is an instance of the Enclosure class. cSst|dtƒS(NR'(RR((R)((s3../Django//lib/python/django/utils/feedgenerator.pyR*{sutitleulinku descriptionu author_emailu author_nameu author_linkupubdateucommentsu unique_idu enclosureu categoriesuitem_copyrightuttlN((RRRR,R-tappend(R.R/R0R1R3R4R5tpubdatetcommentst unique_idt enclosureR7titem_copyrightR;R<R=R>titem((s3../Django//lib/python/django/utils/feedgenerator.pytadd_itemrs* "             cCs t|jƒS(N(tlenR-(R.((s3../Django//lib/python/django/utils/feedgenerator.pyt num_items“scCsiS(ux Return extra attributes to place on the root (i.e. feed/channel) element. Called from write(). ((R.((s3../Django//lib/python/django/utils/feedgenerator.pytroot_attributes–scCsdS(ud Add elements in the root (i.e. feed/channel) element. Called from write(). N((R.thandler((s3../Django//lib/python/django/utils/feedgenerator.pytadd_root_elementsscCsiS(uZ Return extra attributes to place on each item (i.e. item/entry) element. ((R.RF((s3../Django//lib/python/django/utils/feedgenerator.pytitem_attributes¤scCsdS(uF Add elements on each item (i.e. item/entry) element. N((R.RKRF((s3../Django//lib/python/django/utils/feedgenerator.pytadd_item_elementsªscCs t‚dS(uŠ Outputs the feed in the given encoding to outfile, which is a file-like object. Subclasses should override this. N(tNotImplementedError(R.toutfiletencoding((s3../Django//lib/python/django/utils/feedgenerator.pytwrite°scCs#tƒ}|j||ƒ|jƒS(uE Returns the feed in the given encoding as a string. (RRRtgetvalue(R.RQR)((s3../Django//lib/python/django/utils/feedgenerator.pyt writeString·s cCseg|jD] }|ddk r |d^q }t|ƒdkrT|jƒ|dStjjƒSdS(u€ Returns the latest item's pubdate. If none of them have a pubdate, this returns the current date/time. upubdateiiÿÿÿÿN(R-RRHtsorttdatetimetnow(R.titupdates((s3../Django//lib/python/django/utils/feedgenerator.pytlatest_post_date¿s 0 N((t__name__t __module__t__doc__RR?RGRIRJRLRMRNRRRTRZ(((s3../Django//lib/python/django/utils/feedgenerator.pyR&Us            t EnclosurecBseZdZd„ZRS(uRepresents an RSS enclosurecCs&|||_|_t|ƒ|_dS(u2All args are expected to be Python Unicode objectsN(tlengtht mime_typeRR"(R.R"R_R`((s3../Django//lib/python/django/utils/feedgenerator.pyR?Ís(R[R\R]R?(((s3../Django//lib/python/django/utils/feedgenerator.pyR^ËstRssFeedcBs;eZdZd„Zd„Zd„Zd„Zd„ZRS(u"application/rss+xml; charset=utf-8cCs}t||ƒ}|jƒ|jd|jƒƒ|jd|jƒƒ|j|ƒ|j|ƒ|j|ƒ|jdƒdS(Nurssuchannel( Rt startDocumentt startElementtrss_attributesRJRLt write_itemstendChannelElementt endElement(R.RPRQRK((s3../Django//lib/python/django/utils/feedgenerator.pyRRÔs    cCsi|jd6dd6S(Nuversionuhttp://www.w3.org/2005/Atomu xmlns:atom(t_version(R.((s3../Django//lib/python/django/utils/feedgenerator.pyRdÞs cCsNxG|jD]<}|jd|j|ƒƒ|j||ƒ|jdƒq WdS(Nuitem(R-RcRMRNRg(R.RKRF((s3../Django//lib/python/django/utils/feedgenerator.pyReâscCsR|jd|jdƒ|jd|jdƒ|jd|jdƒ|jddk rƒ|jddidd6|jdd6ƒn|jd dk r°|jd |jd ƒnx%|jd D]}|jd |ƒq¾W|jd dk r|jd |jd ƒn|jdt|jƒƒƒ|jddk rN|jd|jdƒndS(Nutitleulinku descriptionufeed_urlu atom:linkuselfureluhrefulanguageu categoriesucategoryufeed_copyrightu copyrightu lastBuildDateuttl(taddQuickElementR+RRRZ(R.RKtcat((s3../Django//lib/python/django/utils/feedgenerator.pyRLès cCs|jdƒdS(Nuchannel(Rg(R.RK((s3../Django//lib/python/django/utils/feedgenerator.pyRfùs(R[R\R`RRRdReRLRf(((s3../Django//lib/python/django/utils/feedgenerator.pyRaÒs    tRssUserland091FeedcBseZdZd„ZRS(u0.91cCsS|jd|dƒ|jd|dƒ|ddk rO|jd|dƒndS(Nutitleulinku description(RiR(R.RKRF((s3../Django//lib/python/django/utils/feedgenerator.pyRNþs(R[R\RhRN(((s3../Django//lib/python/django/utils/feedgenerator.pyRküstRss201rev2FeedcBseZdZd„ZRS(u2.0cCsï|jd|dƒ|jd|dƒ|ddk rO|jd|dƒn|drˆ|drˆ|jdd|d|dfƒnL|dr©|jd|dƒn+|drÔ|jd|did d 6ƒn|d dk r|jd t|d ƒƒn|d dk r(|jd |d ƒn|ddk rO|jd|dƒn|ddk rv|jd|dƒn|ddk rÆ|jddi|djd6|djd6|djd6ƒnx"|dD]}|jd|ƒqÑWdS(Nutitleulinku descriptionu author_nameu author_emailuauthoru%s (%s)u dc:creatoru http://purl.org/dc/elements/1.1/uxmlns:dcupubdateupubDateucommentsu unique_iduguiduttlu enclosureuuurlulengthutypeu categoriesucategory(RiRRR"R_R`(R.RKRFRj((s3../Django//lib/python/django/utils/feedgenerator.pyRNs2   ! (R[R\RhRN(((s3../Django//lib/python/django/utils/feedgenerator.pyRlst Atom1FeedcBsAeZdZdZd„Zd„Zd„Zd„Zd„ZRS(u#application/atom+xml; charset=utf-8uhttp://www.w3.org/2005/AtomcCsZt||ƒ}|jƒ|jd|jƒƒ|j|ƒ|j|ƒ|jdƒdS(Nufeed(RRbRcRJRLReRg(R.RPRQRK((s3../Django//lib/python/django/utils/feedgenerator.pyRR.s    cCsA|jddk r/i|jd6|jdd6Si|jd6SdS(Nulanguageuxmlnsuxml:lang(R+Rtns(R.((s3../Django//lib/python/django/utils/feedgenerator.pyRJ6scCsä|jd|jdƒ|jddidd6|jdd6ƒ|jddk r}|jddidd6|jdd6ƒn|jd |jd ƒ|jd t|jƒƒƒ|jd dk rT|jd iƒ|jd |jd ƒ|jddk r|jd|jdƒn|jddk rD|jd|jdƒn|jd ƒn|jddk r|jd|jdƒnx/|jdD] }|jddi|d6ƒqW|jddk rà|jd|jdƒndS(Nutitleulinkuu alternateureluhrefufeed_urluselfuiduupdatedu author_nameuauthorunameu author_emailuemailu author_linkuuriusubtitleu categoriesucategoryutermufeed_copyrighturights(RiR+RRRZRcRg(R.RKRj((s3../Django//lib/python/django/utils/feedgenerator.pyRL<s((+cCsNxG|jD]<}|jd|j|ƒƒ|j||ƒ|jdƒq WdS(Nuentry(R-RcRMRNRg(R.RKRF((s3../Django//lib/python/django/utils/feedgenerator.pyReRscCs|jd|dƒ|jddi|dd6dd6ƒ|ddk rf|jdt|dƒƒn|d dk rø|jd iƒ|jd |d ƒ|d dk rÁ|jd |d ƒn|ddk rè|jd|dƒn|jd ƒn|ddk r|d}nt|d|dƒ}|jd|ƒ|ddk rm|jd|didd6ƒn|ddk rÄ|jddidd6|djd6|djd6|djd6ƒnx,|dD] }|jddi|d6ƒqÏW|ddk r|jd|dƒndS(Nutitleulinkuuhrefu alternateurelupubdateuupdatedu author_nameuauthorunameu author_emailuemailu author_linkuuriu unique_iduidu descriptionusummaryuhtmlutypeu enclosureulengthu categoriesucategoryutermuitem_copyrighturights( RiRRRcRgR%R"R_R`(R.RKRFRCRj((s3../Django//lib/python/django/utils/feedgenerator.pyRNXs8% !  ( R[R\R`RnRRRJRLReRN(((s3../Django//lib/python/django/utils/feedgenerator.pyRm)s    (R]t __future__RRVt urllib.parseRt ImportErrortdjango.utils.xmlutilsRtdjango.utils.encodingRRt django.utilsRRtdjango.utils.sixRtdjango.utils.timezoneRRRR%tobjectR&R^RaRkRlRmt DefaultFeed(((s3../Django//lib/python/django/utils/feedgenerator.pyts,     v*%\