megaplan-sdk 0.2.3__tar.gz → 0.3.0__tar.gz

{megaplan_sdk-0.2.3/src/megaplan_sdk.egg-info → megaplan_sdk-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.3
+Version: 0.3.0
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -67,6 +67,7 @@ Dynamic: license-file
 - [Задачи](#работа-с-задачами)
 - [Проекты](#работа-с-проектами)
 - [Сделки](#работа-со-сделками)
+- [База знаний](#работа-с-базой-знаний)
 
 ### Продвинутые возможности
 - [Кэширование сущностей](#кэширование-сущностей)
@@ -1123,6 +1124,45 @@ details = await client.deals.get_full_details(
 
 > **Примечание:** Общее описание метода `get_full_details()` и примеры использования см. в разделе [Общие паттерны работы с сущностями](#общие-паттерны-работы-с-сущностями).
 
+## Работа с базой знаний
+
+SDK предоставляет доступ к разделам и статьям Базы знаний Мегаплана через два ресурса: `client.knowledge_base` (разделы) и `client.knowledge_article` (статьи).
+
+```python
+# Список разделов Базы знаний (плоский)
+sections = await client.knowledge_base.list()
+for s in sections:
+    print(s.id, s.name)
+
+# Один раздел с HTML-содержимым
+section = await client.knowledge_base.get(11)
+print(section.content)
+
+# Итерация по всем разделам с автопагинацией
+async for section in client.knowledge_base.iterate():
+    print(section.id, section.name)
+
+# Статья по ID (parent всегда None — используйте base)
+article = await client.knowledge_article.get(33)
+print(article.name, "→ раздел:", article.base.name if article.base else None)
+
+# Экспериментально: раздел вместе со статьями (через парсинг HTML-ссылок)
+bundle = await client.knowledge_base.get_with_articles(2)
+for a in bundle.articles:
+    print(a.id, a.name)
+```
+
+> **Известные ограничения API (серверная сторона):**
+>
+> - **Нет листинга статей:** эндпоинт `GET /api/v3/knowledgeArticle` отсутствует (возвращает 404).
+>   Единственный способ обнаружения статей в разделе — метод `get_with_articles()`, который
+>   парсит HTML-ссылки из поля `content` раздела. Это **экспериментальный** и хрупкий метод —
+>   формат ссылок может измениться на стороне сервера.
+> - **Фильтр `parent` не работает:** `knowledge_base.list()` всегда возвращает плоский список
+>   всех разделов; передача `parent` в фильтре игнорируется сервером. Иерархии разделов нет.
+> - **Поле `parent` у статьи всегда `null`:** для определения принадлежности статьи к разделу
+>   используйте `article.base` (не `article.parent`).
+
 ## Продвинутые возможности
 
 ### Кэширование сущностей

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/README.md

@@ -35,6 +35,7 @@
 - [Задачи](#работа-с-задачами)
 - [Проекты](#работа-с-проектами)
 - [Сделки](#работа-со-сделками)
+- [База знаний](#работа-с-базой-знаний)
 
 ### Продвинутые возможности
 - [Кэширование сущностей](#кэширование-сущностей)
@@ -1091,6 +1092,45 @@ details = await client.deals.get_full_details(
 
 > **Примечание:** Общее описание метода `get_full_details()` и примеры использования см. в разделе [Общие паттерны работы с сущностями](#общие-паттерны-работы-с-сущностями).
 
+## Работа с базой знаний
+
+SDK предоставляет доступ к разделам и статьям Базы знаний Мегаплана через два ресурса: `client.knowledge_base` (разделы) и `client.knowledge_article` (статьи).
+
+```python
+# Список разделов Базы знаний (плоский)
+sections = await client.knowledge_base.list()
+for s in sections:
+    print(s.id, s.name)
+
+# Один раздел с HTML-содержимым
+section = await client.knowledge_base.get(11)
+print(section.content)
+
+# Итерация по всем разделам с автопагинацией
+async for section in client.knowledge_base.iterate():
+    print(section.id, section.name)
+
+# Статья по ID (parent всегда None — используйте base)
+article = await client.knowledge_article.get(33)
+print(article.name, "→ раздел:", article.base.name if article.base else None)
+
+# Экспериментально: раздел вместе со статьями (через парсинг HTML-ссылок)
+bundle = await client.knowledge_base.get_with_articles(2)
+for a in bundle.articles:
+    print(a.id, a.name)
+```
+
+> **Известные ограничения API (серверная сторона):**
+>
+> - **Нет листинга статей:** эндпоинт `GET /api/v3/knowledgeArticle` отсутствует (возвращает 404).
+>   Единственный способ обнаружения статей в разделе — метод `get_with_articles()`, который
+>   парсит HTML-ссылки из поля `content` раздела. Это **экспериментальный** и хрупкий метод —
+>   формат ссылок может измениться на стороне сервера.
+> - **Фильтр `parent` не работает:** `knowledge_base.list()` всегда возвращает плоский список
+>   всех разделов; передача `parent` в фильтре игнорируется сервером. Иерархии разделов нет.
+> - **Поле `parent` у статьи всегда `null`:** для определения принадлежности статьи к разделу
+>   используйте `article.base` (не `article.parent`).
+
 ## Продвинутые возможности
 
 ### Кэширование сущностей

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "megaplan-sdk"
-version = "0.2.3"
+version = "0.3.0"
 description = "Professional Python SDK for Megaplan API v3"
 readme = "README.md"
 requires-python = ">=3.11"

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk/__init__.py

@@ -42,6 +42,11 @@ from megaplan_sdk.models.filter import (
     UserSetting,
 )
 from megaplan_sdk.models.group import Group
+from megaplan_sdk.models.knowledge import (
+    KnowledgeArticle,
+    KnowledgeBase,
+    KnowledgeSectionWithArticles,
+)
 from megaplan_sdk.models.milestone import Milestone
 from megaplan_sdk.models.participant import Participant, parse_participant, parse_participants
 from megaplan_sdk.models.project import Project, ProjectFullDetails
@@ -75,6 +80,9 @@ __all__ = [
     "Department",
     "Group",
     "Milestone",
+    "KnowledgeBase",
+    "KnowledgeArticle",
+    "KnowledgeSectionWithArticles",
     "Participant",
     "parse_participant",
     "parse_participants",
@@ -106,4 +114,4 @@ __all__ = [
     "DEFAULT_TASK_LIST_FIELDS",
 ]
 
-__version__ = "0.2.3"
+__version__ = "0.3.0"

megaplan_sdk-0.3.0/src/megaplan_sdk/_knowledge_links.py

@@ -0,0 +1,26 @@
+"""HTML link parsing for Knowledge Base article discovery.
+
+EXPERIMENTAL / FRAGILE: this module is the single place coupled to Megaplan's
+HTML format. The Megaplan API has no endpoint to list articles in a section,
+so article IDs are discovered by parsing ``/knowledge/<section>/<article>``
+links inside a section's HTML ``content``.
+"""
+
+import re
+
+# Matches /knowledge/<section_id> and /knowledge/<section_id>/<article_id>
+# inside href values; scheme/host-agnostic (absolute or relative URLs).
+_KNOWLEDGE_LINK_RE = re.compile(r"/knowledge/(\d+)(?:/(\d+))?")
+
+
+def extract_article_ids(html: str | None) -> list[int]:
+    """Extract article IDs from two-segment ``/knowledge/<section>/<article>`` links.
+
+    Single-segment ``/knowledge/<section>`` links (section references, e.g. a
+    table of contents) are ignored. Returns unique IDs in first-seen order.
+    """
+    seen: dict[int, None] = {}
+    for _section, article in _KNOWLEDGE_LINK_RE.findall(html or ""):
+        if article:
+            seen.setdefault(int(article), None)
+    return list(seen)

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk/client.py

@@ -13,6 +13,8 @@ from megaplan_sdk.resources.deals import DealsResource
 from megaplan_sdk.resources.departments import DepartmentsResource
 from megaplan_sdk.resources.employees import EmployeesResource
 from megaplan_sdk.resources.filters import FiltersResource
+from megaplan_sdk.resources.knowledge_article import KnowledgeArticleResource
+from megaplan_sdk.resources.knowledge_base import KnowledgeBaseResource
 from megaplan_sdk.resources.projects import ProjectsResource
 from megaplan_sdk.resources.tasks import TasksResource
 
@@ -119,6 +121,10 @@ class MegaplanClient:
         self.employees = EmployeesResource(self._http, cache=self._cache)
         self.departments = DepartmentsResource(self._http, cache=self._cache)
         self.filters = FiltersResource(self._http, cache=self._cache)
+        self.knowledge_article = KnowledgeArticleResource(self._http, cache=self._cache)
+        self.knowledge_base = KnowledgeBaseResource(
+            self._http, cache=self._cache, article_resource=self.knowledge_article
+        )
 
         # Security: Store password only for initial authentication if provided
         self._initial_password = password if (username and password) else None

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk/constants.py

@@ -15,6 +15,8 @@ class ContentType:
     DEPARTMENT = "Department"
     COMMENT = "Comment"
     GROUP = "Group"
+    KNOWLEDGE_BASE = "KnowledgeBase"
+    KNOWLEDGE_ARTICLE = "KnowledgeArticle"
 
 
 # Task fields users commonly try to sort by that the Megaplan API rejects (422).

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk/models/__init__.py

@@ -4,6 +4,11 @@ from megaplan_sdk.models.base import BaseEntity
 from megaplan_sdk.models.common import File, Meta, Pagination, SortField
 from megaplan_sdk.models.deal import Deal, ProgramState, TradeFilter
 from megaplan_sdk.models.group import Group
+from megaplan_sdk.models.knowledge import (
+    KnowledgeArticle,
+    KnowledgeBase,
+    KnowledgeSectionWithArticles,
+)
 from megaplan_sdk.models.participant import Participant, parse_participant, parse_participants
 from megaplan_sdk.models.project import Project, ProjectFilter
 from megaplan_sdk.models.task import Task, TaskFilter
@@ -25,4 +30,7 @@ __all__ = [
     "Participant",
     "parse_participant",
     "parse_participants",
+    "KnowledgeBase",
+    "KnowledgeArticle",
+    "KnowledgeSectionWithArticles",
 ]

megaplan_sdk-0.3.0/src/megaplan_sdk/models/knowledge.py

@@ -0,0 +1,56 @@
+"""Knowledge Base models for Megaplan SDK."""
+
+from pydantic import BaseModel, ConfigDict, Field
+
+from megaplan_sdk.models.base import BaseEntity
+from megaplan_sdk.models.common import DateTime
+
+
+class KnowledgeBase(BaseEntity):
+    """Knowledge Base section.
+
+    The list endpoint returns a trimmed object (no ``content`` /
+    ``last_updated`` / ``is_dropped``); ``knowledge_base.get(id)`` returns
+    the full object including the HTML ``content``.
+    """
+
+    content_type: str = Field(alias="contentType", default="KnowledgeBase")
+    content: str | None = None  # HTML, present only in the full get() response
+    access_role: str | None = Field(alias="accessRole", default=None)
+    last_updated: DateTime | None = Field(alias="lastUpdated", default=None)
+    last_update_by: BaseEntity | None = Field(alias="lastUpdateBy", default=None)
+    order_pos: int | None = Field(alias="orderPos", default=None)
+    expanded: bool | None = None
+    is_dropped: bool | None = Field(alias="isDropped", default=None)
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class KnowledgeArticle(BaseEntity):
+    """Knowledge Base article.
+
+    NOTE: ``parent`` is ALWAYS null in the Megaplan API — use ``base`` (the
+    parent section reference) to determine which section the article belongs to.
+    """
+
+    content_type: str = Field(alias="contentType", default="KnowledgeArticle")
+    content: str | None = None  # HTML body
+    parent: BaseEntity | None = None  # always null in API; use `base`
+    base: KnowledgeBase | None = None  # the real parent-section link
+    access_role: str | None = Field(alias="accessRole", default=None)
+    last_updated: DateTime | None = Field(alias="lastUpdated", default=None)
+    last_update_by: BaseEntity | None = Field(alias="lastUpdateBy", default=None)
+    order_pos: int | None = Field(alias="orderPos", default=None)
+    expanded: bool | None = None
+    is_dropped: bool | None = Field(alias="isDropped", default=None)
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+
+class KnowledgeSectionWithArticles(BaseModel):
+    """Composite returned by the experimental ``get_with_articles`` helper."""
+
+    section: KnowledgeBase
+    articles: list[KnowledgeArticle]
+
+    model_config = ConfigDict(populate_by_name=True, extra="allow")

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk/resources/base.py

@@ -521,6 +521,8 @@ class BaseResource:
             "contractorCompany": ContentType.CONTRACTOR_COMPANY,
             "contractorHuman": ContentType.CONTRACTOR_HUMAN,
             "comment": ContentType.COMMENT,
+            "knowledgeBase": ContentType.KNOWLEDGE_BASE,
+            "knowledgeArticle": ContentType.KNOWLEDGE_ARTICLE,
         }
 
         result = mapping.get(entity_type)

megaplan_sdk-0.3.0/src/megaplan_sdk/resources/knowledge_article.py

@@ -0,0 +1,28 @@
+"""Knowledge Base article resource for Megaplan API."""
+
+from megaplan_sdk.models.knowledge import KnowledgeArticle
+from megaplan_sdk.resources.base import BaseResource
+
+
+class KnowledgeArticleResource(BaseResource):
+    """Resource for Knowledge Base articles.
+
+    Only ``get(id)`` is supported: the Megaplan API has NO endpoint to list
+    articles (``GET /api/v3/knowledgeArticle`` returns 404). To discover the
+    articles of a section, use ``client.knowledge_base.get_with_articles()``.
+    """
+
+    async def get(self, article_id: int, use_cache: bool = True) -> KnowledgeArticle:
+        """Get a Knowledge Base article by ID.
+
+        Args:
+            article_id: Article identifier.
+            use_cache: Whether to use the entity cache (default: True).
+
+        Returns:
+            The article, including its ``base`` (parent section) reference.
+            Note: ``article.parent`` is always None in the API — use ``base``.
+        """
+        return await self._get_entity_cached(
+            "knowledgeArticle", article_id, KnowledgeArticle, use_cache=use_cache
+        )

megaplan_sdk-0.3.0/src/megaplan_sdk/resources/knowledge_base.py

@@ -0,0 +1,149 @@
+"""Knowledge Base section resource for Megaplan API."""
+
+from __future__ import annotations
+
+import asyncio
+from collections.abc import AsyncIterator
+from typing import TYPE_CHECKING, Any
+
+from megaplan_sdk._knowledge_links import extract_article_ids
+from megaplan_sdk.http_client import HTTPClient
+from megaplan_sdk.logging_config import logger
+from megaplan_sdk.models.knowledge import (
+    KnowledgeArticle,
+    KnowledgeBase,
+    KnowledgeSectionWithArticles,
+)
+from megaplan_sdk.resources.base import BaseResource
+from megaplan_sdk.resources.knowledge_article import KnowledgeArticleResource
+
+if TYPE_CHECKING:
+    from megaplan_sdk.cache import EntityCache
+
+
+class KnowledgeBaseResource(BaseResource):
+    """Resource for Knowledge Base sections.
+
+    Provides ``get`` / ``list`` / ``iterate`` over the working endpoints, plus
+    the experimental ``get_with_articles`` helper.
+
+    NOTE: the server-side ``parent`` filter on ``GET /api/v3/knowledgeBase`` is
+    ignored and sections are flat (no hierarchy), so ``list`` exposes no
+    ``parent`` parameter. The real hierarchy is section -> articles via
+    ``KnowledgeArticle.base``.
+    """
+
+    def __init__(
+        self,
+        http_client: HTTPClient,
+        cache: EntityCache | None = None,
+        article_resource: KnowledgeArticleResource | None = None,
+    ) -> None:
+        super().__init__(http_client, cache=cache)
+        # Reused for get_with_articles; falls back to a self-built one (shared cache).
+        self._article_resource = article_resource or KnowledgeArticleResource(
+            http_client, cache=cache
+        )
+
+    async def get(self, section_id: int, use_cache: bool = True) -> KnowledgeBase:
+        """Get a Knowledge Base section by ID (full object, including HTML content).
+
+        Args:
+            section_id: Section identifier.
+            use_cache: Whether to use the entity cache (default: True).
+
+        Returns:
+            Full KnowledgeBase section including HTML content.
+        """
+        return await self._get_entity_cached(
+            "knowledgeBase", section_id, KnowledgeBase, use_cache=use_cache
+        )
+
+    async def list(
+        self,
+        limit: int | None = None,
+        page_after: dict[str, Any] | None = None,
+        page_before: dict[str, Any] | None = None,
+        page_with: dict[str, Any] | None = None,
+    ) -> list[KnowledgeBase]:
+        """Get the flat list of Knowledge Base sections.
+
+        The API has no working ``parent`` filter and sections have no
+        hierarchy, so all sections are returned as a flat list.
+
+        Args:
+            limit: Number of items per page.
+            page_after: Load page starting from this entity.
+            page_before: Load page strictly before this entity.
+            page_with: Load page containing this entity.
+
+        Returns:
+            List of KnowledgeBase sections.
+        """
+        path = self._build_path("api", "v3", "knowledgeBase")
+        params = self._build_list_params(
+            limit=limit,
+            page_after=page_after,
+            page_before=page_before,
+            page_with=page_with,
+        )
+        return await self._get_list(path, KnowledgeBase, params)
+
+    async def iterate(self, limit: int = 100, **kwargs: Any) -> AsyncIterator[KnowledgeBase]:
+        """Iterate over all Knowledge Base sections with automatic pagination.
+
+        Args:
+            limit: Number of items per page.
+            **kwargs: Additional parameters to pass to list().
+
+        Yields:
+            KnowledgeBase section objects.
+        """
+        section: KnowledgeBase
+        async for section in self._iterate_generic(  # type: ignore[valid-type]
+            "KnowledgeBase",
+            self.list,
+            limit,
+            **kwargs,
+        ):
+            yield section
+
+    async def get_with_articles(
+        self, section_id: int, use_cache: bool = True
+    ) -> KnowledgeSectionWithArticles:
+        """Get a section together with its articles (EXPERIMENTAL).
+
+        The Megaplan API has no endpoint to list a section's articles, so this
+        discovers them by parsing ``/knowledge/<section>/<article>`` links in
+        the section's HTML ``content`` and fetching each article. Only articles
+        whose ``base.id`` equals ``section_id`` are kept (so a table-of-contents
+        section cannot pull in unrelated articles). Individual article failures
+        are skipped with a warning.
+
+        FRAGILE: depends on Megaplan's HTML link format. If the format changes,
+        ``articles`` may come back empty even when the section has articles.
+
+        Args:
+            section_id: Section identifier.
+            use_cache: Whether to use the entity cache (default: True).
+
+        Returns:
+            KnowledgeSectionWithArticles with section and its filtered articles.
+        """
+        section = await self.get(section_id, use_cache=use_cache)
+        article_ids = extract_article_ids(section.content)
+
+        fetched = await asyncio.gather(
+            *(self._article_resource.get(aid, use_cache=use_cache) for aid in article_ids),
+            return_exceptions=True,
+        )
+
+        articles: list[KnowledgeArticle] = []
+        for aid, result in zip(article_ids, fetched, strict=True):
+            if isinstance(result, BaseException):
+                logger.warning("Failed to load knowledge article %s: %s", aid, result)
+                continue
+            if result.base is not None and result.base.id == section_id:
+                articles.append(result)
+
+        return KnowledgeSectionWithArticles(section=section, articles=articles)

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0/src/megaplan_sdk.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: megaplan-sdk
-Version: 0.2.3
+Version: 0.3.0
 Summary: Professional Python SDK for Megaplan API v3
 Author-email: Maxim Borzov <max@borzov.com>
 License-Expression: MIT
@@ -67,6 +67,7 @@ Dynamic: license-file
 - [Задачи](#работа-с-задачами)
 - [Проекты](#работа-с-проектами)
 - [Сделки](#работа-со-сделками)
+- [База знаний](#работа-с-базой-знаний)
 
 ### Продвинутые возможности
 - [Кэширование сущностей](#кэширование-сущностей)
@@ -1123,6 +1124,45 @@ details = await client.deals.get_full_details(
 
 > **Примечание:** Общее описание метода `get_full_details()` и примеры использования см. в разделе [Общие паттерны работы с сущностями](#общие-паттерны-работы-с-сущностями).
 
+## Работа с базой знаний
+
+SDK предоставляет доступ к разделам и статьям Базы знаний Мегаплана через два ресурса: `client.knowledge_base` (разделы) и `client.knowledge_article` (статьи).
+
+```python
+# Список разделов Базы знаний (плоский)
+sections = await client.knowledge_base.list()
+for s in sections:
+    print(s.id, s.name)
+
+# Один раздел с HTML-содержимым
+section = await client.knowledge_base.get(11)
+print(section.content)
+
+# Итерация по всем разделам с автопагинацией
+async for section in client.knowledge_base.iterate():
+    print(section.id, section.name)
+
+# Статья по ID (parent всегда None — используйте base)
+article = await client.knowledge_article.get(33)
+print(article.name, "→ раздел:", article.base.name if article.base else None)
+
+# Экспериментально: раздел вместе со статьями (через парсинг HTML-ссылок)
+bundle = await client.knowledge_base.get_with_articles(2)
+for a in bundle.articles:
+    print(a.id, a.name)
+```
+
+> **Известные ограничения API (серверная сторона):**
+>
+> - **Нет листинга статей:** эндпоинт `GET /api/v3/knowledgeArticle` отсутствует (возвращает 404).
+>   Единственный способ обнаружения статей в разделе — метод `get_with_articles()`, который
+>   парсит HTML-ссылки из поля `content` раздела. Это **экспериментальный** и хрупкий метод —
+>   формат ссылок может измениться на стороне сервера.
+> - **Фильтр `parent` не работает:** `knowledge_base.list()` всегда возвращает плоский список
+>   всех разделов; передача `parent` в фильтре игнорируется сервером. Иерархии разделов нет.
+> - **Поле `parent` у статьи всегда `null`:** для определения принадлежности статьи к разделу
+>   используйте `article.base` (не `article.parent`).
+
 ## Продвинутые возможности
 
 ### Кэширование сущностей

{megaplan_sdk-0.2.3 → megaplan_sdk-0.3.0}/src/megaplan_sdk.egg-info/SOURCES.txt

@@ -2,6 +2,7 @@ LICENSE
 README.md
 pyproject.toml
 src/megaplan_sdk/__init__.py
+src/megaplan_sdk/_knowledge_links.py
 src/megaplan_sdk/auth.py
 src/megaplan_sdk/cache.py
 src/megaplan_sdk/client.py
@@ -27,6 +28,7 @@ src/megaplan_sdk/models/department.py
 src/megaplan_sdk/models/employee.py
 src/megaplan_sdk/models/filter.py
 src/megaplan_sdk/models/group.py
+src/megaplan_sdk/models/knowledge.py
 src/megaplan_sdk/models/milestone.py
 src/megaplan_sdk/models/participant.py
 src/megaplan_sdk/models/project.py
@@ -41,5 +43,7 @@ src/megaplan_sdk/resources/departments.py
 src/megaplan_sdk/resources/employees.py
 src/megaplan_sdk/resources/filters.py
 src/megaplan_sdk/resources/full_details.py
+src/megaplan_sdk/resources/knowledge_article.py
+src/megaplan_sdk/resources/knowledge_base.py
 src/megaplan_sdk/resources/projects.py
 src/megaplan_sdk/resources/tasks.py