# FSM-on-dynamodb
<a href="https://opensource.org/license/MIT"><img src="https://img.shields.io/badge/license-MIT-green.svg?logo=mit&logoColor=f5f5f5" alt="MIT-license"></a>
<a href="https://github.com/general-soldatov/FSM-on-dynamodb/"><img src="https://img.shields.io/badge/dynamo-fsm-blue.svg?logo=telegram&logoColor=f5f5f5" alt="dynamo-fsm"></a>
<img src="https://img.shields.io/badge/python-3.9%7C3.10%7C3.11-blue?logo=python&logoColor=f5f5f5" alt="Python" />
<a href="https://github.com/aiogram/aiogram/blob/dev-3.x/"><img src="https://img.shields.io/badge/aiogram-3.10-blue.svg?logo=telegram&logoColor=blue" alt="dynamo-fsm"></a>
<img src="https://img.shields.io/badge/boto3-dynamodb-green.svg?logo=" alt="dynamodb-boto3">
Надстройка над `aiogram` для организации FSM (finite-state-machine) на базе базы данных dynamodb с использованием библиотеки boto3 & botocore. Может быть использована на serverless-решениях AWS и YandexCloud. Установить библиотеку можно с помощью команды:
```bash
pip install dynamodb-fsm
```
В GUI облачной панели управления или с помощью CLI создайте динамическую serverless базу данных и сервисный аккаунт с ключом. Для пользователей YandexCloud можете воспользоваться [документацией](https://yandex.cloud/ru/docs/ydb/quickstart).
Для корректной работы библиотеки `boto3` используется dataclass c переменными окружения, поэтому не забудьте внести следующую информацию в файл `.env`
```BASH
ENDPOINT='url_endpoint'
REGION_NAME='ru-central1'
AWS_ACCESS_KEY_ID='key_id'
AWS_SECRET_ACCESS_KEY='access_key_db'
```
В случае использования собственной конфигурации рекомендуется реализовать следующий код:
```python
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` используйте следующий пример кода:
```python
from dynamodb_fsm import FSMDynamodb
...
storage = FSMDynamodb()
dp = Dispatcher(storage=storage)
```
Актуальная информация о функциях надстройки есть в репозитории [dynamodb-fsm](https://github.com/general-soldatov/FSM-on-dynamodb/tree/main)
Raw data
{
"_id": null,
"home_page": null,
"name": "dynamodb-fsm",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "FSM, aiogram, asyncio, bot, dynamodb, finite-state-machine, ydb",
"author": null,
"author_email": "Yury Soldatov <general-soldatov@mail.ru>",
"download_url": "https://files.pythonhosted.org/packages/cb/4d/7388a3728ab98edcb366f3468b1a8e545f606de976cb43445dbcfdba281b/dynamodb_fsm-0.0.2.tar.gz",
"platform": null,
"description": "# FSM-on-dynamodb\n\n<a href=\"https://opensource.org/license/MIT\"><img src=\"https://img.shields.io/badge/license-MIT-green.svg?logo=mit&logoColor=f5f5f5\" alt=\"MIT-license\"></a>\n<a href=\"https://github.com/general-soldatov/FSM-on-dynamodb/\"><img src=\"https://img.shields.io/badge/dynamo-fsm-blue.svg?logo=telegram&logoColor=f5f5f5\" alt=\"dynamo-fsm\"></a>\n<img src=\"https://img.shields.io/badge/python-3.9%7C3.10%7C3.11-blue?logo=python&logoColor=f5f5f5\" alt=\"Python\" />\n<a href=\"https://github.com/aiogram/aiogram/blob/dev-3.x/\"><img src=\"https://img.shields.io/badge/aiogram-3.10-blue.svg?logo=telegram&logoColor=blue\" alt=\"dynamo-fsm\"></a>\n<img src=\"https://img.shields.io/badge/boto3-dynamodb-green.svg?logo=\" alt=\"dynamodb-boto3\">\n\n\u041d\u0430\u0434\u0441\u0442\u0440\u043e\u0439\u043a\u0430 \u043d\u0430\u0434 `aiogram` \u0434\u043b\u044f \u043e\u0440\u0433\u0430\u043d\u0438\u0437\u0430\u0446\u0438\u0438 FSM (finite-state-machine) \u043d\u0430 \u0431\u0430\u0437\u0435 \u0431\u0430\u0437\u044b \u0434\u0430\u043d\u043d\u044b\u0445 dynamodb \u0441 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u0435\u043c \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 boto3 & botocore. \u041c\u043e\u0436\u0435\u0442 \u0431\u044b\u0442\u044c \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0430 \u043d\u0430 serverless-\u0440\u0435\u0448\u0435\u043d\u0438\u044f\u0445 AWS \u0438 YandexCloud. \u0423\u0441\u0442\u0430\u043d\u043e\u0432\u0438\u0442\u044c \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0443 \u043c\u043e\u0436\u043d\u043e \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e \u043a\u043e\u043c\u0430\u043d\u0434\u044b:\n```bash\npip install dynamodb-fsm\n```\n\u0412 GUI \u043e\u0431\u043b\u0430\u0447\u043d\u043e\u0439 \u043f\u0430\u043d\u0435\u043b\u0438 \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u0438\u043b\u0438 \u0441 \u043f\u043e\u043c\u043e\u0449\u044c\u044e CLI \u0441\u043e\u0437\u0434\u0430\u0439\u0442\u0435 \u0434\u0438\u043d\u0430\u043c\u0438\u0447\u0435\u0441\u043a\u0443\u044e serverless \u0431\u0430\u0437\u0443 \u0434\u0430\u043d\u043d\u044b\u0445 \u0438 \u0441\u0435\u0440\u0432\u0438\u0441\u043d\u044b\u0439 \u0430\u043a\u043a\u0430\u0443\u043d\u0442 \u0441 \u043a\u043b\u044e\u0447\u043e\u043c. \u0414\u043b\u044f \u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u0435\u043b\u0435\u0439 YandexCloud \u043c\u043e\u0436\u0435\u0442\u0435 \u0432\u043e\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u0442\u044c\u0441\u044f [\u0434\u043e\u043a\u0443\u043c\u0435\u043d\u0442\u0430\u0446\u0438\u0435\u0439](https://yandex.cloud/ru/docs/ydb/quickstart).\n\u0414\u043b\u044f \u043a\u043e\u0440\u0440\u0435\u043a\u0442\u043d\u043e\u0439 \u0440\u0430\u0431\u043e\u0442\u044b \u0431\u0438\u0431\u043b\u0438\u043e\u0442\u0435\u043a\u0438 `boto3` \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u0442\u0441\u044f dataclass c \u043f\u0435\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c\u0438 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f, \u043f\u043e\u044d\u0442\u043e\u043c\u0443 \u043d\u0435 \u0437\u0430\u0431\u0443\u0434\u044c\u0442\u0435 \u0432\u043d\u0435\u0441\u0442\u0438 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0443\u044e \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u0432 \u0444\u0430\u0439\u043b `.env`\n```BASH\nENDPOINT='url_endpoint'\nREGION_NAME='ru-central1'\nAWS_ACCESS_KEY_ID='key_id'\nAWS_SECRET_ACCESS_KEY='access_key_db'\n```\n\u0412 \u0441\u043b\u0443\u0447\u0430\u0435 \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u043e\u0432\u0430\u043d\u0438\u044f \u0441\u043e\u0431\u0441\u0442\u0432\u0435\u043d\u043d\u043e\u0439 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u0440\u0435\u043a\u043e\u043c\u0435\u043d\u0434\u0443\u0435\u0442\u0441\u044f \u0440\u0435\u0430\u043b\u0438\u0437\u043e\u0432\u0430\u0442\u044c \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u043a\u043e\u0434:\n\n```python\nfrom dynamodb_fsm import FSMDynamodb\n\n...\n\n@dataclass\nclass DatabaseConfig:\n endpoint_url: str = 'ENDPOINT'\n region_name: str = 'REGION_NAME'\n aws_access_key_id: str = 'AWS_ACCESS_KEY_ID'\n aws_secret_access_key: str = 'AWS_SECRET_ACCESS_KEY'\n\n\nconfig = DatabaseConfig().__dict__\nstorage = FSMDynamodb(config=config)\n```\n\u0414\u043b\u044f \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u0445\u0440\u0430\u043d\u0438\u043b\u0438\u0449\u0430 \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u0439 \u043a \u0434\u0438\u0441\u043f\u0435\u0442\u0447\u0435\u0440\u0443 `aiogram` \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0439\u0442\u0435 \u0441\u043b\u0435\u0434\u0443\u044e\u0449\u0438\u0439 \u043f\u0440\u0438\u043c\u0435\u0440 \u043a\u043e\u0434\u0430:\n\n```python\nfrom dynamodb_fsm import FSMDynamodb\n\n...\n\nstorage = FSMDynamodb()\ndp = Dispatcher(storage=storage)\n```\n\n\u0410\u043a\u0442\u0443\u0430\u043b\u044c\u043d\u0430\u044f \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043e \u0444\u0443\u043d\u043a\u0446\u0438\u044f\u0445 \u043d\u0430\u0434\u0441\u0442\u0440\u043e\u0439\u043a\u0438 \u0435\u0441\u0442\u044c \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 [dynamodb-fsm](https://github.com/general-soldatov/FSM-on-dynamodb/tree/main)\n",
"bugtrack_url": null,
"license": null,
"summary": "FSM storage on dynamo data bases for aiogram 3.10",
"version": "0.0.2",
"project_urls": {
"Contacts": "https://t.me/general_soldatov",
"Documentation": "https://github.com/general-soldatov/FSM-on-dynamodb/tree/main/doc",
"Homepage": "https://github.com/general-soldatov/FSM-on-dynamodb"
},
"split_keywords": [
"fsm",
" aiogram",
" asyncio",
" bot",
" dynamodb",
" finite-state-machine",
" ydb"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "3fc82e4158fa2bbbf9f82508e035e3d43c40f9a247f093eea3a95e6239381ace",
"md5": "8032de83015ff7f0e994d02f552c7eb5",
"sha256": "52456ca9477cf617cae0e4ec0a9f45680c72e7ac8130c72d2f0a7bf1e7df58b1"
},
"downloads": -1,
"filename": "dynamodb_fsm-0.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8032de83015ff7f0e994d02f552c7eb5",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 5213,
"upload_time": "2024-10-05T18:15:56",
"upload_time_iso_8601": "2024-10-05T18:15:56.979327Z",
"url": "https://files.pythonhosted.org/packages/3f/c8/2e4158fa2bbbf9f82508e035e3d43c40f9a247f093eea3a95e6239381ace/dynamodb_fsm-0.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cb4d7388a3728ab98edcb366f3468b1a8e545f606de976cb43445dbcfdba281b",
"md5": "9baeaa240ffe5c18a53794271ebade06",
"sha256": "84f733e3e67237eb25aa673d606427ab0f537e725a303c45b1bdfe1fa575d7c7"
},
"downloads": -1,
"filename": "dynamodb_fsm-0.0.2.tar.gz",
"has_sig": false,
"md5_digest": "9baeaa240ffe5c18a53794271ebade06",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 16867802,
"upload_time": "2024-10-05T18:18:23",
"upload_time_iso_8601": "2024-10-05T18:18:23.657150Z",
"url": "https://files.pythonhosted.org/packages/cb/4d/7388a3728ab98edcb366f3468b1a8e545f606de976cb43445dbcfdba281b/dynamodb_fsm-0.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-05 18:18:23",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "general-soldatov",
"github_project": "FSM-on-dynamodb",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "aiogram",
"specs": [
[
"==",
"3.10.0"
]
]
},
{
"name": "boto3",
"specs": [
[
"==",
"1.34.0"
]
]
},
{
"name": "botocore",
"specs": [
[
"==",
"1.34.0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
"==",
"1.0.1"
]
]
}
],
"lcname": "dynamodb-fsm"
}
JSON
