jit-utils-backend 0.0.1__tar.gz

jit-utils-backend-0.0.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include setup.py
+recursive-include jit_utils *.py
+recursive-exclude * __pycache__
+recursive-exclude * *.py[co]
+recursive-exclude * .DS_Store 

jit-utils-backend-0.0.1/PKG-INFO

@@ -0,0 +1,178 @@
+Metadata-Version: 2.1
+Name: jit-utils-backend
+Version: 0.0.1
+Summary: 极态后端工具包
+Author: zangtao
+Author-email: noguchisyou123456@gmail.com
+Project-URL: Documentation, https://github.com/zangtao/jit-utils-backend
+Project-URL: Source, https://github.com/zangtao/jit-utils-backend
+Project-URL: Tracker, https://github.com/zangtao/jit-utils-backend/issues
+Keywords: python,jit,sdk,apiAuth,utils,backend
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+
+# JIT Utils Backend
+
+极态后端工具包 - 一个为后端开发提供便利工具的 Python 包。
+
+## 安装
+
+```bash
+pip install jit-utils-backend
+```
+
+## 使用方法
+
+### 导入包
+
+```python
+# 导入整个包
+import jit_utils
+
+# 导入特定功能
+from jit_utils import now, randomString, Qrcode, Barcode
+
+# 导入特定模块
+from jit_utils import time_utils, string_utils
+```
+
+## 主要功能
+
+### 1. 时间处理工具
+
+```python
+from jit_utils import now, today, dayShift, formatNow
+
+# 获取当前时间
+current_time = now()
+
+# 获取今天的日期
+today_date = today()
+
+# 日期偏移
+tomorrow = dayShift(today_date, 1)
+
+# 格式化当前时间
+formatted_time = formatNow("%Y-%m-%d %H:%M:%S")
+```
+
+### 2. 字符串处理工具
+
+```python
+from jit_utils import randomString, md5Str, getUuidStr
+
+# 生成随机字符串
+random_str = randomString(8)
+
+# MD5 加密
+encrypted = md5Str("hello world")
+
+# 生成 UUID
+uuid_str = getUuidStr()
+```
+
+### 3. 二维码生成
+
+```python
+from jit_utils import Qrcode
+
+# 创建二维码
+qr = Qrcode("https://example.com")
+
+# 获取二维码图片的字节数据
+qr_bytes = qr.toByte()
+
+# 获取二维码的 base64 字符串
+qr_str = qr.toStr()
+```
+
+### 4. 条形码生成
+
+```python
+from jit_utils import Barcode
+
+# 创建条形码
+barcode = Barcode("123456789")
+
+# 获取条形码图片的字节数据
+barcode_bytes = barcode.toByte()
+
+# 获取条形码的 base64 字符串
+barcode_str = barcode.toStr()
+```
+
+### 5. 数据验证
+
+```python
+from jit_utils import ParamsValidator
+from dataclasses import dataclass
+
+@dataclass
+class UserParams(ParamsValidator):
+    name: str
+    age: int
+    email: str = ""
+
+# 验证参数
+params = UserParams("test_function", name="John", age=25)
+```
+
+### 6. 装饰器
+
+```python
+from jit_utils import forward
+
+@forward("module.submodule")
+def my_function():
+    pass
+```
+
+## 模块说明
+
+- **time_utils**: 时间处理相关工具
+- **string_utils**: 字符串处理相关工具
+- **qrcode**: 二维码生成工具
+- **barcode**: 条形码生成工具
+- **validator**: 数据验证工具
+- **network**: 网络相关工具
+- **signature**: 签名相关工具
+- **matchTool**: 匹配工具
+- **clsTool**: 类工具
+- **exceptions**: 异常处理
+- **workday_constants**: 工作日常量
+- **config**: 配置相关工具
+
+## 依赖包
+
+- requests
+- qrcode
+- python-barcode
+- Pillow
+- arrow
+- python-dateutil
+
+## 许可证
+
+MIT License
+
+## 作者
+
+zangtao (noguchisyou123456@gmail.com)
+
+## 版本
+
+0.0.1

jit-utils-backend-0.0.1/README.md

