began ChoiceRecognizers class -- pending Recognizers-Numbers publishing however to cont. further

Author: Zerryth

libraries/botbuilder-dialogs/botbuilder/dialogs/choices/choice_recognizers.py

@@ -1,6 +1,15 @@
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License.
 
+from typing import List, Union
+
+
+from .choice import Choice
+from .find import Find
+from .find_choices_options import FindChoicesOptions
+from .found_choice import FoundChoice
+from .model_result import ModelResult
+
 class ChoiceRecognizers:
     """ Contains methods for matching user input against a list of choices. """
 
@@ -13,3 +22,45 @@ class ChoiceRecognizers:
     # TS has only 1 recognizer funtion, recognizeChoices()
         # nested within recognizeChoices() is matchChoiceByIndex()
 
+    @staticmethod
+    def recognize_choices(
+        utterance: str,
+        choices: List[Union[str, Choice]],
+        options: FindChoicesOptions = None
+    ) -> ModelResult:
+        """
+        Matches user input against a list of choices.
+
+        Parameters:
+        -----------
+
+        utterance: The input.
+        
+        choices: The list of choices.
+
+        options: (Optional) Options to control the recognition strategy.
+
+        Returns:
+        --------
+        A list of found choices, sorted by most relevant first.
+        """
+        if utterance == None:
+            utterance = ''
+
+        # Try finding choices by text search first
+        # - We only want to use a single strategy for returning results to avoid issues where utterances
+        # like the "the third one" or "the red one" or "the first division book" would miss-recognize as
+        # a numerical index or ordinal as well
+        locale = options.locale if options.locale else 'FILL IN WITH RECOGNIZERS-NUMBER (C# Recognizers.Text.Culture.English)'
+        matched = Find.find_choices(utterance, choices, options)
+
+        if len(matched) == 0:
+            # Next try finding by ordinal
+            # matches = WRITE RecognizeOrdinal()
+            pass
+    
+    @staticmethod
+    def _recognize_ordinal(utterance: str, culture: str) -> List[ModelResult]:
+        # NEED NumberRecognizer class from recognizers-numbers
+        pass
+