chatgraph 0.1.1__py3-none-any.whl → 0.1.4__py3-none-any.whl

chatgraph/bot/chatbot_model.py

@@ -6,7 +6,7 @@ from logging import debug
 from ..error.chatbot_error import ChatbotError, ChatbotMessageError
 from ..messages.base_message_consumer import MessageConsumer
 from ..types.message_types import Message
-from ..types.output_state import ChatbotResponse, RedirectResponse
+from ..types.output_state import ChatbotResponse, RedirectResponse, EndChatResponse, TransferToHuman
 from ..types.route import Route
 from ..types.user_state import UserState
 from .chatbot_router import ChatbotRouter
@@ -38,16 +38,16 @@ class ChatbotApp(ABC):
             prefix (str): O prefixo a ser adicionado às rotas do roteador.
 
         Raises:
-            ChatbotError: Se a rota 'START' não for encontrada no roteador.
+            ChatbotError: Se a rota 'start' não for encontrada no roteador.
         """
-        if 'START' not in router.routes.keys():
-            raise ChatbotError('Erro ao incluir rota, START não encontrado!')
+        if 'start' not in router.routes.keys():
+            raise ChatbotError('Erro ao incluir rota, start não encontrado!')
 
         prefixed_routes = {
             (
-                f'START{prefix.upper()}'
-                if key.upper() == 'START'
-                else f'START{prefix.upper()}{key.upper().replace("START", "")}'
+                f'start{prefix.lower()}'
+                if key.lower() == 'start'
+                else f'start{prefix.lower()}{key.lower().replace("start", "")}'
             ): value
             for key, value in router.routes.items()
         }
@@ -63,10 +63,10 @@ class ChatbotApp(ABC):
         Returns:
             function: O decorador que adiciona a função à rota especificada.
         """
-        route_name = route_name.strip().upper()
+        route_name = route_name.strip().lower()
 
-        if 'START' not in route_name:
-            route_name = f'START{route_name}'
+        if 'start' not in route_name:
+            route_name = f'start{route_name}'
 
         def decorator(func):
             params = dict()
@@ -119,7 +119,7 @@ class ChatbotApp(ABC):
         customer_id = message.customer_id
 
         menu = self.__user_state.get_menu(customer_id)
-        menu = menu.upper()
+        menu = menu.lower()
         handler = self.__routes.get(menu, None)
 
         if not handler:
@@ -143,11 +143,17 @@ class ChatbotApp(ABC):
         elif type(message_response) == ChatbotResponse:
             route = self.__adjust_route(message_response.route, menu)
             self.__user_state.set_menu(customer_id, route)
-            return message_response.message
+            return message_response.json()
         elif type(message_response) == RedirectResponse:
             route = self.__adjust_route(message_response.route, menu)
             self.__user_state.set_menu(customer_id, route)
             return self.process_message(message)
+        elif type(message_response) == EndChatResponse:
+            self.__user_state.delete_menu(customer_id)
+            return message_response.json()
+        elif type(message_response) == TransferToHuman:
+            self.__user_state.delete_menu(customer_id)
+            return message_response.json()
         else:
             raise ChatbotError('Tipo de retorno inválido!')
 
@@ -165,7 +171,7 @@ class ChatbotApp(ABC):
         if not route:
             return absolute_route
 
-        if 'START' not in route:
+        if 'start' not in route:
             route = absolute_route + route
 
         return route

chatgraph/bot/chatbot_router.py

@@ -29,8 +29,8 @@ class ChatbotRouter:
         Returns:
             function: O decorador que adiciona a função à rota especificada.
         """
-        if 'START' not in route_name:
-            route_name = f'START{route_name}'
+        if 'start' not in route_name:
+            route_name = f'start{route_name}'
 
         def decorator(func):
             params = dict()
@@ -46,7 +46,7 @@ class ChatbotRouter:
                 params[param_type] = name
                 debug(f'Parameter: {name}, Type: {param_type}')
 
-            self.routes[route_name.strip().upper()] = {
+            self.routes[route_name.strip().lower()] = {
                 'function': func,
                 'params': params,
                 'return': output_param,
@@ -69,16 +69,16 @@ class ChatbotRouter:
             prefix (str): O prefixo a ser adicionado às rotas do roteador.
 
         Raises:
-            ChatbotError: Se a rota 'START' não for encontrada no roteador fornecido.
+            ChatbotError: Se a rota 'start' não for encontrada no roteador fornecido.
         """
