pixelarraylib 1.0.7__tar.gz → 1.0.9__tar.gz

{pixelarraylib-1.0.7/pixelarraylib.egg-info → pixelarraylib-1.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelarraylib
-Version: 1.0.7
+Version: 1.0.9
 Summary: PixelArray Python开发工具库 - 包含阿里云服务、数据库工具、装饰器、监控等功能
 Author-email: Lu qi <qi.lu@pixelarrayai.com>
 License-Expression: MIT

{pixelarraylib-1.0.7 → pixelarraylib-1.0.9}/pixelarraylib/__init__.py

@@ -20,7 +20,7 @@ PixelArray Python开发工具库
     from pixelarraylib.gitlab import pypi_package_manager
 """
 
-__version__ = "1.0.7"
+__version__ = "1.0.9"
 __author__ = "PixelArray"
 __email__ = "qi.lu@pixelarrayai.com"
 

pixelarraylib-1.0.9/pixelarraylib/aliyun/acr.py

@@ -0,0 +1,514 @@
+import os
+import sys
+import re
+
+from typing import List
+
+from alibabacloud_cr20181201.client import Client as cr20181201Client
+from alibabacloud_credentials.client import Client as CredentialClient
+from alibabacloud_tea_openapi import models as open_api_models
+from alibabacloud_cr20181201 import models as cr_20181201_models
+from alibabacloud_tea_util import models as util_models
+from alibabacloud_tea_util.client import Client as UtilClient
+
+from pixelarraylib.monitor.feishu import Feishu
+
+feishu_alert = Feishu("devtoolkit服务报警")
+
+
+class ACRUtils:
+    def __init__(self, region_id: str, access_key_id: str, access_key_secret: str):
+        self.region_id = region_id
+        self.access_key_id = access_key_id
+        self.access_key_secret = access_key_secret
+        self.client = self._create_client()
+
+    def _create_client(self):
+        credential = CredentialClient()
+        config = open_api_models.Config(
+            credential=credential,
+            access_key_id=self.access_key_id,
+            access_key_secret=self.access_key_secret,
+        )
+        # Endpoint 请参考 https://api.aliyun.com/product/cr
+        config.endpoint = f"cr.{self.region_id}.aliyuncs.com"
+        return cr20181201Client(config)
+
+    def list_instances(self):
+        """
+        description:
+            列出容器镜像服务实例
+        parameters:
+            None
+        return:
+            dict: 包含实例列表的响应数据
+            success(bool): 是否成功
+        """
+
+        try:
+            request = cr_20181201_models.ListInstanceRequest()
+            response = self.client.list_instance(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出实例失败: {e}")
+            return {}, False
+
+    def create_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            创建命名空间
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 创建结果
+            success(bool): 是否成功
+        """
+
+        try:
+            request = cr_20181201_models.CreateNamespaceRequest(
+                instance_id=instance_id, namespace_name=namespace_name
+            )
+            response = self.client.create_namespace(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"创建命名空间失败: {e}")
+            return {}, False
+
+    def delete_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            删除命名空间
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 删除结果
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.DeleteNamespaceRequest(
+                instance_id=instance_id, namespace_name=namespace_name
+            )
+            response = self.client.delete_namespace(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"删除命名空间失败: {e}")
+            return {}, False
+
+    def list_namespaces(self, instance_id: str):
+        """
+        description:
+            列出命名空间
+        parameters:
+            instance_id (str): 实例ID
+        return:
+            dict: 包含命名空间列表的响应数据
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.ListNamespaceRequest(instance_id=instance_id)
+            response = self.client.list_namespace(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出命名空间失败: {e}")
+            return {}, False
+
+    def exists_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            判断命名空间是否存在
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            bool: 是否存在
+        """
+        response, success = self.list_namespaces(instance_id)
+        if not success:
+            return False, False
+        namespace_names = [
+            namespace["NamespaceName"] for namespace in response["Namespaces"]
+        ]
+        return namespace_name in namespace_names, True
+
+    def create_repository(
+        self,
+        instance_id: str,
+        namespace_name: str,
+        repository_name: str,
+        repository_type: str,
+        summary: str,
+    ):
+        """
+        description:
+            创建仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+            repository_type (str): 仓库类型
+            summary (str): 仓库摘要
+        return:
+            dict: 创建结果
+            success(bool): 是否成功
+        """
+        if not re.fullmatch(r"[a-z\-]+", repository_name):
+            print("仓库名称只能包含小写英文字母和横杠")
+            return {}, False
+        try:
+            request = cr_20181201_models.CreateRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_name=repository_name,
+                repo_type=repository_type,
+                summary=summary,
+            )
+            response = self.client.create_repository(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"创建仓库失败: {e}")
+            return {}, False
+
+    def list_repositories(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            列出仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 包含仓库列表的响应数据
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.ListRepositoryRequest(
+                instance_id=instance_id, repo_namespace_name=namespace_name
+            )
+            response = self.client.list_repository(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出仓库失败: {e}")
+            return {}, False
+
+    def exists_repository(
+        self, instance_id: str, namespace_name: str, repository_name: str
+    ):
+        """
+        description:
+            判断仓库是否存在
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+        return:
+            bool: 是否存在
+        """
+        response, success = self.list_repositories(instance_id, namespace_name)
+        if not success:
+            return False, False
+        repository_names = [
+            repository["RepoName"] for repository in response["Repositories"]
+        ]
+        return repository_name in repository_names, True
+
+    def delete_repository(
+        self, instance_id: str, namespace_name: str, repository_id: str
+    ):
+        """
+        description:
+            删除仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_id (str): 仓库ID
+        return:
+            dict: 删除结果
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.DeleteRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_id=repository_id,
+            )
+            response = self.client.delete_repository(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"删除仓库失败: {e}")
+            return {}, False
+
+    def get_repository(
+        self, instance_id: str, namespace_name: str, repository_name: str
+    ):
+        """
+        description:
+            获取仓库详情信息
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+        return:
+            dict: 详情信息
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.GetRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_name=repository_name,
+            )
+            response = self.client.get_repository(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"获取仓库详情失败: {e}")
+            return {}, False
+
+
+class ACRUtilsAsync:
+    def __init__(self, region_id: str, access_key_id: str, access_key_secret: str):
+        self.region_id = region_id
+        self.access_key_id = access_key_id
+        self.access_key_secret = access_key_secret
+        self.client = self._create_client()
+
+    def _create_client(self):
+        credential = CredentialClient()
+        config = open_api_models.Config(
+            credential=credential,
+            access_key_id=self.access_key_id,
+            access_key_secret=self.access_key_secret,
+        )
+        # Endpoint 请参考 https://api.aliyun.com/product/cr
+        config.endpoint = f"cr.{self.region_id}.aliyuncs.com"
+        return cr20181201Client(config)
+
+    async def list_instances(self):
+        """
+        description:
+            列出容器镜像服务实例
+        parameters:
+            None
+        return:
+            dict: 包含实例列表的响应数据
+            success(bool): 是否成功
+        """
+
+        try:
+            request = cr_20181201_models.ListInstanceRequest()
+            response = await self.client.list_instance_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出实例失败: {e}")
+            return {}, False
+
+    async def create_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            创建命名空间
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 创建结果
+            success(bool): 是否成功
+        """
+
+        try:
+            request = cr_20181201_models.CreateNamespaceRequest(
+                instance_id=instance_id, namespace_name=namespace_name
+            )
+            response = await self.client.create_namespace_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"创建命名空间失败: {e}")
+            return {}, False
+
+    async def delete_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            删除命名空间
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 删除结果
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.DeleteNamespaceRequest(
+                instance_id=instance_id, namespace_name=namespace_name
+            )
+            response = await self.client.delete_namespace_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"删除命名空间失败: {e}")
+            return {}, False
+
+    async def list_namespaces(self, instance_id: str):
+        """
+        description:
+            列出命名空间
+        parameters:
+            instance_id (str): 实例ID
+        return:
+            dict: 包含命名空间列表的响应数据
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.ListNamespaceRequest(instance_id=instance_id)
+            response = await self.client.list_namespace_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出命名空间失败: {e}")
+            return {}, False
+
+    async def exists_namespace(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            判断命名空间是否存在
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            bool: 是否存在
+        """
+        response, success = await self.list_namespaces(instance_id)
+        if not success:
+            return False, False
+        namespace_names = [
+            namespace["NamespaceName"] for namespace in response["Namespaces"]
+        ]
+        return namespace_name in namespace_names, True
+
+    async def create_repository(
+        self,
+        instance_id: str,
+        namespace_name: str,
+        repository_name: str,
+        repository_type: str,
+        summary: str,
+    ):
+        """
+        description:
+            创建仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+            repository_type (str): 仓库类型
+            summary (str): 仓库摘要
+        return:
+            dict: 创建结果
+            success(bool): 是否成功
+        """
+        if not re.fullmatch(r"[a-z\-]+", repository_name):
+            print("仓库名称只能包含小写英文字母和横杠")
+            return {}, False
+        try:
+            request = cr_20181201_models.CreateRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_name=repository_name,
+                repo_type=repository_type,
+                summary=summary,
+            )
+            response = await self.client.create_repository_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"创建仓库失败: {e}")
+            return {}, False
+
+    async def list_repositories(self, instance_id: str, namespace_name: str):
+        """
+        description:
+            列出仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+        return:
+            dict: 包含仓库列表的响应数据
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.ListRepositoryRequest(
+                instance_id=instance_id, repo_namespace_name=namespace_name
+            )
+            response = await self.client.list_repository_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"列出仓库失败: {e}")
+            return {}, False
+
+    async def exists_repository(
+        self, instance_id: str, namespace_name: str, repository_name: str
+    ):
+        """
+        description:
+            判断仓库是否存在
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+        return:
+            bool: 是否存在
+        """
+        response, success = await self.list_repositories(instance_id, namespace_name)
+        if not success:
+            return False, False
+        repository_names = [
+            repository["RepoName"] for repository in response["Repositories"]
+        ]
+        return repository_name in repository_names, True
+
+    async def delete_repository(
+        self, instance_id: str, namespace_name: str, repository_id: str
+    ):
+        """
+        description:
+            删除仓库
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_id (str): 仓库ID
+        return:
+            dict: 删除结果
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.DeleteRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_id=repository_id,
+            )
+            response = await self.client.delete_repository_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"删除仓库失败: {e}")
+            return {}, False
+
+    async def get_repository(
+        self, instance_id: str, namespace_name: str, repository_name: str
+    ):
+        """
+        description:
+            获取仓库详情信息
+        parameters:
+            instance_id (str): 实例ID
+            namespace_name (str): 命名空间名称
+            repository_name (str): 仓库名称
+        return:
+            dict: 详情信息
+            success(bool): 是否成功
+        """
+        try:
+            request = cr_20181201_models.GetRepositoryRequest(
+                instance_id=instance_id,
+                repo_namespace_name=namespace_name,
+                repo_name=repository_name,
+            )
+            response = await self.client.get_repository_async(request)
+            return response.body.to_map(), True
+        except Exception as e:
+            print(f"获取仓库详情失败: {e}")
+            return {}, False

{pixelarraylib-1.0.7 → pixelarraylib-1.0.9}/pixelarraylib/aliyun/aliyun_email.py

@@ -1,3 +1,4 @@
+import asyncio
 import os
 import time
 import random
@@ -122,9 +123,130 @@ class AliyunEmailSender:
             if response.status_code == 200:
                 return True
             else:
-                feishu_alert.send(f"发送验证邮件失败: {response}")
+                print(f"发送验证邮件失败: {response}")
                 return False
 
         except Exception as e:
-            feishu_alert.send(traceback.format_exc())
+            print(traceback.format_exc())
+            return False
+
+
+class AliyunEmailSenderAsync:
+    def __init__(self, access_key_id, access_key_secret):
+        self.client = Dm20151123Client(
+            open_api_models.Config(
+                access_key_id=access_key_id,
+                access_key_secret=access_key_secret,
+                endpoint="dm.aliyuncs.com",
+            )
+        )
+
+    async def generate_verification_code(self, length=6):
+        """
+        description:
+            生成数字验证码
+        parameters:
+            length(int): 验证码长度
+        return:
+            str: 验证码
+        """
+        return await asyncio.to_thread(
+            lambda: "".join(str(random.randint(0, 9)) for _ in range(length))
+        )
+
+    def create_verification_email_content(
+        self, username, verification_code, email_type, validity=15
+    ):
+        """
+        description:
+            创建邮件HTML内容
+        parameters:
+            username(str): 用户名
+            validity(int): 验证码有效期
+        return:
+            str: 邮件HTML内容
+        """
+        email_type_str = "注册" if email_type == "register" else "找回密码"
+        return f"""
+        <html>
+        <head>
+            <style>
+                body {{ font-family: Arial, sans-serif; line-height: 1.6; }}
+                .container {{ max-width: 600px; margin: 0 auto; padding: 20px; border: 1px solid #e1e8f7; border-radius: 10px; }}
+                .header {{ background: linear-gradient(to right, #1a2980, #26d0ce); color: white; padding: 15px; text-align: center; border-radius: 8px; }}
+                .code {{ font-size: 28px; font-weight: bold; text-align: center; margin: 25px 0; letter-spacing: 5px; color: #e74c3c; }}
+                .footer {{ margin-top: 30px; text-align: center; color: #777; font-size: 12px; }}
+            </style>
+        </head>
+        <body>
+            <div class="container">
+                <div class="header">
+                    <h2>北京矩阵像素科技有限公司</h2>
+                </div>
+                
+                <p>尊敬的 <strong>{username}</strong>：</p>
+                <p>您正在进行邮箱{email_type_str}验证，您的验证码为：</p>
+                <div class="code">{verification_code}</div>
+                <p>该验证码 <strong>{validity}分钟</strong> 内有效，请尽快完成验证。</p>
+                <p>如非本人操作，请忽略此邮件。</p>
+                
+                <div class="footer">    
+                    <p>阿里云邮件推送服务 | 安全验证</p>
+                    <p>© {time.strftime('%Y')} 企业注册系统 版权所有</p>
+                </div>
+            </div>
+        </body>
+        </html>
+        """
+
+    def get_email_subject(self, email_type):
+        if email_type == "register":
+            return "您的注册验证码"
+        elif email_type == "forgot":
+            return "您的找回密码验证码"
+        else:
+            return "您的验证码"
+
+    async def send_verification_email(
+        self, to_address, verification_code, email_type, username="用户"
+    ):
+        """
+        description:
+            发送验证邮件
+        parameters:
+            to_address(str): 收件人邮箱地址
+            email_type(str): 邮件类型
+            username(str): 用户名
+        return:
+            dict: 发送结果
+        """
+        assert email_type in [
+            "register",
+            "forgot",
+        ], "邮件类型错误，当前只有register和forgot两种类型"
+        try:
+            response = await self.client.single_send_mail_with_options_async(
+                dm_20151123_models.SingleSendMailRequest(
+                    account_name="captcha_new@captcha.pixelarrayai.com",
+                    address_type=1,
+                    to_address=to_address,
+                    subject=self.get_email_subject(email_type),
+                    html_body=self.create_verification_email_content(
+                        username=username,
+                        verification_code=verification_code,
+                        email_type=email_type,
+                    ),
+                    reply_to_address=False,
+                    from_alias="系统验证",  # 发信人昵称
+                ),
+                util_models.RuntimeOptions(),
+            )
+            if response.status_code == 200:
+                return True
+            else:
+                print(f"发送验证邮件失败: {response}")
+                return False
+
+        except Exception as e:
+            print(traceback.format_exc())
             return False

{pixelarraylib-1.0.7 → pixelarraylib-1.0.9}/pixelarraylib/aliyun/billing.py

@@ -244,7 +244,7 @@ class BillingUtils:
             return formatted_response
 
         except Exception as e:
-            feishu_alert.send(traceback.format_exc())
+            print(traceback.format_exc())
             error_response = {
                 "Message": add_comment(f"Format error: {str(e)}", "Message"),
                 "RequestId": add_comment(
@@ -326,7 +326,7 @@ class BillingUtils:
             return formatted_response
 
         except Exception as error:
-            feishu_alert.send(traceback.format_exc())
+            print(traceback.format_exc())
             error_msg = getattr(error, "message", str(error))
             # 诊断地址
             diagnose_url = ""
@@ -473,5 +473,5 @@ class BillingUtils:
             return output_path
 
         except Exception as e:
-            feishu_alert.send(traceback.format_exc())
+            print(traceback.format_exc())
             raise Exception(f"保存账单数据失败: {str(e)}")