webex-bot 0.5.1__tar.gz → 0.6.0__tar.gz

{webex_bot-0.5.1 → webex_bot-0.6.0}/CONTRIBUTING.rst

@@ -102,7 +102,7 @@ Before you submit a pull request, check that it meets these guidelines:
 2. If the pull request adds functionality, the docs should be updated. Put
    your new functionality into a function with a docstring, and add the
    feature to the list in README.rst.
-3. The pull request should work for Python 3.5, 3.6, 3.7 and 3.8, and for PyPy. Check
+3. The pull request should work for Python 3.10, 3.11, 3.12, and 3.13, and for PyPy. Check
    https://travis-ci.com/fbradyirl/webex_bot/pull_requests
    and make sure that the tests pass for all supported Python versions.
 

{webex_bot-0.5.1 → webex_bot-0.6.0}/PKG-INFO

@@ -1,28 +1,55 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: webex_bot
-Version: 0.5.1
+Version: 0.6.0
 Summary: Python package for a Webex Bot based on websockets.
 Home-page: https://github.com/fbradyirl/webex_bot
 Author: Finbarr Brady
 Author-email: finbarr@somemail.com
 License: MIT license
 Keywords: webex_bot
-Platform: UNKNOWN
 Classifier: Development Status :: 2 - Pre-Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Requires-Python: >=3.8
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
-Provides-Extra: proxy
 License-File: LICENSE
