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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webex_bot
-Version: 0.4.8
+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
@@ -16,6 +16,7 @@ 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
@@ -53,6 +54,10 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 `pip install webex_bot`
 
+If you need optional proxy support, use this command instead:
+
+`pip install webex_bot[proxy]`
+
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
@@ -71,11 +76,19 @@ import os
 from webex_bot.commands.echo import EchoCommand
 from webex_bot.webex_bot import WebexBot
 
+# (Optional) Proxy configuration
+# Supports https or wss proxy, wss prioritized.
+proxies = {
+    'https': 'http://proxy.esl.example.com:80',
+    'wss': 'socks5://proxy.esl.example.com:1080'
+}
+
 # Create a Bot Object
 bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
-               include_demo_commands=True)
+               include_demo_commands=True,
+               proxies=proxies)
 
 # Add new commands for the bot to listen out for.
 bot.add_command(EchoCommand())
@@ -349,19 +362,20 @@ and off you go!
 
 ### 0.4.6 (2024-Apr-24)
 
-* Add max backoff time (#55)
-* Attached files. Help, threading and log level overrides. (#54)
-* add stop() call to gracefully exit the bot (#42)
-* feat(20231212): add help image size parameter (#46)
-* update websockets to 11.0.3 (#43)
+* ❌ Bad release. Please do not use this one as there is a startup issue with it.
 
-### 0.4.7 (2024-Apr-24)
+### 0.5.0 (2024-Apr-25)
 
+* Add max backoff time ([#55][pr55])
+* Attached files. Help, threading and log level overrides. ([#54][pr54])
+* add stop() call to gracefully exit the bot ([#42][pr42])
+* feat(20231212): add help image size parameter ([#46][pr46])
+* update websockets to 11.0.3 ([#43][pr43])
 * Fix for help_command syntax issue
 
-### 0.4.8 (2024-Apr-25)
+### 0.5.1 (2024-Apr-25)
 
-* Fix for help_command missing commands.
+* Add Proxy Support. ([#56][pr56])
 
 [1]: https://github.com/aaugustin/websockets
 
@@ -377,6 +391,18 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[pr43]: https://github.com/fbradyirl/webex_bot/pull/43
+
+[pr46]: https://github.com/fbradyirl/webex_bot/pull/46
+
+[pr42]: https://github.com/fbradyirl/webex_bot/pull/42
+
+[pr54]: https://github.com/fbradyirl/webex_bot/pull/54
+
+[pr55]: https://github.com/fbradyirl/webex_bot/pull/55
+
+[pr56]: https://github.com/fbradyirl/webex_bot/pull/56
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2

{webex_bot-0.4.8 → webex_bot-0.5.1}/README.md

@@ -33,6 +33,10 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 `pip install webex_bot`
 
+If you need optional proxy support, use this command instead:
+
+`pip install webex_bot[proxy]`
+
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
@@ -51,11 +55,19 @@ import os
 from webex_bot.commands.echo import EchoCommand
 from webex_bot.webex_bot import WebexBot
 
+# (Optional) Proxy configuration
+# Supports https or wss proxy, wss prioritized.
+proxies = {
+    'https': 'http://proxy.esl.example.com:80',
+    'wss': 'socks5://proxy.esl.example.com:1080'
+}
+
 # Create a Bot Object
 bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
-               include_demo_commands=True)
+               include_demo_commands=True,
+               proxies=proxies)
 
 # Add new commands for the bot to listen out for.
 bot.add_command(EchoCommand())
@@ -329,19 +341,20 @@ and off you go!
 
 ### 0.4.6 (2024-Apr-24)
 
-* Add max backoff time (#55)
-* Attached files. Help, threading and log level overrides. (#54)
-* add stop() call to gracefully exit the bot (#42)
-* feat(20231212): add help image size parameter (#46)
-* update websockets to 11.0.3 (#43)
+* ❌ Bad release. Please do not use this one as there is a startup issue with it.
 
-### 0.4.7 (2024-Apr-24)
+### 0.5.0 (2024-Apr-25)
 
+* Add max backoff time ([#55][pr55])
+* Attached files. Help, threading and log level overrides. ([#54][pr54])
+* add stop() call to gracefully exit the bot ([#42][pr42])
+* feat(20231212): add help image size parameter ([#46][pr46])
+* update websockets to 11.0.3 ([#43][pr43])
 * Fix for help_command syntax issue
 
-### 0.4.8 (2024-Apr-25)
+### 0.5.1 (2024-Apr-25)
 
-* Fix for help_command missing commands.
+* Add Proxy Support. ([#56][pr56])
 
 [1]: https://github.com/aaugustin/websockets
 
@@ -357,6 +370,18 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[pr43]: https://github.com/fbradyirl/webex_bot/pull/43
+
+[pr46]: https://github.com/fbradyirl/webex_bot/pull/46
+
+[pr42]: https://github.com/fbradyirl/webex_bot/pull/42
+
+[pr54]: https://github.com/fbradyirl/webex_bot/pull/54
+
+[pr55]: https://github.com/fbradyirl/webex_bot/pull/55
+
+[pr56]: https://github.com/fbradyirl/webex_bot/pull/56
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2

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

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

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

@@ -13,6 +13,10 @@ setup_requirements = ['pytest-runner', ]
 
 test_requirements = ['pytest>=3', ]
 
+extras_requirements = {
+    "proxy": ["websockets_proxy>=0.1.1"]
+}
+
 setup(
     author="Finbarr Brady",
     author_email='finbarr@somemail.com',
@@ -26,6 +30,7 @@ setup(
         'Programming Language :: Python :: 3.9',
     ],
     description="Python package for a Webex Bot based on websockets.",
+    extras_require=extras_requirements,
     install_requires=requirements,
     license="MIT license",
     long_description=readme,
@@ -38,6 +43,6 @@ setup(
     test_suite='tests',
     tests_require=test_requirements,
     url='https://github.com/fbradyirl/webex_bot',
-    version='0.4.8',
+    version='0.5.1',
     zip_safe=False,
 )

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

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

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

@@ -31,7 +31,8 @@ class WebexBot(WebexWebsocketClient):
                  bot_help_subtitle="Here are my available commands. Click one to begin.",
                  threads=True,
                  help_command=None,
-                 log_level="INFO"):
+                 log_level="INFO",
+                 proxies=None):
         """
         Initialise WebexBot.
 
@@ -46,7 +47,7 @@ class WebexBot(WebexWebsocketClient):
         @param threads: If True, respond to msg by creating a thread.
         @param help_command: If None, use internal HelpCommand, otherwise override.
         @param log_level: Set loggin level.
-
+        @param proxies: Dictionary of proxies for connections.
         """
 
         coloredlogs.install(level=os.getenv("LOG_LEVEL", log_level),
@@ -58,7 +59,8 @@ class WebexBot(WebexWebsocketClient):
                                       teams_bot_token,
                                       on_message=self.process_incoming_message,
                                       on_card_action=self.process_incoming_card_action,
-                                      device_url=device_url)
+                                      device_url=device_url,
+                                      proxies=proxies)
 
         if help_command is None:
             self.help_command = HelpCommand(

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

@@ -11,6 +11,12 @@ import requests
 import websockets
 from webexteamssdk import WebexTeamsAPI
 
+try:
+    from websockets_proxy import Proxy, proxy_connect
+except ImportError:
+    Proxy = None
+    proxy_connect = None
+
 logger = logging.getLogger(__name__)
 
 DEFAULT_DEVICE_URL = "https://wdm-a.wbx2.com/wdm/api/v1"
@@ -36,16 +42,23 @@ class WebexWebsocketClient(object):
                  access_token,
                  device_url=DEFAULT_DEVICE_URL,
                  on_message=None,
-                 on_card_action=None):
+                 on_card_action=None,
+                 proxies=None):
         self.access_token = access_token
-        self.teams = WebexTeamsAPI(access_token=access_token)
+        self.teams = WebexTeamsAPI(access_token=access_token, proxies=proxies)
         self.device_url = device_url
         self.device_info = None
         self.on_message = on_message
         self.on_card_action = on_card_action
+        self.proxies = proxies
         self.websocket = None
         self.share_id = None
 
+        if self.proxies:
+            # Connecting through a proxy
+            if proxy_connect is None:
+                raise ImportError("Failed to load libraries for proxy, maybe forgot [proxy] option during installation.")
+
     def _process_incoming_websocket_message(self, msg):
         """
         Handle websocket data.
@@ -124,7 +137,8 @@ class WebexWebsocketClient(object):
                                                             f"{verb}/{activity_id}")
         headers = {"Authorization": f"Bearer {self.access_token}"}
         conversation_message = requests.get(conversation_message_url,
-                                            headers=headers).json()
+                                            headers=headers,
+                                            proxies=self.proxies).json()
         logger.debug(f"conversation_message={conversation_message}")
         return conversation_message['id']
 
@@ -197,7 +211,20 @@ class WebexWebsocketClient(object):
         async def _connect_and_listen():
             ws_url = self.device_info['webSocketUrl']
             logger.info(f"Opening websocket connection to {ws_url}")
-            async with websockets.connect(ws_url, ssl=ssl_context) as _websocket:
+
+            if self.proxies and "wss" in self.proxies:
+                logger.info(f"Using proxy for websocket connection: {self.proxies['wss']}")
+                proxy = Proxy.from_url(self.proxies["wss"])
+                connect = proxy_connect(ws_url, ssl=ssl_context, proxy=proxy)
+            elif self.proxies and "https" in self.proxies:
+                logger.info(f"Using proxy for websocket connection: {self.proxies['https']}")
+                proxy = Proxy.from_url(self.proxies["https"])
+                connect = proxy_connect(ws_url, ssl=ssl_context, proxy=proxy)
+            else:
+                logger.debug(f"Not using proxy for websocket connection.")
+                connect = websockets.connect(ws_url, ssl=ssl_context)
+
+            async with connect as _websocket:
                 self.websocket = _websocket
                 logger.info("WebSocket Opened.")
                 msg = {'id': str(uuid.uuid4()),
@@ -216,4 +243,4 @@ class WebexWebsocketClient(object):
                 logger.error('could not create device info')
                 raise Exception("No WDM device info")
             # trigger re-connect
-            asyncio.get_event_loop().run_until_complete(_connect_and_listen())
+            asyncio.get_event_loop().run_until_complete(_connect_and_listen())

{webex_bot-0.4.8 → webex_bot-0.5.1}/webex_bot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: webex-bot
-Version: 0.4.8
+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
@@ -16,6 +16,7 @@ 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
@@ -53,6 +54,10 @@ You can find a sample project, using OpenAI/ChatGPT with this library here: http
 
 `pip install webex_bot`
 
+If you need optional proxy support, use this command instead:
+
+`pip install webex_bot[proxy]`
+
 2. On the Webex Developer portal, create a new [bot token][3] and expose it as an environment variable.
 
 ```sh
@@ -71,11 +76,19 @@ import os
 from webex_bot.commands.echo import EchoCommand
 from webex_bot.webex_bot import WebexBot
 
+# (Optional) Proxy configuration
+# Supports https or wss proxy, wss prioritized.
+proxies = {
+    'https': 'http://proxy.esl.example.com:80',
+    'wss': 'socks5://proxy.esl.example.com:1080'
+}
+
 # Create a Bot Object
 bot = WebexBot(teams_bot_token=os.getenv("WEBEX_TEAMS_ACCESS_TOKEN"),
                approved_rooms=['06586d8d-6aad-4201-9a69-0bf9eeb5766e'],
                bot_name="My Teams Ops Bot",
-               include_demo_commands=True)
+               include_demo_commands=True,
+               proxies=proxies)
 
 # Add new commands for the bot to listen out for.
 bot.add_command(EchoCommand())
@@ -349,19 +362,20 @@ and off you go!
 
 ### 0.4.6 (2024-Apr-24)
 
-* Add max backoff time (#55)
-* Attached files. Help, threading and log level overrides. (#54)
-* add stop() call to gracefully exit the bot (#42)
-* feat(20231212): add help image size parameter (#46)
-* update websockets to 11.0.3 (#43)
+* ❌ Bad release. Please do not use this one as there is a startup issue with it.
 
-### 0.4.7 (2024-Apr-24)
+### 0.5.0 (2024-Apr-25)
 
+* Add max backoff time ([#55][pr55])
+* Attached files. Help, threading and log level overrides. ([#54][pr54])
+* add stop() call to gracefully exit the bot ([#42][pr42])
+* feat(20231212): add help image size parameter ([#46][pr46])
+* update websockets to 11.0.3 ([#43][pr43])
 * Fix for help_command syntax issue
 
-### 0.4.8 (2024-Apr-25)
+### 0.5.1 (2024-Apr-25)
 
-* Fix for help_command missing commands.
+* Add Proxy Support. ([#56][pr56])
 
 [1]: https://github.com/aaugustin/websockets
 
@@ -377,6 +391,18 @@ and off you go!
 
 [7]: https://eurl.io/#TeBLqZjLs
 
+[pr43]: https://github.com/fbradyirl/webex_bot/pull/43
+
+[pr46]: https://github.com/fbradyirl/webex_bot/pull/46
+
+[pr42]: https://github.com/fbradyirl/webex_bot/pull/42
+
+[pr54]: https://github.com/fbradyirl/webex_bot/pull/54
+
+[pr55]: https://github.com/fbradyirl/webex_bot/pull/55
+
+[pr56]: https://github.com/fbradyirl/webex_bot/pull/56
+
 [i1]: https://github.com/fbradyirl/webex_bot/issues/1
 
 [i2]: https://github.com/fbradyirl/webex_bot/issues/2

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

@@ -2,3 +2,6 @@ webexteamssdk==1.6.1
 coloredlogs
 websockets==11.0.3
 backoff
+
+[proxy]
+websockets_proxy>=0.1.1