معرفی شرکت ها
dff-0.4.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
The Dialog Flow Framework (DFF) allows you to write conversational services.
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | dff-0.4.1 |
| نام | dff |
| نسخه کتابخانه | 0.4.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Denis Kuznetsov |
| ایمیل نویسنده | kuznetsov.den.p@gmail.com |
| آدرس صفحه اصلی | https://github.com/deeppavlov/dialog_flow_framework |
| آدرس اینترنتی | https://pypi.org/project/dff/ |
| مجوز | - |
# Dialog Flow Framework
The Dialog Flow Framework (DFF) allows you to write conversational services.
The service is written by defining a special dialog graph that describes the behavior of the dialog service.
The dialog graph contains the dialog script. DFF offers a specialized language (DSL) for quickly writing dialog graphs.
You can use it in services such as writing skills for Amazon Alexa, etc., chatbots for social networks, website call centers, etc.
[](https://deeppavlov.github.io/dialog_flow_framework)
[](https://github.com/deeppavlov/dialog_flow_framework/actions/workflows/codestyle.yml)
[](https://github.com/deeppavlov/dialog_flow_framework/actions/workflows/test_coverage.yml)
[](https://github.com/deeppavlov/dialog_flow_framework/blob/master/LICENSE)
[](https://pypi.org/project/dff/)
[](https://pepy.tech/project/dff)
# Quick Start
## Installation
DFF can be installed via pip:
```bash
pip install dff
```
The above command will set the minimum dependencies to start working with DFF.
The installation process allows the user to choose from different packages based on their dependencies, which are:
```bash
pip install dff[core] # minimal dependencies (by default)
pip install dff[json] # dependencies for using JSON
pip install dff[pickle] # dependencies for using Pickle
pip install dff[redis] # dependencies for using Redis
pip install dff[mongodb] # dependencies for using MongoDB
pip install dff[mysql] # dependencies for using MySQL
pip install dff[postgresql] # dependencies for using PostgreSQL
pip install dff[sqlite] # dependencies for using SQLite
pip install dff[ydb] # dependencies for using Yandex Database
pip install dff[telegram] # dependencies for using Telegram
pip install dff[full] # full dependencies including all options above
pip install dff[tests] # dependencies for running tests
pip install dff[test_full] # full dependencies for running all tests (all options above)
pip install dff[tutorials] # dependencies for running tutorials (all options above)
pip install dff[devel] # dependencies for development
pip install dff[doc] # dependencies for documentation
pip install dff[devel_full] # full dependencies for development (all options above)
```
For example, if you are going to use one of the database backends,
you can specify the corresponding requirements yourself. Multiple dependencies can be installed at once, e.g.
```bash
pip install dff[postgresql, mysql]
```
## Basic example
```python
from dff.script import GLOBAL, TRANSITIONS, RESPONSE, Context, Message
from dff.pipeline import Pipeline
import dff.script.conditions.std_conditions as cnd
from typing import Tuple
# create a dialog script
script = {
GLOBAL: {
TRANSITIONS: {
("flow", "node_hi"): cnd.exact_match(Message(text="Hi")),
("flow", "node_ok"): cnd.true()
}
},
"flow": {
"node_hi": {RESPONSE: Message(text="Hi!!!")},
"node_ok": {RESPONSE: Message(text="Okey")},
},
}
# init pipeline
pipeline = Pipeline.from_script(script, start_label=("flow", "node_hi"))
# handler requests
def turn_handler(in_request: Message, pipeline: Pipeline) -> Tuple[Message, Context]:
# Pass the next request of user into pipeline and it returns updated context with actor response
ctx = pipeline(in_request, 0)
# Get last actor response from the context
out_response = ctx.last_response
# The next condition branching needs for testing
return out_response, ctx
while True:
in_request = input("type your answer: ")
out_response, ctx = turn_handler(Message(text=in_request), pipeline)
print(out_response.text)
```
When you run this code, you get similar output:
```
type your answer: hi
Okey
type your answer: Hi
Hi!!!
type your answer: ok
Okey
type your answer: ok
Okey
```
To get more advanced examples, take a look at
[tutorials](https://github.com/deeppavlov/dialog_flow_framework/tree/dev/tutorials) on GitHub.
# Context Storages
## Description
Context Storages allow you to save and retrieve user dialogue states
(in the form of a `Context` object) using various database backends.
The following backends are currently supported:
* [JSON](https://www.json.org/json-en.html)
* [pickle](https://docs.python.org/3/library/pickle.html)
* [shelve](https://docs.python.org/3/library/shelve.html)
* [SQLite](https://www.sqlite.org/index.html)
* [PostgreSQL](https://www.postgresql.org/)
* [MySQL](https://www.mysql.com/)
* [MongoDB](https://www.mongodb.com/)
* [Redis](https://redis.io/)
* [Yandex DataBase](https://ydb.tech/)
Aside from this, we offer some interfaces for saving data to your local file system.
These are not meant to be used in production, but can be helpful for prototyping your application.
## Basic example
```python
from dff.script import Context
from dff.pipeline import Pipeline
from dff.context_storages import SQLContextStorage
from .script import some_df_script
db = SQLContextStorage("postgresql+asyncpg://user:password@host:port/dbname")
pipeline = Pipeline.from_script(some_df_script, start_label=("root", "start"), fallback_label=("root", "fallback"))
def handle_request(request):
user_id = request.args["user_id"]
new_context = pipeline(request, user_id)
return new_context.last_response
```
To get more advanced examples, take a look at
[tutorials](https://github.com/deeppavlov/dialog_flow_framework/tree/dev/tutorials/context_storages) on GitHub.
# Contributing to the Dialog Flow Framework
Please refer to [CONTRIBUTING.md](https://github.com/deeppavlov/dialog_flow_framework/blob/dev/CONTRIBUTING.md).
نیازمندی
| مقدار | نام |
|---|---|
| >=1.8.2 | pydantic |
| >=1.5.5 | nest-asyncio |
| >=4.0.0 | typing-extensions |
| >=1.8.2 | pydantic |
| >=1.5.5 | nest-asyncio |
| >=4.0.0 | typing-extensions |
| >=1.0.1 | bump2version |
| ==0.7.0 | build |
| ==4.0.0 | twine |
| ==4.5.1 | pytelegrambotapi |
| >=3.1.1 | motor |
| >=0.12.0 | pydata-sphinx-theme |
| >=1.0.1 | sphinx-favicon |
| >=36.0.2 | cryptography |
| >=1.4.27 | sqlalchemy[asyncio] |
| >=2.0.2 | sqlalchemy[asyncio] |
| <2.0,>=1.27.0 | telethon |
| ==0.9.0 | sphinxcontrib-katex |
| <8.0.0,>=7.2.1 | pytest |
| <0.15.0,>=0.14.0 | pytest-asyncio |
| ==0.950 | mypy |
| <5.0.0,>=4.0.0 | pytest-cov |
| >=1.8.0 | sphinxcontrib-httpdomain |
| >=0.21.1 | uvicorn |
| ~=2.5.0 | ydb |
| >=3.4 | idna |
| >=3.6.2 | anyio |
| >=2.28.1 | requests |
| >=11.0 | websockets |
| ==0.7.0 | build |
| >=4.0.0 | typing-extensions |
| >=1.5.5 | nest-asyncio |
| >=1.14.1 | jupytext |
| >=0.14.0 | h11 |
| >=22.1.0 | aiofiles |
| >=0.8.9 | nbsphinx |
| <4.0.0,>=3.8.3 | flake8 |
| >=1.8.2 | pydantic |
| >=0.18.0 | aiosqlite |
| ==20.8b1 | black |
| ==0.3.0 | sphinxcontrib-apidoc |
| >=0.26.1 | starlette |
| >=1.0.0 | jupyter |
| ==0.7.0 | sphinx-gallery |
| >=1.19.4 | sphinx-autodoc-typehints |
| >=1.16.0 | six |
| >=2.1.2 | flask[async] |
| <6 | sphinx |
| >=5.9.1 | psutil |
| >=2.0.1 | aioredis |
| >=0.5 | sphinx-copybutton |
| >=0.27.0 | asyncpg |
| <6.0.0,>=5.0.6 | isort |
| >=0.2.5 | asyncmy |
| <=8.0.4 | click |
| ==4.0.0 | twine |
| >=0.95.1 | fastapi |
| >=1.3.0 | sniffio |
| >=1.0.1 | bump2version |
| ==0.3.0 | sphinxcontrib-apidoc |
| >=0.5 | sphinx-copybutton |
| >=2.28.1 | requests |
| >=1.8.0 | sphinxcontrib-httpdomain |
| >=0.12.0 | pydata-sphinx-theme |
| >=1.0.0 | jupyter |
| >=1.0.1 | sphinx-favicon |
| >=1.14.1 | jupytext |
| ==0.9.0 | sphinxcontrib-katex |
| >=0.8.9 | nbsphinx |
| ==0.7.0 | sphinx-gallery |
| >=1.19.4 | sphinx-autodoc-typehints |
| <6 | sphinx |
| ==4.5.1 | pytelegrambotapi |
| >=0.27.0 | asyncpg |
| >=3.1.1 | motor |
| >=0.2.5 | asyncmy |
| >=4.0.0 | typing-extensions |
| >=1.5.5 | nest-asyncio |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=1.4.27 | sqlalchemy[asyncio] |
| >=36.0.2 | cryptography |
| >=22.1.0 | aiofiles |
| >=1.16.0 | six |
| >=1.8.2 | pydantic |
| >=0.18.0 | aiosqlite |
| >=2.0.1 | aioredis |
| ~=2.5.0 | ydb |
| >=22.1.0 | aiofiles |
| >=3.1.1 | motor |
| >=36.0.2 | cryptography |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=0.2.5 | asyncmy |
| >=22.1.0 | aiofiles |
| >=0.27.0 | asyncpg |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=2.0.1 | aioredis |
| >=0.18.0 | aiosqlite |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=1.4.27 | sqlalchemy[asyncio] |
| ==4.5.1 | pytelegrambotapi |
| ==4.5.1 | pytelegrambotapi |
| >=3.1.1 | motor |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=1.4.27 | sqlalchemy[asyncio] |
| >=36.0.2 | cryptography |
| <2.0,>=1.27.0 | telethon |
| <8.0.0,>=7.2.1 | pytest |
| <0.15.0,>=0.14.0 | pytest-asyncio |
| <5.0.0,>=4.0.0 | pytest-cov |
| ~=2.5.0 | ydb |
| >=0.21.1 | uvicorn |
| >=3.4 | idna |
| >=3.6.2 | anyio |
| >=2.28.1 | requests |
| >=11.0 | websockets |
| >=4.0.0 | typing-extensions |
| >=1.5.5 | nest-asyncio |
| >=0.14.0 | h11 |
| >=22.1.0 | aiofiles |
| <4.0.0,>=3.8.3 | flake8 |
| >=1.8.2 | pydantic |
| >=0.18.0 | aiosqlite |
| ==20.8b1 | black |
| >=0.26.1 | starlette |
| >=1.16.0 | six |
| >=2.1.2 | flask[async] |
| >=5.9.1 | psutil |
| >=2.0.1 | aioredis |
| >=0.27.0 | asyncpg |
| <6.0.0,>=5.0.6 | isort |
| >=0.2.5 | asyncmy |
| <=8.0.4 | click |
| >=0.95.1 | fastapi |
| >=1.3.0 | sniffio |
| <2.0,>=1.27.0 | telethon |
| <8.0.0,>=7.2.1 | pytest |
| <0.15.0,>=0.14.0 | pytest-asyncio |
| <5.0.0,>=4.0.0 | pytest-cov |
| >=0.21.1 | uvicorn |
| >=3.4 | idna |
| >=3.6.2 | anyio |
| >=2.28.1 | requests |
| >=11.0 | websockets |
| >=0.14.0 | h11 |
| <4.0.0,>=3.8.3 | flake8 |
| ==20.8b1 | black |
| >=0.26.1 | starlette |
| >=2.1.2 | flask[async] |
| >=5.9.1 | psutil |
| <6.0.0,>=5.0.6 | isort |
| <=8.0.4 | click |
| >=0.95.1 | fastapi |
| >=1.3.0 | sniffio |
| ==4.5.1 | pytelegrambotapi |
| >=3.1.1 | motor |
| >=2.0.2 | sqlalchemy[asyncio] |
| >=1.4.27 | sqlalchemy[asyncio] |
| >=36.0.2 | cryptography |
| <2.0,>=1.27.0 | telethon |
| <8.0.0,>=7.2.1 | pytest |
| <0.15.0,>=0.14.0 | pytest-asyncio |
| <5.0.0,>=4.0.0 | pytest-cov |
| ~=2.5.0 | ydb |
| >=0.21.1 | uvicorn |
| >=3.4 | idna |
| >=3.6.2 | anyio |
| >=2.28.1 | requests |
| >=11.0 | websockets |
| >=4.0.0 | typing-extensions |
| >=1.5.5 | nest-asyncio |
| >=0.14.0 | h11 |
| >=22.1.0 | aiofiles |
| <4.0.0,>=3.8.3 | flake8 |
| >=1.8.2 | pydantic |
| >=0.18.0 | aiosqlite |
| ==20.8b1 | black |
| >=0.26.1 | starlette |
| >=1.16.0 | six |
| >=2.1.2 | flask[async] |
| >=5.9.1 | psutil |
| >=2.0.1 | aioredis |
| >=0.27.0 | asyncpg |
| <6.0.0,>=5.0.6 | isort |
| >=0.2.5 | asyncmy |
| <=8.0.4 | click |
| >=0.95.1 | fastapi |
| >=1.3.0 | sniffio |
| ~=2.5.0 | ydb |
| >=1.16.0 | six |
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.7, <4 | Python |
نحوه نصب
نصب پکیج whl dff-0.4.1:
pip install dff-0.4.1.whl
نصب پکیج tar.gz dff-0.4.1:
pip install dff-0.4.1.tar.gz