magic-pocket 0.1.0__py2.py3-none-any.whl

magic_pocket-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 Masaaki Yasui
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

magic_pocket-0.1.0.dist-info/METADATA

@@ -0,0 +1,47 @@
+Metadata-Version: 2.1
+Name: magic-pocket
+Version: 0.1.0
+Summary: Deploy system for Django projects.
+Author-email: Masaaki Yasui <yasu@worgue.com>
+Description-Content-Type: text/markdown
+Classifier: License :: OSI Approved :: MIT License
+Requires-Dist: click>=8.1.7
+Requires-Dist: tomli>=1.1.0 ; python_version < '3.11'
+Requires-Dist: mergedeep>=1.3.4
+Requires-Dist: pydantic>=2.5.3
+Requires-Dist: pydantic-settings>=2.1.0
+Requires-Dist: boto3>=1.34.28
+Requires-Dist: rich>=13.7.0
+Requires-Dist: deepdiff>=6.7.1
+Requires-Dist: pyyaml>=6.0.1
+Requires-Dist: python-on-whales>=0.68.0
+Requires-Dist: jinja2>=3.1.3
+Requires-Dist: awslambdaric>=2.0.10
+Requires-Dist: apig_wsgi>=2.18.0
+Requires-Dist: django-storages>=1.14.2,!=1.14.3
+Requires-Dist: django>=4.2.0 ; extra == "django"
+Project-URL: Documentation, https://worgue.github.io/magic-pocket/
+Project-URL: Source, https://github.com/worgue/magic-pocket
+Provides-Extra: django
+
+# Magic Pocket - Django Serverless Deployment
+
+ドキュメントはこちら
+https://worgue.github.io/magic-pocket/
+
+
+magic-pocket の目標は、サーバレスDjangoです。Djangoを以下の環境にデプロイします。
+
+- AWS Lambda
+- Neon Postgres
+- S3 storages
+
+## Motivation
+
+小規模な個人プロジェクトを、1人で複数同時に運用するため開発されたライブラリです。
+気軽に作り、飽きたら放っておく、というスタイルで運用するため、以下の要件が最終目標になっています。
+
+- サーバーの保守が不要
+- 使わない間のコストが不要
+- 環境を作る時にやる気を出す必要なし
+

magic_pocket-0.1.0.dist-info/RECORD