+Requires-Dist: webexpythonsdk==2.0.4
+Requires-Dist: coloredlogs
+Requires-Dist: websockets==11.0.3
+Requires-Dist: backoff
+Provides-Extra: proxy
+Requires-Dist: websockets_proxy>=0.1.1; extra == "proxy"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 # Introduction
 
 [![Pypi](https://img.shields.io/pypi/v/webex_bot.svg)](https://pypi.python.org/pypi/webex_bot) [![Build Status](https://github.com/fbradyirl/webex_bot/workflows/Python%20package/badge.svg)](https://github.com/fbradyirl/webex_bot/actions)
 
+> [!IMPORTANT]
+> This repository is only sporadically maintained. Breaking API changes will be maintained on a best efforts basis.
+>
+> Collaborators are welcome, as are PRs for enhancements.
+>
+> Bug reports unrelated to API changes may not get the attention you want.
+
+
 By using this module, you can create a [Webex Teams][5] messaging bot quickly in just a couple of lines of code.
 
 This module does not require you to set up an ngrok tunnel to receive incoming messages when behind a firewall or
@@ -36,7 +63,7 @@ inside a LAN. This package instead uses a websocket to receive messages from the
 * Allows for single or multi-post responses. This is useful if you want to reply with a lot of data, but it won't all
   fit in a single response.
 * Restrict bot to certain users or domains.
-* Uses the [webexteamssdk][2] package to send back replies from the bot.
+* Uses the [webexpythonsdk][2] package to send back replies from the bot.
 
 ## 🚀 Getting started
 
@@ -48,7 +75,7 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 ----
 
-**Only Python 3.9 is tested at this time.**
+**Only Python 3.13 is tested at this time.**
 
 1. Install this module from pypi:
 
@@ -61,7 +88,7 @@ If you need optional proxy support, use this command instead:
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
-export WEBEX_TEAMS_ACCESS_TOKEN=<your bots token>
+export WEBEX_ACCESS_TOKEN=<your bots token>
 ```
 
 3. Run your script:
@@ -84,7 +111,7 @@ proxies = {
 }
 
 # Create a Bot Object
-bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
                include_demo_commands=True,
@@ -102,9 +129,9 @@ where EchoCommand is defined as:
 ```python
 import logging
 
-from webexteamssdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
+from webexpythonsdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
     Text, Image, HorizontalAlignment
-from webexteamssdk.models.cards.actions import Submit
+from webexpythonsdk.models.cards.actions import Submit
 
 from webex_bot.formatting import quote_info
 from webex_bot.models.command import Command
@@ -196,7 +223,8 @@ and off you go!
 
 # Help
 
-* If you are a Cisco employee, you can join the [discussion space here][7].
+* If you are a Cisco employee, and find this useful, consider sending me a [Connected Recognition][8] (cec: `fibrady`) 🙂
+* Also, join the [discussion space here][7].
 * Alternatively, open an issue or PR with a question on usage.
 
 # History
@@ -377,9 +405,42 @@ and off you go!
 
 * Add Proxy Support. ([#56][pr56])
 
+### 0.5.2 (2024-Aug-21)
+
+* Introduce exact_command_keyword_match feature ([#59][pr59])
+
+### 0.6.0 (2025-Apr-24)
+
+* Migrate from "webexteamssdk" library to "webexpythonsdk" library ([#62][pr62])
+* Updated webexpythonsdk library version ([#69][pr69])
+* Added support for generators ([#71][pr71])
+
+#### Breaking changes for the existing webex_bot based applications:
+
+* Support is limited to only Python 3.10+ versions. webex_bot applications running on lower Python versions will have to
+  adapt to this change in Python version requirement.
+* Make the following code changes to your webex_bot application to adapt to ```webex_bot 0.6.0 version and upwards```.
+
+1. ***Mandatory step:*** Replace all imports from `webexteamssdk` to `webexpythonsdk`. For example:
+```
+from webexteamssdk.models.cards import TextBlock
+```
+to
+```
+from webexpythonsdk.models.cards import TextBlock\
+```
+2. ***This step is applicable only if you pass your Webex bot access token to webex_bot via environment variable:*** Change your Webex bot access token environment variable from `WEBEX_TEAMS_ACCESS_TOKEN` to `WEBEX_ACCESS_TOKEN`. Also, make the following code change in your webex_bot application:
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN")
+```
+to
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN")
+```
+
 [1]: https://github.com/aaugustin/websockets
 
-[2]: https://github.com/CiscoDevNet/webexteamssdk
+[2]: https://github.com/WebexCommunity/WebexPythonSDK
 
 [3]: https://developer.webex.com/docs/bots
 
@@ -391,6 +452,8 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[8]: https://www.globoforce.net/microsites/t/awards/Redeem?client=cisco&setCAG=true
+
 [pr43]: https://github.com/fbradyirl/webex_bot/pull/43
 
 [pr46]: https://github.com/fbradyirl/webex_bot/pull/46
@@ -403,6 +466,14 @@ and off you go!
 
 [pr56]: https://github.com/fbradyirl/webex_bot/pull/56
 
+[pr59]: https://github.com/fbradyirl/webex_bot/pull/59
+
+[pr62]: https://github.com/fbradyirl/webex_bot/pull/62
+
+[pr69]: https://github.com/fbradyirl/webex_bot/pull/69
+
+[pr71]: https://github.com/fbradyirl/webex_bot/pull/71
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2
@@ -412,5 +483,3 @@ and off you go!
 [i13]: https://github.com/fbradyirl/webex_bot/issues/13
 
 [i20]: https://github.com/fbradyirl/webex_bot/issues/20
-
-

webex_bot-0.5.1/webex_bot.egg-info/PKG-INFO → webex_bot-0.6.0/README.md

@@ -1,28 +1,15 @@
-Metadata-Version: 2.1
-Name: webex-bot
-Version: 0.5.1
-Summary: Python package for a Webex Bot based on websockets.
-Home-page: https://github.com/fbradyirl/webex_bot
-Author: Finbarr Brady
-Author-email: finbarr@somemail.com
-License: MIT license
-Keywords: webex_bot
-Platform: UNKNOWN
-Classifier: Development Status :: 2 - Pre-Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Natural Language :: English
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-Provides-Extra: proxy
-License-File: LICENSE
-
 # Introduction
 
 [![Pypi](https://img.shields.io/pypi/v/webex_bot.svg)](https://pypi.python.org/pypi/webex_bot) [![Build Status](https://github.com/fbradyirl/webex_bot/workflows/Python%20package/badge.svg)](https://github.com/fbradyirl/webex_bot/actions)
 
+> [!IMPORTANT]
+> This repository is only sporadically maintained. Breaking API changes will be maintained on a best efforts basis.
+>
+> Collaborators are welcome, as are PRs for enhancements.
+>
+> Bug reports unrelated to API changes may not get the attention you want.
+
+
 By using this module, you can create a [Webex Teams][5] messaging bot quickly in just a couple of lines of code.
 
 This module does not require you to set up an ngrok tunnel to receive incoming messages when behind a firewall or
@@ -36,7 +23,7 @@ inside a LAN. This package instead uses a websocket to receive messages from the
 * Allows for single or multi-post responses. This is useful if you want to reply with a lot of data, but it won't all
   fit in a single response.
 * Restrict bot to certain users or domains.
-* Uses the [webexteamssdk][2] package to send back replies from the bot.
+* Uses the [webexpythonsdk][2] package to send back replies from the bot.
 
 ## 🚀 Getting started
 
@@ -48,7 +35,7 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 ----
 
-**Only Python 3.9 is tested at this time.**
+**Only Python 3.13 is tested at this time.**
 
 1. Install this module from pypi:
 
@@ -61,7 +48,7 @@ If you need optional proxy support, use this command instead:
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
-export WEBEX_TEAMS_ACCESS_TOKEN=<your bots token>
+export WEBEX_ACCESS_TOKEN=<your bots token>
 ```
 
 3. Run your script:
@@ -84,7 +71,7 @@ proxies = {
 }
 
 # Create a Bot Object
-bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
                include_demo_commands=True,
@@ -102,9 +89,9 @@ where EchoCommand is defined as:
 ```python
 import logging
 
-from webexteamssdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
+from webexpythonsdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
     Text, Image, HorizontalAlignment
-from webexteamssdk.models.cards.actions import Submit
+from webexpythonsdk.models.cards.actions import Submit
 
 from webex_bot.formatting import quote_info
 from webex_bot.models.command import Command
@@ -196,7 +183,8 @@ and off you go!
 
 # Help
 
-* If you are a Cisco employee, you can join the [discussion space here][7].
+* If you are a Cisco employee, and find this useful, consider sending me a [Connected Recognition][8] (cec: `fibrady`) 🙂
+* Also, join the [discussion space here][7].
 * Alternatively, open an issue or PR with a question on usage.
 
 # History
@@ -377,9 +365,42 @@ and off you go!
 
 * Add Proxy Support. ([#56][pr56])
 
+### 0.5.2 (2024-Aug-21)
+
+* Introduce exact_command_keyword_match feature ([#59][pr59])
+
+### 0.6.0 (2025-Apr-24)
+
+* Migrate from "webexteamssdk" library to "webexpythonsdk" library ([#62][pr62])
+* Updated webexpythonsdk library version ([#69][pr69])
+* Added support for generators ([#71][pr71])
+
+#### Breaking changes for the existing webex_bot based applications:
+
+* Support is limited to only Python 3.10+ versions. webex_bot applications running on lower Python versions will have to
+  adapt to this change in Python version requirement.
+* Make the following code changes to your webex_bot application to adapt to ```webex_bot 0.6.0 version and upwards```.
+
+1. ***Mandatory step:*** Replace all imports from `webexteamssdk` to `webexpythonsdk`. For example:
+```
+from webexteamssdk.models.cards import TextBlock
+```
+to
+```
+from webexpythonsdk.models.cards import TextBlock\
+```
+2. ***This step is applicable only if you pass your Webex bot access token to webex_bot via environment variable:*** Change your Webex bot access token environment variable from `WEBEX_TEAMS_ACCESS_TOKEN` to `WEBEX_ACCESS_TOKEN`. Also, make the following code change in your webex_bot application:
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN")
+```
+to
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN")
+```
+
 [1]: https://github.com/aaugustin/websockets
 
-[2]: https://github.com/CiscoDevNet/webexteamssdk
+[2]: https://github.com/WebexCommunity/WebexPythonSDK
 
 [3]: https://developer.webex.com/docs/bots
 
@@ -391,6 +412,8 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[8]: https://www.globoforce.net/microsites/t/awards/Redeem?client=cisco&setCAG=true
+
 [pr43]: https://github.com/fbradyirl/webex_bot/pull/43
 
 [pr46]: https://github.com/fbradyirl/webex_bot/pull/46
@@ -403,6 +426,14 @@ and off you go!
 
 [pr56]: https://github.com/fbradyirl/webex_bot/pull/56
 
+[pr59]: https://github.com/fbradyirl/webex_bot/pull/59
+
+[pr62]: https://github.com/fbradyirl/webex_bot/pull/62
+
+[pr69]: https://github.com/fbradyirl/webex_bot/pull/69
+
+[pr71]: https://github.com/fbradyirl/webex_bot/pull/71
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2
@@ -412,5 +443,3 @@ and off you go!
 [i13]: https://github.com/fbradyirl/webex_bot/issues/13
 
 [i20]: https://github.com/fbradyirl/webex_bot/issues/20
-
-

{webex_bot-0.5.1 → webex_bot-0.6.0}/setup.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.5.1
+current_version = 0.6.0
 commit = True
 tag = True
 

{webex_bot-0.5.1 → webex_bot-0.6.0}/setup.py

@@ -7,7 +7,7 @@ from setuptools import setup, find_packages
 with open('README.md') as readme_file:
     readme = readme_file.read()
 
-requirements = ['webexteamssdk==1.6.1', 'coloredlogs', 'websockets==11.0.3', 'backoff']
+requirements = ['webexpythonsdk==2.0.4', 'coloredlogs', 'websockets==11.0.3', 'backoff']
 
 setup_requirements = ['pytest-runner', ]
 
@@ -20,14 +20,16 @@ extras_requirements = {
 setup(
     author="Finbarr Brady",
     author_email='finbarr@somemail.com',
-    python_requires='>=3.8',
+    python_requires='>=3.10',
     classifiers=[
         'Development Status :: 2 - Pre-Alpha',
         'Intended Audience :: Developers',
         'License :: OSI Approved :: MIT License',
         'Natural Language :: English',
-        'Programming Language :: Python :: 3.8',
-        'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
+        'Programming Language :: Python :: 3.11',
+        'Programming Language :: Python :: 3.12',
+        'Programming Language :: Python :: 3.13',
     ],
     description="Python package for a Webex Bot based on websockets.",
     extras_require=extras_requirements,
@@ -43,6 +45,6 @@ setup(
     test_suite='tests',
     tests_require=test_requirements,
     url='https://github.com/fbradyirl/webex_bot',
-    version='0.5.1',
+    version='0.6.0',
     zip_safe=False,
 )

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/__init__.py

@@ -1,4 +1,4 @@
 """Top-level package for Webex Bot."""
 
 __author__ = """Finbarr Brady"""
-__version__ = '0.5.1'
+__version__ = '0.6.0'

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/commands/echo.py

@@ -1,8 +1,8 @@
 import logging
 
-from webexteamssdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
+from webexpythonsdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
     Text, Image, HorizontalAlignment
-from webexteamssdk.models.cards.actions import Submit
+from webexpythonsdk.models.cards.actions import Submit
 
 from webex_bot.formatting import quote_info
 from webex_bot.models.command import Command

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/commands/help.py

@@ -1,8 +1,8 @@
 import logging
 
-from webexteamssdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
+from webexpythonsdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
     ImageSize, Image, Fact
-from webexteamssdk.models.cards.actions import Submit
+from webexpythonsdk.models.cards.actions import Submit
 
 from webex_bot.models.command import Command, COMMAND_KEYWORD_KEY
 from webex_bot.models.response import response_from_adaptive_card

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/models/command.py

@@ -9,8 +9,9 @@ COMMAND_KEYWORD_KEY = "command_keyword"
 
 class Command(ABC):
 
-    def __init__(self, command_keyword=None, chained_commands=[], card=None, help_message=None,
-                 delete_previous_message=False,
+    def __init__(self, command_keyword=None, exact_command_keyword_match=False,
+                 chained_commands=[], card=None,
+                 help_message=None, delete_previous_message=False,
                  card_callback_keyword=None, approved_rooms=None):
         """
         Create a new bot command.
@@ -25,10 +26,11 @@ class Command(ABC):
                     )
 
         @param command_keyword: (optional) Text indicating a phrase to invoke this card.
+        @param exact_command_keyword_match: If True, there will be an exact command_keyword match performed. If False, then a sub-string match will be performed. Default: False. 
         @param chained_commands: (optional) List of other commands related
         to this command. This allows multiple related cards to be added at once.
         @param card: (deprecated) A dict representation of the JSON card.
-        Prefer to use cards built in code using the webexteamssdk.models.cards classes
+        Prefer to use cards built in code using the webexpythonsdk.models.cards classes
         (see https://github.com/fbradyirl/webex_bot/blob/main/webex_bot/commands/echo.py for example)
         @param help_message: Short description of this command.
         @param delete_previous_message: If True, the card which invoked this command will be deleted. (default False)
@@ -37,6 +39,7 @@ class Command(ABC):
         @param approved_rooms: If defined, only members of these spaces will be allowed to run this command. Default: None (everyone)
         """
         self.command_keyword = command_keyword
+        self.exact_command_keyword_match = exact_command_keyword_match
         self.help_message = help_message
         self.card = card
         self.pre_card_callback = self.execute
@@ -52,7 +55,7 @@ class Command(ABC):
         if card is not None:
             log.warning(f"[{command_keyword}]. Using a card dict is now deprecated. "
                         f"Switch to use adaptive cards built in code "
-                        "using the webexteamssdk.models.cards classes (see "
+                        "using the webexpythonsdk.models.cards classes (see "
                         "https://github.com/fbradyirl/webex_bot/blob/main/webex_bot/commands/echo.py for example)")
             if 'actions' in card:
                 if len(card['actions']) > 0:

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/models/response.py

@@ -1,6 +1,6 @@
 import json
 
-from webexteamssdk.models.cards import AdaptiveCard
+from webexpythonsdk.models.cards import AdaptiveCard
 
 
 def response_from_adaptive_card(adaptive_card: AdaptiveCard):

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/webex_bot.py

@@ -2,10 +2,11 @@
 import logging
 import os
 
+import types
 import backoff
 import coloredlogs
 import requests
-import webexteamssdk
+import webexpythonsdk
 
 from webex_bot.commands.echo import EchoCommand
 from webex_bot.commands.help import HelpCommand
@@ -95,7 +96,7 @@ class WebexBot(WebexWebsocketClient):
     @backoff.on_exception(backoff.expo, requests.exceptions.ConnectionError)
     def get_me_info(self):
         """
-        Fetch me info from webexteamssdk
+        Fetch me info from webexpythonsdk
         """
         me = self.teams.people.me()
         self.bot_display_name = me.displayName
@@ -168,7 +169,7 @@ class WebexBot(WebexWebsocketClient):
                 for member in room_members:
                     if member.personEmail == user_email:
                         is_user_member = True
-            except webexteamssdk.exceptions.ApiError as apie:
+            except webexpythonsdk.exceptions.ApiError as apie:
                 log.warn(f"API error: {apie}")
         return is_user_member
 
@@ -234,10 +235,21 @@ class WebexBot(WebexWebsocketClient):
 
             if not is_card_callback_command and c.command_keyword:
                 log.debug(f"c.command_keyword: {c.command_keyword}")
-                if user_command.find(c.command_keyword) != -1:
-                    command = c
-                    # If a command was found, stop looking for others
-                    break
+                log.info(f"exact_command_keyword_match: {c.exact_command_keyword_match}")
+                log.info(f"user_command: {user_command}")
+                log.info(f"command_keyword: {c.command_keyword}")
+                if c.exact_command_keyword_match: # Check if the "exact_command_keyword_match" flag is set to True
+                    if user_command == c.command_keyword:
+                        log.info("Exact match found!")
+                        command=c
+                        # If a command was found, stop looking for others
+                        break
+                else: # Enter here if the "exact_command_keyword_match" flag is set to False
+                    if user_command.find(c.command_keyword) != -1:
+                        log.info("Sub-string match found!")
+                        command = c
+                        # If a command was found, stop looking for others
+                        break
             else:
                 log.debug(f"card_callback_keyword: {c.card_callback_keyword}")
                 if user_command == c.command_keyword or user_command == c.card_callback_keyword:
@@ -325,7 +337,7 @@ class WebexBot(WebexWebsocketClient):
             self.teams.messages.create(**reply)
             reply = "ok"
         # Support returning a list of Responses
-        elif reply and isinstance(reply, list):
+        elif reply and (isinstance(reply, list) or isinstance(reply, types.GeneratorType)):
             for response in reply:
                 # Make sure is a Response
                 if isinstance(response, Response):

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot/websockets/webex_websocket_client.py

@@ -9,7 +9,7 @@ import backoff
 import certifi
 import requests
 import websockets
-from webexteamssdk import WebexTeamsAPI
+from webexpythonsdk import WebexAPI
 
 try:
     from websockets_proxy import Proxy, proxy_connect
@@ -45,7 +45,7 @@ class WebexWebsocketClient(object):
                  on_card_action=None,
                  proxies=None):
         self.access_token = access_token
-        self.teams = WebexTeamsAPI(access_token=access_token, proxies=proxies)
+        self.teams = WebexAPI(access_token=access_token, proxies=proxies)
         self.device_url = device_url
         self.device_info = None
         self.on_message = on_message

webex_bot-0.5.1/README.md → webex_bot-0.6.0/webex_bot.egg-info/PKG-INFO

@@ -1,7 +1,55 @@
+Metadata-Version: 2.4
+Name: webex_bot
+Version: 0.6.0
+Summary: Python package for a Webex Bot based on websockets.
+Home-page: https://github.com/fbradyirl/webex_bot
+Author: Finbarr Brady
+Author-email: finbarr@somemail.com
+License: MIT license
+Keywords: webex_bot
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: webexpythonsdk==2.0.4
+Requires-Dist: coloredlogs
+Requires-Dist: websockets==11.0.3
+Requires-Dist: backoff
+Provides-Extra: proxy
+Requires-Dist: websockets_proxy>=0.1.1; extra == "proxy"
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: provides-extra
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
 # Introduction
 
 [![Pypi](https://img.shields.io/pypi/v/webex_bot.svg)](https://pypi.python.org/pypi/webex_bot) [![Build Status](https://github.com/fbradyirl/webex_bot/workflows/Python%20package/badge.svg)](https://github.com/fbradyirl/webex_bot/actions)
 
+> [!IMPORTANT]
+> This repository is only sporadically maintained. Breaking API changes will be maintained on a best efforts basis.
+>
+> Collaborators are welcome, as are PRs for enhancements.
+>
+> Bug reports unrelated to API changes may not get the attention you want.
+
+
 By using this module, you can create a [Webex Teams][5] messaging bot quickly in just a couple of lines of code.
 
 This module does not require you to set up an ngrok tunnel to receive incoming messages when behind a firewall or
@@ -15,7 +63,7 @@ inside a LAN. This package instead uses a websocket to receive messages from the
 * Allows for single or multi-post responses. This is useful if you want to reply with a lot of data, but it won't all
   fit in a single response.
 * Restrict bot to certain users or domains.
-* Uses the [webexteamssdk][2] package to send back replies from the bot.
+* Uses the [webexpythonsdk][2] package to send back replies from the bot.
 
 ## 🚀 Getting started
 
@@ -27,7 +75,7 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 ----
 
-**Only Python 3.9 is tested at this time.**
+**Only Python 3.13 is tested at this time.**
 
 1. Install this module from pypi:
 
@@ -40,7 +88,7 @@ If you need optional proxy support, use this command instead:
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
-export WEBEX_TEAMS_ACCESS_TOKEN=<your bots token>
+export WEBEX_ACCESS_TOKEN=<your bots token>
 ```
 
 3. Run your script:
@@ -63,7 +111,7 @@ proxies = {
 }
 
 # Create a Bot Object
-bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
                include_demo_commands=True,
@@ -81,9 +129,9 @@ where EchoCommand is defined as:
 ```python
 import logging
 
-from webexteamssdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
+from webexpythonsdk.models.cards import Colors, TextBlock, FontWeight, FontSize, Column, AdaptiveCard, ColumnSet, \
     Text, Image, HorizontalAlignment
-from webexteamssdk.models.cards.actions import Submit
+from webexpythonsdk.models.cards.actions import Submit
 
 from webex_bot.formatting import quote_info
 from webex_bot.models.command import Command
@@ -175,7 +223,8 @@ and off you go!
 
 # Help
 
-* If you are a Cisco employee, you can join the [discussion space here][7].
+* If you are a Cisco employee, and find this useful, consider sending me a [Connected Recognition][8] (cec: `fibrady`) 🙂
+* Also, join the [discussion space here][7].
 * Alternatively, open an issue or PR with a question on usage.
 
 # History
@@ -356,9 +405,42 @@ and off you go!
 
 * Add Proxy Support. ([#56][pr56])
 
+### 0.5.2 (2024-Aug-21)
+
+* Introduce exact_command_keyword_match feature ([#59][pr59])
+
+### 0.6.0 (2025-Apr-24)
+
+* Migrate from "webexteamssdk" library to "webexpythonsdk" library ([#62][pr62])
+* Updated webexpythonsdk library version ([#69][pr69])
+* Added support for generators ([#71][pr71])
+
+#### Breaking changes for the existing webex_bot based applications:
+
+* Support is limited to only Python 3.10+ versions. webex_bot applications running on lower Python versions will have to
+  adapt to this change in Python version requirement.
+* Make the following code changes to your webex_bot application to adapt to ```webex_bot 0.6.0 version and upwards```.
+
+1. ***Mandatory step:*** Replace all imports from `webexteamssdk` to `webexpythonsdk`. For example:
+```
+from webexteamssdk.models.cards import TextBlock
+```
+to
+```
+from webexpythonsdk.models.cards import TextBlock\
+```
+2. ***This step is applicable only if you pass your Webex bot access token to webex_bot via environment variable:*** Change your Webex bot access token environment variable from `WEBEX_TEAMS_ACCESS_TOKEN` to `WEBEX_ACCESS_TOKEN`. Also, make the following code change in your webex_bot application:
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN")
+```
+to
+```
+bot = WebexBot(teams_bot_token=os.getenv("WEBEX_ACCESS_TOKEN")
+```
+
 [1]: https://github.com/aaugustin/websockets
 
-[2]: https://github.com/CiscoDevNet/webexteamssdk
+[2]: https://github.com/WebexCommunity/WebexPythonSDK
 
 [3]: https://developer.webex.com/docs/bots
 
@@ -370,6 +452,8 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[8]: https://www.globoforce.net/microsites/t/awards/Redeem?client=cisco&setCAG=true
+
 [pr43]: https://github.com/fbradyirl/webex_bot/pull/43
 
 [pr46]: https://github.com/fbradyirl/webex_bot/pull/46
@@ -382,6 +466,14 @@ and off you go!
 
 [pr56]: https://github.com/fbradyirl/webex_bot/pull/56
 
+[pr59]: https://github.com/fbradyirl/webex_bot/pull/59
+
+[pr62]: https://github.com/fbradyirl/webex_bot/pull/62
+
+[pr69]: https://github.com/fbradyirl/webex_bot/pull/69
+
+[pr71]: https://github.com/fbradyirl/webex_bot/pull/71
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2

{webex_bot-0.5.1 → webex_bot-0.6.0}/webex_bot.egg-info/requires.txt

@@ -1,4 +1,4 @@
-webexteamssdk==1.6.1
+webexpythonsdk==2.0.4
 coloredlogs
 websockets==11.0.3
 backoff