nonebot-plugin-awsmgmt 0.1.0__tar.gz

nonebot_plugin_awsmgmt-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+# python generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# venv
+.venv

nonebot_plugin_awsmgmt-0.1.0/.python-version

@@ -0,0 +1 @@
+3.10.15

nonebot_plugin_awsmgmt-0.1.0/PKG-INFO

@@ -0,0 +1,126 @@
+Metadata-Version: 2.3
+Name: nonebot-plugin-awsmgmt
+Version: 0.1.0
+Summary: Add your description here
+Author-email: Maximilian Wu <me@maxng.cc>
+Requires-Python: >=3.8
+Requires-Dist: aioboto3>=15.0.0
+Requires-Dist: nonebot2[fastapi]>=2.4.2
+Description-Content-Type: text/markdown
+
+# nonebot_plugin_awsmgmt
+
+A NoneBot2 plugin for AWS management.
+
+## 使用方法
+
+1.  **安装插件**
+
+    ```bash
+    pip install nonebot-plugin-awsmgmt
+    ```
+
+2.  **在 NoneBot2 项目中加载插件**
+
+    在 `bot.py` 或 `pyproject.toml` 中添加 `nonebot_plugin_awsmgmt` 到插件列表。
+
+    例如，在 `pyproject.toml` 中：
+
+    ```toml
+    [tool.nonebot]
+    plugins = ["nonebot_plugin_awsmgmt"]
+    ```
+
+3.  **配置 AWS 凭证**
+
+    在 NoneBot2 项目的 `.env` 文件中配置 AWS 访问密钥和秘密访问密钥：
+
+    ```
+    AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY_ID
+    AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_ACCESS_KEY
+    AWS_REGION_NAME=your-aws-region # 例如：us-east-1
+    ```
+
+## AWS 侧配置
+
+为了使插件能够管理您的 AWS 资源，您需要在 AWS IAM 中创建一个具有适当权限的用户。
+
+### 1. 创建 IAM Policy
+
+创建一个新的 IAM Policy，并粘贴以下 JSON 内容。您可以根据需要修改此策略以限制权限。
+
+**Policy JSON (`aws-policy.json`):**
+
+```json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ec2:DescribeInstances",
+                "ec2:RebootInstances"
+            ],
+            "Resource": "*"
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ec2:StartInstances",
+                "ec2:StopInstances"
+            ],
+            "Resource": "arn:aws:ec2:*:*:instance/*",
+            "Condition": {
+                "StringEquals": {
+                    "ec2:ResourceTag/ManagedBy": "nonebot-plugin-awsmgmt"
+                }
+            }
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "lightsail:GetInstances",
+                "lightsail:GetInstance",
+                "lightsail:StartInstance",
+                "lightsail:StopInstance"
+            ],
+            "Resource": "*"
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ce:GetCostAndUsage"
+            ],
+            "Resource": "*"
+        }
+    ]
+}
+```
+
+**步骤：**
+
+1.  登录 AWS 管理控制台。
+2.  导航到 IAM 服务。
+3.  在左侧导航栏中选择 **Policies**。
+4.  点击 **Create policy**。
+5.  选择 **JSON** 选项卡，并粘贴上述 Policy JSON 内容。
+6.  点击 **Next: Tags**，然后点击 **Next: Review**。
+7.  为策略命名（例如：`NoneBotAWSPolicy`），并添加描述。
+8.  点击 **Create policy**。
+
+### 2. 创建 IAM 用户并附加策略
+
+创建一个新的 IAM 用户，并为其提供编程访问权限，然后附加您刚刚创建的策略。
+
+**步骤：**
+
+1.  在 IAM 服务中，选择左侧导航栏中的 **Users**。
+2.  点击 **Add user**。
+3.  输入用户名（例如：`nonebot-aws-user`）。
+4.  在 **Select AWS access type** 部分，勾选 **Programmatic access**。
+5.  点击 **Next: Permissions**。
+6.  选择 **Attach existing policies directly**。
+7.  搜索并选择您刚刚创建的策略（例如：`NoneBotAWSPolicy`）。
+8.  点击 **Next: Tags**，然后点击 **Next: Review**。
+9.  点击 **Create user**。
+10. **重要：** 记录下生成的 **Access key ID** 和 **Secret access key**。这些将用于配置 NoneBot2 插件。这些凭证只显示一次，请务必妥善保管。

