Forms for aiogram
Project description
aiogram-forms
Introduction
aiogram-forms
is an addition for aiogram
which allows you to create different forms and process user input step by step easily.
Installation
pip install aiogram-forms
Usage
Create form you need by subclassing aiogram_forms.forms.Form
. Fields can be added with aiogram_forms.fields.Field
. For more examples refer to examples
folder.
class UserProfileForm(forms.Form):
"""Example of user details form."""
# Simple field usage
name = fields.StringField('Name')
# Using custom validators
username = fields.StringField(
'Username', validators=[validators.RegexValidator(r'^[a-z0-9_-]{3,15}$')]
)
# Custom reply keyboard with validation
language = fields.ChoicesField(
'Language', LANGUAGE_CHOICES, reply_keyboard=LANGUAGE_KEYBOARD
)
# Custom validation message
email = fields.EmailField(
'Email', validation_error_message='Wrong email format!'
)
# Allow user to share contact as reply
phone = fields.PhoneNumberField(
'Phone', share_contact=True, share_contact_label='Share your contact'
)
History
All notable changes to this project will be documented in CHANGELOG file.
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
aiogram_forms-0.3.0.tar.gz
(6.3 kB
view hashes)
Built Distribution
Close
Hashes for aiogram_forms-0.3.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | b90e145a62636309aea1a43137d34685c53393a92d10e3ba61f6538b5fd3bb97 |
|
MD5 | f4069d84feadacc9ef136a28223cfe06 |
|
BLAKE2b-256 | 95428b632fd1d7fe360ebe33386eacbd0bc79e3bb74bb6be073f5398d10c6b4e |