easy-use-tools 1.0.1__tar.gz

easy_use_tools-1.0.1/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2021 The Python Packaging Authority
+
+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.

easy_use_tools-1.0.1/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: easy_use_tools
+Version: 1.0.1
+Summary: An easy use tools package
+Home-page: https://github.com/XXX
+Author: yuanyang.li
+Author-email: yuanyang.edison.li@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.1
+Requires-Dist: numpy>=1.19.5
+Requires-Dist: shortuuid
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 通用工具集
+这是一个通用工具集, 适用于>=Python3.8
+
+## 1. 准备
+### 1.1 安装依赖
+```
+pip3 install --upgrade packaging setuptools wheel twine
+```
+
+## 2. 命令说明
+### 2.1 本地安装使用
+```
+python setup.py install
+```
+### 2.2 打包
+```
+python setup.py sdist bdist_wheel
+```
+在当前dist目录下的两个文件是要上传到 PyPi 网站上供别人下载安装的（*.tar.gz、*.whl）
+
+### 2.3 配置文件检查
+```
+python3 setup.py check
+```
+
+### 2.4 上传前检查
+```
+twine check dist/*
+```
+### 2.4 执行上传
+```
+twine upload dist/*
+```
+### 2.5 清理
+```
+rm -rf build/ dist/ *.egg-info/
+```

easy_use_tools-1.0.1/README.md

@@ -0,0 +1,37 @@
+# 通用工具集
+这是一个通用工具集, 适用于>=Python3.8
+
+## 1. 准备
+### 1.1 安装依赖
+```
+pip3 install --upgrade packaging setuptools wheel twine
+```
+
+## 2. 命令说明
+### 2.1 本地安装使用
+```
+python setup.py install
+```
+### 2.2 打包
+```
+python setup.py sdist bdist_wheel
+```
+在当前dist目录下的两个文件是要上传到 PyPi 网站上供别人下载安装的（*.tar.gz、*.whl）
+
+### 2.3 配置文件检查
+```
+python3 setup.py check
+```
+
+### 2.4 上传前检查
+```
+twine check dist/*
+```
+### 2.4 执行上传
+```
+twine upload dist/*
+```
+### 2.5 清理
+```
+rm -rf build/ dist/ *.egg-info/
+```

easy_use_tools-1.0.1/easy_use_tools/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

easy_use_tools-1.0.1/easy_use_tools/core/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

easy_use_tools-1.0.1/easy_use_tools/manage.py

@@ -0,0 +1,3 @@
+# coding=utf-8
+def run():
+    print("This is manage run entry")

easy_use_tools-1.0.1/easy_use_tools/utils/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

easy_use_tools-1.0.1/easy_use_tools/utils/common.py

@@ -0,0 +1,80 @@
+# coding=utf-8
+import datetime
+import hashlib
+import os
+import sys
+import logging
+import better_exceptions
+import pyautogui
+
+RECURSIVE_CREATE_DIR = lambda dp: os.makedirs(dp) or dp if not os.path.exists(dp) else dp  # ---> mkdir -p
+
+def get_current_time():
+    return datetime.datetime.now().strftime('%Y-%m-%d_%H_%M_%S')
+
+def better_show_exception(print_type="print"):
+    """
+        详细打印异常的堆栈信息
+
+    """
+    e_type, value, e_traceback = sys.exc_info()
+    msg = ''
+    rst = better_exceptions.format_exception(e_type, value, e_traceback)
+    for i in rst:
+        msg += i
+        msg += '\n'
+    if print_type == "print":
+        print(msg)
+    else:
+        logging.error(msg)
+
+
+def human_duration(seconds: int) -> str:
+    """
+    将秒数自动转换成易读字符串
+    支持的最大单位是 year，可根据需要扩展
+    """
+    if seconds == 0:
+        return "0s"
+
+    # 定义时间单位与秒数的映射（从大到小）
+    units = [
+        ("year", 365 * 24 * 3600),
+        ("day", 24 * 3600),
+        ("h", 3600),
+        ("m", 60),
+        ("s", 1)
+    ]
+
+    parts = []
+    remainder = abs(seconds)
+    for name, count in units:
+        if remainder >= count:
+            num = remainder // count
+            parts.append(f"{num}{name}")
+            remainder -= num * count
+
+    # 拼接并保留符号
+    sign = "-" if seconds < 0 else ""
+    return sign + " ".join(parts)
+
+def take_screenshot(f_path):
+    """
+    截图并保存为文件
+    """
+    screenshot = pyautogui.screenshot()
+    rst = screenshot.save(f_path)
+    return rst
+
+def calculate_string_md5(input_string):
+    """
+    description: 计算字符串的md5值
+    :param input_string:md5
+    :return:  eg: 098F6BCD4621D373CADE4E832627B4F6
+
+    """
+    md5 = hashlib.md5()
+    b = input_string.encode(encoding='utf-8')
+    md5.update(b)
+    str_md5 = md5.hexdigest()
+    return str_md5