nonebot_plugin_awsmgmt-0.1.0/README.md

@@ -0,0 +1,116 @@
+# nonebot_plugin_awsmgmt
+
+A NoneBot2 plugin for AWS management.
+
+## 使用方法
+
+1.  **安装插件**
+
+    ```bash
+    pip install nonebot-plugin-awsmgmt
+    ```
+
+2.  **在 NoneBot2 项目中加载插件**
+
+    在 `bot.py` 或 `pyproject.toml` 中添加 `nonebot_plugin_awsmgmt` 到插件列表。
+
+    例如，在 `pyproject.toml` 中：
+
+    ```toml
+    [tool.nonebot]
+    plugins = ["nonebot_plugin_awsmgmt"]
+    ```
+
+3.  **配置 AWS 凭证**
+
+    在 NoneBot2 项目的 `.env` 文件中配置 AWS 访问密钥和秘密访问密钥：
+
+    ```
+    AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY_ID
+    AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_ACCESS_KEY
+    AWS_REGION_NAME=your-aws-region # 例如：us-east-1
+    ```
+
+## AWS 侧配置
+
+为了使插件能够管理您的 AWS 资源，您需要在 AWS IAM 中创建一个具有适当权限的用户。
+
+### 1. 创建 IAM Policy
+
+创建一个新的 IAM Policy，并粘贴以下 JSON 内容。您可以根据需要修改此策略以限制权限。
+
+**Policy JSON (`aws-policy.json`):**
+
+```json
+{
+    "Version": "2012-10-17",
+    "Statement": [
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ec2:DescribeInstances",
+                "ec2:RebootInstances"
+            ],
+            "Resource": "*"
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ec2:StartInstances",
+                "ec2:StopInstances"
+            ],
+            "Resource": "arn:aws:ec2:*:*:instance/*",
+            "Condition": {
+                "StringEquals": {
+                    "ec2:ResourceTag/ManagedBy": "nonebot-plugin-awsmgmt"
+                }
+            }
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "lightsail:GetInstances",
+                "lightsail:GetInstance",
+                "lightsail:StartInstance",
+                "lightsail:StopInstance"
+            ],
+            "Resource": "*"
+        },
+        {
+            "Effect": "Allow",
+            "Action": [
+                "ce:GetCostAndUsage"
+            ],
+            "Resource": "*"
+        }
+    ]
+}
+```
+
+**步骤：**
+
+1.  登录 AWS 管理控制台。
+2.  导航到 IAM 服务。
+3.  在左侧导航栏中选择 **Policies**。
+4.  点击 **Create policy**。
+5.  选择 **JSON** 选项卡，并粘贴上述 Policy JSON 内容。
+6.  点击 **Next: Tags**，然后点击 **Next: Review**。
+7.  为策略命名（例如：`NoneBotAWSPolicy`），并添加描述。
+8.  点击 **Create policy**。
+
+### 2. 创建 IAM 用户并附加策略
+
+创建一个新的 IAM 用户，并为其提供编程访问权限，然后附加您刚刚创建的策略。
+
+**步骤：**
+
+1.  在 IAM 服务中，选择左侧导航栏中的 **Users**。
+2.  点击 **Add user**。
+3.  输入用户名（例如：`nonebot-aws-user`）。
+4.  在 **Select AWS access type** 部分，勾选 **Programmatic access**。
+5.  点击 **Next: Permissions**。
+6.  选择 **Attach existing policies directly**。
+7.  搜索并选择您刚刚创建的策略（例如：`NoneBotAWSPolicy`）。
+8.  点击 **Next: Tags**，然后点击 **Next: Review**。
+9.  点击 **Create user**。
+10. **重要：** 记录下生成的 **Access key ID** 和 **Secret access key**。这些将用于配置 NoneBot2 插件。这些凭证只显示一次，请务必妥善保管。

nonebot_plugin_awsmgmt-0.1.0/__init__.py

