Add Python SDK examples for first 10 tutorials

- Wrapper classes with one method per API action
- Scenario orchestrators (setup/interact/teardown)
- pytest test scaffolds with Stubber fixtures
- 4 tutorials with full implementations, 6 with scaffolds

Author: mwunderl

tuts/001-lightsail-gs/python/lightsail_wrapper.py

@@ -0,0 +1,58 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import logging
+import boto3
+from botocore.exceptions import ClientError
+
+logger = logging.getLogger(__name__)
+
+
+class LightsailWrapper:
+    def __init__(self, client):
+        self.client = client
+
+    def create_instances(self, instance_name, blueprint_id='amazon_linux_2023', bundle_id='nano_3_2'):
+        """Calls lightsail:CreateInstances."""
+        try:
+            self.client.create_instances(instanceNames=[instance_name], blueprintId=blueprint_id, bundleId=bundle_id, availabilityZone=f'{self.client.meta.region_name}a')
+            logger.info("CreateInstances succeeded.")
+        except ClientError:
+            logger.exception("CreateInstances failed.")
+            raise
+
+    def create_disk(self, disk_name, size_in_gb=8):
+        """Calls lightsail:CreateDisk."""
+        try:
+            self.client.create_disk(diskName=disk_name, sizeInGb=size_in_gb, availabilityZone=f'{self.client.meta.region_name}a')
+            logger.info("CreateDisk succeeded.")
+        except ClientError:
+            logger.exception("CreateDisk failed.")
+            raise
+
+    def get_instance(self, instance_name):
+        """Calls lightsail:GetInstance."""
+        try:
+            return self.client.get_instance(instanceName=instance_name)['instance']
+            logger.info("GetInstance succeeded.")
+        except ClientError:
+            logger.exception("GetInstance failed.")
+            raise
+
+    def delete_instance(self, instance_name):
+        """Calls lightsail:DeleteInstance."""
+        try:
+            self.client.delete_instance(instanceName=instance_name)
+            logger.info("DeleteInstance succeeded.")
+        except ClientError:
+            logger.exception("DeleteInstance failed.")
+            raise
+
+    def delete_disk(self, disk_name):
+        """Calls lightsail:DeleteDisk."""
+        try:
+            self.client.delete_disk(diskName=disk_name)
+            logger.info("DeleteDisk succeeded.")
+        except ClientError:
+            logger.exception("DeleteDisk failed.")
+            raise

tuts/001-lightsail-gs/python/requirements.txt

@@ -0,0 +1,2 @@
+boto3>=1.26
+pytest>=7.0

tuts/001-lightsail-gs/python/scenario_getting_started.py

@@ -0,0 +1,19 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import uuid
+import boto3
+from lightsail_wrapper import LightsailWrapper
+
+
+def run_scenario():
+    client = boto3.client("lightsail")
+    wrapper = LightsailWrapper(client)
+    suffix = uuid.uuid4().hex[:8]
+    print(f"Running Lightsail getting started scenario...")
+    # TODO: implement setup, interact, teardown
+    print("Scenario complete.")
+
+
+if __name__ == "__main__":
+    run_scenario()

tuts/001-lightsail-gs/python/test_lightsail.py

@@ -0,0 +1,21 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import pytest
+from botocore.stub import Stubber
+import boto3
+from lightsail_wrapper import LightsailWrapper
+
+
+@pytest.fixture
+def lightsail_stubber():
+    client = boto3.client("lightsail", region_name="us-east-1")
+    with Stubber(client) as stubber:
+        yield client, stubber
+
+
+def test_wrapper_creates(capsys, lightsail_stubber):
+    client, stubber = lightsail_stubber
+    wrapper = LightsailWrapper(client)
+    # TODO: add stubbed responses and assertions
+    assert wrapper is not None

tuts/002-vpc-gs/python/ec2_wrapper.py

@@ -0,0 +1,15 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import logging
+import boto3
+from botocore.exceptions import ClientError
+
+logger = logging.getLogger(__name__)
+
+
+class EC2Wrapper:
+    def __init__(self, client):
+        self.client = client
+
+    # TODO: Add wrapper methods matching the CLI tutorial actions

