Skip to main content

Python inline calendar for telegram bots

Project description

python-telegram-bot-calendar

PyPI version CodeFactor cock

Very simple inline calendar for your bot.

Getting Started

This library is tested on Python 3.6 and 3.7.

Installation

pip install python-telegram-bot-calendar

Usage

There is one main class - DetailedTelegramCalendar that can be used as follows. This is the example for pyTelegramBotAPI library. Other libraries are also supported.

from telegram_bot_calendar import DetailedTelegramCalendar, LSTEP

...
@bot.message_handler(commands=['start'])
def start(m):
    calendar, step = DetailedTelegramCalendar().build()
    bot.send_message(m.chat.id,
                     f"Select {LSTEP[step]}",
                     reply_markup=calendar)


@bot.callback_query_handler(func=DetailedTelegramCalendar.func())
def cal(c):
    result, key, step = DetailedTelegramCalendar().process(c.data)
    if not result and key:
        bot.edit_message_text(f"Select {LSTEP[step]}",
                              c.message.chat.id,
                              c.message.message_id,
                              reply_markup=key)
    elif result:
        bot.edit_message_text(f"You selected {result}",
                              c.message.chat.id,
                              c.message.message_id)

In start handler the calendar is created. Several arguments can be passed:

  • calendar_id - small integer or string, used for calendar identification. It used when you need several different calendars (default - 0)
  • current_date - datetime.date object, initial date value (default - today date)
  • additional_buttons - 1D list of buttons that will be added to the bottom of the calendar
  • locale - either en, ru, or eo, can be added more
  • min_date and max_date - both are used as min and max values for the calendar

As you can see, special function that is provided should be passed to callback query handler. It will automatically work. The function takes only one argument - calendar_id that is 0 by default.

In the body of the handler function you need to call process function on callback data. WARNING! You need to create the calendar object again if it was not saved before.

The function process return tuple of size 3 - result, keyboard, step.

  • result - datetime.date object if user finished selecting. Otherwise None
  • keyboard - inline keyboard markup if the result is not ready. Otherwise None
  • step - YEAR, MONTH, or DAY if not ready. None is also possible if there is no change in keyboard.

Advanced use

Several calendars

You can create as many calendars as you want. However, in order to handle them properly set different calendar_id's when you want to distinguish them. Take a look at examples.

Date ranges

In the class constructor min_date and max_date - both are used as min and max values for the calendar. If you add them, the calendar will not show undesired dates. Example: 3

Custom style

You can also write your own code. One of the examples is redefining the steps order.

In the package you can find WMonthTelegramCalendar and WYearTelegramCalendar that start from day and month selecting, not from year.

You can also redefine style parameters. Example:

class MyStyleCalendar(DetailedTelegramCalendar):
    # previous and next buttons style. they are emoji now!
    prev_button = "⬅️"
    next_button = "➡️"
    # you do not want empty cells when month and year are being selected
    empty_month_button = ""
    empty_year_button = ""

You will get:

4

Custom Translation

your_translation_months = list('abcdefghijkl')
your_translation_days_of_week = list('yourtra')

class MyTranslationCalendar(DetailedTelegramCalendar):
    def __init__(self, **kwargs):
        super().__init__(**kwargs)
        self.days_of_week['yourtransl'] = your_translation_days_of_week
        self.months['yourtransl'] = your_translation_months

5

Examples

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

  1. Fork the Project
  2. Create your Feature Branch (git checkout -b feature/yourFeature)
  3. Commit your Changes (git commit -m 'Add some yourFeature')
  4. Push to the Branch (git push origin feature/yourFeature)
  5. Open a Pull Request

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python-telegram-bot-calendar-1.0.5.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

File details

Details for the file python-telegram-bot-calendar-1.0.5.tar.gz.

File metadata

  • Download URL: python-telegram-bot-calendar-1.0.5.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1

File hashes

Hashes for python-telegram-bot-calendar-1.0.5.tar.gz
Algorithm Hash digest
SHA256 b1536021edc6d9ed8976ecb2f20869d9558ce946e10e01c8c8b66444757d70f7
MD5 137f3590d30018cea6e2963952df2c75
BLAKE2b-256 87d70b80bbdc4030c492f7d95499fe2a649905155b795fcee2841f51a3fec02c

See more details on using hashes here.

File details

Details for the file python_telegram_bot_calendar-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: python_telegram_bot_calendar-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 10.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.56.0 CPython/3.9.1

File hashes

Hashes for python_telegram_bot_calendar-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 2d4ce5aefcb54629b9f3189d9f0ca2a0ff3cdf763d6a986f581ffbc2b967bd4d
MD5 fcd01de2df66e8d521b01cadacd37019
BLAKE2b-256 92aa5c37e79a487e803a1f4b195c8a8c2ba23a663968370b7f8d4497ecebd6a2

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page