chatgraph 0.3.1__py3-none-any.whl → 0.3.4__py3-none-any.whl

chatgraph-0.3.4.dist-info/METADATA

@@ -0,0 +1,326 @@
+Metadata-Version: 2.1
+Name: chatgraph
+Version: 0.3.4
+Summary: A user-friendly chatbot library
+Home-page: https://github.com/irissonnlima/chatgraph
+License: MIT
+Keywords: chatbot,rabbitmq,messaging,routing,chatgraph,python
+Author: Irisson N. Lima
+Author-email: irisson.lima@verdecard.com.br
+Requires-Python: >=3.12,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Dist: grpcio (>=1.67.0,<2.0.0)
+Requires-Dist: grpcio-tools (>=1.67.0,<2.0.0)
+Requires-Dist: pika (>=1.3.2,<2.0.0)
+Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
+Requires-Dist: rich (>=13.8.1,<14.0.0)
+Requires-Dist: typer (>=0.12.5,<0.13.0)
+Project-URL: Repository, https://github.com/irissonnlima/chatgraph
+Description-Content-Type: text/markdown
+
+### **README - ChatGraph**
+
+# ChatGraph - Framework para Criação de Chatbots
+
+ChatGraph é uma biblioteca desenvolvida para criar chatbots interativos e modulares. Com suporte integrado para gRPC e RabbitMQ, ela permite gerenciar fluxos complexos de mensagens e criar comandos de chatbots que respondem a rotas específicas. Toda interação começa pela rota `start` e deriva para sub-rotas como `start.choice`.
+
+### **Requisitos**
+- Python 3.12+
+- `pip` para gerenciamento de pacotes
+
+### **Instalação**
+A biblioteca ChatGraph pode ser instalada diretamente via `pip`:
+
+```bash
+pip install chatgraph
+```
+
+## **Configuração**
+
+### **Variáveis de Ambiente**
+Crie um arquivo `.env` na raiz do projeto para definir as variáveis necessárias, incluindo detalhes de conexão com RabbitMQ e URI para gRPC. Exemplo:
+
+```env
+RABBIT_USER=seu_usuario
+RABBIT_PASS=sua_senha
+RABBIT_URI=amqp://localhost
+RABBIT_QUEUE=chat_queue
+RABBIT_PREFETCH=1
+RABBIT_VHOST=/
+GRPC_URI=grpc://localhost:50051
+```
+
+Aqui está uma descrição mais detalhada de cada um dos objetos mencionados. Esses componentes são fundamentais para a estrutura e funcionalidade do ChatGraph, permitindo gerenciar fluxos de chat, interações e estados do usuário de forma eficiente.
+
+### **Tipos de Objetos e Suas Funções**
+
+---
+
+### **1. `UserCall`**
+**Localização:** `from .types.request_types import UserCall`
+
+O `UserCall` representa uma solicitação de interação do usuário para o chatbot. Ele encapsula as informações básicas sobre uma mensagem recebida do usuário e fornece detalhes essenciais que o chatbot pode usar para decidir como responder.
+
+#### **Principais Propriedades:**
+- **`text`**: A mensagem de texto enviada pelo usuário.
+- **`user_id`**: Identificador único do usuário, permitindo o rastreamento e a vinculação de estados.
+- **`platform`**: Informação sobre a plataforma usada (por exemplo, WhatsApp, Web, etc.).
+- **`timestamp`**: Horário em que a mensagem foi recebida.
+- **`metadata`**: Dados adicionais que podem incluir informações contextuais (ex: geolocalização, histórico de navegação).
+
+#### **Uso:**
+O `UserCall` é instanciado sempre que uma nova mensagem é recebida, e fornece os dados necessários para que o chatbot processe e determine a resposta apropriada.
+
+---
+
+### **2. `UserState`**
+**Localização:** `from .types.request_types import UserState`
+
+`UserState` é usado para representar o estado atual do usuário no sistema de chatbot. Ele guarda o contexto de uma sessão do usuário, permitindo que o chatbot mantenha informações ao longo de múltiplas interações.
+
+#### **Principais Propriedades:**
+- **`state_id`**: Identificador único para o estado do usuário.
+- **`current_route`**: A rota atual onde o usuário está localizado dentro do fluxo do chatbot.
+- **`data`**: Dados de estado armazenados que podem ser usados para tomar decisões em futuras interações (ex: preferências, histórico de escolhas).
+- **`last_interaction`**: Timestamp da última interação do usuário.
+
+#### **Uso:**
+O `UserState` ajuda a manter o contexto entre as mensagens para que o chatbot possa continuar uma conversa sem perder informações importantes.
+
+---
+
+### **3. `RedirectResponse`**
+**Localização:** `from .types.end_types import RedirectResponse`
+
+`RedirectResponse` é usado quando o chatbot precisa redirecionar o usuário para uma rota diferente dentro do fluxo de conversa. Isso é útil para mover o usuário para diferentes partes do chatbot com base na lógica de negócios.
+
+#### **Principais Propriedades:**
+- **`target_route`**: Rota para a qual o usuário será redirecionado.
+- **`message`**: Mensagem opcional a ser exibida durante o redirecionamento.
+
+#### **Uso:**
+Permite criar fluxos mais dinâmicos, onde os usuários podem ser movidos para diferentes rotas dependendo de suas ações e escolhas.
+
+---
+
+### **4. `EndChatResponse`**
+**Localização:** `from .types.end_types import EndChatResponse`
+
+`EndChatResponse` é uma resposta que sinaliza o fim de uma conversa com o chatbot. Pode ser usado para finalizar a sessão de forma limpa e opcionalmente fornecer uma mensagem de encerramento.
+
+#### **Principais Propriedades:**
+- **`message`**: Mensagem final que será enviada ao usuário para encerrar a conversa.
+- **`feedback_prompt`**: (Opcional) Um prompt para feedback, se desejado.
+
+#### **Uso:**
+Usado quando o fluxo do chatbot deve ser encerrado. Garante que a sessão do usuário seja finalizada corretamente e fornece uma experiência de término satisfatória.
+
+---
+
+### **5. `TransferToHuman`**
+**Localização:** `from .types.end_types import TransferToHuman`
+
+`TransferToHuman` é uma resposta que permite transferir a interação do usuário para um operador humano. Isso é útil quando o chatbot encontra uma situação que requer suporte humano.
+
+#### **Principais Propriedades:**
+- **`message`**: Mensagem para informar ao usuário que ele será transferido para um atendente humano.
+- **`department`**: (Opcional) Departamento ou equipe específica para a qual a interação será transferida.
+
+#### **Uso:**
+Fornece uma maneira para o chatbot transferir conversas para atendimento humano quando necessário, garantindo uma transição suave.
+
+---
+
+### **6. `Message`**
+**Localização:** `from .types.message_types import Message`
+
+O `Message` é um objeto básico que representa uma mensagem de texto enviada pelo chatbot para o usuário. Ele é o bloco de construção fundamental para as respostas do chatbot.
+
+#### **Principais Propriedades:**
+- **`text`**: O conteúdo da mensagem que será enviado ao usuário.
+- **`metadata`**: Informações adicionais sobre a mensagem (ex: tags, prioridade).
+
+#### **Uso:**
+Usado para enviar respostas simples e diretas ao usuário. O `Message` é utilizado em quase todas as interações básicas do chatbot.
+
+---
+
+### **7. `Button`**
+**Localização:** `from .types.message_types import Button`
+
+O `Button` representa uma mensagem que inclui botões clicáveis para oferecer ao usuário opções específicas. Ele é essencial para criar fluxos interativos e guiar o usuário para ações específicas.
+
+#### **Principais Propriedades:**
+- **`text`**: Texto descritivo acima dos botões.
+- **`buttons`**: Lista de opções que aparecem como botões clicáveis.
+- **`callback_data`**: (Opcional) Dados que são passados quando um botão é clicado, permitindo lógica adicional.
+
+#### **Uso:**
+Facilita a navegação no chatbot ao permitir que o usuário escolha uma ação clicando em um botão, em vez de digitar uma resposta.
+
+---
+
+### **8. `ListElements`**
+**Localização:** `from .types.message_types import ListElements`
+
+O `ListElements` é um tipo de mensagem que exibe uma lista de elementos ao usuário, útil para apresentar várias opções de uma só vez.
+
+#### **Principais Propriedades:**
+- **`title`**: Título da lista.
+- **`items`**: Lista de elementos a serem exibidos.
+- **`image_url`**: (Opcional) URL de uma imagem para cada item, se desejado.
+- **`description`**: (Opcional) Descrição adicional para cada elemento.
+
+#### **Uso:**
+Ideal para cenários em que múltiplas opções precisam ser apresentadas ao usuário, como uma lista de produtos ou serviços.
+
+---
+
+### **9. `Route`**
+**Localização:** `from .types.route import Route`
+
+O `Route` gerencia a navegação entre diferentes partes do chatbot. Ele é responsável por direcionar o fluxo de conversação, ajudando a determinar qual é a próxima rota ou passo que o usuário deve seguir.
+
+#### **Principais Funções:**
+- **`get_next`**: Retorna a próxima rota a ser seguida no fluxo.
+- **`back`**: Permite retornar para uma rota anterior.
+- **`forward`**: Avança para uma rota específica.
+- **`resolve`**: Determina qual é a rota baseada no estado atual e nas escolhas do usuário.
+
+#### **Uso:**
+O `Route` é essencial para criar fluxos conversacionais dinâmicos e adaptáveis. Ele ajuda a definir a progressão lógica do chatbot, permitindo controle total sobre como o usuário navega entre diferentes partes do fluxo.
+
+
+### **Estrutura de Rota**
+Todas as interações no ChatGraph começam pela rota `start` e se derivam para sub-rotas, criando um fluxo contínuo para gerenciar conversas.
+
+- **Exemplo:** `start`, `start.choice`, `start.choice.about`
+
+## **Uso**
+
+### **Configurando o Chatbot**
+```python
+from chatgraph import ChatbotApp, UserCall, Button, Route
+
+app = ChatbotApp()
+
+@app.route("start")
+def start(usercall: UserCall, rota: Route) -> tuple:
+    return (
+        'Bem-vindo!',
+        Button(
+            text="Escolha uma opção:",
+            buttons=["Opção 1", "Opção 2"]
+        ),
+        rota.get_next('.choice')
+    )
+
+@app.route("start.choice")
+def start_choice(usercall: UserCall, rota: Route) -> tuple:
+    if usercall.text == "Opção 1":
+        return 'Você escolheu a Opção 1!'
+    elif usercall.text == "Opção 2":
+        return 'Você escolheu a Opção 2!'
+    
+app.start()
+```
+
+## **Estrutura da Biblioteca**
+
+```
+chatgraph/
+│
+├── auth/
+│   └── credentials.py  # Gerenciamento de credenciais
+├── bot/
+│   ├── chatbot_model.py  # Lógica principal do chatbot
+│   └── chatbot_router.py  # Roteamento de rotas do chatbot
+├── cli/
+│   └── main.py  # Implementação do CLI
+├── gRPC/
+│   └── gRPCCall.py  # Implementação de comunicação gRPC
+├── messages/
+│   └── message_consumer.py  # Consumidor de mensagens RabbitMQ
+└── types/
+    ├── request_types.py  # Definição de tipos de requisições
+    ├── message_types.py  # Definição de tipos de mensagens
+    ├── end_types.py  # Tipos de finalização de chat
+    └── route.py  # Gerenciamento de rotas
+```
+
+## **Exemplo de Configuração de Rota**
+
+### **Estrutura de Fluxo**
+```python
+from chatgraph import ChatbotApp, UserCall, Button, Route
+
+app = ChatbotApp()
+
+@app.route("start")
+def start(usercall: UserCall, rota: Route)->tuple:
+    return (
+        'Oi', 
+        Button(
+            text="Olá, eu sou o chatbot da empresa X. Como posso te ajudar?",
+            buttons=["saber mais", "falar com atendente"],
+        ),
+        rota.get_next('.choice')
+    )
+
+@app.route("start.choice")
+def start_choice(usercall: UserCall, rota: Route)->tuple:
+    if usercall.text == "saber mais":
+        return (
+            'Sobre o que você quer saber mais?',
+            Button(
+                text="Sobre a empresa",
+                buttons=["sobre produtos", "sobre serviços"],
+            ),
+            rota.get_next('.about')
+        )
+    elif usercall.text == "falar com atendente":
+        return 'Ok'
+    
+app.start()
+```
+
+## **CLI**
+
+### **Comandos Disponíveis**
+1. **Listar campanhas:**
+   ```bash
+   chatgraph campaigns
+   ```
+2. **Filtrar campanhas usando regex:**
+   ```bash
+   chatgraph campaigns --regex "promo"
+   ```
+3. **Deletar um estado de usuário:**
+   ```bash
+   chatgraph delete-ustate 12345
+   ```
+   **Alias:** `delete-user-state`, `del-ustate`, `dus`
+
+### **Aliases e Flexibilidade**
+Para facilitar o uso, alguns comandos possuem apelidos. Por exemplo, o comando para deletar estados de usuário pode ser chamado de múltiplas formas:
+```bash
+chatgraph delete-user-state 12345
+chatgraph del-ustate 12345
+chatgraph dus 12345
+```
+
+## **Contribuição**
+1. Faça um fork do repositório.
+2. Crie uma nova branch (`git checkout -b minha-nova-feature`).
+3. Faça commit das suas alterações (`git commit -am 'Adiciona nova feature'`).
+4. Envie para a branch (`git push origin minha-nova-feature`).
+5. Crie um novo Pull Request.
+
+## **Licença**
+Este projeto é licenciado sob a Licença MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
+
+---
+
+Esse README fornece instruções detalhadas sobre como instalar, configurar e usar a biblioteca ChatGraph, incluindo a estrutura de rotas e exemplos de implementação para facilitar o desenvolvimento de chatbots com fluxos claros e intuitivos.

