python3-openEuler 0.0.1__tar.gz → 0.0.3__tar.gz

{python3_openeuler-0.0.1 → python3_openeuler-0.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python3-openEuler
-Version: 0.0.1
+Version: 0.0.3
 Summary: used to get and deal information about openEuler os
 Home-page: https://gitee.com/devops_dev/openEuler
 Author: redrose2100

python3_openeuler-0.0.3/openEuler/__init__.py

@@ -0,0 +1,74 @@
+from openEuler.openEuler import OpenEuler
+import logging
+from typing import Optional, Union
+
+# 初始化包专属日志器（名称与包绑定，避免冲突）
+logger = logging.getLogger(__name__)
+
+# 核心：设置默认日志级别为 INFO（全局生效）
+DEFAULT_LOG_LEVEL = logging.INFO
+logger.setLevel(DEFAULT_LOG_LEVEL)
+
+# 禁止日志向上传播（避免干扰用户根日志器）
+logger.propagate = False
+
+# 定义默认日志格式（包含关键上下文信息）
+DEFAULT_FORMATTER = logging.Formatter(
+    fmt="[%(asctime)s] [%(name)s] [%(levelname)s] %(message)s",
+    datefmt="%Y-%m-%d %H:%M:%S"
+)
+
+def _add_default_handler(level: int = DEFAULT_LOG_LEVEL):
+    """
+    为日志器添加默认控制台Handler（仅在无Handler时添加，避免重复输出）
+
+    Args:
+        level: Handler的日志级别（默认与logger级别一致）
+    """
+    if not logger.handlers:
+        # 输出到stdout（而非stderr，避免与错误信息混淆）
+        console_handler = logging.StreamHandler()
+        console_handler.setLevel(level)  # Handler级别可独立控制
+        console_handler.setFormatter(DEFAULT_FORMATTER)
+        logger.addHandler(console_handler)
+
+
+def get_logger(
+        custom_formatter: Optional[logging.Formatter] = None,
+        level: Optional[Union[int, str]] = None
+) -> logging.Logger:
+    """
+    获取包的日志器，支持自定义格式和级别
+
+    Args:
+        custom_formatter: 自定义日志格式（如不指定则使用默认格式）
+        level: 日志级别（可选，如 logging.DEBUG 或 "DEBUG"，优先级高于默认）
+
+    Returns:
+        配置好的日志器实例
+    """
+    # 确保默认Handler存在（首次调用时初始化）
+    _add_default_handler()
+
+    # 动态调整日志级别（支持字符串级别，如 "DEBUG"，更友好）
+    if level is not None:
+        # 若传入字符串级别（如 "DEBUG"），转换为logging常量
+        if isinstance(level, str):
+            level = logging.getLevelName(level.upper())
+        logger.setLevel(level)
+        # 同步调整所有Handler的级别（避免Handler级别低于logger导致的日志丢失）
+        for handler in logger.handlers:
+            handler.setLevel(level)
+
+    # 应用用户自定义格式
+    if custom_formatter:
+        for handler in logger.handlers:
+            handler.setFormatter(custom_formatter)
+
+    return logger
+
+
+# 初始化时触发一次默认Handler添加（确保用户首次使用日志即有输出）
+_add_default_handler()
+
+__all__ = ["OpenEuler", "get_logger"]

python3_openeuler-0.0.3/openEuler/openEuler.py

@@ -0,0 +1,270 @@
+import re
+import logging
+import requests
+from bs4 import BeautifulSoup
+import traceback
+import functools
+import inspect
+from typing import Callable, Any
+from typing import List, Dict, Any, Optional
+
+import requests.exceptions
+from typing import Generator, Optional,Tuple
+
+log=logging.getLogger(__name__)
+
+def enter_and_leave_function(func: Callable) -> Callable:
+    """
+    函数调用日志装饰器：
+    1. 记录函数入参、调用位置
+    2. 正常执行时记录返回值
+    3. 异常时记录完整堆栈（含函数内具体报错行数）
+    """
+
+    @functools.wraps(func)  # 保留原函数元信息（如 __name__、__doc__）
+    def wrapper(*args: Any, **kwargs: Any) -> Any:
+        # 获取函数定义的文件路径和行号（基础位置信息）
+        func_def_file = inspect.getsourcefile(func) or "unknown_file"
+        func_def_file = func_def_file.split("/")[-1]
+        func_def_line = inspect.getsourcelines(func)[1] if func_def_file != "unknown_file" else "unknown_line"
+        log.info(
+            f"[{func_def_file}: {func_def_line}]"
+            f"[{func.__name__}()]"
+            f"| args={args}, kwargs={kwargs}"
+        )
+
+        try:
+            result = func(*args, **kwargs)
+            log.info(
+                f"[{func_def_file}: {func_def_line}]"
+                f" finish run function {func.__name__}(), return value is: {result} "
+            )
+            return result
+
+        except Exception as e:
+            error_traceback = traceback.format_exc()
+
+            log.error(
+                f"[{func_def_file}: {func_def_line}]"
+                f"failed to run function {func.__name__}() :Failed. "
+                f"| error_type：{type(e).__name__} "
+                f"| error_message：{str(e)} "
+                f"| full_stack_trace：\n{error_traceback}",
+                exc_info=False  # 已手动捕获堆栈，避免 logging 重复打印
+            )
+            raise  # 重新抛出异常，不中断原异常链路
+
+    return wrapper
+
+class Gitee():
+    def __init__(self):
+        self.__base_url= "https://gitee.com/api/v5"
+        self.__access_token="aa6cb32539129acf5605793f91a1588c"
+
+    def get_branches_list_by_repo(self,repo_name,owner_name):
+        """
+        获取仓库的所有分支
+        :param repo_name: 仓库名称
+        :param owner_name: 仓库所属空间地址(企业、组织或个人的地址
+        :return:
+        """
+        url = f"{self.__base_url}/repos/{owner_name}/{repo_name}/branches"
+        page=1
+        parameters={
+            "access_token":self.__access_token,
+            "repo":repo_name,
+            "owner":owner_name,
+            "sort":"name",
+            "direction":"asc",
+            "page":page,
+            "per_page":10
+        }
+        headers={
+            "Content-Type":"application/json",
+            "Accept":"application/json",
+            "User-Agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.90 Safari/537.36"
+        }
+        branches=[]
+        while True:
+            response=requests.get(url,params=parameters,headers=headers)
+            if response.status_code==200:
+                data=response.json()
+                for branch in data:
+                    branches.append(branch["name"])
+                page+=1
+                parameters["page"]=page
+                if len(data)==0:
+                    return branches
+            else:
+                log.error(f"request url is {url}, parameters is {parameters},headers is {headers} failed, response status code is {response.status_code}")
+                return branches
+
+    def get_repo_name_and_repo_html_url_by_org(self,org_name):
+        log.info(f"begin to get openEuler repo names and repo html urls by org {org_name}...")
+        url = f"{self.__base_url}/orgs/{org_name}/repos"
+        page=1
+        parameters={
+            "access_token":"aa6cb32539129acf5605793f91a1588c",
+            "org":org_name,
+            "page":page,
+            "per_page":10,
+            "type":"all"
+        }
+        headers={
+            "Content-Type":"application/json",
+            "Accept":"application/json",
+            "User-Agent":"Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/89.0.4389.90 Safari/537.36"
+        }
+        page=1
+        log.info(f"begin to request url is {url}, parameters is {parameters},headers is {headers}...")
+        while True:
+            response=requests.get(url,params=parameters,headers=headers)
+            if response.status_code==200:
+                data=response.json()
+                for repo in data:
+                    yield repo["name"],repo["html_url"]
+                page+=1
+                parameters["page"]=page
+                if len(data)==0:
+                    break
+            else:
+                log.error(f"request url is {url}, parameters is {parameters},headers is {headers} failed, response status code is {response.status_code}")
+                break
+
+class OpenEuler():
+    def __init__(self):
+        pass
+
+    def get_openEuler_repo_names_and_urls(
+            self,
+            os_version: str
+    ) -> Generator[Tuple[str, str], None, None]:
+        """
+        从 Gitee 的 src-openEuler 组织中筛选出包含指定 openEuler 版本分支的仓库信息。
+
+        函数通过调用 Gitee 相关接口，遍历 src-openEuler 组织下的所有仓库，
+        检查仓库是否存在与目标 openEuler 版本匹配的分支，若存在则返回该仓库的名称和 HTML 地址。
+
+        Args:
+            os_version: 目标 openEuler 版本号（如 "24.03-LTS-SP2"），用于匹配仓库分支
+
+        Yields:
+            Generator[Tuple[str, str], None, None]:
+                迭代返回符合条件的仓库信息元组：
+                - 第一个元素：仓库名称（如 "kernel"）
+                - 第二个元素：仓库的 HTML 访问地址（如 "https://gitee.com/src-openEuler/kernel"）
+
+        Notes:
+            依赖 Gitee 类的以下方法：
+            - get_repo_name_and_repo_html_url_by_org(org_name: str): 用于获取指定组织下所有仓库的名称和 HTML 地址
+            - get_branches_list_by_repo(repo_name: str, org_name: str): 用于获取指定仓库的所有分支名称列表
+        """
+        # 初始化 Gitee 接口操作实例
+        log.info("正在初始化 Gitee 接口操作实例...")
+        gitee = Gitee()
+
+        # 遍历 src-openEuler 组织下的所有仓库（名称 + HTML 地址）
+        for repo_name, repo_url in gitee.get_repo_name_and_repo_html_url_by_org("src-openEuler"):
+            log.info(f"正在检查仓库: {repo_name}，地址: {repo_url}")
+
+            # 获取当前仓库的所有分支列表
+            branches = gitee.get_branches_list_by_repo(repo_name, "src-openEuler")
+            # 处理无分支的异常情况
+            if not branches:
+                log.warning(f"仓库 {repo_name}（{repo_url}）未发现任何分支，已跳过")
+                continue
+
+            # 检查目标版本分支是否存在，存在则返回该仓库信息
+            branch = f"openEuler-{os_version}"
+            if branch in branches:
+                log.info(f"仓库 {repo_name}（{repo_url}）已找到目标版本分支 {branch}")
+                yield repo_name, repo_url
+
+    def get_openEuler_everything_pkgs(
+            self, os_version: str, os_arch: str
+    ) -> Generator[str, None, None]:
+        """
+        从 openEuler everything 源页面迭代        以迭代方式返回指定版本、架构的所有 RPM 包完整名称。
+
+        Args:
+            os_version: openEuler 版本号（如 "24.03-LTS-SP2"）
+            os_arch: 系统架构（如 "x86_64", "aarch64"）
+
+        Yields:
+            str: RPM 包完整名称（如 "zvbi-devel-0.2.44-1.oe2403sp2.x86_64.rpm"）
+
+        Raises:
+            RuntimeError: 网络请求失败（如超时、404、500 等）
+            ValueError: 页面解析失败（未找到任何 .rpm 包）
+        """
+        base_url_template = "https://dl-cdn.openeuler.openatom.cn/openEuler-{os_version}/everything/{os_arch}/Packages/"
+        timeout = 15
+        headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+            "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"
+        }
+
+        target_url = base_url_template.format(os_version=os_version, os_arch=os_arch)
+
+        try:
+            with requests.Session() as session:
+                session.mount('https://', requests.adapters.HTTPAdapter(
+                    pool_connections=10,
+                    pool_maxsize=10,
+                    max_retries=3
+                ))
+                response = session.get(
+                    url=target_url,
+                    headers=headers,
+                    timeout=timeout,
+                    allow_redirects=True
+                )
+                response.raise_for_status()
+                html_content = response.text
+
+        except requests.exceptions.RequestException as e:
+            raise RuntimeError(f"获取页面失败！URL: {target_url}, 错误: {str(e)}") from e
+
+        soup = BeautifulSoup(html_content, "html.parser")
+        # 精确匹配.rpm链接，排除父目录和空链接
+        pkg_links = soup.find_all(
+            "a",
+            href=lambda href: isinstance(href, str) and href.endswith(".rpm") and not href.startswith('../')
+        )
+
+        if not pkg_links:
+            raise ValueError(f"页面解析失败！URL: {target_url}, 未找到任何 .rpm 包")
+
+        for link in pkg_links:
+            full_pkg_name = link.get("href", "").strip()
+            if full_pkg_name:  # 过滤空字符串
+                yield full_pkg_name
+
+
+
+if __name__ == "__main__":
+    # 初始化获取器
+    # oe = OpenEuler()
+    # log.info("正在初始化 Gitee 模块...")
+    # repos_generator = oe.get_openEuler_repo_names_and_urls(
+    #     os_version="24.03-LTS-SP2"
+    # )
+    # log.info("正在获取 openEuler 24.03-LTS-SP2 x86_64 架构的仓库信息...")
+    # count=0
+    # for repo_name, repo_url in repos_generator:
+    #     log.info(f"正在处理仓库: {repo_name}，地址: {repo_url}")
+    #     count+=1
+    #     print(f"{repo_name}：{repo_url}")
+    # log.info("共获取到 %d 个仓库" % count)
+    # 示例：获取 openEuler 24.03-LTS-SP2 x86_64 架构的所有包（迭代打印前 10 个）
+    # pkg_generator = oe.get_openEuler_everything_pkgs(
+    #     os_version="24.03-LTS-SP1",
+    #     os_arch="x86_64"
+    # )
+    # count=0
+    # for name in pkg_generator:
+    #     count+=1
+    #     print(f"{name}")
+    # print("共获取到 %d 个软件包" % count)
+    pass
+

