ChatterBot 1.2.7__tar.gz → 1.2.9__tar.gz

{chatterbot-1.2.7 → chatterbot-1.2.9}/ChatterBot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ChatterBot
-Version: 1.2.7
+Version: 1.2.9
 Summary: ChatterBot is a machine learning, conversational dialog engine
 Author: Gunther Cox
 License-Expression: BSD-3-Clause
@@ -28,10 +28,10 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: <3.13,>=3.9
+Requires-Python: <3.14,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mathparse<0.2,>=0.1
+Requires-Dist: mathparse<0.3,>=0.2
 Requires-Dist: python-dateutil<2.10,>=2.9
 Requires-Dist: sqlalchemy<2.1,>=2.0
 Requires-Dist: spacy<3.9,>=3.8
@@ -42,20 +42,21 @@ Requires-Dist: coverage; extra == "test"
 Requires-Dist: sphinx<8.2,>=5.3; extra == "test"
 Requires-Dist: sphinx-sitemap>=2.6.0; extra == "test"
 Requires-Dist: huggingface_hub; extra == "test"
+Requires-Dist: django<6.0,<=4.1; extra == "test"
 Provides-Extra: dev
 Requires-Dist: pint>=0.8.1; extra == "dev"
 Requires-Dist: pyyaml<7.0,>=6.0; extra == "dev"
 Requires-Dist: chatterbot-corpus<1.3.0,>=1.2.2; extra == "dev"
-Requires-Dist: ollama<1.0,>=0.4.7; extra == "dev"
+Requires-Dist: ollama<1.0,>=0.6.0; extra == "dev"
 Requires-Dist: openai; extra == "dev"
 Provides-Extra: redis
-Requires-Dist: redis[hiredis]<5.3; extra == "redis"
-Requires-Dist: langchain-redis<=0.2.0; extra == "redis"
+Requires-Dist: redis[hiredis]<7.0; extra == "redis"
+Requires-Dist: langchain-redis<=0.2.5; extra == "redis"
 Requires-Dist: langchain-huggingface<=0.1.2; extra == "redis"
 Requires-Dist: accelerate<=1.6.0; extra == "redis"
 Requires-Dist: sentence-transformers<=4.0.2; extra == "redis"
 Provides-Extra: mongodb