-        if 'START' not in router.routes.keys():
-            raise ChatbotError('Erro ao incluir rota, START não encontrado!')
+        if 'start' not in router.routes.keys():
+            raise ChatbotError('Erro ao incluir rota, start não encontrado!')
 
         prefixed_routes = {
             (
-                f'{prefix.upper()}'
-                if key.upper() == 'START'
-                else f'START{prefix.upper()}{key.upper().replace("START", "")}'
+                f'{prefix.lower()}'
+                if key.lower() == 'start'
+                else f'start{prefix.lower()}{key.lower().replace("start", "")}'
             ): value
             for key, value in router.routes.items()
         }

chatgraph/messages/test_message_consumer.py

@@ -0,0 +1,17 @@
+from typing import Any, Callable
+from .base_message_consumer import MessageConsumer
+
+
+class TestMessageConsumer(MessageConsumer):
+    """
+    Classe de consumidor de mensagens de teste para uso em testes unitários.
+    """
+    def __init__(self) -> None:
+        super().__init__()
+        
+    @classmethod
+    def load_dotenv(cls) -> 'TestMessageConsumer':
+        return cls()
+    
+    def start_consume(self, process_message: Callable) -> Any:
+        return super().start_consume(process_message)

chatgraph/types/output_state.py

@@ -1,4 +1,5 @@
 from typing import Union
+import json
 
 messageTypes = Union[str, float, int, None]
 
@@ -22,6 +23,15 @@ class ChatbotResponse:
         """
         self.message = message
         self.route = route
+    
+    def json(self):
+        '''
+        Retorna o objeto em formato json.
+        '''
+        return json.dumps({
+            'type': 'message',
+            'message': self.message,
+        })
 
 
 class RedirectResponse:
@@ -40,3 +50,50 @@ class RedirectResponse:
             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 json.dumps({
+            '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 json.dumps({
+            'type': 'transfer',
+            'campaign_id': self.campaign_id,
+            'observations': self.observations,
+        })

chatgraph/types/route.py

@@ -10,31 +10,33 @@ class Route:
         routes (list[str]): A lista de todas as rotas disponíveis no fluxo.
     """
 
-    def __init__(self, current: str, routes: list[str]):
+    def __init__(self, current: str, routes: list[str], separator:str='.'):
         """
         Inicializa a rota com a rota atual e a lista de rotas disponíveis.
 
         Args:
             current (str): A rota atual.
             routes (list[str]): A lista de todas as rotas disponíveis no fluxo.
+            separator (str): O separador de partes de rota. Padrão é '.'.
         """
         self.current = current
         self.routes = routes
+        self.separator = separator
 
     def get_previous(self) -> str:
         """
         Retorna o caminho anterior ao caminho atual.
 
         Raises:
-            RouteError: Se a rota atual for 'START', indicando que não há caminho anterior.
+            RouteError: Se a rota atual for 'start', indicando que não há caminho anterior.
 
         Returns:
             str: O caminho anterior à rota atual.
         """
-        if self.current == 'START':
-            raise RouteError('Não há caminho anterior ao START')
+        if self.current == 'start':
+            raise RouteError('Não há caminho anterior ao start')
 
-        previous_route = '/'.join(self.current.split('/')[:-1])
+        previous_route = self.separator.join(self.current.split(self.separator)[:-1])
         return previous_route
 
     def get_next(self, next_part: str) -> str:
@@ -50,8 +52,8 @@ class Route:
         Returns:
             str: O próximo caminho construído a partir da rota atual e da parte fornecida.
         """
-        next_part = next_part.strip().upper()
-        next_route = f"{self.current.rstrip('/')}{next_part}"
+        next_part = next_part.strip().lower()
+        next_route = f"{self.current.rstrip(self.separator)}{next_part}"
         if next_route not in self.routes:
             raise RouteError(f'Rota não encontrada: {next_route}')
         return next_route

chatgraph/types/user_state.py

@@ -31,6 +31,16 @@ class UserState(ABC):
             menu (str): O menu a ser definido para o cliente.
         """
         pass
