feat(parser): add tag access fields to Message objects

Author: linuxdaemon

irclib/parser.py

@@ -3,6 +3,7 @@
 Backported from async-irc (https://github.com/snoonetIRC/async-irc.git)
 """
 
+import datetime
 import re
 from abc import ABCMeta, abstractmethod
 from collections.abc import Iterable, Iterator, Sequence
@@ -65,7 +66,16 @@
     unescaped: escaped for escaped, unescaped in TAG_VALUE_ESCAPES.items()
 }
 
-SelfT = TypeVar("SelfT")
+
+def parse_server_time(value: Optional[str]) -> datetime.datetime:
+    if value:
+        ts = datetime.datetime.strptime(value, "%Y-%m-%dT%H:%M:%S.%fZ").replace(
+            tzinfo=datetime.timezone.utc
+        )
+    else:
+        ts = datetime.datetime.now(datetime.timezone.utc)
+
+    return ts
 
 
 class Parseable(metaclass=ABCMeta):
@@ -616,6 +626,30 @@ def __init__(
         self._command = command
         self._parameters = _parse_params(parameters)
 
+    def has_tag(self, name: str) -> bool:
+        if not self.tags:
+            return False
+
+        return name in self.tags
+
+    def get_tag_value(self, name: str) -> Optional[str]:
+        if self.tags and name in self.tags:
+            return self.tags[name].value
+
+        return None
+
+    @property
+    def time(self) -> datetime.datetime:
+        return parse_server_time(self.get_tag_value("time"))
+
+    @property
+    def message_id(self) -> Optional[str]:
+        return self.get_tag_value("msgid")
+
+    @property
+    def batch_id(self) -> Optional[str]:
+        return self.get_tag_value("batch")
+
     @property
     def tags(self) -> MsgTagList:
         """IRC tag list."""