Add /library_versions

Admin only command.

Author: Yossi

README.md

@@ -4,25 +4,26 @@
 ## What this does
 This is a telegram bot that attempts to create URL hacks that help people read news sites with user hostile designs. 
 
-Add the bot to a group chat and make it an admin so it can see all messages. Or talk to it in pm.
+Add the bot to a group chat and make it an admin so it can see all messages. Or talk to it in Private Chat.
 
 Regular users can use the bot as follows:  
 * Post messages as usual. The bot will silently detect and remember the most recent link it sees.  
-When you know that the the most recent link needs to get the bot treatment you say `/include`.  
+When the most recent link needs the bot treatment, say `/include`.  
 Immediately and from now on the bot will attempt to post a list of bypass links for all urls from that domain.  
 You can also send `/include` as a reply to a message to target the domain in that message even if it isn't the most recent one anymore. Or you can add domains manually with `/include domain.tld`.  
 Messages with multiple links are treated as though only the first link exists, even if the first link needs no action and a subsequent one does.  
 * `/list` will show all the domains the bot is set to act on.  
-* `/remove domain.tld` to remove one.  
+* `/remove domain.tld` to remove domain.  
 * Reply to a bot message with `/delete` and the bot will delete that message and your `/delete` message too (if it can) to keep things tidy.  
-Only works on bot messages less than 48 hours old (telegram restriction) or less than 10 bot messages ago (bot restriction).  
+Only works on bot messages less than 48 hours old (telegram restriction) and less than 10 bot messages ago (bot restriction).  
 
 Additionally, users can request a google translate version of the most recent link by sending `/translate`.  
 `/translate` defaults to english but will also accept a list of ISO-639-1 language codes. For example `/translate en fr es` will produce 3 translate links.
 
 As a bot admin you have some commands that only you can run:  
 `/data` - Show all the stored data for the chat where you sent the command from.  
-`/data clear <key>` - delete all the data in `<key>`.  
+`/data clear <key>` - Delete all the data in `<key>`.  
+`/library_versions` - Show the versions of all installed libraries and highlight any that are out of date.  
 If the bot throws an exception it will send it to you in a private message.  
 The bot will spit out log messages at the info level when messages come in or out. It does not attempt to permanently save these logs anywhere.  
 Data stored by the bot (like the list of domains to bypass) lives in `data/bot.persist`.  
@@ -32,8 +33,8 @@ Ideally new versions of the bot will be backward compatible with the existing `d
 But just in case, the list of domains to bypass can be exported per group with the `/export` command. This will create a simple text file with the domains listed in it. The filename will be `{chat_id}_urls_backup.txt`.  
 To import this list back into the bot you just upload a text file with the exact filename to match the chat you're in. You can even forward the message from `/export` back into the chat and not have to download the file.  
 
-Anyone can check the running version of the bot as well as the latest version available (if not the same) by sending `/version`.  
-You can also run `/start` to find the chat_id to use for this filename, and your user_id to use in the list of admins.    
+Anyone can check the running version of the bot as well as the latest version available (if not the same) by using `/version`, but `/library_versons` is admin only.  
+Anyone can also run `/start` to find the chat_id to use for this filename, and their user_id to use in the list of admins.    
 
 ## Setup
 Clone this repo and `cd` into it.  

bot.py

@@ -1,7 +1,7 @@
 '''Telegram bot that (primarily) attempts to perform url hacks to get around paywalls'''
 
 
-__version__ = '2.3.1'
+__version__ = '2.4.0'
 
 
 import asyncio
@@ -25,6 +25,7 @@
 from urlextract import URLExtract
 
 from data.secrets import LIST_OF_ADMINS, TOKEN  # If it crashed here it's because you didn't create secrets.py correctly (or at all). Or you didn't pass docker run -v /full/path/to/data/:/home/botuser/data/
+import subprocess
 
 
 logging.basicConfig(format='%(asctime)s - %(levelname)s %(message)s', level=logging.INFO)
@@ -117,6 +118,37 @@ async def chat_data(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
     await say(html.escape(text), update, context)
 
 
+@log
+@send_typing_action
+async def library_versions(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    '''Show installed library versions and the latest available versions online'''
+
+    installed_result = subprocess.run(['pip', 'list', '--format=columns'], capture_output=True, text=True)
+    outdated_result = subprocess.run(['pip', 'list', '--outdated', '--format=columns'], capture_output=True, text=True)
+
+    installed_libraries = installed_result.stdout.splitlines()
+    outdated_libraries = outdated_result.stdout.splitlines()
+
+    outdated_dict = {line.split()[0]: line.split()[2] for line in outdated_libraries[2:]}
+
+    response = [installed_libraries[0]]  # Headers
+    for line in installed_libraries[2:]:
+        lib_name = line.split()[0]
+        if lib_name in outdated_dict:
+            response.append(f"{line} (latest: {outdated_dict[lib_name]})")
+        else:
+            response.append(line)
+
+    further_instructions = ''
+    if outdated_dict:
+        further_instructions = "To update all outdated libraries, run:\n<code>pip list --outdated | awk 'NR>2 {print $1}' | xargs -n1 pip install -U</code>"
+
+    text = html.escape("\n".join(response))
+
+    if text:
+        await say(f'<pre>{text}</pre>{further_instructions}', update, context)
+
+
 # internal bot helper stuff
 async def say(text: str, update: Update, context: ContextTypes.DEFAULT_TYPE) -> int | None:
     '''Send text to channel'''
@@ -236,7 +268,7 @@ async def wayback(url: str, client: httpx.AsyncClient) -> str | None:
             archive_org_url = r.json().get('archived_snapshots', {}).get('closest', {}).get('url')
             if archive_org_url:
                 return archive_org_url
-        
+
     except httpx.TimeoutException:
         pass
 
@@ -581,6 +613,7 @@ async def post_init(application: Application) -> None:
 
     application.add_handler(CommandHandler('start', start))
     application.add_handler(CommandHandler('version', version))
+    application.add_handler(CommandHandler('library_versions', library_versions, filters=filters.User(user_id=LIST_OF_ADMINS)))
     application.add_handler(CommandHandler('translate', translate))
     application.add_handler(CommandHandler('include', include))
     application.add_handler(CommandHandler('remove', remove))