1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
"""GeoRSS feed or feed item."""
from __future__ import annotations
import datetime
from georss_client.consts import (
XML_ATTR_TERM,
XML_TAG_AUTHOR,
XML_TAG_CATEGORY,
XML_TAG_CONTRIBUTOR,
XML_TAG_DC_DATE,
XML_TAG_LAST_BUILD_DATE,
XML_TAG_MANAGING_EDITOR,
XML_TAG_NAME,
XML_TAG_PUB_DATE,
XML_TAG_PUBLISHED,
XML_TAG_UPDATED,
)
from georss_client.xml_parser.feed_dict_source import FeedDictSource
class FeedOrFeedItem(FeedDictSource):
"""Represents the common base of feed and its items."""
@property
def category(self) -> list | None:
"""Return the categories of this feed item."""
category = self._attribute([XML_TAG_CATEGORY])
if category:
if isinstance(category, (str, dict)):
# If it's a string or a dict, wrap in list.
category = [category]
result = []
for item in category:
if XML_ATTR_TERM in item:
# <category term="Category 1"/>
item = item.get(XML_ATTR_TERM)
result.append(item)
return result
return None
@property
def published_date(self) -> datetime.datetime | None:
"""Return the published date of this feed or feed item."""
parsed_date = self._attribute(
[XML_TAG_PUB_DATE, XML_TAG_PUBLISHED, XML_TAG_DC_DATE]
)
return parsed_date if isinstance(parsed_date, datetime.datetime) else None
@property
def pub_date(self) -> datetime.datetime | None:
"""Return the published date of this feed or feed item."""
return self.published_date
@property
def updated_date(self) -> datetime.datetime | None:
"""Return the updated date of this feed or feed item."""
parsed_date = self._attribute([XML_TAG_LAST_BUILD_DATE, XML_TAG_UPDATED])
return parsed_date if isinstance(parsed_date, datetime.datetime) else None
@property
def last_build_date(self) -> datetime.datetime | None:
"""Return the last build date of this feed."""
return self.updated_date
@property
def author(self) -> str | None:
"""Return the author of this feed."""
# <managingEditor>jrc-ems@ec.europa.eu</managingEditor>
managing_editor = self._attribute([XML_TAG_MANAGING_EDITOR])
if managing_editor:
return managing_editor
# <author>
# <name>Istituto Nazionale di Geofisica e Vulcanologia</name>
# <uri>http://www.ingv.it</uri>
# </author>
author = self._attribute([XML_TAG_AUTHOR, XML_TAG_CONTRIBUTOR])
if author:
return author.get(XML_TAG_NAME, None)
return None
@property
def contributor(self) -> str | None:
"""Return the contributor of this feed."""
return self.author
@property
def managing_editor(self) -> str | None:
"""Return the managing editor of this feed."""
return self.author
|