chatgraph-0.3.4.dist-info/RECORD

@@ -0,0 +1,24 @@
+chatgraph/__init__.py,sha256=lUMcFMSxKQeHVFq7CyZV2r_UOHAtGGpeXtac0RUd7po,718
+chatgraph/auth/credentials.py,sha256=xsMEpLQnc66novPjL6upocMcnUnvFJ7yxINzUenkxmc,2388
+chatgraph/bot/chatbot_model.py,sha256=yRjbjiQHkaN3IVf-gEu-NQHNxOMsj34imCpuZK3m84g,7201
+chatgraph/bot/chatbot_router.py,sha256=tl-4WP9wqUjCIwvtO9kJVUFjN2-mxNDUTRAFL9PXBgI,3028
+chatgraph/cli/__init__.py,sha256=tfgYhGoKy1nD4STN4xDh6J4VV55RICk7v1GZmzAg-bM,7413
+chatgraph/error/chatbot_error.py,sha256=4sEcW8vz0eQk2QDmDygucVM4caHliZW5iH7XJvmLBuk,1897
+chatgraph/error/route_error.py,sha256=CY8m82ap7-Sr-DXPsolltRW50TqD__5RyXBmNNJCWr8,793
+chatgraph/gRPC/gRPCCall.py,sha256=jYZg7CvtKWhtv2sQMrSunSmvnnL83MKmNVO8GWmGZ9U,7696
+chatgraph/messages/message_consumer.py,sha256=1h3gQQ9AWTA1rRsqVjaq6BCh06R9ny_aD_AyUicFTeo,8816
+chatgraph/pb/userstate.proto,sha256=LdrHde9ga4z6vfAX2P4jcPuU9qdiJulCf3MfWz_8vsQ,810
+chatgraph/pb/userstate_pb2.py,sha256=yk7jWGFgv2eAU5Q4juf8RApedwRRhPez9-y93MaZVlw,2772
+chatgraph/pb/userstate_pb2_grpc.py,sha256=QJEGEmdBL6bkxrTI-gNhGbZpPUFuP5jm7eFu8y21PMI,10340
+chatgraph/pb/voll.proto,sha256=fSjx24MT_fJQbo7EwO9BsuIWAa7IzXgJnioCSrdt3FM,2007
+chatgraph/pb/voll_pb2.py,sha256=IkopsIc8x-lS9j6WpL9Wk5MHl41FDa8cU0kmZRpKKKY,5291
+chatgraph/pb/voll_pb2_grpc.py,sha256=U-_nXTAIEzo2GMYjHiphbSyTx3zyipsnKebFuZuoU1k,17685
+chatgraph/types/end_types.py,sha256=--Ty2gM_y7J-yRAvZV26e4HMUpoguAMAhfOIS9-kQTk,1316
+chatgraph/types/message_types.py,sha256=-GQAQi1iMz1ysZLAXJImIg34ObnSJnhz7zv6VBrlNuw,3364
+chatgraph/types/request_types.py,sha256=ZTJY-jc4zwPO4cfpksL7J0MKtYuTtecn9ZObkTSi9OU,8577
+chatgraph/types/route.py,sha256=2fuHEPKUL_Vuv4g8pB6M7eJLouxXasqjesdju6_eumE,2757
+chatgraph-0.3.4.dist-info/entry_points.txt,sha256=bO9_Q-PqE5vCNNo6ke_-3j2gHfKQMDGnKDTkNuCdBuA,48
+chatgraph-0.3.4.dist-info/LICENSE,sha256=rVJozpRzDlplOpvI8A1GvmfVS0ReYdZvMWc1j2jV0v8,1090
+chatgraph-0.3.4.dist-info/METADATA,sha256=hHLj0Qq0hX0TFE8xpHmjA4xQc_YLC51cld9uBOnTbX8,12781
+chatgraph-0.3.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+chatgraph-0.3.4.dist-info/RECORD,,