@@ -0,0 +1,50 @@
+pocket/__init__.py,sha256=JGyTWg48tN0-P6BH2WFWaLHOSilzYOpsrShIbcL_I30,64
+pocket/context.py,sha256=-xPhwwB-4U5Q87BZKME5gi8KO22GcfyVvSel7-TCK60,10231
+pocket/general_context.py,sha256=5QKnxIGCkp33zRNqemmmvR8fqoedagil6txMoMi426E,3206
+pocket/general_settings.py,sha256=RD4ht0pjSuqlYLeKnJTG7WNwmG78JaLFAIe-CCrkHew,1931
+pocket/mediator.py,sha256=iq1_JzviruWrhrAD61dSozuua7twN7AxW8Ez7hBJrQs,4597
+pocket/runtime.py,sha256=0hlbNgIfvzu1uttB4RRDllK2lXkz8e45mbXvkZlBrms,3287
+pocket/settings.py,sha256=u6FvECLsTSeRXLz8xRY8qEgTOIdSVo1cww4pcFefc-o,9039
+pocket/utils.py,sha256=oGUIjHosuMQWvoAaz3XqjgLlyJtapBF-PX7MMrSK4Hg,2612
+pocket/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pocket/cli/awscontainer_cli.py,sha256=PkuCFAtcrAdJ91XClfPfR5yzydyfuQ6RGj1r25BORgc,5911
+pocket/cli/deploy_cli.py,sha256=XzxUGyqSw606bYcmE1gVWMy7UWaCJzSxpYOsBtKND0Y,2430
+pocket/cli/main_cli.py,sha256=1WlUSNCqHzfvcCImPXitSSNvRYHyrucGGQMzw9l_Exg,673
+pocket/cli/neon_cli.py,sha256=ry2MMR63vzbRrHnYta8Bv0DT6rDpsfgeC11y7KCPpJc,2462
+pocket/cli/s3_cli.py,sha256=4-2xfZ30YQzGrzyQKHz4RfQL2NWB7uwbRZTjFig8Pao,1486
+pocket/cli/spa_cli.py,sha256=eHwGkb5AjRFuRYnmb3fxzp_znr8DPV7Q7EPYLoWyZPY,1901
+pocket/cli/status_cli.py,sha256=66kifOIF8HD-VWhAkmNfWEZj7BfvLQlmfjMsSvehbD0,2059
+pocket/cli/vpc_cli.py,sha256=FpEKZgsHyfowRGnLQK3q2dR9JPJQr3IXbhn0ZiQNr5w,1613
+pocket/django/__init__.py,sha256=nvNCBm-9BLVWmIUpmd_OETtWMFwQ7_fJZqE3PmLP_-4,177
+pocket/django/context.py,sha256=xuCfZxL0IthUpijke3zb3_FLX-qutBKK6_OtofYoOxk,2305
+pocket/django/django_cli.py,sha256=L_bbtXpdINNtpAPozAphIfu2-NOaa5UoSJIqjv3JmzI,6147
+pocket/django/lambda_handlers.py,sha256=IRvMx1qCa9kIvFRVmOxaxNwfBS-pt39hyGfdz51EDmg,1968
+pocket/django/runtime.py,sha256=Dq-dxgwiRJnKQ-99yuh5E3AtO3JocC4XTmNgx8vkKpc,1504
+pocket/django/settings.py,sha256=8Gg8FgOLlHpMcJF0bdFMwBTEkGTXS2Rc0uyG5H2Lgcs,1594
+pocket/django/urls.py,sha256=nkAiNEVjI9pUw0Z1t9cunynarNe_9Usrw_prBhwEL-c,1349
+pocket/django/utils.py,sha256=HqWznmI-QaWWcO1Po758oQXWK1tGaSlz7855FOcsLcQ,4670
+pocket/resources/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pocket/resources/awscontainer.py,sha256=o2Ize_2CNR5Na3kmnZftvHBygOOzbi4gStu_8gGMeow,6187
+pocket/resources/base.py,sha256=xOwos3J8RQgVxIpWw9IVYL3QKHHCAAtX6XJujsgBc6c,117
+pocket/resources/neon.py,sha256=Op9KoYdRvCVAfqRjqZYmyDXpKfofZXQQC16dSxljYzE,9869
+pocket/resources/s3.py,sha256=oGWPDUunmo8JS4g_ZeHefiRyGJKg9POwU_mG4ANgjtc,5251
+pocket/resources/spa.py,sha256=PFN_IhNYRjbiffC2HEXbLACP4ztbCi81eyCqA0foRwg,11055
+pocket/resources/vpc.py,sha256=5TbIBegzCBCOgltchwjFPNjgNJC-MTrj6f0ME3NUSHk,1302
+pocket/resources/aws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pocket/resources/aws/cloudformation.py,sha256=B8d5lFTcd0U_RyKsf0hMAUV7K4AAZz2OXCXGwl6Ohfc,6175
+pocket/resources/aws/ecr.py,sha256=fDX3wMxShu2v0Q93KFlglJzf0emcZ5MFpoUuhMW_PqQ,3205
+pocket/resources/aws/efs.py,sha256=Y2OOSMCC0khdbvEbvG6bCoWnzLC5sunnO39SO_iuih0,3932
+pocket/resources/aws/lambdahandler.py,sha256=KvIrxO6Akghi2jWnwtJ1IZN2PFnL0PGg0ZXqGUMYrY4,6629
+pocket/resources/aws/secretsmanager.py,sha256=cGbp0nL52bvooNLpttD2y7rmXlQLR934IpuSJSYVc-o,3987
+pocket/templates/cloudformation/awscontainer.yaml,sha256=4JW37R2I8y1g1guwLYn9iCDdH-al0sEyW6EKaDMHKG0,12443
+pocket/templates/cloudformation/spa.yaml,sha256=zEs9JcL-BBqUP_7fIFlA-ummqSa7n46X-nJS8K96vc8,2691
+pocket/templates/cloudformation/vpc.yaml,sha256=jV11OzAVhjOn36uO3PKWDpdEFqJD9TreCFV177lbcdY,5085
+pocket/templates/init/django-dotenv.env,sha256=sgYd_76armFBDDOVEYB4B0PZp0UR8soEf5RJ0NwVwEk,73
+pocket/templates/init/django-settings.py,sha256=pmTtaJcyJuhTTr95DLQbZewUAPYlhnEGrTBeZkLfFZo,3600
+pocket/templates/init/pocket.Dockerfile,sha256=_-yYd73xSVC-yyG2bu2Rkp4tP1a22lx6zeOG4djbNzk,911
+pocket/templates/init/pocket_simple.toml,sha256=RlZNvJ5OtTJyrlEk6Ex3AIvGaZJvfe3N3C8piKLrmVM,849
+magic_pocket-0.1.0.dist-info/entry_points.txt,sha256=zwGA18mmLk4cdBpb7hJEQqrpS7-e7H6GNsBV1F4_eX0,51
+magic_pocket-0.1.0.dist-info/LICENSE,sha256=6sI-S9egZe33_sWOqLD7eyix1d7xlHn_oiB-3mlXrZw,1080
+magic_pocket-0.1.0.dist-info/WHEEL,sha256=Sgu64hAMa6g5FdzHxXv9Xdse9yxpGGMeagVtPMWpJQY,99
+magic_pocket-0.1.0.dist-info/METADATA,sha256=c0Iur_M7LHnZH7P588esOgBgae1JaKRgoORh83-9H-w,1613
+magic_pocket-0.1.0.dist-info/RECORD,,