@@ -0,0 +1,151 @@
+# JIT Utils Backend
+
+极态后端工具包 - 一个为后端开发提供便利工具的 Python 包。
+
+## 安装
+
+```bash
+pip install jit-utils-backend
+```
+
+## 使用方法
+
+### 导入包
+
+```python
+# 导入整个包
+import jit_utils
+
+# 导入特定功能
+from jit_utils import now, randomString, Qrcode, Barcode
+
+# 导入特定模块
+from jit_utils import time_utils, string_utils
+```
+
+## 主要功能
+
+### 1. 时间处理工具
+
+```python
+from jit_utils import now, today, dayShift, formatNow
+
+# 获取当前时间
+current_time = now()
+
+# 获取今天的日期
+today_date = today()
+
+# 日期偏移
+tomorrow = dayShift(today_date, 1)
+
+# 格式化当前时间
+formatted_time = formatNow("%Y-%m-%d %H:%M:%S")
+```
+
+### 2. 字符串处理工具
+
+```python
+from jit_utils import randomString, md5Str, getUuidStr
+
+# 生成随机字符串
+random_str = randomString(8)
+
+# MD5 加密
+encrypted = md5Str("hello world")
+
+# 生成 UUID
+uuid_str = getUuidStr()
+```
+
+### 3. 二维码生成
+
+```python
+from jit_utils import Qrcode
+
+# 创建二维码
+qr = Qrcode("https://example.com")
+
+# 获取二维码图片的字节数据
+qr_bytes = qr.toByte()
+
+# 获取二维码的 base64 字符串
+qr_str = qr.toStr()
+```
+
+### 4. 条形码生成
+
+```python
+from jit_utils import Barcode
+
+# 创建条形码
+barcode = Barcode("123456789")
+
+# 获取条形码图片的字节数据
+barcode_bytes = barcode.toByte()
+
+# 获取条形码的 base64 字符串
+barcode_str = barcode.toStr()
+```
+
+### 5. 数据验证
+
+```python
+from jit_utils import ParamsValidator
+from dataclasses import dataclass
+
+@dataclass
+class UserParams(ParamsValidator):
+    name: str
+    age: int
+    email: str = ""
+
+# 验证参数
+params = UserParams("test_function", name="John", age=25)
+```
+
+### 6. 装饰器
+
+```python
+from jit_utils import forward
+
+@forward("module.submodule")
+def my_function():
+    pass
+```
+
+## 模块说明
+
+- **time_utils**: 时间处理相关工具
+- **string_utils**: 字符串处理相关工具
+- **qrcode**: 二维码生成工具
+- **barcode**: 条形码生成工具
+- **validator**: 数据验证工具
+- **network**: 网络相关工具
+- **signature**: 签名相关工具
+- **matchTool**: 匹配工具
+- **clsTool**: 类工具
+- **exceptions**: 异常处理
+- **workday_constants**: 工作日常量
+- **config**: 配置相关工具
+
+## 依赖包
+
+- requests
+- qrcode
+- python-barcode
+- Pillow
+- arrow
+- python-dateutil
+
+## 许可证
+
+MIT License
+
+## 作者
+
+zangtao (noguchisyou123456@gmail.com)
+
+## 版本
+
+0.0.1

jit-utils-backend-0.0.1/jit_utils/__init__.py