{python3_openeuler-0.0.1 → python3_openeuler-0.0.3}/python3_openEuler.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: python3-openEuler
-Version: 0.0.1
+Version: 0.0.3
 Summary: used to get and deal information about openEuler os
 Home-page: https://gitee.com/devops_dev/openEuler
 Author: redrose2100

{python3_openeuler-0.0.1 → python3_openeuler-0.0.3}/setup.py

@@ -10,7 +10,7 @@ except:
 
 setup(
     name="python3-openEuler",
-    version="0.0.1",
+    version="0.0.3",
     description="used to get and deal information about openEuler os",
     long_description=long_desc,
     long_description_content_type="text/markdown",

python3_openeuler-0.0.1/openEuler/__init__.py

@@ -1 +0,0 @@
-from openEuler.openEuler import OpenEuler

python3_openeuler-0.0.1/openEuler/openEuler.py

@@ -1,85 +0,0 @@
-import requests
-from bs4 import BeautifulSoup
-from log import log
-from typing import Generator, Optional
-
-class OpenEuler():
-    def __init__(self):
-        pass
-
-    def get_openEuler_everything_pkgs(
-            self, os_version: str, os_arch: str
-    ) -> Generator[str, None, None]:
-        """
-        从 openEuler everything 源页面获取指定版本、架构的所有软件包列表，以迭代方式返回。
-
-        Args:
-            os_version: openEuler 版本号（如 "24.03-LTS-SP2"）
-            os_arch: 系统架构（如 "x86_64", "aarch64"）
-
-        Yields:
-            str: 软件包名称（如 "a2ps-4.14-36.oe2403.x86_64.rpm"）
-
-        Raises:
-            requests.exceptions.RequestException: 网络请求失败（如超时、404、500 等）
-            ValueError: 页面解析失败（未找到任何 .rpm 包）
-        """
-        # 基础 URL 模板（openEuler everything 源固定路径）
-        base_url_template = "https://dl-cdn.openeuler.openatom.cn/openEuler-{os_version}/everything/{os_arch}/Packages/"
-        # 请求超时时间（避免长期阻塞）
-        timeout = 15
-        # 请求头（模拟浏览器，避免部分服务器拦截）
-        headers = {
-            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
-        }
-        # 1. 构造目标页面 URL
-        target_url = base_url_template.format(
-            os_version=os_version, os_arch=os_arch
-        )
-        try:
-            # 2. 发送 GET 请求获取页面内容（允许重定向，部分 CDN 可能跳转）
-            response = requests.get(
-                url=target_url,
-                headers=headers,
-                timeout=timeout,
-                allow_redirects=True
-            )
-            # 检查响应状态码（非 200 视为请求失败）
-            response.raise_for_status()
-            html_content = response.text
-
-        except requests.exceptions.RequestException as e:
-            raise RuntimeError(
-                f"获取页面失败！URL: {target_url}, 错误: {str(e)}"
-            ) from e
-
-        # 3. 解析 HTML 提取 .rpm 包链接
-        soup = BeautifulSoup(html_content, "html.parser")  # 使用标准 HTML 解析器（无需额外依赖）
-        # 页面中软件包以 <a> 标签存在，href 属性为包名，且文本与 href 一致
-        pkg_links = soup.find_all("a", href=lambda href: href and href.endswith(".rpm"))
-
-        if not pkg_links:
-            raise ValueError(
-                f"页面解析失败！URL: {target_url}, 未找到任何 .rpm 格式的软件包"
-            )
-
-        # 4. 迭代返回软件包名称（通过 yield 实现生成器）
-        for link in pkg_links:
-            pkg_name = link.get("href")  # 从 href 属性获取包名（避免文本空格问题）
-            if pkg_name:  # 双重校验（防止空链接）
-                yield pkg_name
-
-if __name__ == "__main__":
-    # 初始化获取器
-    oe = OpenEuler()
-    # 示例：获取 openEuler 24.03-LTS-SP2 x86_64 架构的所有包（迭代打印前 10 个）
-    pkg_generator = oe.get_openEuler_everything_pkgs(
-        os_version="24.03-LTS-SP2",
-        os_arch="x86_64"
-    )
-    count=0
-    for pkg in pkg_generator:
-        count+=1
-        print(pkg)
-    print("共获取到 %d 个软件包" % count)
-