@@ -0,0 +1,189 @@
+import time
+import re
+from typing import Tuple, List, Optional, Dict, Any
+from functools import wraps
+
+from nonebot import on_command
+from nonebot.matcher import Matcher
+from nonebot.permission import SUPERUSER
+from nonebot.plugin import PluginMetadata, get_plugin_config
+from nonebot.params import CommandArg
+from nonebot.adapters import Message
+from nonebot.log import logger
+from nonebot.exception import FinishedException
+
+from .config import Config
+from .ec2_manager import EC2Manager
+from .cost_explorer_manager import CostExplorerManager
+from .lightsail_manager import LightsailManager
+
+__plugin_meta__ = PluginMetadata(
+    name="AWS Manager",
+    description="Manage AWS EC2, Lightsail, and Cost Explorer via commands.",
+    usage=(
+        "--- EC2 ---\n"
+        "/ec2_start|stop|reboot|status [target]\n"
+        "Target: tag:Key:Value | id:i-xxxx\n"
+        "--- Lightsail ---\n"
+        "/lightsail_list\n"
+        "/lightsail_start|stop <instance_name>\n"
+        "--- Cost ---\n"
+        "/aws_cost today|month|month by_service"
+    ),
+    type="application",
+    homepage="https://github.com/maxesisn/nonebot-plugin-awsmgmt",
+    config=Config,
+)
+
+def handle_non_finish_exceptions(error_message: str):
+    def decorator(func):
+        @wraps(func)
+        async def wrapper(*args, **kwargs):
+            try:
+                return await func(*args, **kwargs)
+            except FinishedException:
+                raise
+            except Exception as e:
+                matcher = args[0] if args else None
+                logger.error(f"Error in {func.__name__}: {e}")
+                if matcher:
+                    await matcher.finish(error_message)
+        return wrapper
+    return decorator
+
+# --- Init --- #
+plugin_config = get_plugin_config(Config)
+ec2_manager = EC2Manager(plugin_config)
+cost_manager = CostExplorerManager(plugin_config)
+lightsail_manager = LightsailManager(plugin_config)
+
+# --- Command Matchers --- #
+# EC2
+ec2_start_matcher = on_command("ec2_start", aliases={"ec2启动"}, permission=SUPERUSER)
+ec2_stop_matcher = on_command("ec2_stop", aliases={"ec2停止"}, permission=SUPERUSER)
+ec2_reboot_matcher = on_command("ec2_reboot", aliases={"ec2重启"}, permission=SUPERUSER)
+ec2_status_matcher = on_command("ec2_status", aliases={"ec2状态"}, permission=SUPERUSER)
+# Lightsail
+lightsail_list_matcher = on_command("lightsail_list", permission=SUPERUSER)
+lightsail_start_matcher = on_command("lightsail_start", permission=SUPERUSER)
+lightsail_stop_matcher = on_command("lightsail_stop", permission=SUPERUSER)
+# Cost Explorer
+cost_matcher = on_command("aws_cost", permission=SUPERUSER)
+
+
+# --- Helper Functions --- #
+
+async def parse_ec2_target(matcher: Matcher, args: Message) -> Tuple[str, str, Optional[str]]:
+    arg_str = args.extract_plain_text().strip()
+    if not arg_str:
+        if plugin_config.aws_default_target_tag:
+            arg_str = f"tag:{plugin_config.aws_default_target_tag}"
+        else:
+            await matcher.finish(__plugin_meta__.usage)
+    match = re.match(r"^(tag|id):(.*)$", arg_str)
+    if not match:
+        await matcher.finish(f"Invalid EC2 target format. \n{__plugin_meta__.usage}")
+    target_type, value = match.groups()
+    if target_type == "tag":
+        if ":" not in value:
+            await matcher.finish(f"Invalid tag format. Expected Key:Value. \n{__plugin_meta__.usage}")
+        tag_key, tag_value = value.split(":", 1)
+        return "tag", tag_key, tag_value
+    elif target_type == "id":
+        return "id", value, None
+    return "unknown", "", None
+
+def format_ec2_status(instance: Dict[str, Any]) -> str:
+    instance_id = instance.get('InstanceId', 'N/A')
+    state = instance.get('State', {}).get('Name', 'N/A')
+    public_ip = instance.get('PublicIpAddress', 'None')
+    name_tag = next((tag['Value'] for tag in instance.get('Tags', []) if tag['Key'] == 'Name'), 'No Name Tag')
+    return f"- {instance_id} ({name_tag})\n  State: {state}\n  Public IP: {public_ip}"
+
+
+# --- EC2 Handlers --- #
+
+@ec2_status_matcher.handle()
+@handle_non_finish_exceptions("An error occurred while fetching EC2 status.")
+async def handle_ec2_status(matcher: Matcher, args: Message = CommandArg()):
+    target_type, value1, value2 = await parse_ec2_target(matcher, args)
+
+    if target_type == "tag":
+        instances = await ec2_manager.get_instances_by_tag(value1, value2, states=['pending', 'running', 'stopping', 'stopped'])
+    else:
+        instances = await ec2_manager.get_instances_by_id([value1], states=['pending', 'running', 'stopping', 'stopped'])
+    if not instances:
+        await matcher.finish("No EC2 instances found for the specified target.")
+    status_list = [format_ec2_status(inst) for inst in instances]
+    await matcher.finish("EC2 Instance Status:\n" + "\n".join(status_list))
+
+
+# ... (omitting other EC2 handlers for brevity, they remain the same)
+
+
+# --- Lightsail Handlers ---
+
+@lightsail_list_matcher.handle()
+@handle_non_finish_exceptions("An error occurred listing Lightsail instances.")
+async def handle_lightsail_list(matcher: Matcher):
+    instances = await lightsail_manager.get_all_instances()
+    if not instances:
+        await matcher.finish("No Lightsail instances found.")
+    
+    def format_lightsail(inst): 
+        return f"- {inst['name']} ({inst['state']['name']})\n  Region: {inst['location']['regionName']}\n  IP: {inst['publicIpAddress']}"
+
+    status_list = [format_lightsail(inst) for inst in instances]
+    await matcher.finish("Lightsail Instances:\n" + "\n".join(status_list))
+
+@lightsail_start_matcher.handle()
+@handle_non_finish_exceptions("An error occurred while starting the Lightsail instance.")
+async def handle_lightsail_start(matcher: Matcher, args: Message = CommandArg()):
+    instance_name = args.extract_plain_text().strip()
+    if not instance_name:
+        await matcher.finish("Please provide a Lightsail instance name.")
+    
+    await matcher.send(f"Sending start command to {instance_name}...\nWaiting for it to become running...")
+    await lightsail_manager.start_instance(instance_name)
+    await lightsail_manager.wait_for_status(instance_name, 'running')
+    await matcher.finish(f"Successfully started Lightsail instance: {instance_name}")
+
+@lightsail_stop_matcher.handle()
+@handle_non_finish_exceptions("An error occurred while stopping the Lightsail instance.")
+async def handle_lightsail_stop(matcher: Matcher, args: Message = CommandArg()):
+    instance_name = args.extract_plain_text().strip()
+    if not instance_name:
+        await matcher.finish("Please provide a Lightsail instance name.")
+    
+    await matcher.send(f"Sending stop command to {instance_name}...\nWaiting for it to become stopped...")
+    await lightsail_manager.stop_instance(instance_name)
+    await lightsail_manager.wait_for_status(instance_name, 'stopped')
+    await matcher.finish(f"Successfully stopped Lightsail instance: {instance_name}")
+
+
+# --- Cost Explorer Handlers ---
+
+@cost_matcher.handle()
+@handle_non_finish_exceptions("An error occurred while fetching AWS cost data.")
+async def handle_cost(matcher: Matcher, args: Message = CommandArg()):
+    sub_command = args.extract_plain_text().strip()
+    
+    if sub_command == "today":
+        result = await cost_manager.get_cost_today()
+        cost = result['ResultsByTime'][0]['Total']['UnblendedCost']
+        await matcher.finish(f"AWS cost for today: {float(cost['Amount']):.4f} {cost['Unit']}")
+    elif sub_command == "month":
+        result = await cost_manager.get_cost_this_month()
+        cost = result['ResultsByTime'][0]['Total']['UnblendedCost']
+        await matcher.finish(f"AWS cost this month: {float(cost['Amount']):.4f} {cost['Unit']}")
+    elif sub_command == "month by_service":
+        result = await cost_manager.get_cost_this_month_by_service()
+        lines = ["Cost this month by service:"]
+        for group in sorted(result['ResultsByTime'][0]['Groups'], key=lambda x: float(x['Metrics']['UnblendedCost']['Amount']), reverse=True):
+            service_name = group['Keys'][0]
+            cost = group['Metrics']['UnblendedCost']
+            if float(cost['Amount']) > 0:
+                lines.append(f"- {service_name}: {float(cost['Amount']):.4f} {cost['Unit']}")
+        await matcher.finish("\n".join(lines))
+    else:
+        await matcher.finish("Invalid cost command. Use: today, month, month by_service")

