Add async template lifecycle example

Author: kvz

README.md

@@ -62,7 +62,7 @@ For copy/paste runnable examples, take a look at
 [`examples/`](https://github.com/transloadit/python-sdk/tree/HEAD/examples).
 
 The examples cover sync uploads, async uploads, resumable uploads, Template usage,
-Template lifecycle management, and Smart CDN URL signing.
+sync and async Template lifecycle management, and Smart CDN URL signing.
 
 ## Documentation
 

docs/source/index.rst

@@ -91,6 +91,6 @@ Examples
 For copy/paste runnable examples, take a look at `examples/`_.
 
 The examples cover sync uploads, async uploads, resumable uploads, Template usage,
-Template lifecycle management, and Smart CDN URL signing.
+sync and async Template lifecycle management, and Smart CDN URL signing.
 
 .. _examples/: https://github.com/transloadit/python-sdk/tree/HEAD/examples

examples/README.md

@@ -16,6 +16,7 @@ poetry run python examples/async_image_resize.py
 poetry run python examples/resumable_upload.py
 poetry run python examples/assembly_with_template.py
 poetry run python examples/template_lifecycle.py
+poetry run python examples/async_template_lifecycle.py
 poetry run python examples/smart_cdn_url.py
 ```
 

examples/async_template_lifecycle.py

@@ -0,0 +1,86 @@
+"""Create, fetch, update, and delete a Template with the async client.
+
+Run from the repository root:
+
+    TRANSLOADIT_KEY=xxx TRANSLOADIT_SECRET=yyy poetry run python examples/async_template_lifecycle.py
+"""
+
+import asyncio
+import os
+from uuid import uuid4
+
+from transloadit.async_client import AsyncTransloadit
+
+
+def get_credentials():
+    key = os.getenv("TRANSLOADIT_KEY")
+    secret = os.getenv("TRANSLOADIT_SECRET")
+    if not key or not secret:
+        raise RuntimeError("Please set TRANSLOADIT_KEY and TRANSLOADIT_SECRET.")
+    return key, secret
+
+
+def extract_template_id(response_data):
+    template_id = response_data.get("id") or response_data.get("template_id")
+    if not template_id:
+        raise RuntimeError(f"Template response did not contain an id: {response_data}")
+    return template_id
+
+
+async def main():
+    key, secret = get_credentials()
+    template_id = None
+    deleted = False
+    template_name = f"python-sdk-async-example-{uuid4().hex[:12]}"
+
+    async with AsyncTransloadit(key, secret) as client:
+        try:
+            template = client.new_template(template_name)
+            template.add_step(
+                "resize",
+                "/image/resize",
+                {
+                    "use": ":original",
+                    "width": 120,
+                    "height": 120,
+                    "resize_strategy": "fit",
+                    "format": "png",
+                },
+            )
+            created = await template.create()
+            template_id = extract_template_id(created.data)
+            print("Created template:", template_id)
+
+            fetched = await client.get_template(template_id)
+            print("Fetched template:", fetched.data.get("name") or fetched.data.get("template_name"))
+
+            updated = await client.update_template(
+                template_id,
+                {
+                    "name": f"{template_name}-updated",
+                    "template": {
+                        "steps": {
+                            "resize": {
+                                "use": ":original",
+                                "robot": "/image/resize",
+                                "width": 96,
+                                "height": 96,
+                                "resize_strategy": "fit",
+                                "format": "jpg",
+                            },
+                        },
+                    },
+                },
+            )
+            print("Updated template:", updated.data.get("ok"))
+
+            deleted_response = await client.delete_template(template_id)
+            print("Deleted template:", deleted_response.data.get("ok"))
+            deleted = True
+        finally:
+            if template_id and not deleted:
+                await client.delete_template(template_id)
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

tests/test_examples.py

@@ -15,6 +15,7 @@
     "resumable_upload.py",
     "assembly_with_template.py",
     "template_lifecycle.py",
+    "async_template_lifecycle.py",
     "smart_cdn_url.py",
 ]