webex-bot 0.4.1__py2.py3-none-any.whl → 0.4.6__py2.py3-none-any.whl

webex_bot/__init__.py

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

webex_bot/commands/help.py

@@ -14,7 +14,7 @@ HELP_COMMAND_KEYWORD = "help"
 
 class HelpCommand(Command):
 
-    def __init__(self, bot_name, bot_help_subtitle, bot_help_image):
+    def __init__(self, bot_name, bot_help_subtitle, bot_help_image, bot_help_image_size=ImageSize.SMALL):
         self.commands = None
         super().__init__(
             command_keyword=HELP_COMMAND_KEYWORD,
@@ -25,6 +25,7 @@ class HelpCommand(Command):
         self.bot_name = bot_name
         self.bot_help_subtitle = bot_help_subtitle
         self.bot_help_image = bot_help_image
+        self.bot_help_image_size = bot_help_image_size
 
     def execute(self, message, attachment_actions, activity):
         pass
@@ -42,7 +43,7 @@ class HelpCommand(Command):
 
         image = Image(
             url=self.bot_help_image,
-            size=ImageSize.SMALL)
+            size=self.bot_help_image_size)
 
         header_column = Column(items=[heading, subtitle], width=2)
         header_image_column = Column(

webex_bot/webex_bot.py

@@ -16,10 +16,6 @@ from webex_bot.models.response import Response
 from webex_bot.websockets.webex_websocket_client import WebexWebsocketClient, DEFAULT_DEVICE_URL
 
 log = logging.getLogger(__name__)
-coloredlogs.install(level=os.getenv("LOG_LEVEL", "INFO"),
-                    fmt='%(asctime)s  [%(levelname)s]  '
-                        '[%(module)s.%(name)s.%(funcName)'
-                        's]:%(lineno)s %(message)s')
 
 
 class WebexBot(WebexWebsocketClient):
@@ -32,7 +28,10 @@ class WebexBot(WebexWebsocketClient):
                  device_url=DEFAULT_DEVICE_URL,
                  include_demo_commands=False,
                  bot_name="Webex Bot",
-                 bot_help_subtitle="Here are my available commands. Click one to begin."):
+                 bot_help_subtitle="Here are my available commands. Click one to begin.",
+                 threads=True,
+                 help_command=None,
+                 log_level="INFO"):
         """
         Initialise WebexBot.
 
@@ -44,8 +43,16 @@ class WebexBot(WebexWebsocketClient):
         @param include_demo_commands: If True, any demo commands will be included.
         @param bot_name: Your custom name for the bot.
         @param bot_help_subtitle: Text to show in the help card.
+        @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.
+
         """
 
