style(scripts): apply black formatting to new files

Author: randall-vx

scripts/test_call.py

@@ -6,21 +6,23 @@
 sys.path.insert(0, "./src")
 from telegram_mcp.mcp_server import mcp
 
+
 async def main():
     try:
         # FastMCP internals for testing tool calls simulate an MCP call
         print("Calling create_folder with payload object...")
-        # Since 'create_folder' uses Telethon, it might crash without a real session, 
+        # Since 'create_folder' uses Telethon, it might crash without a real session,
         # but what we care about is if the payload binding works or if it throws a TypeError/ValidationError.
-        
+
         args = {"payload": {"title": "TestFolderSchema", "include_contacts": True}}
-        
+
         # FastMCP tools are stored in mcp._tools or similar. We can also just use the tool call handler.
         result = await mcp.call_tool("create_folder", args)
         print(f"Tool executed successfully. Result: {result}")
-        
+
     except Exception as e:
         print(f"Failed: {type(e).__name__} - {e}")
 
+
 if __name__ == "__main__":
     asyncio.run(main())

scripts/validate_shadowing.py

@@ -3,16 +3,17 @@
 import os
 from pprint import pprint
 
+
 def validate_shadowing(filepath: str):
     """
-    Parses a python file and ensures no local variable (or argument) 
+    Parses a python file and ensures no local variable (or argument)
     in any function shadows a top-level module import.
     """
-    with open(filepath, 'r', encoding='utf-8') as f:
+    with open(filepath, "r", encoding="utf-8") as f:
         source = f.read()
-    
+
     tree = ast.parse(source, filename=filepath)
-    
+
     # 1. Collect all top-level imports
     global_imports = set()
     for node in tree.body:
@@ -31,40 +32,47 @@ def validate_shadowing(filepath: str):
     for node in ast.walk(tree):
         if isinstance(node, (ast.FunctionDef, ast.AsyncFunctionDef)):
             func_name = node.name
-            
+
             # 2a. Check arguments
             args = []
-            if node.args.args: args.extend(node.args.args)
-            if node.args.posonlyargs: args.extend(node.args.posonlyargs)
-            if node.args.kwonlyargs: args.extend(node.args.kwonlyargs)
-            if node.args.vararg: args.append(node.args.vararg)
-            if node.args.kwarg: args.append(node.args.kwarg)
+            if node.args.args:
+                args.extend(node.args.args)
+            if node.args.posonlyargs:
+                args.extend(node.args.posonlyargs)
+            if node.args.kwonlyargs:
+                args.extend(node.args.kwonlyargs)
+            if node.args.vararg:
+                args.append(node.args.vararg)
+            if node.args.kwarg:
+                args.append(node.args.kwarg)
 
             for arg in args:
                 if arg.arg in global_imports:
-                    shadow_errors.append(f"Function '{func_name}' has parameter '{arg.arg}' shadowing an import.")
+                    shadow_errors.append(
+                        f"Function '{func_name}' has parameter '{arg.arg}' shadowing an import."
+                    )
 
             # 2b. Check local assignments (any Name with Store context)
             for child in ast.walk(node):
                 if isinstance(child, ast.Name) and isinstance(child.ctx, ast.Store):
                     if child.id in global_imports:
-                        shadow_errors.append(f"Function '{func_name}' has local variable '{child.id}' shadowing an import. Line {getattr(child, 'lineno', '?')}")
+                        shadow_errors.append(
+                            f"Function '{func_name}' has local variable '{child.id}' shadowing an import. Line {getattr(child, 'lineno', '?')}"
+                        )
 
     if shadow_errors:
         print(f"\n[CRITICAL FATAL] Shadowing detected in {filepath}:")
         for err in shadow_errors:
             print(f"  - {err}")
         return False
-    
+
     print(f"[{os.path.basename(filepath)}] AST Shadowing Check: PASSED \u2705")
     return True
 
+
 if __name__ == "__main__":
-    files_to_check = [
-        "src/telegram_mcp/mcp_server.py",
-        "src/telegram_mcp/client.py"
-    ]
-    
+    files_to_check = ["src/telegram_mcp/mcp_server.py", "src/telegram_mcp/client.py"]
+
     all_passed = True
     for f in files_to_check:
         full_path = os.path.join(os.getcwd(), f)
@@ -73,8 +81,8 @@ def validate_shadowing(filepath: str):
                 all_passed = False
         else:
             print(f"Warning: File {f} not found.")
-            
+
     if not all_passed:
         sys.exit(1)
-    
+
     sys.exit(0)

src/telegram_mcp/dtos.py

@@ -1,14 +1,18 @@
 from typing import List, Optional, Union
 from pydantic import BaseModel, Field
 
+
 class ImportContactsPayload(BaseModel):
     contact_list: list = Field(
         description="A list of contacts. Each contact should be a dict with phone, first_name, last_name."
     )
 
+
 class CreateFolderPayload(BaseModel):
     title: str = Field(description="Folder name (required)")
-    emoticon: Optional[str] = Field(default=None, description="Folder emoji (optional, e.g., '📁', '🏠', '💼')")
+    emoticon: Optional[str] = Field(
+        default=None, description="Folder emoji (optional, e.g., '📁', '🏠', '💼')"
+    )
     chat_ids: Optional[List[Union[int, str]]] = Field(
         default=None, description="List of chat IDs or usernames to include (optional)"
     )
@@ -19,4 +23,6 @@ class CreateFolderPayload(BaseModel):
     include_bots: bool = Field(default=False, description="Include all bots")
     exclude_muted: bool = Field(default=False, description="Exclude muted chats")
     exclude_read: bool = Field(default=False, description="Exclude read chats")
-    exclude_archived: bool = Field(default=True, description="Exclude archived chats (default True)")
+    exclude_archived: bool = Field(
+        default=True, description="Exclude archived chats (default True)"
+    )