magic_pocket-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: flit 3.9.0
+Root-Is-Purelib: true
+Tag: py2-none-any
+Tag: py3-none-any

magic_pocket-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+pocket=pocket.cli.main_cli:main
+

pocket/__init__.py

@@ -0,0 +1,3 @@
+"""Deploy system for Django projects."""
+
+__version__ = "0.1.0"

pocket/cli/awscontainer_cli.py

@@ -0,0 +1,184 @@
+import webbrowser
+
+import click
+
+from ..context import Context
+from ..mediator import Mediator
+from ..resources.awscontainer import AwsContainer
+from ..utils import echo
+
+
+@click.group()
+def awscontainer():
+    pass
+
+
+def get_awscontainer_resource(stage):
+    context = Context.from_toml(stage=stage)
+    if not context.awscontainer:
+        echo.danger("awscontainer is not configured for this stage")
+        raise Exception("awscontainer is not configured for this stage")
+    return AwsContainer(context=context.awscontainer)
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+def yaml(stage):
+    ac = get_awscontainer_resource(stage)
+    print(ac.stack.yaml)
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+def yaml_diff(stage):
+    ac = get_awscontainer_resource(stage)
+    print(ac.stack.yaml_diff.to_json(indent=2))
+
+
+@awscontainer.group()
+def secretsmanager():
+    pass
+
+
+@secretsmanager.command()
+@click.option("--stage", prompt=True)
+@click.option("--show-values", is_flag=True, default=False)
+def list(stage, show_values):
+    ac = get_awscontainer_resource(stage)
+    sm = ac.context.secretsmanager
+    if not sm:
+        echo.warning("secretsmanager is not configured for this stage")
+        return
+    for key, arn in sm.secrets.items():
+        print("%s: %s" % (key, arn))
+        if show_values:
+            print("  - " + sm.resource.user_secrets[key])
+    for key, pocket_secret in sm.pocket_secrets.items():
+        status = "CREATED" if key in sm.resource.pocket_secrets else "NOEXIST"
+        print("%s: %s %s" % (key, pocket_secret.type, pocket_secret.options))
+        print("  - " + status)
+        if (status == "CREATED") and show_values:
+            value = sm.resource.pocket_secrets[key]
+            if isinstance(value, str):
+                print("  - " + value)
+            else:
+                for k, v in value.items():
+                    print(f"  - {k}: {v}")
+
+
+@secretsmanager.command()
+@click.option("--stage", prompt=True)
+def create_pocket_managed(stage):
+    ac = get_awscontainer_resource(stage)
+    sm = ac.context.secretsmanager
+    if not sm:
+        echo.warning("secretsmanager is not configured for this stage")
+        return
+    mediator = Mediator(Context.from_toml(stage=stage))
+    mediator.create_pocket_managed_secrets()
+
+
+def _confirm_delete_pocket_managed_secrets(awscontainer: AwsContainer):
+    sm = awscontainer.context.secretsmanager
+    if not sm:
+        echo.warning("secretsmanager is not configured")
+        return
+    existing_secret_keys = [
+        key for key in sm.pocket_secrets.keys() if key in sm.resource.pocket_secrets
+    ]
+    if not existing_secret_keys:
+        echo.warning("No pocket managed secets are created yet.")
+        return
+    echo.warning("You are deleting pocket managed secrets.")
+    echo.info("Deleting secrets:")
+    for key in existing_secret_keys:
+        echo.info(" - " + key)
+    echo.danger("This data cannot be restored!")
+    click.confirm("Do you realy want to delete pocket managed secrets?", abort=True)
+
+
+@secretsmanager.command()
+@click.option("--stage", prompt=True)
+def delete_pocket_managed(stage):
+    ac = get_awscontainer_resource(stage)
+    _confirm_delete_pocket_managed_secrets(ac)
+    if ac.context.secretsmanager:
+        ac.context.secretsmanager.resource.delete_pocket_secrets()
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+def create(stage):
+    ac = get_awscontainer_resource(stage)
+    if not ac.status == "NOEXIST":
+        echo.warning("AWS lambda container is already created.")
+    else:
+        mediator = Mediator(Context.from_toml(stage=stage))
+        ac.create(mediator)
+        echo.success("Created: lambda")
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+@click.option("--with-secrets", is_flag=True, default=False)
+def destroy(stage, with_secrets):
+    ac = get_awscontainer_resource(stage)
+    if ac.stack.status == "NOEXIST":
+        echo.warning("No AWS lambda container found.")
+    else:
+        ac.stack.delete()
+        echo.success("Aws lambda container was destroyed.")
+    if with_secrets:
+        _confirm_delete_pocket_managed_secrets(ac)
+        if ac.context.secretsmanager:
+            ac.context.secretsmanager.resource.delete_pocket_secrets()
+            echo.success("Pocket managed secrets were deleted.")
+    else:
+        echo.warning("Pocket managed secrets still exists.")
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+def update(stage):
+    ac = get_awscontainer_resource(stage)
+    if ac.status == "NOEXIST":
+        echo.warning("AWS lambda has not created yet.")
+        return
+    if ac.status == "FAILED":
+        echo.danger("AWS lambda has failed. Please check console.")
+        return
+    if ac.status == "PROGRESS":
+        echo.warning("AWS lambda is updating. Please wait.")
+        return
+    mediator = Mediator(Context.from_toml(stage=stage))
+    ac.update(mediator)
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+def status(stage):
+    ac = get_awscontainer_resource(stage)
+    if ac.status == "COMPLETED":
+        echo.success("Container is working!!!")
+    elif ac.status == "NOEXIST":
+        echo.warning("Container has not created yet.")
+    elif ac.status == "FAILED":
+        echo.danger("Container has failed. Please check console.")
+    else:
+        echo.warning("Container stack status: %s" % ac.stack.status)
+
+
+@awscontainer.command()
+@click.option("--stage", prompt=True)
+@click.option("--openpath")
+def url(stage, openpath):
+    ac = get_awscontainer_resource(stage)
+    if ac.status == "COMPLETED":
+        if endpoint := ac.endpoints.get("wsgi"):
+            echo.success(f"wsgi url: {endpoint}")
+            if openpath:
+                webbrowser.open(endpoint + "/" + openpath)
+        else:
+            echo.warning("wsgi endpoint not found.")
+    else:
+        echo.warning("Container is not working.")

