Metadata-Version: 2.1
Name: aiogram-timepicker
Version: 0.2.1
Summary: Time Selection tool for Aiogram Telegram Bots
Author-email: Marat Ashrafzianov <maratashdev@gmail.com>
Project-URL: Homepage, https://github.com/maratx86/aiogram-timepicker
Project-URL: Bug Tracker, https://github.com/maratx86/aiogram-timepicker/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: aiogram~=2.12
Requires-Dist: importlib-metadata; python_version < "3.7"

# Time Selection tool for Aiogram Telegram Bots

## Description
A simple inline time selection tool for [aiogram](https://github.com/aiogram/aiogram) telegram bots written in Python.
Demo: [@aiogram_timepicker_bot](https://t.me/aiogram_timepicker_bot).

Offers 9 types of panel time picker:
* Panel Pickers (`aiogram_timepicker.panel` and `aiogram_timepicker.panel.single`):
* * Full Time Picker - user can select a time with hours, minutes and seconds.
* * Minute & Second Picker - user can select a time with minutes and seconds.
* * Single Hour Picker - user can select a hour.
* * Single Minute Picker - user can select a minute.
* * Single Second Picker - user can select a second.
* Carousel Pickers (`aiogram_timepicker.carousel`):
* * Full Time Picker - user can select a time with hours, minutes and seconds with carousel.
* Clock Pickers (`aiogram_timepicker.clock`):
* * c24 - user can select a hour between 0 and 24.
* * c24_ts3 - user can select a minute/second between 0 and 57 with 3 timestamp.
* * c60_ts5 - user can select a minute/second between 0 and 55 with 5 timestamp.

## Usage
Install package with pip

        pip install aiogram_timepicker

A full working example on how to use aiogram-timepicker is provided in *bot_example.py*. 
You create a timepicker panel and add it to a message with a *reply_markup* parameter, and then you can process it in a `callbackqueyhandler` method using the *process_selection* method.

## Demo
Code example is [**examples/simple_aiogram_2.12_bot.py**](./examples/simple_aiogram_2.12_bot.py) and demo use [@aiogram_timepicker_bot](https://t.me/aiogram_timepicker_bot).


## Licence
Read more about licence [here](./LICENSE.txt).