easy_use_tools-1.0.1/easy_use_tools/utils/linux/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

easy_use_tools-1.0.1/easy_use_tools/utils/log.py

@@ -0,0 +1,179 @@
+# coding=utf-8
+# -*- coding: utf-8 -*-
+# logger
+import logging
+import logging.config
+import os
+import platform
+import sys
+
+
+class Logger:
+    if sys.platform.startswith('win'):
+        all_log_dir_path = r"D:\log_dir"  # 所有日志存储目录路径
+    elif sys.platform.startswith('linux'):
+        all_log_dir_path = "/var/log/log_dir"  # 所有日志存储目录路径
+
+    def __init__(self,log_name="default"):
+        """
+            Logger初始化
+        """
+        self.log_name = log_name or "default"
+        self.current_logger_dir_path = os.path.join(Logger.all_log_dir_path, self.log_name)  # 当前logger的目录路径
+        self.root_logger_dir_path = os.path.join(Logger.all_log_dir_path,'root')
+        os.makedirs(self.current_logger_dir_path, exist_ok=True)
+        os.makedirs(self.root_logger_dir_path, exist_ok=True)
+        logging.config.dictConfig(self.get_log_setting())  # load 配置文件
+        self.logger = logging.getLogger(log_name)
+
+    def logger_check(self):
+        # ---- 新增以下检查代码 ----
+        print(f"当前 logger 名称: {self.logger.name}")
+        if self.logger.handlers:
+            print("这个 logger 已配置的处理器 (Handlers):")
+            for handler in self.logger.handlers:
+                print(f"  - Handler 类型: {type(handler).__name__}")
+                if hasattr(handler, 'formatter') and handler.formatter:
+                    print(f"    使用的格式器: {handler.formatter._fmt}")
+        else:
+            print("警告：这个 logger 没有找到任何处理器，可能正在使用上级 logger 的配置!")
+        # ---- 检查代码结束 ----
+
+    def debug(self, message):
+        self.logger.debug(message)
+
+    def info(self, message):
+        self.logger.info(message)
+
+    def warn(self, message):
+        self.logger.warning(message)
+
+    def error(self, message):
+        self.logger.error(message)
+
+    def cri(self, message):
+        self.logger.critical(message)
+
+    def get_log_setting(self):
+        setting_map = {
+            'version': 1,  # 保留字
+            'disable_existing_loggers': False,  # 禁用已经存在的logger实例,也就是如果为true且有两个logger只会保留最后一个
+            # 过滤器
+            'filters': {},
+            # 日志文件的格式
+            'formatters': {
+                # 详细的日志格式
+                'standard': {
+                    'format': "[%(asctime)s][%(levelname)s][%(threadName)s:%(thread)d][logger_id:%(name)s][%(filename)s:%(lineno)d] %(message)s"
+                },
+                # 简单的日志格式
+                'simple': {
+                    'format': '[%(asctime)s][%(levelname)s][%(filename)s:%(lineno)d] %(message)s'
+                },
+                # 定义一个特殊的日志格式
+                'specific': {
+                    'format': '[%(asctime)s][%(levelname)s][%(message)s]'
+                }
+            },
+
+            # 处理器
+            'handlers': {
+
+                # logger的handlers
+                # 终端
+                'console': {
+                    'level': 'INFO',
+                    'class': 'logging.StreamHandler',
+                    'formatter': 'standard'
+                },
+                # INFO
+                'info': {
+                    'level': 'INFO',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.current_logger_dir_path,
+                                             "{}_INFO.log".format(self.log_name)),
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,  # 最多备份几个
+                    'formatter': 'standard',
+                    'encoding': 'utf-8',
+                },
+                # ERROR
+                'error': {
+                    'level': 'ERROR',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.current_logger_dir_path,
+                                             "{}_ERROR.log".format(self.log_name)),
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,
+                    'formatter': 'standard',
+                    'encoding': 'utf-8',
+                },
+                # DEBUG
+                'debug': {
+                    'level': 'DEBUG',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.current_logger_dir_path,
+                                             "{}_DEBUG.log".format(self.log_name)),
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,
+                    'formatter': 'standard',
+                    'encoding': "utf-8"
+                },
+
+                # root handlers
+                # root-终端
+                'root_console': {
+                    'level': 'INFO',
+                    'class': 'logging.StreamHandler',
+                    'formatter': 'standard'
+                },
+                # root-INFO
+                'root_info': {
+                    'level': 'INFO',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.root_logger_dir_path,"ROOT_INFO.log"),
+
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,  # 最多备份几个
+                    'formatter': 'standard',
+                    'encoding': 'utf-8',
+                },
+                # root-ERROR
+                'root_error': {
+                    'level': 'ERROR',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.root_logger_dir_path,"ROOT_ERROR.log"),
+
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,
+                    'formatter': 'standard',
+                    'encoding': 'utf-8',
+                },
+                # root-DEBUG
+                'root_debug': {
+                    'level': 'DEBUG',
+                    'class': 'logging.handlers.RotatingFileHandler',  # 保存到文件，自动切
+                    'filename': os.path.join(self.root_logger_dir_path,"ROOT_DEBUG.log"),
+                    'maxBytes': 1024 * 1024 * 50,  # 日志大小 50M
+                    'backupCount': 5,
+                    'formatter': 'standard',
+                    'encoding': "utf-8"
+                }
+            },
+            'loggers': {
+                # 默认的logger应用如下配置
+                self.log_name: {
+                    'handlers': ['console', 'info', 'error', 'debug'],
+                    'level': 'DEBUG',
+                    'propagate': True,  # 向不向更高级别的logger传递,也就是所有logger会向根日志器传递
+                },
+
+            },
+            # 新增对根日志器的配置
+            'root': {
+                'level': 'INFO',    # 设置根日志器级别为INFO或更低
+                'handlers': ['root_console', 'root_info', 'root_error', 'root_debug'],  # 为根日志器添加处理器，例如控制台处理器
+            }
+        }
+        return setting_map
+