chatgraph-0.3.4.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+chatgraph=chatgraph.cli:main
+

chatgraph/types/output_state.py

@@ -1,138 +0,0 @@
-from typing import Union
-import json
-
-messageTypes = Union[str, float, int, None]
-
-
-class ChatbotResponse:
-    """
-    Representa a resposta do chatbot, contendo a mensagem a ser enviada ao usuário e a rota a ser seguida.
-
-    Atributos:
-        message (messageTypes): A mensagem de resposta do chatbot. Pode ser uma string, um número, ou None.
-        route (str, opcional): A rota para a qual o chatbot deve direcionar após esta mensagem. Padrão é None.
-    """
-
-    def __init__(
-            self, 
-            message: messageTypes = None, 
-            route: str = None, 
-            abs_text:bool=False
-        ) -> None:
-        """
-        Inicializa a resposta do chatbot com uma mensagem e uma rota opcional.
-
-        Args:
-            message (messageTypes, opcional): A mensagem a ser enviada ao usuário. Pode ser uma string, um número, ou None.
-            route (str, opcional): A rota para a qual o chatbot deve direcionar após esta mensagem. Padrão é None.
-        """
-        if not message:
-            message = ''
-            
-        if not abs_text:
-            message = message.replace('\t', '')
-            
-        self.message = message
-        self.route = route
-    
-    def json(self):
-        '''
-        Retorna o objeto em formato json.
-        '''
-        return {
-            'type': 'message',
-            'text': self.message,
-        }
-
-
-class RedirectResponse:
-    """
-    Representa uma resposta que redireciona o fluxo do chatbot para uma nova rota.
-
-    Atributos:
-        route (str): A rota para a qual o chatbot deve redirecionar.
-    """
-
-    def __init__(self, route: str) -> None:
-        """
-        Inicializa a resposta de redirecionamento com a rota especificada.
-
-        Args:
-            route (str): A rota para a qual o chatbot deve redirecionar.
-        """
-        self.route = route
-
-class EndChatResponse:
-    """
-    Representa uma resposta que indica o fim do chatbot.
-
-    Atributos:
-        tabulation_id (str): O ID da tabulação do chatbot.
-        observations (str): As observações finais do chatbot.
-    """
-
-    def __init__(self, tabulation_id: str, observations:str) -> None:
-        '''
-        Finzaliza e tabula as informações do chatbot.
-        '''
-        self.tabulation_id = tabulation_id
-        self.observations = observations
-        
-    def json(self):
-        '''
-        Retorna o objeto em formato json.
-        '''
-        return {
-            'type': 'tabulate',
-            'tabulation_id': self.tabulation_id,
-            'observations': self.observations,
-        }
-        
-class TransferToHuman:
-    """
-    Representa uma transferencia para um atendente humano.
-    """
-    def __init__(self, campaign_id: str, observations:str) -> None:
-        '''
-        Finzaliza e tabula as informações do chatbot.
-        '''
-        self.campaign_id = campaign_id
-        self.observations = observations
-        
-    def json(self):
-        '''
-        Retorna o objeto em formato json.
-        '''
-        return {
-            'type': 'transfer',
-            'campaign_id': self.campaign_id,
-            'observations': self.observations,
-        }
-
-class RedirectEntireChatbot:
-    """
-    Representa uma resposta que redireciona o fluxo do chatbot para um outro menu.
-
-    Atributos:
-        menu (str): O menu para o qual o chatbot deve redirecionar.
-        route (str): A rota para a qual o chatbot deve redirecionar.
-    """
-
-    def __init__(self, menu:str, route: str) -> None:
-        """
-        Inicializa a resposta de redirecionamento com a rota especificada.
-
-        Args:
-            route (str): A rota para a qual o chatbot deve redirecionar.
-        """
-        self.route = route
-        self.menu = menu
-    def json(self):
-        '''
-        Retorna o objeto em formato json.
-        '''
-        return {
-            'type': 'redirect',
-            'menu': self.menu,
-            'route': self.route,
-        }

