python-telegram-bot-pagination 0.0.1

Python inline keyboard pagination for Telegram Bot API

python-telegram-bot-pagination

Provide easy way for create number pagination with inline keyboard for telegram bot on python.

Simple example

Installation

pip install python-telegram-bot-pagination

Usage

    from telegram_bot_pagination import InlineKeyboardPaginator

    paginator = InlineKeyboardPaginator(
        page_count,
        current_page=page,
        data_pattern='page#{page}'
    )

    bot.send_message(
        chat_id,
        text,
        reply_markup=paginator.markup,
    )

Init arguments:

• page_count - integer, total 1-based pages count.
• current_page - integer, 1-based current page. Default 1
• data_pattern - string with python style formatting named argument 'page'. Used for generate callback data for button. Default '{page}'

Properties:

• markup - json object for InlineKeyboardMarkup TelegramAPI type
• keyboard - array of button's dist

Button render controlling:

For edit button render, use paginator object properties:

• first_page_label
• previous_page_label
• current_page_label
• next_page_label
• last_page_label

All of them can by python style formatting string with one arg, or simple string.

For example:

class MyPaginator(InlineKeyboardPaginator):
    first_page_label = '<<'
    previous_page_label = '<'
    current_page_label = '-{}-'
    next_page_label = '>'
    last_page_label = '>>'

paginator = MyPaginator(page_count)

Result: