dynamodb-fsm 0.0.2

FSM storage on dynamo data bases for aiogram 3.10

FSM-on-dynamodb

Надстройка над aiogram для организации FSM (finite-state-machine) на базе базы данных dynamodb с использованием библиотеки boto3 & botocore. Может быть использована на serverless-решениях AWS и YandexCloud. Установить библиотеку можно с помощью команды:

pip install dynamodb-fsm

В GUI облачной панели управления или с помощью CLI создайте динамическую serverless базу данных и сервисный аккаунт с ключом. Для пользователей YandexCloud можете воспользоваться документацией. Для корректной работы библиотеки boto3 используется dataclass c переменными окружения, поэтому не забудьте внести следующую информацию в файл .env

ENDPOINT='url_endpoint'
REGION_NAME='ru-central1'
AWS_ACCESS_KEY_ID='key_id'
AWS_SECRET_ACCESS_KEY='access_key_db'

В случае использования собственной конфигурации рекомендуется реализовать следующий код:

from dynamodb_fsm import FSMDynamodb

...

@dataclass
class DatabaseConfig:
    endpoint_url: str = 'ENDPOINT'
    region_name: str = 'REGION_NAME'
    aws_access_key_id: str = 'AWS_ACCESS_KEY_ID'
    aws_secret_access_key: str = 'AWS_SECRET_ACCESS_KEY'


config = DatabaseConfig().__dict__
storage = FSMDynamodb(config=config)

Для подключения хранилища состояний к диспетчеру aiogram используйте следующий пример кода:

from dynamodb_fsm import FSMDynamodb

...

storage = FSMDynamodb()
dp = Dispatcher(storage=storage)

Актуальная информация о функциях надстройки есть в репозитории dynamodb-fsm