pocket/cli/deploy_cli.py

@@ -0,0 +1,72 @@
+import inspect
+import webbrowser
+
+import click
+
+from ..context import Context
+from ..mediator import Mediator
+from ..utils import echo
+
+
+def get_resources(context: Context):
+    resources = []
+    if context.neon:
+        resources.append(context.neon.resource)
+    if context.s3:
+        resources.append(context.s3.resource)
+    if context.awscontainer:
+        if context.awscontainer.vpc:
+            resources.append(context.awscontainer.vpc.resource)
+        resources.append(context.awscontainer.resource)
+    if context.spa:
+        resources.append(context.spa.resource)
+    return resources
+
+
+def deploy_init_resources(context: Context):
+    for resource in get_resources(context):
+        target_name = resource.__class__.__name__
+        echo.log("Deploy init %s..." % target_name)
+        resource.deploy_init()
+
+
+def deploy_resources(context: Context):
+    mediator = Mediator(context)
+    for resource in get_resources(context):
+        target_name = resource.__class__.__name__
+        if resource.status == "NOEXIST":
+            echo.log("Creating %s..." % target_name)
+            if "mediator" in inspect.signature(resource.create).parameters:
+                resource.create(mediator)
+            else:
+                resource.create()
+        elif resource.status == "REQUIRE_UPDATE":
+            echo.log("Updating %s..." % target_name)
+            if "mediator" in inspect.signature(resource.update).parameters:
+                resource.update(mediator)
+            else:
+                resource.update()
+        else:
+            echo.log("%s is already the latest version." % target_name)
+
+
+@click.command()
+@click.option("--stage", prompt=True)
+@click.option("--openpath")
+def deploy(stage: str, openpath):
+    context = Context.from_toml(stage=stage)
+    deploy_init_resources(context)
+    deploy_resources(context)
+    if endpoint := context.awscontainer and context.awscontainer.resource.endpoints.get(
+        "wsgi"
+    ):
+        if endpoint is None:
+            echo.warning("wsgi endpoint is not created yet.")
+            echo.warning("You can check the endpoint later by resource command.")
+            echo.warning("$ pocket resource awscontainer url")
+            echo.warning("Or deploy again.")
+            echo.warning("$ pocket deploy")
+        else:
+            echo.success(f"wsgi url: {endpoint}")
+            if openpath:
+                webbrowser.open(endpoint + "/" + openpath)