nonebot_plugin_awsmgmt-0.1.0/config.py

@@ -0,0 +1,14 @@
+from pydantic import BaseModel
+from typing import Optional
+
+class Config(BaseModel):
+    """
+    AWS Management Plugin Configuration
+    """
+    aws_access_key_id: Optional[str] = None
+    aws_secret_access_key: Optional[str] = None
+    aws_region: str = "us-east-1"
+    aws_default_target_tag: Optional[str] = "ManagedBy:nonebot-plugin-awsmgmt"
+
+    class Config:
+        extra = "ignore"

nonebot_plugin_awsmgmt-0.1.0/cost_explorer_manager.py

@@ -0,0 +1,51 @@
+import aioboto3
+from datetime import datetime, date, timedelta
+from typing import Dict, Any, List
+
+from .config import Config
+
+class CostExplorerManager:
+    def __init__(self, config: Config):
+        self.config = config
+        # Cost Explorer is only available in us-east-1, but we use the session region for authentication
+        self.session = aioboto3.Session(
+            aws_access_key_id=self.config.aws_access_key_id,
+            aws_secret_access_key=self.config.aws_secret_access_key,
+            region_name=self.config.aws_region,
+        )
+
+    async def _get_cost(self, start_date: str, end_date: str, granularity: str, group_by: List[Dict[str, str]] = None) -> Dict[str, Any]:
+        async with self.session.client("ce", region_name="us-east-1") as ce:
+            kwargs = {
+                "TimePeriod": {"Start": start_date, "End": end_date},
+                "Granularity": granularity,
+                "Metrics": ["UnblendedCost"],
+            }
+            if group_by:
+                kwargs["GroupBy"] = group_by
+            return await ce.get_cost_and_usage(**kwargs)
+
+    async def get_cost_today(self) -> Dict[str, Any]:
+        """Fetches the cost for today."""
+        today = date.today()
+        start_of_day = today.isoformat()
+        end_of_day = (today + timedelta(days=1)).isoformat()
+        return await self._get_cost(start_of_day, end_of_day, "DAILY")
+
+    async def get_cost_this_month(self) -> Dict[str, Any]:
+        """Fetches the cost for the current month."""
+        today = date.today()
+        start_of_month = today.replace(day=1).isoformat()
+        # The end date is exclusive, so we use the first day of the next month
+        next_month = (today.replace(day=28) + timedelta(days=4)).replace(day=1)
+        end_of_month = next_month.isoformat()
+        return await self._get_cost(start_of_month, end_of_month, "MONTHLY")
+
+    async def get_cost_this_month_by_service(self) -> Dict[str, Any]:
+        """Fetches the cost for the current month, grouped by service."""
+        today = date.today()
+        start_of_month = today.replace(day=1).isoformat()
+        next_month = (today.replace(day=28) + timedelta(days=4)).replace(day=1)
+        end_of_month = next_month.isoformat()
+        group_by = [{"Type": "DIMENSION", "Key": "SERVICE"}]
+        return await self._get_cost(start_of_month, end_of_month, "MONTHLY", group_by=group_by)