@@ -0,0 +1,152 @@
+# -*-coding:utf-8-*-
+"""
+JIT Utils Backend - 极态后端工具包
+
+A comprehensive utility package for backend development with JIT.
+
+主要功能:
+- 时间处理工具
+- 字符串处理工具
+- 二维码和条形码生成
+- 数据验证
+- 网络工具
+- 签名工具
+等等...
+"""
+
+__version__ = '0.0.1'
+__author__ = 'zangtao'
+
+# 导入主要的工具类和函数
+try:
+    from .decorator import forward
+except ImportError:
+    pass
+
+# 时间工具
+try:
+    from . import time as time_utils
+    # 导出一些常用的时间函数
+    from .time import (
+        now, today, get, dayShift,
+        monday, weekShift, monthStart, monthShift,
+        quarterStart, quarterShift, yearStart, yearShift,
+        getTimestamp, timeStampToDateTime, strToTimestamp,
+        formatNow, datetime2string, string2datetime
+    )
+except ImportError:
+    pass
+
+# 字符串工具
+try:
+    from . import string as string_utils
+    from .string import (
+        randomString, randomNum, getUuidStr,
+        md5Bytes, md5Str, getFileMd5,
+        renderTemplateString
+    )
+except ImportError:
+    pass
+
+# 二维码工具
+try:
+    from .qrcode import Qrcode
+except ImportError:
+    Qrcode = None
+
+# 条形码工具
+try:
+    from .barcode import Barcode
+except ImportError:
+    Barcode = None
+
+# 验证工具
+try:
+    from .validator import ParamsValidator
+except ImportError:
+    ParamsValidator = None
+
+# 网络工具
+try:
+    from . import network
+except ImportError:
+    pass
+
+# 签名工具
+try:
+    from . import signature
+except ImportError:
+    pass
+
+# 匹配工具
+try:
+    from . import matchTool
+except ImportError:
+    pass
+
+# 类工具
+try:
+    from . import clsTool
+except ImportError:
+    pass
+
+# 转换工具
+try:
+    from .convert import Converter, MemoryCompiler
+except ImportError:
+    # 如果导入失败，创建占位符避免 __all__ 报错
+    Converter = None
+    MemoryCompiler = None
+
+# 异常处理
+try:
+    from . import exceptions
+except ImportError:
+    pass
+
+# 工作日常量
+try:
+    from . import workday_constants
+except ImportError:
+    pass
+
+# 配置相关
+try:
+    from . import config
+except ImportError:
+    pass
+
+# 定义 __all__ 列表，控制 from jit_utils import * 的行为
+__all__ = [
+    # 版本信息
+    '__version__',
+    '__author__',
+    
+    # 装饰器
+    'forward',
+    
+    # 时间工具
+    'time_utils',
+    'now', 'today', 'get', 'dayShift',
+    'monday', 'weekShift', 'monthStart', 'monthShift',
+    'quarterStart', 'quarterShift', 'yearStart', 'yearShift',
+    'getTimestamp', 'timeStampToDateTime', 'strToTimestamp',
+    'formatNow', 'datetime2string', 'string2datetime',
+    
+    # 字符串工具
+    'string_utils',
+    'randomString', 'randomNum', 'getUuidStr',
+    'md5Bytes', 'md5Str', 'getFileMd5',
+    'renderTemplateString',
+    
+    # 二维码和条形码
+    'Qrcode', 'Barcode',
+    
+    # 验证工具
+    'ParamsValidator',
+    
+    # 其他模块
+    'network', 'signature', 'matchTool',
+    'clsTool', 'exceptions', 'workday_constants',
+    'config', 'Converter', 'MemoryCompiler'
+]

jit-utils-backend-0.0.1/jit_utils/apiAuthSign.py

@@ -0,0 +1,73 @@
+# -*-coding:utf-8-*-
+"""
+Created on 2024/11/09
+
+@author: 臧韬
+
+@desc: 默认描述
+"""
+
+import base64
+import hashlib
+import json
+import time
+
+from jit.commons.utils.logger import log
+
+
+class Sign(object):
+    """
+    这个签名算法用于认证服务和api授权元素
+    """
+
+    EXPIRE_TIME = 5 * 60 * 1000
+    # 签名返回的错误信息，如果是错误信息，返回空tuple，兼容原来通过bool方法校验签名是否通过的写法
+    TIME_OUT_ERROR = []
+    SIGN_CHECK_ERROR = []
+    SIGN_CHECK_SUCCESS = [0]
+
+    def __init__(self, secret):
+        self.secret = secret
+
+    def encode(self, args, timestamp, debug=False):
+        return self.getSign({**args, "timestamp": timestamp, "secret": self.secret}, debug=debug)
+
+    @staticmethod
+    def getSign(args, debug=False):
+        nArgs = {}
+        for k, v in args.items():
+            nArgs[k.lower()] = v
+        sortedKeys = sorted(nArgs.keys())
+        params = []
+        for key in sortedKeys:
+            value = nArgs[key]
+            if not isinstance(value, str):
+                value = json.dumps(value, sort_keys=True, separators=(",", ":"), ensure_ascii=False)
+            params.append(f"{key}={value}")
+        if debug:
+            # 隐藏secret
+            for idx, param in enumerate(params):
+                if param.split("=")[0] == "secret":
+                    params[idx] = "secret=*********************"
+
+            paramStr = "&".join(params)
+
+            apiAuthDebug = {
+                "paramStr": paramStr,
+            }
+            log.debug(",".join("{k}:{v}".format(k=k, v=v) for k, v in apiAuthDebug.items()))
+            if hasattr(app.request, "respExtraData"):
+                app.request.respExtraData["apiAuthDebug"] = apiAuthDebug
+        return hashlib.sha1(base64.b64encode("&".join(params).encode("utf-8"))).hexdigest()
+
+    def verify(self, args):
+        args = args.copy()
+        timestamp = args.pop("timestamp")
+        if abs(int(time.time() * 1000) - int(timestamp)) > self.EXPIRE_TIME:
+            return self.TIME_OUT_ERROR
+        signature = args.pop("accessSign")
+        debug = app.request.headers.get("debug") == "1"
+        if signature == self.encode(args, timestamp, debug=debug):
+            return self.SIGN_CHECK_SUCCESS
+        else:
+            return self.SIGN_CHECK_ERROR

