Merge branch 'master' into python-bytes-to-strings

Author: bzaczynski

how-to-indent-in-python/README.md

@@ -0,0 +1,3 @@
+# How to Properly Indent Python Code
+
+This folder contains sample code for the Real Python tutorial [How to Properly Indent Python Code](https://realpython.com/how-to-indent-in-python/).

how-to-indent-in-python/long_indented_list.py

@@ -0,0 +1,17 @@
+long_list_of_names = [
+    "Amy",
+    "Brian",
+    "Carol",
+    "Dennis",
+    "Emma",
+    "Frank",
+    "Georgia",
+    "Herbert",
+    "Isabelle",
+    "Joshua",
+    "Kimberly",
+    "Laurence",
+    "Megan",
+    "Nicolas",
+    "Ophelia",
+]

how-to-indent-in-python/lucky_number.py

@@ -0,0 +1,8 @@
+lucky_number = 7
+for number in range(10):
+    if number == lucky_number:
+        print("Found the lucky number!")
+    else:
+        print(f"{number} is not my lucky number.")
+
+print("Done.")

how-to-indent-in-python/sample_code.py

@@ -0,0 +1,12 @@
+# ruff: noqa
+def add(a,      b):
+    answer       = a    +     b
+
+    return  answer
+
+def sub (c      ,
+    d):
+
+    answer = c      -d
+
+    return answer

pyproject.toml

@@ -4,7 +4,8 @@ line-length = 79
 exclude = [
     ".devcontainers",
     ".github",
-    "migrations"
+    "migrations",
+    "how-to-indent-in-python/sample_code.py"
 ]
 
 [tool.ruff.lint]

python-mcp-client/README.md

@@ -0,0 +1,3 @@
+# Build a Python MCP Client to Test Servers From Your Terminal
+
+This folder provides the code examples for the Real Python article [Build a Python MCP Client to Test Servers From Your Terminal](https://realpython.com/python-mcp-client/).

python-mcp-client/source-code-final/README.md

@@ -0,0 +1,81 @@
+# MCP Client
+
+A minimal client for testing Model Context Protocol (MCP) servers, featuring AI integration.
+
+## Features
+
+- **MCP server integration**: Connect to any MCP server
+- **Server introspection**: List available tools, prompts, and resources with the `--members` option
+- **TUI AI-powered chat**: Interactive chat with AI-powered tool execution using the `--chat` option
+
+## Installation
+
+1. Download the sample code
+
+2. Install dependencies:
+```console
+$ uv sync
+```
+
+3. Set up your OpenAI API key:
+```console
+$ export OPENAI_API_KEY="your-openai-api-key"
+```
+
+## Usage
+
+### List Server Members
+
+Inspect what tools, prompts, and resources are available on an MCP server:
+
+```console
+$ uv run python -m mcp_client /path/to/mcp_server.py --members
+```
+
+This command will display the following:
+
+- Tools and their descriptions
+- Prompts and their purposes
+- Resources and their types
+
+### Interactive Chat Mode
+
+Start an interactive chat session using the MCP server tools:
+
+```console
+$ uv run python -m mcp_client <path/to/mcp/server.py> --chat
+```
+
+- Example - Ask questions and get AI-powered responses:
+```console
+$ uv run python -m mcp_client mcp_server/mcp_server.py --chat
+
+MCP Client Started!
+Type your queries or 'quit' to exit.
+
+You: Greet Pythonista
+
+Assistant: [Used echo({'message': "Hello, Pythonista! 🐍 How's your coding journey going today?"})]
+Hello, Pythonista! 🐍 How's your coding journey going today?
+
+You:
+```
+
+- The AI will automatically use available MCP tools when needed
+- Type `quit` to exit
+
+## Example MCP Server
+
+The project includes, `mcp_server.py`, which is a minimal MCP server that provides:
+
+- A sample tool that says hello
+- Sample prompts and resources
+
+You can use this server to test the client's functionalities.
+
+## Requirements
+
+- Python >= 3.13
+- The MCP Python SDK and OpenAI Python SDK
+- An OpenAI API key
+- An MCP server to connect to

python-mcp-client/source-code-final/mcp_client/__init__.py

@@ -0,0 +1,30 @@
+import asyncio
+
+from mcp_client.cli import parse_args
+from mcp_client.mcp_client import MCPClient
+
+
+async def main() -> None:
+    """Run the MCP client with the specified options."""
+    args = parse_args()
+    if not args.server_path.exists():
+        print(f"Error: Server script '{args.server_path}' not found")
+        return
+
+    try:
+        async with MCPClient(str(args.server_path)) as client:
+            if args.members:
+                await client.list_all_members()
+            elif args.chat:
+                await client.run_chat()
+    except RuntimeError as e:
+        print(e)
+
+
+def cli_main():
+    """Entry point for the mcp-client CLI app."""
+    asyncio.run(main())
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

python-mcp-client/source-code-final/mcp_client/__main__.py

@@ -0,0 +1,17 @@
+async def run_chat(handler) -> None:
+    """Run an AI-handled chat session."""
+    print("\nMCP Client's Chat Started!")
+    print("Type your queries or 'quit' to exit.")
+
+    while True:
+        try:
+            if not (query := input("\nYou: ").strip()):
+                continue
+            if query.lower() == "quit":
+                break
+
+            print("\n" + await handler.process_query(query))
+        except Exception as e:
+            print(f"\nError: {str(e)}")
+
+    print("\nGoodbye!")