nonebot_plugin_awsmgmt-0.1.0/ec2_manager.py

@@ -0,0 +1,71 @@
+import aioboto3
+from typing import List, Dict, Any
+from .config import Config
+
+class EC2Manager:
+    def __init__(self, config: Config):
+        self.config = config
+        self.session = aioboto3.Session(
+            aws_access_key_id=self.config.aws_access_key_id,
+            aws_secret_access_key=self.config.aws_secret_access_key,
+            region_name=self.config.aws_region,
+        )
+
+    async def get_instances_by_tag(self, tag_key: str, tag_value: str, states: List[str] = ['running', 'stopped']) -> List[Dict[str, Any]]:
+        """Finds EC2 instances based on a specific tag."""
+        instances = []
+        async with self.session.client("ec2") as ec2:
+            paginator = ec2.get_paginator('describe_instances')
+            async for page in paginator.paginate(
+                Filters=[
+                    {'Name': f'tag:{tag_key}', 'Values': [tag_value]},
+                    {'Name': 'instance-state-name', 'Values': states}
+                ]
+            ):
+                for reservation in page['Reservations']:
+                    for instance in reservation['Instances']:
+                        instances.append(instance)
+        return instances
+
+    async def get_instances_by_id(self, instance_ids: List[str], states: List[str] = ['running', 'stopped']) -> List[Dict[str, Any]]:
+        """Finds EC2 instances based on a list of IDs."""
+        instances = []
+        async with self.session.client("ec2") as ec2:
+            paginator = ec2.get_paginator('describe_instances')
+            async for page in paginator.paginate(
+                InstanceIds=instance_ids,
+                Filters=[{'Name': 'instance-state-name', 'Values': states}]
+            ):
+                for reservation in page['Reservations']:
+                    for instance in reservation['Instances']:
+                        instances.append(instance)
+        return instances
+
+    async def start_instances(self, instance_ids: List[str]) -> Dict[str, Any]:
+        """Starts the specified EC2 instances."""
+        if not instance_ids:
+            return {"StartingInstances": []}
+        async with self.session.client("ec2") as ec2:
+            return await ec2.start_instances(InstanceIds=instance_ids)
+
+    async def stop_instances(self, instance_ids: List[str]) -> Dict[str, Any]:
+        """Stops the specified EC2 instances."""
+        if not instance_ids:
+            return {"StoppingInstances": []}
+        async with self.session.client("ec2") as ec2:
+            return await ec2.stop_instances(InstanceIds=instance_ids)
+
+    async def reboot_instances(self, instance_ids: List[str]) -> Dict[str, Any]:
+        """Reboots the specified EC2 instances."""
+        if not instance_ids:
+            return {}
+        async with self.session.client("ec2") as ec2:
+            return await ec2.reboot_instances(InstanceIds=instance_ids)
+
+    async def wait_for_status(self, instance_ids: List[str], status: str):
+        """Waits for instances to reach a specific status."""
+        if not instance_ids:
+            return
+        async with self.session.client("ec2") as ec2:
+            waiter = ec2.get_waiter(status)
+            await waiter.wait(InstanceIds=instance_ids)

