epoch8-smartfeed 0.2.0

No project description provided

SmartFeed

Python-package для формирования ленты (Feed) из клиентских данных с заданной конфигурацией.

Содержание:

• Использование
  • Установка
  • Формирование конфигурации
  • Требования к клиентскому методу
  • Запуск

Использование

Установка

poetry add git+ssh://[e-mail]:epoch8/looky-timeline.git

Формирование конфигурации

Конфигурация каждого фида должна быть словарем следующего вида:

"version": "1",
"view_session": True or False,
"session_size": 800,  # по умолчанию 100
"session_live_time": 500,  # по умолчанию 300
"feed": {
    "merger_id": "merger_pos",
    "type": "merger_positional",
    "positions": [1, 3, 15],
    "start": 17,
    "end": 200,
    "step": 2,
    "positional": {
        "subfeed_id": "sf_positional",
        "type": "subfeed",
        "method_name": "ads",
        "subfeed_params": {
            "limit_to_return": 10,
        },
    },
    "default": {
        "merger_id": "merger_percent",
        "type": "merger_percentage",
        "shuffle": False,
        "items": [
            {
                "percentage": 40,
                "data": {
                    "subfeed_id": "sf_1_default_merger_of_main",
                    "type": "subfeed",
                    "method_name": "followings",
                },
            },
            {
                "percentage": 60,
                "data": {
                    "subfeed_id": "sf_2_default_merger_of_main",
                    "type": "subfeed",
                    "method_name": "ads",
                    "raise_error": True or False (default = True),
                },
            },
        ],
    },
},

Требования к клиентскому методу

Клиентский метод для получения данных должен обязательно включать в себя следующие параметры:

• user_id: Any - ID объекта, на который ориентируемся при получении данных субфида.
• limit: int - Количество возвращаемых данных.
• next_page: FeedResultNextPageInside - Объект курсора пагинации, формируется на стороне клиента после обработки данных.

Возвращаемый тип данных: FeedResultClient.

Запуск

Для получения ленты с помощью SmartFeed нужно выполнить следующий код:

from smartfeed.manager import FeedManager
from smartfeed.schemas import FeedResult, FeedResultNextPage, FeedResultNextPageInside

from client.services import ClientService

config = {} # получаем конфигурацию фида
methods_dict = {
    "method_1": ClientService().method_1,
    "method_2": ClientService().method_2,
    # и т.д.
}
# для конфигурации view_session = False,
# Redis передавать небязательно
redis_client = redis.Redis()

feed_manager = FeedManager(
    config=config,
    methods_dict=methods_dict,
    redis_client=redis_client,
)

user_id = "sjjdj?" # любой тип данных
limit = 100
next_page = FeedResultNextPage(
    data={
        "subfeed_id": FeedResultNextPageInside(page=1, after=None),
    }
)
data: FeedResult = await feed_manager.get_data(
    user_id=user_id,
    limit=limit,
    next_page=next_page,
)