+    
+    @abstractmethod
+    def delete_menu(self, customer_id: str) -> None:
+        """
+        Deleta o menu atual para o ID de cliente fornecido.
+
+        Args:
+            customer_id (str): O ID do cliente.
+        """
+        pass
 
 
 class SimpleUserState(UserState):
@@ -49,7 +59,7 @@ class SimpleUserState(UserState):
 
     def get_menu(self, customer_id: str) -> str:
         """
-        Retorna o menu atual para o ID de cliente fornecido. Se o cliente não tiver um menu definido, define 'START' como padrão.
+        Retorna o menu atual para o ID de cliente fornecido. Se o cliente não tiver um menu definido, define 'start' como padrão.
 
         Args:
             customer_id (str): O ID do cliente.
@@ -57,8 +67,8 @@ class SimpleUserState(UserState):
         Returns:
             str: O menu atual associado ao cliente.
         """
-        menu = self.states.get(customer_id, 'START')
-        if menu == 'START':
+        menu = self.states.get(customer_id, 'start')
+        if menu == 'start':
             self.set_menu(customer_id, menu)
         return menu
 
@@ -71,4 +81,14 @@ class SimpleUserState(UserState):
             menu (str | None): O menu a ser definido para o cliente. Se None, não faz nenhuma alteração.
         """
         if menu:
-            self.states[customer_id] = menu.upper()
+            self.states[customer_id] = menu.lower()
+
+    def delete_menu(self, customer_id: str) -> None:
+        """
+        Deleta o menu atual para o ID de cliente fornecido.
+
+        Args:
+            customer_id (str): O ID do cliente.
+        """
+        if customer_id in self.states:
+            self.states.pop(customer_id)

{chatgraph-0.1.1.dist-info → chatgraph-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: chatgraph
-Version: 0.1.1
+Version: 0.1.4
 Summary: A user-friendly chatbot library
 Home-page: https://github.com/irissonnlima/chatgraph
 License: MIT
@@ -108,11 +108,11 @@ from chatgraph import ChatbotApp, ChatbotRouter, SimpleUserState, RabbitMessageC
 # Definindo rotas com ChatbotRouter
 router = ChatbotRouter()
 
-@router.route("START")
+@router.route("start")
 def say_hello():
-    return ChatbotResponse(message="Hello! How can I assist you today?", route="HELP")
+    return ChatbotResponse(message="Hello! How can I assist you today?", route=".help")
 
-@router.route("/HELP")
+@router.route(".help")
 def provide_help():
     return ChatbotResponse(message="Here are some things I can help with: ...")
 

chatgraph-0.1.4.dist-info/RECORD

@@ -0,0 +1,17 @@
+chatgraph/__init__.py,sha256=qPA9Vw2SZivqVUlB19D-YrRuequMThR6kgO2XsZcwDc,602
+chatgraph/auth/credentials.py,sha256=xsMEpLQnc66novPjL6upocMcnUnvFJ7yxINzUenkxmc,2388
+chatgraph/bot/chatbot_model.py,sha256=6tPoplS9nPHMYK0gSKFGq6cQr3dA2jOiBJTmQVuOb0I,6643
+chatgraph/bot/chatbot_router.py,sha256=kZ_4X5AhhE2mntx4tcHiapaSKC1T4K1jqIVjLp1Pjg0,2817
+chatgraph/error/chatbot_error.py,sha256=4sEcW8vz0eQk2QDmDygucVM4caHliZW5iH7XJvmLBuk,1897
+chatgraph/error/route_error.py,sha256=CY8m82ap7-Sr-DXPsolltRW50TqD__5RyXBmNNJCWr8,793
+chatgraph/messages/base_message_consumer.py,sha256=OSdTT4dHIzawLDOCZ-4hZ06T8UBxoJIosqvXl7gxpM0,1099
+chatgraph/messages/rabbitMQ_message_consumer.py,sha256=mRcJ1Hbd5wPFxC3v6Tj3pYvjd9yAc398Ys6cUox-CTY,7005
+chatgraph/messages/test_message_consumer.py,sha256=9XIkbCHd1S6S8pINRT-SLEvUT0TQWBCsdPhYN6PpZ2s,518
+chatgraph/types/message_types.py,sha256=NBuebmpO2e9ilspBoFgs9O3rY_VQ2AP_Z8Q_nC70nyM,965
+chatgraph/types/output_state.py,sha256=fpJ_hGO4aZ3wr6DV4i9ctnkHytWhK6ZDpKpJ3vSwRyY,3064
+chatgraph/types/route.py,sha256=nKTqzwGl7d_Bu8G6Sr0EmmhuuiZWKEoSozITRrdyi1g,2587
+chatgraph/types/user_state.py,sha256=B17bN300RW_9-WUbI7pWK_BUCvMbdpm6gLQHPqdGly4,2858
+chatgraph-0.1.4.dist-info/LICENSE,sha256=rVJozpRzDlplOpvI8A1GvmfVS0ReYdZvMWc1j2jV0v8,1090
+chatgraph-0.1.4.dist-info/METADATA,sha256=KQyN7GDztKsyFwUM4F_kF9eFE--Bi44ajc7AsaI6-Mg,5829
+chatgraph-0.1.4.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+chatgraph-0.1.4.dist-info/RECORD,,

chatgraph-0.1.1.dist-info/RECORD

@@ -1,16 +0,0 @@
-chatgraph/__init__.py,sha256=qPA9Vw2SZivqVUlB19D-YrRuequMThR6kgO2XsZcwDc,602
-chatgraph/auth/credentials.py,sha256=xsMEpLQnc66novPjL6upocMcnUnvFJ7yxINzUenkxmc,2388
-chatgraph/bot/chatbot_model.py,sha256=D2MGguq3Fnl9xiY0frpk_-DkTNgeBV57q5w3jx8Kba4,6296
-chatgraph/bot/chatbot_router.py,sha256=CQxu7ZiLBZDzXso65f4u3jfLA8BsuTAmp_tonFhFdc0,2817
-chatgraph/error/chatbot_error.py,sha256=4sEcW8vz0eQk2QDmDygucVM4caHliZW5iH7XJvmLBuk,1897
-chatgraph/error/route_error.py,sha256=CY8m82ap7-Sr-DXPsolltRW50TqD__5RyXBmNNJCWr8,793
-chatgraph/messages/base_message_consumer.py,sha256=OSdTT4dHIzawLDOCZ-4hZ06T8UBxoJIosqvXl7gxpM0,1099
-chatgraph/messages/rabbitMQ_message_consumer.py,sha256=mRcJ1Hbd5wPFxC3v6Tj3pYvjd9yAc398Ys6cUox-CTY,7005
-chatgraph/types/message_types.py,sha256=NBuebmpO2e9ilspBoFgs9O3rY_VQ2AP_Z8Q_nC70nyM,965
-chatgraph/types/output_state.py,sha256=ZditFyycd6CEvemrW9c7mThQDP1l6tI_8p19Jgj8pbs,1471
-chatgraph/types/route.py,sha256=iSeVDMsH_1Q1n1sAyeiqFdvg2KWIY8DFdGThswwpUBw,2422
-chatgraph/types/user_state.py,sha256=0n7K5k5DGoP3ug8XNPREqdJHGHXmcOwhPrANpXJSDjU,2321
-chatgraph-0.1.1.dist-info/LICENSE,sha256=rVJozpRzDlplOpvI8A1GvmfVS0ReYdZvMWc1j2jV0v8,1090
-chatgraph-0.1.1.dist-info/METADATA,sha256=yt3nbvNpQX-gCBzx8zP9Uz6ZDPfpCml2Dpd1Z8D8KuU,5828
-chatgraph-0.1.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-chatgraph-0.1.1.dist-info/RECORD,,