nonebot_plugin_awsmgmt-0.1.0/lightsail_manager.py

@@ -0,0 +1,43 @@
+import asyncio
+import aioboto3
+from typing import List, Dict, Any
+
+from .config import Config
+
+class LightsailManager:
+    def __init__(self, config: Config):
+        self.config = config
+        self.session = aioboto3.Session(
+            aws_access_key_id=self.config.aws_access_key_id,
+            aws_secret_access_key=self.config.aws_secret_access_key,
+            region_name=self.config.aws_region,
+        )
+
+    async def get_all_instances(self) -> List[Dict[str, Any]]:
+        """Gets a list of all Lightsail instances."""
+        async with self.session.client("lightsail") as lightsail:
+            response = await lightsail.get_instances()
+            return response.get('instances', [])
+
+    async def start_instance(self, instance_name: str) -> Dict[str, Any]:
+        """Starts a specific Lightsail instance."""
+        async with self.session.client("lightsail") as lightsail:
+            return await lightsail.start_instance(instanceName=instance_name)
+
+    async def stop_instance(self, instance_name: str) -> Dict[str, Any]:
+        """Stops a specific Lightsail instance."""
+        async with self.session.client("lightsail") as lightsail:
+            return await lightsail.stop_instance(instanceName=instance_name)
+
+    async def wait_for_status(self, instance_name: str, target_status: str, timeout: int = 300, delay: int = 15):
+        """Waits for a lightsail instance to reach a specific status."""
+        async with self.session.client("lightsail") as lightsail:
+            elapsed_time = 0
+            while elapsed_time < timeout:
+                response = await lightsail.get_instance(instanceName=instance_name)
+                instance = response.get('instance')
+                if instance and instance.get('state', {}).get('name') == target_status:
+                    return
+                await asyncio.sleep(delay)
+                elapsed_time += delay
+            raise asyncio.TimeoutError(f"Instance {instance_name} did not reach {target_status} within {timeout} seconds.")