easy_use_tools-1.0.1/easy_use_tools/utils/windows/__init__.py

@@ -0,0 +1 @@
+# coding=utf-8

easy_use_tools-1.0.1/easy_use_tools.egg-info/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: easy_use_tools
+Version: 1.0.1
+Summary: An easy use tools package
+Home-page: https://github.com/XXX
+Author: yuanyang.li
+Author-email: yuanyang.edison.li@gmail.com
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.1
+Requires-Dist: numpy>=1.19.5
+Requires-Dist: shortuuid
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 通用工具集
+这是一个通用工具集, 适用于>=Python3.8
+
+## 1. 准备
+### 1.1 安装依赖
+```
+pip3 install --upgrade packaging setuptools wheel twine
+```
+
+## 2. 命令说明
+### 2.1 本地安装使用
+```
+python setup.py install
+```
+### 2.2 打包
+```
+python setup.py sdist bdist_wheel
+```
+在当前dist目录下的两个文件是要上传到 PyPi 网站上供别人下载安装的（*.tar.gz、*.whl）
+
+### 2.3 配置文件检查
+```
+python3 setup.py check
+```
+
+### 2.4 上传前检查
+```
+twine check dist/*
+```
+### 2.4 执行上传
+```
+twine upload dist/*
+```
+### 2.5 清理
+```
+rm -rf build/ dist/ *.egg-info/
+```

easy_use_tools-1.0.1/easy_use_tools.egg-info/SOURCES.txt