pocket/cli/main_cli.py

@@ -0,0 +1,41 @@
+import click
+
+from .. import __version__
+from ..django import django_cli
+from . import (
+    awscontainer_cli,
+    deploy_cli,
+    neon_cli,
+    s3_cli,
+    spa_cli,
+    status_cli,
+    vpc_cli,
+)
+
+
+@click.group()
+def main():
+    pass
+
+
+@main.command()
+def version():
+    """Print the version number."""
+    click.echo(__version__)
+
+
+main.add_command(deploy_cli.deploy)
+main.add_command(status_cli.status)
+main.add_command(django_cli.django)
+
+
+@main.group()
+def resource():
+    pass
+
+
+resource.add_command(vpc_cli.vpc)
+resource.add_command(awscontainer_cli.awscontainer)
+resource.add_command(neon_cli.neon)
+resource.add_command(s3_cli.s3)
+resource.add_command(spa_cli.spa)

pocket/cli/neon_cli.py

@@ -0,0 +1,97 @@
+from pprint import pprint
+
+import click
+
+from ..context import Context
+from ..resources.neon import Neon
+from ..utils import echo
+
+
+@click.group()
+def neon():
+    pass
+
+
+def get_neon_resource(stage):
+    context = Context.from_toml(stage=stage)
+    if not context.neon:
+        echo.danger("neon is not configured for this stage")
+        raise Exception("neon is not configured for this stage")
+    return Neon(context=context.neon)
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+def context(stage):
+    neon = get_neon_resource(stage)
+    pprint(neon.context.model_dump())
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+def create(stage):
+    neon = get_neon_resource(stage)
+    neon.create()
+    echo.success("New branch was created")
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+def reset_database(stage):
+    neon = get_neon_resource(stage)
+    neon.reset_database()
+    echo.success("Reset database")
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+@click.option("--base-stage", default=None)
+def branch_out(stage, base_stage):
+    neon = get_neon_resource(stage)
+    if neon.branch:
+        raise Exception("Branch already exists")
+    base_neon = get_neon_resource(base_stage)
+    if not base_neon.working:
+        raise Exception("Base stage is not working")
+    assert base_neon.branch
+    neon.create_branch(base_neon.branch)
+    echo.success("New branch was created")
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+def delete(stage):
+    neon = get_neon_resource(stage)
+    neon.delete_branch()
+    echo.success("Branch was deleted successfully.")
+
+
+@neon.command()
+@click.option("--stage", prompt=True)
+def status(stage):
+    neon = get_neon_resource(stage)
+    if neon.project:
+        echo.success("Project found")
+    else:
+        echo.warning("Project not found")
+        return
+    if neon.branch:
+        echo.success("Branch found")
+    else:
+        echo.warning("Branch not found")
+        return
+    if neon.database:
+        echo.success("Database found")
+    else:
+        echo.warning("Database not found")
+        return
+    if neon.endpoint:
+        echo.success("Endpoint found: %s" % neon.endpoint.host)
+    else:
+        echo.warning("Endpoint not found")
+    if neon.role:
+        echo.success("Role found: %s" % neon.context.role_name)
+    else:
+        echo.warning("Role not found")
+    if neon.role and neon.endpoint:
+        echo.success("Database url: %s" % neon.database_url)