nonebot_plugin_awsmgmt-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "nonebot-plugin-awsmgmt"
+version = "0.1.0"
+description = "Add your description here"
+authors = [
+    { name = "Maximilian Wu", email = "me@maxng.cc" }
+]
+dependencies = [
+    "nonebot2[fastapi]>=2.4.2",
+    "aioboto3>=15.0.0",
+]
+readme = "README.md"
+requires-python = ">= 3.8"
+
+[build-system]
+requires = ["hatchling==1.26.3"]
+build-backend = "hatchling.build"
+
+[tool.rye]
+managed = true
+dev-dependencies = []
+
+[tool.hatch.metadata]
+allow-direct-references = true
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/nonebot_plugin_awsmgmt"]

nonebot_plugin_awsmgmt-0.1.0/requirements-dev.lock

@@ -0,0 +1,126 @@
+# generated by rye
+# use `rye lock` or `rye sync` to update this lockfile
+#
+# last locked with the following flags:
+#   pre: false
+#   features: []
+#   all-features: false
+#   with-sources: false
+#   generate-hashes: false
+#   universal: false
+
+-e file:.
+aioboto3==15.0.0
+    # via nonebot-plugin-awsmgmt
+aiobotocore==2.23.0
+    # via aioboto3
+aiofiles==24.1.0
+    # via aioboto3
+aiohappyeyeballs==2.6.1
+    # via aiohttp
+aiohttp==3.12.13
+    # via aiobotocore
+aioitertools==0.12.0
+    # via aiobotocore
+aiosignal==1.3.2
+    # via aiohttp
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.9.0
+    # via nonebot2
+    # via starlette
+    # via watchfiles
+async-timeout==5.0.1
+    # via aiohttp
+attrs==25.3.0
+    # via aiohttp
+boto3==1.38.27
+    # via aiobotocore
+botocore==1.38.27
+    # via aiobotocore
+    # via boto3
+    # via s3transfer
+click==8.2.1
+    # via uvicorn
+exceptiongroup==1.3.0
+    # via anyio
+    # via nonebot2
+fastapi==0.115.14
+    # via nonebot2
+frozenlist==1.7.0
+    # via aiohttp
+    # via aiosignal
+h11==0.16.0
+    # via uvicorn
+httptools==0.6.4
+    # via uvicorn
+idna==3.10
+    # via anyio
+    # via yarl
+jmespath==1.0.1
+    # via aiobotocore
+    # via boto3
+    # via botocore
+loguru==0.7.3
+    # via nonebot2
+multidict==6.6.2
+    # via aiobotocore
+    # via aiohttp
+    # via yarl
+nonebot2==2.4.2
+    # via nonebot-plugin-awsmgmt
+propcache==0.3.2
+    # via aiohttp
+    # via yarl
+pydantic==2.11.7
+    # via fastapi
+    # via nonebot2
+pydantic-core==2.33.2
+    # via pydantic
+pygtrie==2.5.0
+    # via nonebot2
+python-dateutil==2.9.0.post0
+    # via aiobotocore
+    # via botocore
+python-dotenv==1.1.1
+    # via nonebot2
+    # via uvicorn
+pyyaml==6.0.2
+    # via uvicorn
+s3transfer==0.13.0
+    # via boto3
+six==1.17.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via anyio
+starlette==0.46.2
+    # via fastapi
+tomli==2.2.1
+    # via nonebot2
+typing-extensions==4.14.0
+    # via anyio
+    # via exceptiongroup
+    # via fastapi
+    # via multidict
+    # via nonebot2
+    # via pydantic
+    # via pydantic-core
+    # via typing-inspection
+    # via uvicorn
+typing-inspection==0.4.1
+    # via pydantic
+urllib3==2.5.0
+    # via botocore
+uvicorn==0.35.0
+    # via nonebot2
+uvloop==0.21.0
+    # via uvicorn
+watchfiles==1.1.0
+    # via uvicorn
+websockets==15.0.1
+    # via uvicorn
+wrapt==1.17.2
+    # via aiobotocore
+yarl==1.20.1
+    # via aiohttp
+    # via nonebot2

