chatgraph 0.6.4__py3-none-any.whl

chatgraph-0.6.4.dist-info/METADATA

@@ -0,0 +1,521 @@
+Metadata-Version: 2.4
+Name: chatgraph
+Version: 0.6.4
+Summary: A user-friendly chatbot library
+License: MIT
+License-File: LICENSE
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: aio-pika (>=9.5.8,<10.0.0)
+Requires-Dist: grpcio (>=1.67.0,<2.0.0)
+Requires-Dist: grpcio-tools (>=1.67.0,<2.0.0)
+Requires-Dist: httpx (>=0.28.1,<0.29.0)
+Requires-Dist: matplotlib (>=3.10.0,<4.0.0)
+Requires-Dist: networkx (>=3.4.2,<4.0.0)
+Requires-Dist: pika (>=1.3.2,<2.0.0)
+Requires-Dist: protobuf (>=6.31.1,<7.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: Homepage, https://github.com/irissonnlima/chatgraph
+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
+```
+
+## **Testes**
+
+O ChatGraph possui uma estrutura completa de testes dividida em **testes unitários** e **testes de integração**.
+
+### **Estrutura de Testes**
+
+```
+tests/
+├── unit/                    # Testes unitários (rápidos, isolados, usam mocks)
+│   ├── test_router_http_client.py
+│   ├── test_models_*.py
+│   └── conftest.py
+└── integration/             # Testes de integração (chamadas reais para APIs)
+    ├── test_router_client_integration.py
+    └── conftest.py
+```
+
+### **Executando Testes Unitários**
+
+Os testes unitários usam mocks e são rápidos. Execute-os com:
+
+```bash
+# Todos os testes unitários
+poetry run pytest tests/unit/ -v
+
+# Teste específico
+poetry run pytest tests/unit/test_router_http_client.py -v
+
+# Com cobertura
+poetry run pytest tests/unit/ --cov=chatgraph --cov-report=html
+```
+
+### **Executando Testes de Integração**
+
+Os testes de integração fazem chamadas **reais** para APIs externas e validam contratos e comportamentos reais.
+
+#### **1. Configure as Variáveis de Ambiente**
+
+Crie um arquivo `.env` ou exporte as variáveis:
+
+```bash
+# Obrigatório
+export ROUTER_API_BASE_URL="https://api.example.com/v1/actions"
+
+# Opcional (se a API requer autenticação)
+export ROUTER_API_USERNAME="seu_usuario"
+export ROUTER_API_PASSWORD="sua_senha"
+
+# Opcional (timeout padrão: 60s)
+export ROUTER_API_TIMEOUT="60.0"
+
+# Opcional (IDs para testes)
+export TEST_USER_ID="user_test_001"
+export TEST_COMPANY_ID="company_test_001"
+```
+
+**No Windows (PowerShell):**
+
+```powershell
+$env:ROUTER_API_BASE_URL="https://api.example.com/v1/actions"
+$env:ROUTER_API_USERNAME="seu_usuario"
+$env:ROUTER_API_PASSWORD="sua_senha"
+```
+
+#### **2. Execute os Testes de Integração**
+
+```bash
+# Todos os testes de integração
+poetry run pytest tests/integration/ -v
+
+# Usando marker
+poetry run pytest -m integration -v
+
+# Teste específico
+poetry run pytest tests/integration/test_router_client_integration.py::TestRouterHTTPClientIntegrationSessions::test_get_all_sessions_real_api -v
+```
+
+#### **3. Skip Automático**
+
+Se as variáveis de ambiente não estiverem configuradas, os testes de integração serão **automaticamente pulados** com mensagem informativa:
+
+```
+SKIPPED: Variáveis de ambiente não configuradas: ROUTER_API_BASE_URL. 
+Configure as variáveis para executar testes de integração.
+```
+
+### **Executando Todos os Testes**
+
+```bash
+# Todos os testes (unitários + integração)
+poetry run pytest -v
+
+# Com cobertura
+poetry run pytest --cov=chatgraph --cov-report=html
+poetry run start htmlcov/index.html  # Abre relatório de cobertura
+```
+
+### **Markers Disponíveis**
+
+- `@pytest.mark.unit` - Testes unitários (rápidos, isolados)
+- `@pytest.mark.integration` - Testes de integração (requerem APIs externas)
+
+**Exemplos:**
+
+```bash
+# Apenas unitários
+poetry run pytest -m unit -v
+
+# Apenas integração
+poetry run pytest -m integration -v
+
+# Excluir integração
+poetry run pytest -m "not integration" -v
+```
+
+### **Boas Práticas**
+
+1. **Desenvolvimento:** Execute testes unitários frequentemente (são rápidos)
+2. **Pre-commit:** Execute todos os testes unitários antes de commitar
+3. **Pre-deploy:** Execute testes de integração para validar com API real
+4. **CI/CD:** Configure variáveis de ambiente no pipeline para testes de integração
+
+### **Troubleshooting**
+
+**Problema:** Testes de integração falhando
+
+- ✅ Verifique se as variáveis de ambiente estão configuradas
+- ✅ Confirme que a API está acessível
+- ✅ Valide credenciais (username/password)
+- ✅ Verifique logs de erro detalhados com `-v` ou `-vv`
+
+**Problema:** Testes unitários falhando
+
+- ✅ Execute `poetry install` para garantir dependências
+- ✅ Verifique se `respx` está instalado (`poetry add --group dev respx`)
+
+## **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.
+
+**Ao contribuir:**
+
+- ✅ Adicione testes unitários para novas funcionalidades
+- ✅ Adicione testes de integração se houver integração com APIs
+- ✅ Mantenha cobertura de testes acima de 80%
+- ✅ Execute `poetry run task lint` antes de commitar
+
+## **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.6.4.dist-info/RECORD

@@ -0,0 +1,27 @@
+chatgraph/__init__.py,sha256=O8lB4R5IEneRulFv5KEQMXHoKXsEgvhHdGp5fXJiQhU,855
+chatgraph/auth/credentials.py,sha256=qLgoDwkE53jS90p-w08v49E0-XZ0Fu99yNX5Y30N4vo,2317
+chatgraph/bot/chatbot_model.py,sha256=Q-o4JuRyP7JR0pVOWv_x7VwhasHqiNXVwv0LogOmfsM,7828
+chatgraph/bot/chatbot_router.py,sha256=TDSPCLsbnBiyxezpFM-9tfffKGK_Z4UabZcw_NhM0PI,2501
+chatgraph/bot/default_functions.py,sha256=5V-KrZWsZSaHz41Qgn63HN9nqb6LgirCQ9LfQ52idFs,716
+chatgraph/cli/__init__.py,sha256=NOfVmX4erWo59F2AJexEAV-EHMZ4eqXJpAcKL3nlL4I,7226
+chatgraph/error/chatbot_error.py,sha256=eorGZ19cMAUgQR2KdbA9t6goEtrZjFW8l27VQoHWT_8,1840
+chatgraph/error/route_error.py,sha256=lYuRVaTsNUyWQtVBC77OiJtsArw1dzLzSDbP8Tw2yCU,767
+chatgraph/gRPC/gRPCCall.py,sha256=59PsCfCzYq3MwvusjIQ972w3AH383Ev5VFZHxbgBDZk,7372
+chatgraph/messages/message_consumer.py,sha256=mzJ0Tgpm0D2gTCWzmr9wO7vIiT_W3LsFF6ee1unHKVY,7608
+chatgraph/models/actions.py,sha256=g2ww4Ek3FSepAMcFdWAP4i6AuMo1AbhDGg5cIlFi0cY,3675
+chatgraph/models/message.py,sha256=5vbJrYtzJU0gTc_UdIZkprwj02KxUydJwMERELDqvpo,10315
+chatgraph/models/userstate.py,sha256=GJFX-kzaltCv_6qa9nC8LUYWaAzi9gaeKBqZE4bASX8,6494
+chatgraph/pb/router.proto,sha256=Rzye1x6rGtBeTVlkvsAslmKgLB631fTqp1QgIrU2AgM,3337
+chatgraph/pb/router_pb2.py,sha256=eSo0ncYDSG3ryIfWNFzqmG3anx-VmQ2nGXBy1gPnXmQ,7962
+chatgraph/pb/router_pb2_grpc.py,sha256=iaQQsYPc8Tihuf4sWEI48DhvhtCYtDqFBHhwRtE57ps,29886
+chatgraph/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+chatgraph/services/router_http_client.py,sha256=wgpMFXPJuWffnOSI62D8JfwBUF7x7X08I5DGaolvzFQ,13132
+chatgraph/types/background_task.py,sha256=9JQCvb-wTUbh777-z4DpWBwgESBj5DgxaD9cVzAE2to,902
+chatgraph/types/end_types.py,sha256=CSqkbLyeaXyk2p0BZotbioVJq0nyk2P-nXkvy5UevlI,2012
+chatgraph/types/route.py,sha256=HZgfo329qt_LGf4DVbwyKDPXwdBGaFgONxqzMnt1z6E,3068
+chatgraph/types/usercall.py,sha256=JpwCr26xaxUXg5oay1o2io5JuXeNfdtBQjHF6invSKs,7433
+chatgraph-0.6.4.dist-info/METADATA,sha256=7QiIwE34ZHQhJa_M_oBwxCJkFAJQ4DdweTcSXLrKgXA,17235
+chatgraph-0.6.4.dist-info/WHEEL,sha256=M5asmiAlL6HEcOq52Yi5mmk9KmTVjY2RDPtO4p9DMrc,88
+chatgraph-0.6.4.dist-info/entry_points.txt,sha256=bO9_Q-PqE5vCNNo6ke_-3j2gHfKQMDGnKDTkNuCdBuA,48
+chatgraph-0.6.4.dist-info/licenses/LICENSE,sha256=LDPw26HLt7Shwj_1sg2pN_BeYzbcjO77fGbFGEmBKuk,1069
+chatgraph-0.6.4.dist-info/RECORD,,

chatgraph-0.6.4.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: poetry-core 2.2.0
+Root-Is-Purelib: true
+Tag: py3-none-any

chatgraph-0.6.4.dist-info/entry_points.txt

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

chatgraph-0.6.4.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Irisson Lima
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.