+        coloredlogs.install(level=os.getenv("LOG_LEVEL", log_level),
+                            fmt='%(asctime)s  [%(levelname)s]  '
+                                '[%(module)s.%(name)s.%(funcName)'
+                                's]:%(lineno)s %(message)s')
         log.info("Registering bot with Webex cloud")
         WebexWebsocketClient.__init__(self,
                                       teams_bot_token,
@@ -58,27 +65,30 @@ class WebexBot(WebexWebsocketClient):
         # text and callback function
         # By default supports 2 command, echo and help
 
-        self.help_command = HelpCommand(
-            bot_name=bot_name,
-            bot_help_subtitle=bot_help_subtitle,
-            bot_help_image=self.teams.people.me().avatar)
+        if help_command is None:
+            self.help_command = HelpCommand(
+                bot_name=bot_name,
+                bot_help_subtitle=bot_help_subtitle,
+                bot_help_image=self.teams.people.me().avatar)
+            self.help_command.commands = self.commands
+            # Set default help message
+            self.help_message = "Hello!  I understand the following commands:  \n"
+        else:
+            self.help_command = help_command
         self.commands = {
             self.help_command
         }
         if include_demo_commands:
             self.add_command(EchoCommand())
 
-        self.help_command.commands = self.commands
-
         self.card_callback_commands = {}
         self.approved_users = approved_users
         self.approved_domains = approved_domains
         self.approved_rooms = approved_rooms
-        # Set default help message
-        self.help_message = "Hello!  I understand the following commands:  \n"
         self.approval_parameters_check()
         self.bot_display_name = ""
         self.get_me_info()
+        self.threads = threads
 
     @backoff.on_exception(backoff.expo, requests.exceptions.ConnectionError)
     def get_me_info(self):
@@ -307,7 +317,7 @@ class WebexBot(WebexWebsocketClient):
             # If the Response lacks a roomId, set it to the incoming room
             if not reply.roomId:
                 reply.roomId = room_id
-            if not reply.parentId and conv_target_id:
+            if not reply.parentId and conv_target_id and self.threads:
                 reply.parentId = conv_target_id
             reply = reply.as_dict()
             self.teams.messages.create(**reply)
@@ -351,14 +361,25 @@ class WebexBot(WebexWebsocketClient):
             quote_info(f"{user_email} I've messaged you 1-1. Please reply to me there.")
         if reply_one_to_one:
             if not is_one_on_one_space:
-                self.teams.messages.create(roomId=room_id,
-                                           markdown=default_move_to_one_to_one_heads_up,
+                if self.threads:
+                    self.teams.messages.create(roomId=room_id,
+                                               markdown=default_move_to_one_to_one_heads_up,
+                                               parentId=conv_target_id)
+                else:
+                    self.teams.messages.create(roomId=room_id,
+                                               markdown=default_move_to_one_to_one_heads_up)
+            if self.threads:
+                self.teams.messages.create(toPersonEmail=user_email,
+                                           markdown=reply,
                                            parentId=conv_target_id)
-            self.teams.messages.create(toPersonEmail=user_email,
-                                       markdown=reply,
-                                       parentId=conv_target_id)
+            else:
+                self.teams.messages.create(toPersonEmail=user_email,
+                                           markdown=reply)
         else:
-            self.teams.messages.create(roomId=room_id, markdown=reply, parentId=conv_target_id)
+            if self.threads:
+                self.teams.messages.create(roomId=room_id, markdown=reply, parentId=conv_target_id)
+            else:
+                self.teams.messages.create(roomId=room_id, markdown=reply)
 
     def run_pre_card_load_reply(self, command, message, teams_message, activity):
         """

webex_bot/websockets/webex_websocket_client.py

@@ -28,6 +28,8 @@ DEVICE_DATA = {
 ssl_context = ssl.create_default_context()
 ssl_context.load_verify_locations(certifi.where())
 
+MAX_BACKOFF_TIME = 240
+
 
 class WebexWebsocketClient(object):
     def __init__(self,
@@ -42,12 +44,14 @@ class WebexWebsocketClient(object):
         self.on_message = on_message
         self.on_card_action = on_card_action
         self.websocket = None
+        self.share_id = None
 
     def _process_incoming_websocket_message(self, msg):
         """
         Handle websocket data.
         :param msg: The raw websocket message
         """
+        logger.info(f"msg['data'] = {msg['data']}")
         if msg['data']['eventType'] == 'conversation.activity':
             activity = msg['data']['activity']
             if activity['verb'] == 'post':
@@ -61,6 +65,31 @@ class WebexWebsocketClient(object):
                     self._ack_message(message_base_64_id)
                     # Now process it with the handler
                     self.on_message(teams_message=webex_message, activity=activity)
+            elif activity['verb'] == 'share':
+                logger.debug(f"activity={activity}")
+                self.share_id = activity['id']
+                return
+            elif activity['verb'] == 'update':
+                logger.debug(f"activity={activity}")
+
+                object = activity['object']
+                if object['objectType'] == 'content' and object['contentCategory'] == 'documents':
+                    if 'files' in object.keys():
+                        for item in object['files']['items']:
+                            if not item['malwareQuarantineState'] == 'safe':
+                                return
+                    else:
+                        return
+                else:
+                    return
+                message_base_64_id = self._get_base64_message_id(activity)
+                webex_message = self.teams.messages.get(message_base_64_id)
+                logger.debug(f"webex_message from message_base_64_id: {webex_message}")
+                if self.on_message:
+                    # ack message first
+                    self._ack_message(message_base_64_id)
+                    # Now process it with the handler
+                    self.on_message(teams_message=webex_message, activity=activity)
             elif activity['verb'] == 'cardAction':
                 logger.debug(f"activity={activity}")
 
@@ -83,10 +112,14 @@ class WebexWebsocketClient(object):
         @return: base 64 message id
         """
         activity_id = activity['id']
-        logger.debug(f"activity verb=post. message id={activity_id}")
+        logger.debug(f"activity verb={activity['verb']}. message id={activity_id}")
         conversation_url = activity['target']['url']
         conv_target_id = activity['target']['id']
-        verb = "messages" if activity['verb'] == "post" else "attachment/actions"
+        verb = "messages" if activity['verb'] in ["post", "update"] else "attachment/actions"
+        if activity['verb'] == "update" and self.share_id is not None:
+            activity_id = self.share_id
+            self.share_id = None
+        logger.debug(f"activity_id={activity_id}")
         conversation_message_url = conversation_url.replace(f"conversations/{conv_target_id}",
                                                             f"{verb}/{activity_id}")
         headers = {"Authorization": f"Bearer {self.access_token}"}
@@ -134,6 +167,12 @@ class WebexWebsocketClient(object):
         logger.debug(f"self.device_info: {self.device_info}")
         return resp
 
+    def stop(self):
+        def terminate():
+            raise SystemExit()
+
+        asyncio.get_event_loop().create_task(terminate())
+
     def run(self):
         if self.device_info is None:
             if self._get_device_info() is None:
@@ -151,10 +190,10 @@ class WebexWebsocketClient(object):
                 logger.warning(
                     f"An exception occurred while processing message. Ignoring. {messageProcessingException}")
 
-        @backoff.on_exception(backoff.expo, websockets.ConnectionClosedError)
-        @backoff.on_exception(backoff.expo, websockets.ConnectionClosedOK)
-        @backoff.on_exception(backoff.expo, websockets.ConnectionClosed)
-        @backoff.on_exception(backoff.expo, socket.gaierror)
+        @backoff.on_exception(backoff.expo, websockets.ConnectionClosedError, max_time=MAX_BACKOFF_TIME)
+        @backoff.on_exception(backoff.expo, websockets.ConnectionClosedOK, max_time=MAX_BACKOFF_TIME)
+        @backoff.on_exception(backoff.expo, websockets.ConnectionClosed, max_time=MAX_BACKOFF_TIME)
+        @backoff.on_exception(backoff.expo, socket.gaierror, max_time=MAX_BACKOFF_TIME)
         async def _connect_and_listen():
             ws_url = self.device_info['webSocketUrl']
             logger.info(f"Opening websocket connection to {ws_url}")

{webex_bot-0.4.1.dist-info → webex_bot-0.4.6.dist-info}/METADATA

@@ -1,10 +1,10 @@
 Metadata-Version: 2.1
 Name: webex-bot
-Version: 0.4.1
+Version: 0.4.6
 Summary: Python package for a Webex Bot based on websockets.
 Home-page: https://github.com/fbradyirl/webex_bot
 Author: Finbarr Brady
-Author-email: finbarr.brady@gmail.com
+Author-email: finbarr@somemail.com
 License: MIT license
 Keywords: webex_bot
 Platform: UNKNOWN
@@ -19,7 +19,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: webexteamssdk ==1.6.1
 Requires-Dist: coloredlogs
-Requires-Dist: websockets ==10.2
+Requires-Dist: websockets ==11.0.3
 Requires-Dist: backoff
 
 # Introduction
@@ -351,6 +351,14 @@ and off you go!
 
 * Always ensure there is a thread ID in the Activity before accessing it
 
+### 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)
+
 [1]: https://github.com/aaugustin/websockets
 
 [2]: https://github.com/CiscoDevNet/webexteamssdk

{webex_bot-0.4.1.dist-info → webex_bot-0.4.6.dist-info}/RECORD

@@ -1,18 +1,18 @@
-webex_bot/__init__.py,sha256=wM8rIowBAwgnHk63Eug1MtM50E7YAwXOIKLSfGy0aTU,95
+webex_bot/__init__.py,sha256=iAWNyB5H4ndIq6bXqGlXlf6PUKceoqT-5dwRKJMBN9A,95
 webex_bot/exceptions.py,sha256=qs9yVitfJtvxwBMC8uCvTDOxUQ_oZjWFf1dU8Oaue14,740
 webex_bot/formatting.py,sha256=jvPKym-z8CIJygpPVTVbt6vFXQo9_HQHpRDJB-nh-SI,382
-webex_bot/webex_bot.py,sha256=lTulu3zF_34WCDV4QY5crTY-MRNaefLVLgdb-TZO3To,19410
+webex_bot/webex_bot.py,sha256=Vm_XKlTfPK1VnUdQZ3n36XXUJD5Z_iQ6iNPjrWKq49I,20449
 webex_bot/cards/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webex_bot/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webex_bot/commands/echo.py,sha256=YmeRVh56pzsj0_lRHDvgyrv6YqQQdRiusG65dHTh9qU,3397
-webex_bot/commands/help.py,sha256=6vUp3hdpIgYL2Jlc1fgxGrG0V3ebkJ_4rEGJEnZO7W0,3367
+webex_bot/commands/help.py,sha256=s4buQxnmHijkqWiYs8RZ_H-yzi3EhAffSozPCGNndD0,3468
 webex_bot/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 webex_bot/models/command.py,sha256=Rok661eZM2Mg465CZ4GgctWi1RD-BD5Bruq0FsJ8GDQ,5023
 webex_bot/models/response.py,sha256=1U0EQv8O5R3-demaumxMExn278DG4AeQHhXP_g4xndk,2544
 webex_bot/websockets/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-webex_bot/websockets/webex_websocket_client.py,sha256=dxK7zaHrw0Vc8UFVTmwDOl2URPlu_Z74tDnVEnubdh0,7600
-webex_bot-0.4.1.dist-info/LICENSE,sha256=93eGb10xmgkBP2Fh_n0E9YDXe0c0oz-FsnAimXG0S4Y,1072
-webex_bot-0.4.1.dist-info/METADATA,sha256=c4coU61paZ41ojJqUIamz9WEZP8zhMqutVJdP9ENjX0,10748
-webex_bot-0.4.1.dist-info/WHEEL,sha256=iYlv5fX357PQyRT2o6tw1bN-YcKFFHKqB_LwHO5wP-g,110
-webex_bot-0.4.1.dist-info/top_level.txt,sha256=q1Y0RtYYinR7oXSwL93cK59c2KN_CbMVca8MLWeF63M,10
-webex_bot-0.4.1.dist-info/RECORD,,
+webex_bot/websockets/webex_websocket_client.py,sha256=uBpvpRLmfhgtfDr0Yomg6FNei9CIsCEigNsAEu5c5iY,9427
+webex_bot-0.4.6.dist-info/LICENSE,sha256=93eGb10xmgkBP2Fh_n0E9YDXe0c0oz-FsnAimXG0S4Y,1072
+webex_bot-0.4.6.dist-info/METADATA,sha256=QP_kCZ9w2jsdrk5AqTWQxCDTH8E_uVzN_v3m4HKmWFc,11008
+webex_bot-0.4.6.dist-info/WHEEL,sha256=DZajD4pwLWue70CAfc7YaxT1wLUciNBvN_TTcvXpltE,110
+webex_bot-0.4.6.dist-info/top_level.txt,sha256=q1Y0RtYYinR7oXSwL93cK59c2KN_CbMVca8MLWeF63M,10
+webex_bot-0.4.6.dist-info/RECORD,,

{webex_bot-0.4.1.dist-info → webex_bot-0.4.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.41.2)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py2-none-any
 Tag: py3-none-any