jit-utils-backend-0.0.1/jit_utils/barcode.py

@@ -0,0 +1,50 @@
+# -*-coding:utf-8-*-
+"""
+Created on 2025/02/10
+
+@author: 臧韬
+
+@desc: 默认描述
+"""
+import base64
+import io
+
+import barcode
+from barcode.errors import BarcodeError
+from barcode.writer import ImageWriter
+
+
+class Barcode(object):
+    """
+    二维码模块，暂用于文件渲染
+    """
+
+    def __init__(self, value: str, codeType="code128"):
+        self.value = value
+        self.codeType = codeType
+
+    def toByte(self):
+        file = self.toFile()
+        data = file.read()
+        return data
+
+    def toFile(self):
+        obj = barcode.get(self.codeType, self.value, writer=ImageWriter())
+        # 保存条形码为图像文件
+        imageBuffer = io.BytesIO()
+        obj.write(fp=imageBuffer)
+        imageBuffer.seek(0)
+        return imageBuffer
+
+    def toStr(self):
+        if not self.value:
+            return ""
+        try:
+            b64Code = base64.b64encode(self.toByte()).decode("utf-8")
+        except BarcodeError as e:
+            return "ERROR:{}".format(str(e))
+
+        return "<image:{}>".format(b64Code)
+
+    def __str__(self):
+        return self.toStr()

jit-utils-backend-0.0.1/jit_utils/clsTool.py

@@ -0,0 +1,71 @@
+# -*-coding:utf-8-*-
+"""
+Created on 2024/09/29
+
+@author: 臧韬
+
+@desc: 因为框架打包不重启的时候会出现isinstance方法和issubclass函数出现问题，
+       所以重新实现这两个方法，通过类名来确定是否为子类，而不是通过对象ID。
+"""
+
+
+def issubclassByName(cls, class_or_tuple: type | tuple):
+    if isinstance(class_or_tuple, tuple):
+        for cls_name in class_or_tuple:
+            if issubclassByName(cls, cls_name):
+                return True
+        else:
+            return False
+
+    if not isinstance(cls, type):
+        raise TypeError("issubclassByName() arg 0 must be a class")
+
+    if not isinstance(class_or_tuple, type):
+        raise TypeError("isinstanceByName() arg 1 must be a class or tuple with class")
+
+    __className = class_or_tuple.__name__
+    if cls is type:
+        # 特殊情况
+        mroNames = [item.__name__ for item in type.mro(type)]
+    else:
+        mroNames = [item.__name__ for item in cls.mro()]
+    if __className in mroNames:
+        return True
+    else:
+        return False
+
+
+def isinstanceByName(obj, class_or_tuple: type | tuple):
+    if isinstance(class_or_tuple, tuple):
+        for cls_name in class_or_tuple:
+            if isinstanceByName(obj, cls_name):
+                return True
+        else:
+            return False
+
+    if not isinstance(obj, object):
+        raise TypeError("isinstanceByName() arg 0 must be an object")
+
+    if not isinstance(class_or_tuple, type):
+        raise TypeError("isinstanceByName() arg 1 must be a class or tuple with class")
+
+    cls = type(obj)
+    if cls.__name__ == class_or_tuple.__name__:
+        return True
+    return issubclassByName(cls, class_or_tuple)
+
+
+if __name__ == "__main__":
+    A = type("A", (object,), {})
+    B = type("B", (A,), {})
+
+    a = A()
+    b = B()
+
+    print("class B is subclass of A: ", issubclassByName(B, A))
+    print("object b is instance of A: ", isinstanceByName(b, A))
+    print("object b is instance of B: ", isinstanceByName(b, B))
+    print("object b is instance of B or A: ", isinstanceByName(b, (B, A)))
+    print("object a is instance of object: ", isinstanceByName(a, object))
+    print("class A is instance of type: ", isinstanceByName(A, type))
+    print("object a is not instance of type: ", not isinstanceByName(a, type))

jit-utils-backend-0.0.1/jit_utils/config/__init__.py

@@ -0,0 +1,11 @@
+# -*-coding:utf-8-*-
+"""
+Created on 2023/10/23
+
+@author: 臧韬
+
+@desc: 默认描述
+"""
+
+from commons.utils.config.config import TlConfig
+from commons.utils.config.field import Field, IntField, StringField