pocket/cli/s3_cli.py

@@ -0,0 +1,62 @@
+from pprint import pprint
+
+import click
+
+from ..context import Context
+from ..resources.s3 import S3
+from ..utils import echo
+
+
+@click.group()
+def s3():
+    pass
+
+
+def get_s3_resource(stage):
+    context = Context.from_toml(stage=stage)
+    if not context.s3:
+        echo.danger("s3 is not configured for this stage")
+        raise Exception("s3 is not configured for this stage")
+    return S3(context=context.s3)
+
+
+@s3.command()
+@click.option("--stage", prompt=True)
+def context(stage):
+    storage = get_s3_resource(stage)
+    pprint(storage.context.model_dump())
+
+
+@s3.command()
+@click.option("--stage", prompt=True)
+def create(stage):
+    storage = get_s3_resource(stage)
+    if storage.exists():
+        echo.warning(
+            "S3 Bucket is already created by you.\n"
+            "Presume this bucket is properly configured.\n"
+            "Please check the bucket.",
+        )
+        return
+    storage.ensure_exists()
+    echo.success("Created: bucket %s" % storage.context.bucket_name)
+
+
+@s3.command()
+@click.option("--stage", prompt=True)
+def update_public_dirs(stage):
+    storage = get_s3_resource(stage)
+    if not storage.exists():
+        echo.warning("No bucket found.")
+    storage.ensure_public_access_block()
+    storage.ensure_policy()
+
+
+@s3.command()
+@click.option("--stage", prompt=True)
+def status(stage):
+    storage = get_s3_resource(stage)
+    if storage.exists():
+        echo.success("Storage found")
+    else:
+        echo.warning("Storage not found")

pocket/cli/spa_cli.py

@@ -0,0 +1,82 @@
+import click
+
+from ..context import Context
+from ..utils import echo
+
+
+@click.group()
+def spa():
+    pass
+
+
+def get_spa_resource(stage):
+    context = Context.from_toml(stage=stage)
+    if not context.spa:
+        echo.danger("spa is not configured for this stage")
+        raise Exception("spa is not configured for this stage")
+    return context.spa.resource
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def yaml(stage):
+    spa = get_spa_resource(stage)
+    print(spa.stack.yaml)
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def yaml_diff(stage):
+    spa = get_spa_resource(stage)
+    print(spa.stack.yaml_diff.to_json(indent=2))
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def context(stage):
+    spa = get_spa_resource(stage)
+    print(spa.context.model_dump_json(indent=2))
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def create(stage):
+    spa = get_spa_resource(stage)
+    spa.create()
+    echo.success("spa store was created")
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def destroy(stage):
+    spa = get_spa_resource(stage)
+    spa.delete()
+    echo.success("spa store was deleted successfully.")
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def update(stage):
+    spa = get_spa_resource(stage)
+    if spa.status == "NOEXIST":
+        echo.warning("Spa resource has not created yet.")
+        return
+    if spa.status == "FAILED":
+        echo.danger("Spa resource creation has failed. Please check console.")
+        return
+    if spa.status == "PROGRESS":
+        echo.warning("Spa is updating. Please wait.")
+        return
+    spa.update()
+
+
+@spa.command()
+@click.option("--stage", prompt=True)
+def status(stage):
+    spa = get_spa_resource(stage)
+    if spa._origin_s3_exists():
+        echo.info("s3 for spa exists")
+    if spa.status == "COMPLETED":
+        echo.success("COMPLETED")
+    else:
+        print(spa.status)