@@ -0,0 +1,17 @@
+LICENSE
+README.md
+setup.py
+easy_use_tools/__init__.py
+easy_use_tools/manage.py
+easy_use_tools.egg-info/PKG-INFO
+easy_use_tools.egg-info/SOURCES.txt
+easy_use_tools.egg-info/dependency_links.txt
+easy_use_tools.egg-info/entry_points.txt
+easy_use_tools.egg-info/requires.txt
+easy_use_tools.egg-info/top_level.txt
+easy_use_tools/core/__init__.py
+easy_use_tools/utils/__init__.py
+easy_use_tools/utils/common.py
+easy_use_tools/utils/log.py
+easy_use_tools/utils/linux/__init__.py
+easy_use_tools/utils/windows/__init__.py

easy_use_tools-1.0.1/easy_use_tools.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

easy_use_tools-1.0.1/easy_use_tools.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+show_info = easy_use_tools.manage:run

easy_use_tools-1.0.1/easy_use_tools.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests>=2.25.1
+numpy>=1.19.5
+shortuuid

easy_use_tools-1.0.1/easy_use_tools.egg-info/top_level.txt

@@ -0,0 +1 @@
+easy_use_tools

easy_use_tools-1.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

easy_use_tools-1.0.1/setup.py

@@ -0,0 +1,79 @@
+# coding=utf-8
+import setuptools  # 导入setuptools打包工具
+from pathlib import Path
+
+def parse_requirements(filename):
+    """使用 packaging 包安全地解析 requirements.txt"""
+    try:
+        from packaging.requirements import Requirement
+    except ImportError:
+        # 回退方案：如果packaging不可用，尝试简单处理
+        return simple_parse_requirements(filename)
+
+    requirements = []
+    file_path = Path(filename)
+
+    if not file_path.exists():
+        return requirements
+
+    with open(file_path, 'r', encoding='utf-8') as f:
+        for line in f:
+            line = line.strip()
+            # 跳过空行和注释
+            if not line or line.startswith('#'):
+                continue
+            try:
+                # 使用packaging验证并规范化需求字符串
+                req = Requirement(line)
+                requirements.append(str(req))
+            except Exception:
+                # 如果解析失败，回退到原始行
+                requirements.append(line)
+
+    return requirements
+
+
+def simple_parse_requirements(filename):
+    """简化的解析器，作为回退方案"""
+    file_path = Path(filename)
+    if not file_path.exists():
+        return []
+
+    with open(file_path, 'r', encoding='utf-8') as f:
+        return [
+            line.strip() for line in f
+            if line.strip() and not line.startswith('#')
+        ]
+
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setuptools.setup(
+    name="easy_use_tools",  # 用自己的名替换其中的YOUR_USERNAME_
+    version="1.0.1",  # 包版本号，便于维护版本,保证每次发布都是版本都是唯一的
+    author="yuanyang.li",  # 作者，可以写自己的姓名
+    author_email="yuanyang.edison.li@gmail.com",  # 作者联系方式，可写自己的邮箱地址
+    description="An easy use tools package",  # 包的简述
+    long_description=long_description,  # 包的详细介绍，一般在README.md文件内
+    long_description_content_type="text/markdown",
+    url="https://github.com/XXX",  # 自己项目地址，比如github的项目地址
+    license_files=['LICENSE'],
+    packages=setuptools.find_packages(),
+    # 依赖管理
+    install_requires=parse_requirements('requirements'),
+    # install_requires=[  # 项目运行所依赖的第三方包列表
+    #     "requests >= 2.25.1",  # 可以指定版本
+    #     "shortuuid",  # 也可以不指定版本，但建议指定
+    #     "PyYAML >= 5.4.1",
+    #     # 注意：通常不推荐使用"pandas"这样宽泛的声明，最好指明最低版本
+    # ],
+    entry_points={
+        "console_scripts" : ['show_info = easy_use_tools.manage:run']
+    }, #安装成功后，在命令行输入show_infot easy_use_tools.manage.py中的run了, 格式：'命令名=包.模块:函数'
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+    ],
+    python_requires='>=3.8',  # 对python的最低版本要求
+)