docs(content/v4): further Python SDK/example amendments

Signed-off-by: Vaughn Dice <vdice@akamai.com>

Author: vdice

content/v4/http-outbound.md

@@ -184,7 +184,7 @@ HTTP functions and classes are available in the `http` module. The function name
 from spin_sdk import http
 from spin_sdk.http import Request, Response, send
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
         response = await send(Request("GET", "https://random-data-api.fermyon.app/animals/json", {}, None))
         return response

content/v4/http-trigger.md

@@ -228,13 +228,13 @@ addEventListener('fetch', async (event: FetchEvent) => {
 
 > [**Want to go straight to the reference documentation?**  Find it here.](https://spinframework.github.io/spin-python-sdk/v4/)
 
-In Python, the application must define a top-level class named `WasiHttpHandler030Rc20260315` which inherits from [http.Handler](https://spinframework.github.io/spin-python-sdk/v4/http/index.html#spin_sdk.http.Handler), overriding the `handle_request` method.
+In Python, the application must define a top-level class named `HttpHandler` which inherits from [http.Handler](https://spinframework.github.io/spin-python-sdk/v4/http/index.html#spin_sdk.http.Handler), overriding the `handle_request` method.
 
 ```python
 from spin_sdk import http
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
       async def handle_request(self, request: Request) -> Response:
         return Response(
             200,

content/v4/kv-store-api-guide.md

@@ -131,7 +131,7 @@ The key value functions are provided through the `key_value` module in the Pytho
 from spin_sdk import http, key_value
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
         with await key_value.open_default() as store:
             await store.set("test", bytes("hello world!", "utf-8"))
@@ -168,8 +168,9 @@ class WasiHttpHandler030Rc20260315(http.Handler):
     - Return whether the specified key is present in the store
 
     [`get_keys` **Operation**](https://spinframework.github.io/spin-python-sdk/v4/wit/imports/spin_key_value_key_value_3_0_0.html#spin_sdk.wit.imports.spin_key_value_key_value_3_0_0.Store.get_keys)
-    - The underlying `get_keys` implementation no longer returns a list of strings in v4 of the SDK. Rather, due to the asynchronous nature of this method, it now returns a `Tuple` containing a [StreamReader](https://github.com/bytecodealliance/componentize-py/blob/1b3d2e936868307a48fb70941dcad71b54e844f8/bundled/componentize_py_async_support/streams.py#L101) and a [FutureReader](https://github.com/bytecodealliance/componentize-py/blob/1b3d2e936868307a48fb70941dcad71b54e844f8/bundled/componentize_py_async_support/futures.py#L11). You _must_ check when the stream ends, to determine if the stream ended normally, or was terminated prematurely due to an error.
-    - However, a new [util](https://spinframework.github.io/spin-python-sdk/v4/util.html) module offers a convenience method called [collect](https://spinframework.github.io/spin-python-sdk/v4/util.html#spin_sdk.util.collect), which does return the list of keys, after reading them from the stream and handling the future, raising an exception if an error results. (You can use this helper to collect values from any `Tuple[StreamReader, FutureReader]` - it isn't specific to KV.)
+    - Returns a `Tuple` containing a [StreamReader](https://github.com/bytecodealliance/componentize-py/blob/1b3d2e936868307a48fb70941dcad71b54e844f8/bundled/componentize_py_async_support/streams.py#L101) and a [FutureReader](https://github.com/bytecodealliance/componentize-py/blob/1b3d2e936868307a48fb70941dcad71b54e844f8/bundled/componentize_py_async_support/futures.py#L11). You _must_ check when the stream ends, to determine if the stream ended normally, or was terminated prematurely due to an error.
+
+    > If you're familiar with previous versions of the Python SDK, note that `get_keys` no longer returns a list.  To get the keys as a list, use `await util.collect(await store.get_keys())`. See [collect](https://spinframework.github.io/spin-python-sdk/v4/util.html#spin_sdk.util.collect) for more details.
 
 You can find a complete Python code example using the Key Value store in the [Spin Python SDK repository on GitHub](https://github.com/spinframework/spin-python-sdk/tree/main/examples/spin-kv).
 

content/v4/mqtt-outbound.md

@@ -91,7 +91,7 @@ from spin_sdk import http, mqtt
 from spin_sdk.mqtt import Qos
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
   async def handle_request(self, request: Request) -> Response:
         with await mqtt.open("mqtt://localhost:1883?client_id=client001", "user", "password", 30) as conn:
             await conn.publish("telemetry", bytes("Eureka!", "utf-8"), Qos.AT_LEAST_ONCE)

content/v4/quickstart.md

@@ -559,7 +559,7 @@ takes an HTTP request as a parameter and returns an HTTP response.
 ```python
 from spin_sdk.http import Handler, Request, Response
 
-class WasiHttpHandler030Rc20260315(Handler):
+class HttpHandler(Handler):
     async def handle_request(self, request: Request) -> Response:
         return Response(
             200,

content/v4/rdbms-storage.md

@@ -146,24 +146,26 @@ addEventListener('fetch', async (event: FetchEvent) => {
 
 > [**Want to go straight to the reference documentation?**  Find it here.](https://spinframework.github.io/spin-python-sdk/v4/)
 
-The code below is an [Outbound MySQL example](https://github.com/spinframework/spin-python-sdk/tree/main/examples/spin-mysql). There is also an outbound [PostgreSQL example](https://github.com/spinframework/spin-python-sdk/tree/main/examples/spin-postgres) available.
+The code below shows use of the [Postgres](https://spinframework.github.io/spin-python-sdk/v4/postgres.html) module and its [open](https://spinframework.github.io/spin-python-sdk/v4/postgres.html#spin_sdk.postgres.open) function for opening a connection to the database:
 
 ```python
-from spin_sdk import http, mysql
+from spin_sdk import http, postgres
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
-        with mysql.open("mysql://root:@127.0.0.1/spin_dev") as db:
-            print(db.query("select * from test", []))
-        
+        with await postgres.open("user=postgres dbname=spin_dev host=localhost sslmode=disable password=password") as db:
+            print(db.query("SELECT * FROM test", []))
+
         return Response(
             200,
             {"content-type": "text/plain"},
             bytes("Hello from Python!", "utf-8")
         )
 ```
 
+You can find a complete outbound PostgreSQL example in the [Spin Python SDK repository on GitHub](https://github.com/spinframework/spin-python-sdk/tree/main/examples/spin-postgres). There is also an [Outbound MySQL example](https://github.com/spinframework/spin-python-sdk/tree/main/examples/spin-mysql) available.
+
 {{ blockEnd }}
 
 {{ startTab "TinyGo"}}

content/v4/redis-outbound.md

@@ -125,7 +125,7 @@ To open a connection to a Redis instance, use the `redis.open` function. You can
 from spin_sdk import http, redis 
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
         with await redis.open("redis://localhost:6379") as db:
             print(await db.get("test"))

content/v4/redis-trigger.md

@@ -94,12 +94,12 @@ The JavaScript/TypeScript SDK doesn't currently support Redis components.  Pleas
 
 {{ startTab "Python"}}
 
-In Python, the handler needs to implement the [`SpinRedisInboundRedis300`](https://spinframework.github.io/spin-python-sdk/v4/wit/exports/index.html#spin_sdk.wit.exports.SpinRedisInboundRedis300) class, and override the `handle_message` method:
+In Python, the handler needs to implement the [`RedisHandler`](https://spinframework.github.io/spin-python-sdk/v4/wit/exports/index.html#spin_sdk.wit.exports.RedisHandler) class, and override the `handle_message` method:
 
 ```python
 from spin_sdk.wit import exports
 
-class SpinRedisInboundRedis300(exports.SpinRedisInboundRedis300):
+class RedisHandler(exports.RedisHandler):
     async def handle_message(self, message: bytes) -> None:
         print(message)
 ```

content/v4/serverless-ai-api-guide.md

@@ -164,7 +164,7 @@ addEventListener('fetch', async (event: FetchEvent) => {
 from spin_sdk import http, llm
 from spin_sdk.http import Request, Response
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
         prompt="You are a stand up comedy writer. Tell me a joke."
         result = llm.infer("llama2-chat", prompt)

content/v4/sqlite-api-guide.md

@@ -165,7 +165,7 @@ from spin_sdk import http, sqlite
 from spin_sdk.http import Request, Response
 from spin_sdk.sqlite import Value_Integer
 
-class WasiHttpHandler030Rc20260315(http.Handler):
+class HttpHandler(http.Handler):
     async def handle_request(self, request: Request) -> Response:
         with await sqlite.open_default() as db:
             result = db.execute("SELECT * FROM todos WHERE id > (?);", [Value_Integer(1)])