tuts/002-vpc-gs/python/requirements.txt

@@ -0,0 +1,2 @@
+boto3>=1.26
+pytest>=7.0

tuts/002-vpc-gs/python/scenario_getting_started.py

@@ -0,0 +1,18 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import uuid
+import boto3
+from ec2_wrapper import EC2Wrapper
+
+
+def run_scenario():
+    client = boto3.client("ec2")
+    wrapper = EC2Wrapper(client)
+    print(f"Running EC2 getting started scenario...")
+    # TODO: implement setup, interact, teardown
+    print("Scenario complete.")
+
+
+if __name__ == "__main__":
+    run_scenario()

tuts/002-vpc-gs/python/test_ec2.py

@@ -0,0 +1,20 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import pytest
+from botocore.stub import Stubber
+import boto3
+from ec2_wrapper import EC2Wrapper
+
+
+@pytest.fixture
+def stubber():
+    client = boto3.client("ec2", region_name="us-east-1")
+    with Stubber(client) as stubber:
+        yield client, stubber
+
+
+def test_wrapper_creates(stubber):
+    client, stub = stubber
+    wrapper = EC2Wrapper(client)
+    assert wrapper is not None

tuts/003-s3-gettingstarted/python/requirements.txt

@@ -0,0 +1,2 @@
+boto3>=1.26
+pytest>=7.0

tuts/003-s3-gettingstarted/python/s3_wrapper.py

@@ -0,0 +1,76 @@
+# Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import logging
+import boto3
+from botocore.exceptions import ClientError
+
+logger = logging.getLogger(__name__)
+
+
+class S3Wrapper:
+    def __init__(self, client):
+        self.client = client
+
+    def create_bucket(self, bucket_name):
+        """Calls s3:CreateBucket."""
+        try:
+            self.client.create_bucket(Bucket=bucket_name)
+            logger.info("CreateBucket succeeded.")
+        except ClientError:
+            logger.exception("CreateBucket failed.")
+            raise
+
+    def put_object(self, bucket_name, key, body):
+        """Calls s3:PutObject."""
+        try:
+            self.client.put_object(Bucket=bucket_name, Key=key, Body=body)
+            logger.info("PutObject succeeded.")
+        except ClientError:
+            logger.exception("PutObject failed.")
+            raise
+
+    def get_object(self, bucket_name, key):
+        """Calls s3:GetObject."""
+        try:
+            return self.client.get_object(Bucket=bucket_name, Key=key)['Body'].read()
+            logger.info("GetObject succeeded.")
+        except ClientError:
+            logger.exception("GetObject failed.")
+            raise
+
+    def copy_object(self, src_bucket, src_key, dst_bucket, dst_key):
+        """Calls s3:CopyObject."""
+        try:
+            self.client.copy_object(CopySource={'Bucket': src_bucket, 'Key': src_key}, Bucket=dst_bucket, Key=dst_key)
+            logger.info("CopyObject succeeded.")
+        except ClientError:
+            logger.exception("CopyObject failed.")
+            raise
+
+    def list_objects(self, bucket_name):
+        """Calls s3:ListObjectsV2."""
+        try:
+            return self.client.list_objects_v2(Bucket=bucket_name).get('Contents', [])
+            logger.info("ListObjectsV2 succeeded.")
+        except ClientError:
+            logger.exception("ListObjectsV2 failed.")
+            raise
+
+    def delete_objects(self, bucket_name, keys):
+        """Calls s3:DeleteObjects."""
+        try:
+            self.client.delete_objects(Bucket=bucket_name, Delete={'Objects': [{'Key': k} for k in keys]})
+            logger.info("DeleteObjects succeeded.")
+        except ClientError:
+            logger.exception("DeleteObjects failed.")
+            raise
+
+    def delete_bucket(self, bucket_name):
+        """Calls s3:DeleteBucket."""
+        try:
+            self.client.delete_bucket(Bucket=bucket_name)
+            logger.info("DeleteBucket succeeded.")
+        except ClientError:
+            logger.exception("DeleteBucket failed.")
+            raise