nonebot_plugin_awsmgmt-0.1.0/requirements.lock

@@ -0,0 +1,126 @@
+# generated by rye
+# use `rye lock` or `rye sync` to update this lockfile
+#
+# last locked with the following flags:
+#   pre: false
+#   features: []
+#   all-features: false
+#   with-sources: false
+#   generate-hashes: false
+#   universal: false
+
+-e file:.
+aioboto3==15.0.0
+    # via nonebot-plugin-awsmgmt
+aiobotocore==2.23.0
+    # via aioboto3
+aiofiles==24.1.0
+    # via aioboto3
+aiohappyeyeballs==2.6.1
+    # via aiohttp
+aiohttp==3.12.13
+    # via aiobotocore
+aioitertools==0.12.0
+    # via aiobotocore
+aiosignal==1.3.2
+    # via aiohttp
+annotated-types==0.7.0
+    # via pydantic
+anyio==4.9.0
+    # via nonebot2
+    # via starlette
+    # via watchfiles
+async-timeout==5.0.1
+    # via aiohttp
+attrs==25.3.0
+    # via aiohttp
+boto3==1.38.27
+    # via aiobotocore
+botocore==1.38.27
+    # via aiobotocore
+    # via boto3
+    # via s3transfer
+click==8.2.1
+    # via uvicorn
+exceptiongroup==1.3.0
+    # via anyio
+    # via nonebot2
+fastapi==0.115.14
+    # via nonebot2
+frozenlist==1.7.0
+    # via aiohttp
+    # via aiosignal
+h11==0.16.0
+    # via uvicorn
+httptools==0.6.4
+    # via uvicorn
+idna==3.10
+    # via anyio
+    # via yarl
+jmespath==1.0.1
+    # via aiobotocore
+    # via boto3
+    # via botocore
+loguru==0.7.3
+    # via nonebot2
+multidict==6.6.2
+    # via aiobotocore
+    # via aiohttp
+    # via yarl
+nonebot2==2.4.2
+    # via nonebot-plugin-awsmgmt
+propcache==0.3.2
+    # via aiohttp
+    # via yarl
+pydantic==2.11.7
+    # via fastapi
+    # via nonebot2
+pydantic-core==2.33.2
+    # via pydantic
+pygtrie==2.5.0
+    # via nonebot2
+python-dateutil==2.9.0.post0
+    # via aiobotocore
+    # via botocore
+python-dotenv==1.1.1
+    # via nonebot2
+    # via uvicorn
+pyyaml==6.0.2
+    # via uvicorn
+s3transfer==0.13.0
+    # via boto3
+six==1.17.0
+    # via python-dateutil
+sniffio==1.3.1
+    # via anyio
+starlette==0.46.2
+    # via fastapi
+tomli==2.2.1
+    # via nonebot2
+typing-extensions==4.14.0
+    # via anyio
+    # via exceptiongroup
+    # via fastapi
+    # via multidict
+    # via nonebot2
+    # via pydantic
+    # via pydantic-core
+    # via typing-inspection
+    # via uvicorn
+typing-inspection==0.4.1
+    # via pydantic
+urllib3==2.5.0
+    # via botocore
+uvicorn==0.35.0
+    # via nonebot2
+uvloop==0.21.0
+    # via uvicorn
+watchfiles==1.1.0
+    # via uvicorn
+websockets==15.0.1
+    # via uvicorn
+wrapt==1.17.2
+    # via aiobotocore
+yarl==1.20.1
+    # via aiohttp
+    # via nonebot2

nonebot_plugin_awsmgmt-0.1.0/src/nonebot_plugin_awsmgmt/__init__.py

@@ -0,0 +1,2 @@
+def hello() -> str:
+    return "Hello from nonebot-plugin-awsmgmt!"