-Requires-Dist: pymongo<4.12,>=4.11; extra == "mongodb"
+Requires-Dist: pymongo<4.16,>=4.11; extra == "mongodb"
 Dynamic: license-file
 
 ![ChatterBot: Machine learning in Python](https://i.imgur.com/b3SCmGT.png)
@@ -163,6 +164,16 @@ See release notes for changes https://github.com/gunthercox/ChatterBot/releases
 5. Use the projects [built-in automated testing](https://docs.chatterbot.us/testing/).
    to help make sure that your contribution is free from errors.
 
+# Sponsors
+
+ChatterBot is sponsored by:
+
+<p style="font-size:21px; color:black;">Browser testing via 
+   <a href="https://www.lambdatest.com/?utm_source=chatterbot&utm_medium=sponsor" target="_blank">
+      <img src="https://www.lambdatest.com/blue-logo.png" style="vertical-align: middle;" width="250" height="45" />
+   </a>
+</p>
+
 # License
 
 ChatterBot is licensed under the [BSD 3-clause license](https://opensource.org/licenses/BSD-3-Clause).

{chatterbot-1.2.7 → chatterbot-1.2.9}/ChatterBot.egg-info/requires.txt

@@ -1,4 +1,4 @@
-mathparse<0.2,>=0.1
+mathparse<0.3,>=0.2
 python-dateutil<2.10,>=2.9
 sqlalchemy<2.1,>=2.0
 spacy<3.9,>=3.8
@@ -8,15 +8,15 @@ tqdm
 pint>=0.8.1
 pyyaml<7.0,>=6.0
 chatterbot-corpus<1.3.0,>=1.2.2
-ollama<1.0,>=0.4.7
+ollama<1.0,>=0.6.0
 openai
 
 [mongodb]
-pymongo<4.12,>=4.11
+pymongo<4.16,>=4.11
 
 [redis]
-redis[hiredis]<5.3
-langchain-redis<=0.2.0
+redis[hiredis]<7.0
+langchain-redis<=0.2.5
 langchain-huggingface<=0.1.2
 accelerate<=1.6.0
 sentence-transformers<=4.0.2
@@ -27,3 +27,4 @@ coverage
 sphinx<8.2,>=5.3
 sphinx-sitemap>=2.6.0
 huggingface_hub
+django<6.0,<=4.1

{chatterbot-1.2.7 → chatterbot-1.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ChatterBot
-Version: 1.2.7
+Version: 1.2.9
 Summary: ChatterBot is a machine learning, conversational dialog engine
 Author: Gunther Cox
 License-Expression: BSD-3-Clause
@@ -28,10 +28,10 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3 :: Only
-Requires-Python: <3.13,>=3.9
+Requires-Python: <3.14,>=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mathparse<0.2,>=0.1
+Requires-Dist: mathparse<0.3,>=0.2
 Requires-Dist: python-dateutil<2.10,>=2.9
 Requires-Dist: sqlalchemy<2.1,>=2.0
 Requires-Dist: spacy<3.9,>=3.8
@@ -42,20 +42,21 @@ Requires-Dist: coverage; extra == "test"
 Requires-Dist: sphinx<8.2,>=5.3; extra == "test"
 Requires-Dist: sphinx-sitemap>=2.6.0; extra == "test"
 Requires-Dist: huggingface_hub; extra == "test"
+Requires-Dist: django<6.0,<=4.1; extra == "test"
 Provides-Extra: dev
 Requires-Dist: pint>=0.8.1; extra == "dev"
 Requires-Dist: pyyaml<7.0,>=6.0; extra == "dev"
 Requires-Dist: chatterbot-corpus<1.3.0,>=1.2.2; extra == "dev"
-Requires-Dist: ollama<1.0,>=0.4.7; extra == "dev"
+Requires-Dist: ollama<1.0,>=0.6.0; extra == "dev"
 Requires-Dist: openai; extra == "dev"
 Provides-Extra: redis
-Requires-Dist: redis[hiredis]<5.3; extra == "redis"
-Requires-Dist: langchain-redis<=0.2.0; extra == "redis"
+Requires-Dist: redis[hiredis]<7.0; extra == "redis"
+Requires-Dist: langchain-redis<=0.2.5; extra == "redis"
 Requires-Dist: langchain-huggingface<=0.1.2; extra == "redis"
 Requires-Dist: accelerate<=1.6.0; extra == "redis"
 Requires-Dist: sentence-transformers<=4.0.2; extra == "redis"
 Provides-Extra: mongodb
-Requires-Dist: pymongo<4.12,>=4.11; extra == "mongodb"
+Requires-Dist: pymongo<4.16,>=4.11; extra == "mongodb"
 Dynamic: license-file
 
 ![ChatterBot: Machine learning in Python](https://i.imgur.com/b3SCmGT.png)
@@ -163,6 +164,16 @@ See release notes for changes https://github.com/gunthercox/ChatterBot/releases
 5. Use the projects [built-in automated testing](https://docs.chatterbot.us/testing/).
    to help make sure that your contribution is free from errors.
 
+# Sponsors
+
+ChatterBot is sponsored by:
+
+<p style="font-size:21px; color:black;">Browser testing via 
+   <a href="https://www.lambdatest.com/?utm_source=chatterbot&utm_medium=sponsor" target="_blank">
+      <img src="https://www.lambdatest.com/blue-logo.png" style="vertical-align: middle;" width="250" height="45" />
+   </a>
+</p>
+
 # License
 
 ChatterBot is licensed under the [BSD 3-clause license](https://opensource.org/licenses/BSD-3-Clause).

{chatterbot-1.2.7 → chatterbot-1.2.9}/README.md

@@ -103,6 +103,16 @@ See release notes for changes https://github.com/gunthercox/ChatterBot/releases
 5. Use the projects [built-in automated testing](https://docs.chatterbot.us/testing/).
    to help make sure that your contribution is free from errors.
 
+# Sponsors
+
+ChatterBot is sponsored by:
+
+<p style="font-size:21px; color:black;">Browser testing via 
+   <a href="https://www.lambdatest.com/?utm_source=chatterbot&utm_medium=sponsor" target="_blank">
+      <img src="https://www.lambdatest.com/blue-logo.png" style="vertical-align: middle;" width="250" height="45" />
+   </a>
+</p>
+
 # License
 
 ChatterBot is licensed under the [BSD 3-clause license](https://opensource.org/licenses/BSD-3-Clause).

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/__init__.py

@@ -4,7 +4,7 @@ ChatterBot is a machine learning, conversational dialog engine.
 from .chatterbot import ChatBot
 
 
-__version__ = '1.2.7'
+__version__ = '1.2.9'
 
 __all__ = (
     'ChatBot',

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/chatterbot.py

@@ -77,7 +77,12 @@ class ChatBot(object):
         try:
             Tagger = kwargs.get('tagger', PosLemmaTagger)
 
-            self.tagger = Tagger(language=tagger_language)
+            # Allow instances to be provided for performance optimization
+            # (Example: a pre-loaded model in a tagger when unit testing)
+            if not isinstance(Tagger, type):
+                self.tagger = Tagger
+            else:
+                self.tagger = Tagger(language=tagger_language)
         except IOError as io_error:
             # Return a more helpful error message if possible
             if "Can't find model" in str(io_error):
@@ -224,7 +229,6 @@ class ChatBot(object):
             # Save the response generated for the input
             self.learn_response(response, previous_statement=input_statement)
 
-
         return response
 
     def generate_response(self, input_statement, additional_response_selection_parameters=None):
@@ -345,8 +349,6 @@ class ChatBot(object):
         Returns the latest response in a conversation if it exists.
         Returns None if a matching conversation cannot be found.
         """
-        from chatterbot.conversation import Statement as StatementObject
-
         conversation_statements = list(self.storage.filter(
             conversation=conversation,
             order_by=['id']

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/comparisons.py

@@ -85,7 +85,10 @@ class SpacySimilarity(Comparator):
            python -m spacy download en_core_web_sm
            python -m spacy download de_core_news_sm
 
-        Alternatively, the ``spacy`` models can be installed as Python packages. The following lines could be included in a ``requirements.txt`` or ``pyproject.yml`` file if you needed to pin specific versions:
+        Alternatively, the ``spacy`` models can be installed as Python
+        packages. The following lines could be included in a
+        ``requirements.txt`` or ``pyproject.yml`` file if you needed to pin
+        specific versions:
 
         .. code-block:: text
 

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/components.py

@@ -29,6 +29,9 @@ def chatterbot_bigram_indexer(document):
             token for token in document if not (token.is_punct)
         ]
 
+    # Pairs consist of the part-of-speech of the first token and the
+    # lemma of the second token in the bigram. This provides a good
+    # balance of generalization and specificity for matching.
     bigram_pairs = [
         f"{tokens[i - 1].pos_}:{tokens[i].lemma_.lower()}"
         for i in range(1, len(tokens))

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/ext/django_chatterbot/abstract_models.py

@@ -3,25 +3,15 @@ from chatterbot import constants
 from django.db import models
 from django.utils import timezone
 from django.conf import settings
+from django.apps import apps
 
 
 DJANGO_APP_NAME = constants.DEFAULT_DJANGO_APP_NAME
-STATEMENT_MODEL = 'Statement'
-TAG_MODEL = 'Tag'
 
-if hasattr(settings, 'CHATTERBOT'):
-    """
-    Allow related models to be overridden in the project settings.
-    Default to the original settings if one is not defined.
-    """
-    DJANGO_APP_NAME = settings.CHATTERBOT.get(
-        'django_app_name',
-        DJANGO_APP_NAME
-    )
-    STATEMENT_MODEL = settings.CHATTERBOT.get(
-        'statement_model',
-        STATEMENT_MODEL
-    )
+# Default model paths for swappable models
+# These can be overridden via CHATTERBOT_STATEMENT_MODEL and CHATTERBOT_TAG_MODEL settings
+DEFAULT_STATEMENT_MODEL = f'{DJANGO_APP_NAME}.Statement'
+DEFAULT_TAG_MODEL = f'{DJANGO_APP_NAME}.Tag'
 
 
 class AbstractBaseTag(models.Model):
@@ -88,7 +78,9 @@ class AbstractBaseStatement(models.Model, StatementMixin):
     )
 
     tags = models.ManyToManyField(
-        TAG_MODEL,
+        settings.CHATTERBOT_TAG_MODEL if hasattr(
+            settings, 'CHATTERBOT_TAG_MODEL'
+        ) else DEFAULT_TAG_MODEL,
         related_name='statements',
         help_text='The tags that are associated with this statement.'
     )
@@ -117,17 +109,51 @@ class AbstractBaseStatement(models.Model, StatementMixin):
             return self.text
         return '<empty>'
 
+    @classmethod
+    def get_tag_model(cls):
+        """
+        Return the Tag model class, respecting the swappable setting.
+
+        This method checks:
+        1. Django settings (CHATTERBOT_TAG_MODEL) - project-wide configuration
+        2. The model referenced by the 'tags' field - handles custom models via kwargs
+        3. Falls back to DEFAULT_TAG_MODEL if introspection fails
+
+        This ensures the correct Tag model is used even when custom models
+        are specified via storage adapter kwargs rather than Django settings.
+        """
+        tag_model_path = getattr(settings, 'CHATTERBOT_TAG_MODEL', None)
+
+        if tag_model_path:
+            return apps.get_model(tag_model_path)
+
+        # If no setting, infer from the ManyToManyField relationship for
+        # cases where custom models are specified via kwargs
+        try:
+            # Get the model that this class's 'tags' field points to
+            tags_field = cls._meta.get_field('tags')
+            related_model = tags_field.related_model
+
+            # Resolve strings (lazy references)
+            if isinstance(related_model, str):
+                return apps.get_model(related_model)
+            return related_model
+        except Exception:
+            # Fallback to default if introspection fails
+            return apps.get_model(DEFAULT_TAG_MODEL)
+
     def get_tags(self) -> list[str]:
         """
         Return the list of tags for this statement.
-        (Overrides the method from StatementMixin)
         """
         return list(self.tags.values_list('name', flat=True))
 
     def add_tags(self, *tags):
         """
         Add a list of strings to the statement as tags.
-        (Overrides the method from StatementMixin)
         """
-        for _tag in tags:
-            self.tags.get_or_create(name=_tag)
+        TagModel = self.get_tag_model()
+
+        for tag_name in tags:
+            tag_obj, _created = TagModel.objects.get_or_create(name=tag_name)
+            self.tags.add(tag_obj)

chatterbot-1.2.9/chatterbot/ext/django_chatterbot/models.py

@@ -0,0 +1,26 @@
+from chatterbot.ext.django_chatterbot.abstract_models import AbstractBaseStatement, AbstractBaseTag
+
+
+class Statement(AbstractBaseStatement):
+    """
+    A statement represents a single spoken entity, sentence or
+    phrase that someone can say.
+
+    This model can be swapped for a custom model by setting
+    CHATTERBOT_STATEMENT_MODEL in your Django settings.
+    """
+
+    class Meta:
+        swappable = 'CHATTERBOT_STATEMENT_MODEL'
+
+
+class Tag(AbstractBaseTag):
+    """
+    A label that categorizes a statement.
+
+    This model can be swapped for a custom model by setting
+    CHATTERBOT_TAG_MODEL in your Django settings.
+    """
+
+    class Meta:
+        swappable = 'CHATTERBOT_TAG_MODEL'

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/logic/best_match.py

@@ -78,7 +78,6 @@ class BestMatch(LogicAdapter):
                 additional_response_selection_parameters
             )
 
-
         # Get all statements with text similar to the closest match
         response_list = list(self.chatbot.storage.filter(**response_selection_parameters))
 

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/logic/specific_response.py

@@ -20,7 +20,19 @@ class SpecificResponseAdapter(LogicAdapter):
     def __init__(self, chatbot, **kwargs):
         super().__init__(chatbot, **kwargs)
 
-        self.input_text = kwargs.get('input_text')
+        try:
+            self.input_text = kwargs['input_text']
+        except KeyError:
+            raise chatbot.ChatBotException(
+                'The SpecificResponseAdapter requires an input_text parameter.'
+            )
+
+        try:
+            self._output_text = kwargs['output_text']
+        except KeyError:
+            raise chatbot.ChatBotException(
+                'The SpecificResponseAdapter requires an output_text parameter.'
+            )
 
         self.matcher = None
 
@@ -33,8 +45,6 @@ class SpecificResponseAdapter(LogicAdapter):
 
             self.matcher.add('SpecificResponse', [self.input_text])
 
-        self._output_text = kwargs.get('output_text')
-
     def _initialize_nlp(self, language):
         model = get_model_for_language(language)
 

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/logic/unit_conversion.py

@@ -85,7 +85,7 @@ class UnitConversion(LogicAdapter):
         for unit in unit_variations:
             try:
                 return getattr(self.unit_registry, unit)
-            except Exception:
+            except AttributeError:
                 continue
         return None
 

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/parsing.py

@@ -503,7 +503,7 @@ regex = [
 ]
 
 
-def convert_string_to_number(value):
+def convert_string_to_number(value: str) -> int:
     """
     Convert strings to numbers
     """
@@ -517,7 +517,7 @@ def convert_string_to_number(value):
     return sum(num_list)
 
 
-def convert_time_to_hour_minute(hour, minute, convention):
+def convert_time_to_hour_minute(hour: str, minute: str, convention: str) -> dict:
     """
     Convert time to hour, minute
     """
@@ -532,12 +532,19 @@ def convert_time_to_hour_minute(hour, minute, convention):
     minute = int(minute)
 
     if convention.lower() == 'pm':
-        hour += 12
+        # Handle 12 PM (noon) - it stays as 12
+        # Handle 1-11 PM - add 12
+        if hour != 12:
+            hour += 12
+    else:
+        # Handle 12 AM (midnight) - convert to 0
+        if hour == 12:
+            hour = 0
 
     return {'hours': hour, 'minutes': minute}
 
 
-def date_from_quarter(base_date, ordinal, year):
+def date_from_quarter(base_date: datetime, ordinal: int, year: int) -> list[datetime]:
     """
     Extract date from quarter of a year
     """
@@ -554,7 +561,7 @@ def date_from_quarter(base_date, ordinal, year):
     ]
 
 
-def date_from_relative_day(base_date, time, dow):
+def date_from_relative_day(base_date: datetime, time: str, dow: str) -> datetime:
     """
     Converts relative day to time
     Ex: this tuesday, last tuesday
@@ -577,7 +584,7 @@ def date_from_relative_day(base_date, time, dow):
         return next_week_day(base_date, num)
 
 
-def date_from_relative_week_year(base_date, time, dow, ordinal=1):
+def date_from_relative_week_year(base_date: datetime, time: str, dow: str, ordinal: int = 1) -> datetime:
     """
     Converts relative day to time
     Eg. this tuesday, last tuesday
@@ -608,7 +615,10 @@ def date_from_relative_week_year(base_date, time, dow, ordinal=1):
                 day = min(relative_date.day, calendar.monthrange(year, month)[1])
                 return datetime(year, month, day)
             else:
-                return datetime(relative_date.year, relative_date.month + ord, relative_date.day)
+                # Base the day to valid range on the target month
+                target_month = relative_date.month + ord
+                day = min(relative_date.day, calendar.monthrange(relative_date.year, target_month)[1])
+                return datetime(relative_date.year, target_month, day)
         elif time == 'end of the':
             return datetime(
                 relative_date.year,
@@ -636,7 +646,7 @@ def date_from_relative_week_year(base_date, time, dow, ordinal=1):
             return datetime(relative_date.year, relative_date.month, relative_date.day, 23, 59, 59)
 
 
-def date_from_adverb(base_date, name):
+def date_from_adverb(base_date: datetime, name: str) -> datetime:
     """
     Convert Day adverbs to dates
     Tomorrow => Date
@@ -645,14 +655,14 @@ def date_from_adverb(base_date, name):
     # Reset date to start of the day
     adverb_date = datetime(base_date.year, base_date.month, base_date.day)
     if name == 'today' or name == 'tonite' or name == 'tonight':
-        return adverb_date.today().replace(hour=0, minute=0, second=0, microsecond=0)
+        return adverb_date
     elif name == 'yesterday':
         return adverb_date - timedelta(days=1)
     elif name == 'tomorrow' or name == 'tom':
         return adverb_date + timedelta(days=1)
 
 
-def date_from_duration(base_date, number_as_string, unit, duration, base_time=None):
+def date_from_duration(base_date: datetime, number_as_string: str, unit: str, duration: str, base_time: str = None) -> datetime:
     """
     Find dates from duration
     Eg: 20 days from now
@@ -682,7 +692,7 @@ def date_from_duration(base_date, number_as_string, unit, duration, base_time=No
         return base_date + timedelta(**args)
 
 
-def this_week_day(base_date, weekday):
+def this_week_day(base_date: datetime, weekday: int) -> datetime:
     """
     Finds coming weekday
     """
@@ -698,7 +708,7 @@ def this_week_day(base_date, weekday):
     return day
 
 
-def previous_week_day(base_date, weekday):
+def previous_week_day(base_date: datetime, weekday: int) -> datetime:
     """
     Finds previous weekday
     """
@@ -708,9 +718,9 @@ def previous_week_day(base_date, weekday):
     return day
 
 
-def next_week_day(base_date, weekday):
+def next_week_day(base_date: datetime, weekday: int) -> datetime:
     """
-    Finds next weekday
+    Finds the next weekday.
     """
     day_of_week = base_date.weekday()
     end_of_this_week = base_date + timedelta(days=6 - day_of_week)
@@ -720,7 +730,7 @@ def next_week_day(base_date, weekday):
     return day
 
 
-def datetime_parsing(text, base_date=datetime.now()):
+def datetime_parsing(text: str, base_date: datetime = datetime.now()) -> list[tuple[str, datetime, tuple[int, int]]]:
     """
     Extract datetime objects from a string of text.
     """

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/response_selection.py

@@ -18,17 +18,28 @@ def get_most_frequent_response(input_statement: Statement, response_list: list[S
 
     :return: The response statement with the greatest number of occurrences.
     """
-    matching_response = None
-    occurrence_count = -1
-
     logger = logging.getLogger(__name__)
     logger.info('Selecting response with greatest number of occurrences.')
 
+    # Collect all unique text values from response_list
+    response_texts = set(statement.text for statement in response_list)
+
+    # Fetch all statements matching the input in a single query
+    # Then count occurrences in memory
+    all_matching = list(storage.filter(in_response_to=input_statement.text))
+
+    # Count how many times each response text appears in the database
+    occurrence_counts = {}
+    for statement in all_matching:
+        if statement.text in response_texts:
+            occurrence_counts[statement.text] = occurrence_counts.get(statement.text, 0) + 1
+
+    # Find the response with the highest occurrence count
+    matching_response = None
+    occurrence_count = -1
+
     for statement in response_list:
-        count = len(list(storage.filter(
-            text=statement.text,
-            in_response_to=input_statement.text)
-        ))
+        count = occurrence_counts.get(statement.text, 0)
 
         # Keep the more common statement
         if count >= occurrence_count:

{chatterbot-1.2.7 → chatterbot-1.2.9}/chatterbot/search.py

@@ -74,6 +74,10 @@ class IndexedTextSearch:
 
                 yield statement
 
+                if confidence >= 1.0:
+                    self.chatbot.logger.info('Exact match found, stopping search')
+                    break
+
 
 class TextSearch:
     """
@@ -149,3 +153,7 @@ class TextSearch:
                 ))
 
                 yield statement
+
+                if confidence >= 1.0:
+                    self.chatbot.logger.info('Exact match found, stopping search')
+                    break