chatgraph-0.3.1.dist-info/METADATA

@@ -1,146 +0,0 @@
-Metadata-Version: 2.1
-Name: chatgraph
-Version: 0.3.1
-Summary: A user-friendly chatbot library
-Home-page: https://github.com/irissonnlima/chatgraph
-License: MIT
-Keywords: chatbot,rabbitmq,messaging,routing,chatgraph,python
-Author: Irisson N. Lima
-Author-email: irisson.lima@verdecard.com.br
-Requires-Python: >=3.12,<4.0
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: grpcio (>=1.66.2,<2.0.0)
-Requires-Dist: grpcio-tools (>=1.66.2,<2.0.0)
-Requires-Dist: pika (>=1.3.2,<2.0.0)
-Requires-Dist: python-dotenv (>=1.0.1,<2.0.0)
-Requires-Dist: rich (>=13.8.1,<14.0.0)
-Project-URL: Repository, https://github.com/irissonnlima/chatgraph
-Description-Content-Type: text/markdown
-
-# ChatGraph
-
-**ChatGraph** é uma biblioteca Python projetada para facilitar a construção e gerenciamento de chatbots com roteamento flexível. 
-
-Ela oferece uma estrutura para definir rotas de chatbot, processar mensagens e gerenciar o estado do usuário de maneira eficiente.
-
-## Instalação
-
-Você pode instalar o ChatGraph diretamente do PyPI:
-
-```bash
-pip install chatgraph
-```
-
-Link do PyPI: [ChatGraph no PyPI](https://pypi.org/project/chatgraph/)
-
-## Estrutura da Biblioteca
-
-### 1. `ChatbotApp`
-
-A classe `ChatbotApp` é o núcleo da aplicação do chatbot. Ela gerencia as rotas definidas, processa as mensagens recebidas e lida com a lógica de navegação dentro do chatbot.
-
-- **Métodos principais:**
-  - `include_router`: Inclui um conjunto de rotas (definido por `ChatbotRouter`) na aplicação.
-  - `route`: Decorador para associar funções a rotas específicas.
-  - `start`: Inicia o consumo de mensagens do RabbitMQ.
-  - `process_message`: Processa a mensagem recebida e executa a função correspondente à rota atual do usuário.
-
-### 2. `ChatbotRouter`
-
-A classe `ChatbotRouter` permite definir e agrupar rotas que podem ser facilmente incluídas na aplicação principal do chatbot.
-
-- **Métodos principais:**
-  - `route`: Decorador para adicionar uma função como uma rota no roteador.
-  - `include_router`: Inclui outro roteador dentro do roteador atual, permitindo a construção modular das rotas.
-
-### 3. `MessageConsumer` e `RabbitMessageConsumer`
-
-A classe abstrata `MessageConsumer` define a interface para consumidores de mensagens no sistema do chatbot. A implementação concreta `RabbitMessageConsumer` consome mensagens de uma fila RabbitMQ, processa essas mensagens e envia respostas de acordo.
-
-- **Métodos principais:**
-  - `start_consume`: Inicia o consumo de mensagens do RabbitMQ.
-  - `on_request`: Processa uma mensagem recebida e envia a resposta correspondente.
-  - `load_dotenv`: Carrega as configurações do RabbitMQ a partir de variáveis de ambiente.
-
-### 4. `UserState` e `SimpleUserState`
-
-A classe abstrata `UserState` define a interface para o gerenciamento do estado do usuário. A implementação `SimpleUserState` usa um dicionário em memória para armazenar o estado atual do menu para cada usuário.
-
-- **Métodos principais:**
-  - `get_menu`: Retorna o menu atual associado a um ID de cliente.
-  - `set_menu`: Define o menu atual para um ID de cliente.
-
-### 5. `Message`
-
-A classe `Message` encapsula os dados de uma mensagem enviada ou recebida pelo chatbot.
-
-- **Atributos:**
-  - `type`: Tipo da mensagem (ex. texto, imagem).
-  - `text`: Conteúdo da mensagem.
-  - `customer_id`: ID do cliente que enviou ou recebeu a mensagem.
-  - `channel`: Canal de comunicação utilizado (ex. WhatsApp, SMS).
-  - `customer_phone`: Número de telefone do cliente.
-  - `company_phone`: Número de telefone da empresa.
-  - `status`: Status da mensagem (opcional).
-
-### 6. `ChatbotResponse` e `RedirectResponse`
-
-Essas classes são usadas para definir a resposta do chatbot após o processamento de uma mensagem.
-
-- **`ChatbotResponse`**: Contém uma mensagem de resposta e uma rota opcional.
-- **`RedirectResponse`**: Define uma rota para a qual o chatbot deve redirecionar o fluxo.
-
-### 7. `Route` e `RouteError`
-
-A classe `Route` gerencia a navegação entre diferentes partes do fluxo do chatbot, permitindo obter a rota anterior e calcular a próxima rota com base na entrada do usuário.
-
-- **Métodos principais:**
-  - `get_previous`: Retorna o caminho anterior ao atual.
-  - `get_next`: Monta e retorna o próximo caminho com base em uma parte fornecida.
-
-A classe `RouteError` é uma exceção personalizada usada para indicar problemas relacionados à navegação nas rotas.
-
-## Exemplo de Uso
-
-Aqui está um exemplo básico de como configurar e utilizar o ChatGraph:
-
-```python
-from chatgraph import ChatbotApp, ChatbotRouter, SimpleUserState, RabbitMessageConsumer, ChatbotResponse
-
-# Definindo rotas com ChatbotRouter
-router = ChatbotRouter()
-
-@router.route("start")
-def say_hello():
-    return ChatbotResponse(message="Hello! How can I assist you today?", route=".help")
-
-@router.route(".help")
-def provide_help():
-    return ChatbotResponse(message="Here are some things I can help with: ...")
-
-# Configurando a aplicação do chatbot
-user_state = SimpleUserState()
-message_consumer = RabbitMessageConsumer.load_dotenv()
-
-app = ChatbotApp(user_state=user_state, message_consumer=message_consumer)
-app.include_router(router, prefix="")
-
-# Iniciando o chatbot
-app.start()
-```
-
-Neste exemplo, o chatbot responde "Hello! How can I assist you today?" quando a rota `HELLO` é acessada e depois direciona o usuário para a rota `HELP`.
-
-## Contribuição
-
-Se você encontrar bugs ou tiver sugestões de melhorias, sinta-se à vontade para abrir uma issue ou enviar um pull request no repositório do projeto.
-
-## Licença
-
-Este projeto está licenciado sob a licença MIT. Consulte o arquivo LICENSE para obter mais detalhes.
-
----
-
-Com **ChatGraph**, você tem a flexibilidade e a simplicidade necessárias para construir chatbots poderosos e altamente configuráveis, integrados, por enquanto, com RabbitMQ para um processamento robusto de mensagens.

chatgraph-0.3.1.dist-info/RECORD

@@ -1,21 +0,0 @@
-chatgraph/__init__.py,sha256=OnPa3kE9pTXlxnkwwc45_2F6bqfR_GZAFal6-FFeT_U,648
-chatgraph/auth/credentials.py,sha256=xsMEpLQnc66novPjL6upocMcnUnvFJ7yxINzUenkxmc,2388
-chatgraph/bot/chatbot_model.py,sha256=DQgEXDs3XWMqYdZ7XA1G2f6XmpD54x1cLbHGub2MAtw,7572
-chatgraph/bot/chatbot_router.py,sha256=tl-4WP9wqUjCIwvtO9kJVUFjN2-mxNDUTRAFL9PXBgI,3028
-chatgraph/error/chatbot_error.py,sha256=4sEcW8vz0eQk2QDmDygucVM4caHliZW5iH7XJvmLBuk,1897
-chatgraph/error/route_error.py,sha256=CY8m82ap7-Sr-DXPsolltRW50TqD__5RyXBmNNJCWr8,793
-chatgraph/gRPC/gRPCCall.py,sha256=g1VGr6z-_IN2J3tSFAXqM1E2F8xx_p5noH3e_klJiKc,4478
-chatgraph/messages/message_consumer.py,sha256=8GOhBPE8ntSf74prw8STCUqi9jfW9gAmMdH9RAqnwEA,8978
-chatgraph/pb/userstate.proto,sha256=3uWtonkgBG-5jk7Du7uKDQwFnoNQaUZYVr1lb77EJSA,630
-chatgraph/pb/userstate_pb2.py,sha256=yJepkWX2mLQpY0I4qhfrObrYfRAmnq4mccPTMlCV-os,2363
-chatgraph/pb/userstate_pb2_grpc.py,sha256=QS8-9X6WDeurl4DAI0dzvCdGbQusHlMON0_p1QqmuEs,8635
-chatgraph/pb/voll.proto,sha256=qFV0_MLUTsVcDdEWz9EVWObn3Nu-tNwX2aGeKPxDtE8,716
-chatgraph/pb/voll_pb2.py,sha256=aspT1ynrGTKh_SQcIoEb_uSJ7j_nKpxEdyj-hkr4lTI,2519
-chatgraph/pb/voll_pb2_grpc.py,sha256=RFW3_dbzz_INJG8D1LQmmdyEr7ajLRqT1JPl0D-Hgso,6742
-chatgraph/types/message_types.py,sha256=ICFa0mG1so2hBo82YM4tx695P781a5I3zqVL48soRog,6529
-chatgraph/types/output_state.py,sha256=lwnQt_Z1MCdvDya1Sv_lJ13MM6qKsYJMaSMfXYhW_aw,4079
-chatgraph/types/route.py,sha256=J1Bm5C3PDwdUy6RCIR4sK94ljyrsLmyKOjKFnyJ6Dsg,2753
-chatgraph-0.3.1.dist-info/LICENSE,sha256=rVJozpRzDlplOpvI8A1GvmfVS0ReYdZvMWc1j2jV0v8,1090
-chatgraph-0.3.1.dist-info/METADATA,sha256=vPUUgVQXPec2pesOTKJhJHzb2rdpp1Pi51c40qR5hgE,6000
-chatgraph-0.3.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-chatgraph-0.3.1.dist-info/RECORD,,