arz_api.models.thread_object

  1from requests import Response
  2from typing import TYPE_CHECKING
  3from arz_api.consts import MAIN_URL
  4
  5if TYPE_CHECKING:
  6    from arz_api.models.member_object import Member
  7    from arz_api.models.category_object import Category
  8    from arz_api import ArizonaAPI
  9
 10
 11class Thread:
 12    def __init__(self, API: 'ArizonaAPI', id: int, creator: 'Member', create_date: int, title: str, prefix: str, content: str, html_content: str, pages_content: int, thread_post_id: int, is_closed: bool) -> None:
 13        self.API = API
 14        self.id = id
 15        """**ID темы**"""
 16        self.creator = creator
 17        """**Объект Member создателя темы**"""
 18        self.create_date = create_date
 19        """**Дата создания темы в UNIX**"""
 20        self.title = title
 21        """**Заголовок темы**"""
 22        self.prefix = prefix
 23        """**Префикс темы**"""
 24        self.content = content
 25        """**Текст из темы**"""
 26        self.content_html = html_content
 27        """**Сырой контент темы**"""
 28        self.pages_count = pages_content
 29        """**Количество страниц с ответами в теме**"""
 30        self.is_closed = is_closed
 31        """**Закрыта ли тема**"""
 32        self.thread_post_id = thread_post_id
 33        """**ID сообщения темы (post_id)**"""
 34        self.url = f"{MAIN_URL}/threads/{self.id}/"
 35        """Ссылка на объект"""
 36    
 37
 38    def answer(self, message_html: str) -> Response:
 39        """Оставить сообщение в теме
 40
 41        Attributes:
 42            message_html (str): Cодержание ответа. Рекомендуется использование HTML
 43        
 44        Returns:
 45            Объект Response модуля requests
 46        """
 47
 48        return self.API.answer_thread(self.id, message_html)
 49
 50
 51    def watch(self, email_subscribe: bool = False, stop: bool = False) -> Response:
 52        """Изменить статус отслеживания темы
 53
 54        Attributes:
 55            email_subscribe (bool): Отправлять ли уведомления на почту. По умолчанию False (необяз.)
 56            stop (bool): - Принудительно прекратить отслеживание. По умолчанию False (необяз.)
 57        
 58        Returns:
 59            Объект Response модуля requests
 60        """
 61
 62        return self.API.watch_thread(self.id, email_subscribe, stop)
 63    
 64
 65    def delete(self, reason: str, hard_delete: bool = False) -> Response:
 66        """Удалить тему
 67
 68        Attributes:
 69            reason (str): Причина для удаления
 70            hard_delete (bool): Полное удаление сообщения. По умолчанию False (необяз.)
 71            
 72        Returns:
 73            Объект Response модуля requests
 74        """
 75
 76        return self.API.delete_thread(self.id, reason, hard_delete)
 77    
 78
 79    def edit(self, message_html: str) -> Response:
 80        """Отредактировать содержимое темы
 81
 82        Attributes:
 83            message_html (str): Новое содержимое ответа. Рекомендуется использование HTML
 84        
 85        Returns:
 86            Объект Response модуля requests
 87        """
 88
 89        return self.API.edit_thread(self.id, message_html)
 90
 91
 92    def edit_info(self, title: str = None, prefix_id: int = None, sticky: bool = True, opened: bool = True) -> Response:
 93        """Изменить заголовок и/или префикс темы
 94
 95        Attributes:
 96            title (str): Новое название
 97            prefix_id (int): Новый ID префикса
 98            sticky (bool): Закрепить (True - закреп / False - не закреп)
 99            opened (bool): Открыть/закрыть тему (True - открыть / False - закрыть)
100        
101        Returns:
102            Объект Response модуля requests
103        """
104
105        return self.API.edit_thread_info(self.id, title, prefix_id, sticky, opened)
106    
107
108    def get_posts(self, page: int = 1) -> list:
109        """Получить все ID сообщений из темы на странице
110
111        Attributes:
112            page (int): Cтраница для поиска. По умолчанию 1 (необяз.)
113        
114        Returns:
115            Список (list), состоящий из ID всех сообщений на странице
116        """
117
118        return self.API.get_thread_posts(self.id, page)
119
120
121    def react(self, reaction_id: int = 1) -> Response:
122        """Поставить реакцию на тему
123
124        Attributes:
125            reaction_id (int): ID реакции. По умолчанию 1 (необяз.)
126            
127        Returns:
128            Объект Response модуля requests
129        """
130
131        return self.API.react_thread(self.id, reaction_id)
132    
133
134    def get_category(self) -> 'Category':
135        """Получить родительский раздел раздела
136        
137        Returns:
138            Объект Catrgory, в котором создан раздел
139        """
140
141        return self.API.get_thread_category(self.id)