Added method to fetch forum post

Author: Galarzaa90

CHANGELOG.rst

@@ -6,6 +6,14 @@ Changelog
     Due to this library relying on external content, older versions are not guaranteed to work.
     Try to always use the latest version.
 
+.. v3.1.0:
+
+3.1.0 (2020-07-29)
+==================
+
+- Added ``fetch_forum_post`` method to fetch a forum post directly.
+- Fixed bug with forum posts made by tournament characters.
+
 .. v3.0.3:
 
 3.0.3 (2020-07-28)

docs/api.rst

@@ -127,6 +127,12 @@ ForumBoard
     :members:
     :inherited-members:
 
+ForumPost
+---------
+.. autoclass:: ForumPost
+    :members:
+    :inherited-members:
+
 ForumThread
 -----------
 .. autoclass:: ForumThread

serve.py

@@ -99,6 +99,13 @@ async def get_forum_thread(request: web.Request):
     return web.json_response(thread, dumps=CustomJson.dumps)
 
 
+@routes.get('/forums/post/{post_id}')
+async def get_forum_post(request: web.Request):
+    post_id = request.match_info['post_id']
+    post = await app["tibiapy"].fetch_forum_post(int(post_id))
+    return web.json_response(post, dumps=CustomJson.dumps)
+
+
 @routes.get('/forums/announcement/{announcement_id}/')
 async def get_forum_announcement(request: web.Request):
     announcement_id = request.match_info['announcement_id']

tibiapy/__init__.py

@@ -16,7 +16,7 @@
 from tibiapy.world import *
 from tibiapy.client import *
 
-__version__ = '3.0.3'
+__version__ = '3.1.0'
 
 from logging import NullHandler
 

tibiapy/client.py

@@ -13,7 +13,7 @@
 from tibiapy.enums import Category, HouseOrder, HouseStatus, HouseType, NewsCategory, NewsType, VocationFilter
 from tibiapy.errors import Forbidden, NetworkError
 from tibiapy.event import EventSchedule
-from tibiapy.forum import CMPostArchive, ForumAnnouncement, ForumBoard, ForumThread, ListedBoard
+from tibiapy.forum import CMPostArchive, ForumAnnouncement, ForumBoard, ForumPost, ForumThread, ListedBoard
 from tibiapy.guild import Guild, GuildWars, ListedGuild
 from tibiapy.highscores import Highscores
 from tibiapy.house import House, ListedHouse
@@ -419,6 +419,41 @@ async def fetch_forum_thread(self, thread_id, page=1):
         parsing_time = time.perf_counter() - start_time
         return TibiaResponse(response, thread, parsing_time)
 
+    async def fetch_forum_post(self, post_id):
+        """Fetches a forum post with a given id.
+
+        The thread that contains the post will be returned, containing the desired post in
+        :py:attr:`ForumThread.anchored_post`.
+
+        The displayed page will be the page where the post is located.
+
+        .. versionadded:: 3.1.0
+
+        Parameters
+        ----------
+        post_id : :class:`int`
+            The id of the post.
+
+        Returns
+        -------
+        :class:`TibiaResponse` of :class:`ForumThread`
+            A response containing the forum, if found.
+
+        Raises
+        ------
+        Forbidden
+            If a 403 Forbidden error was returned.
+            This usually means that Tibia.com is rate-limiting the client because of too many requests.
+        NetworkError
+            If there's any connection errors during the request."""
+        response = await self._request("get", ForumPost.get_url(post_id))
+        start_time = time.perf_counter()
+        thread = ForumThread.from_content(response.content)
+        if thread:
+            thread.anchored_post = next((p for p in thread.posts if p.post_id == post_id), None)
+        parsing_time = time.perf_counter() - start_time
+        return TibiaResponse(response, thread, parsing_time)
+
     async def fetch_forum_announcement(self, announcement_id):
         """Fetches a forum announcement.
 

tibiapy/forum.py

@@ -512,9 +512,10 @@ def _parse_author_table(cls, character_info_container):
         convert_line_breaks(char_info)
         char_info_text = char_info.text
         info_match = author_info_regex.search(char_info_text)
-        author.world = info_match.group(1)
-        author.vocation = try_enum(Vocation, info_match.group(2))
-        author.level = int(info_match.group(3))
+        if info_match:
+            author.world = info_match.group(1)
+            author.vocation = try_enum(Vocation, info_match.group(2))
+            author.level = int(info_match.group(3))
         if guild_info:
             guild_match = guild_regexp.search(guild_info.text)
             guild_name = guild_match.group(2)
@@ -782,7 +783,7 @@ def __repr__(self):
 
 
 class ForumPost(abc.BasePost, abc.Serializable):
-    """Represent's a forum post.
+    """Represents a forum post.
 
     .. versionadded:: 3.0.0
 
@@ -872,6 +873,10 @@ class ForumThread(abc.BaseThread, abc.Serializable):
         Whether the thread has a golden frame or not.
 
         In the Proposals board,a golden frame means the thread has a reply by a staff member.
+    anchored_post: :class:`ForumPost`
+        The post where the page is anchored to, if any.
+
+        When a post is fetched directly, the thread that contains it is displayed, anchored to the specific post.
     """
     __slots__ = (
         "title",
@@ -883,6 +888,7 @@ class ForumThread(abc.BaseThread, abc.Serializable):
         "page",
         "total_pages",
         "golden_frame",
+        "anchored_post",
         "posts",
     )
 
@@ -897,6 +903,7 @@ def __init__(self, **kwargs):
         self.total_pages: int = kwargs.get("total_pages", 1)
         self.posts: List[ForumPost] = kwargs.get("posts", [])
         self.golden_frame: bool = kwargs.get("golden_frame", False)
+        self.anchored_post: Optional[ForumPost] = None
 
     def __repr__(self):
         return f"<{self.__class__.__name__} title={self.title!r} board={self.board!r} section={self.section!r}>"