✨ feat(is&to): useIs & useTo

Author: mic1on

src/usepy/__init__.py

@@ -11,7 +11,8 @@
     useRunInThread,
     useCatchError,
     useExceptDebug,
-    useListify
+    useListify,
+    useCachedProperty,
 )
 from .utils import (
     useTimer,
@@ -24,6 +25,8 @@
     useCookieToDict,
     useHeadersToDict
 )
+from .utils import useIs, useTo
+
 from ._datetime import useDateTime
 
 from ._path import usePath
@@ -43,6 +46,8 @@
     'useExceptDebug',
     'useListify',
     # utils
+    'useIs',
+    'useTo',
     'useTimer',
     'useTimerManager',
     'useUserAgent',

src/usepy/utils/__init__.py

@@ -1,11 +1,13 @@
 from . import useragent as useUserAgent
 from .timer import Timer as useTimer, TimerManager as useTimerManager
 from .import_object import import_object as useImport, LazyImport as useLazyImport
-from .to_dict import (
+from ._to import (
     cookie_to_dict as useCookieToDict,
     headers_to_dict as useHeadersToDict,
     data_to_dict as useDataToDict,
 )
 from .utils import (
     gen_unique_id as useUniqueId,
 )
+from . import _to as useTo
+from . import _is as useIs

src/usepy/utils/_is.py

@@ -0,0 +1,33 @@
+"""
+    @Author: MicLon
+    @Date: 2023/02/19
+    @Description: 用于检查数据类型的工具函数
+"""
+import re
+
+
+def is_token(value) -> bool:
+    """
+    检查`value`是否符合token规范
+    :param value: 要检查的值
+    :return:
+    """
+    return bool(re.match('^[A-Za-z0-9]{3,32}$', value))
+
+
+def is_string(value) -> bool:
+    """
+    检查`value`是否是字符串
+    :param value: 要检查的值
+    :return: bool
+    """
+    return isinstance(value, (str, bytes))
+
+
+def is_regexp(value) -> bool:
+    """
+    检查`value`是否是正则表达式
+    :param value: 要检查的值
+    :return:
+    """
+    return isinstance(value, type(re.compile("regex_test")))

src/usepy/utils/_to.py

@@ -0,0 +1,52 @@
+"""
+    @Author: MicLon
+    @Date: 2023/02/19
+    @Description: 用于转换数据类型的工具函数
+"""
+
+from typing import Any
+
+
+def cookie_to_dict(cookies: str) -> dict:
+    """
+    将字符串cookie转换为字典
+    :param cookies: cookie字符串
+    :return: dict
+    """
+    return {cookie.split('=')[0]: cookie.split('=')[-1] for cookie in cookies.split('; ')}
+
+
+def headers_to_dict(headers: str) -> dict:
+    """
+    将字符串headers转换为字典
+    :param headers: headers字符串
+    :return: dict
+    """
+    header_dict = {}
+    for line in headers.split('\n'):
+        if ':' in line:
+            key, value = line.split(':', 1)
+            header_dict[key.strip()] = value.strip()
+    return header_dict
+
+
+def data_to_dict(data: str) -> dict:
+    """
+    将字符串data转换为字典
+    :param data: data字符串。格式为`key1=value1&key2=value2`
+    :return: dict
+    """
+    return {item.split('=')[0]: item.split('=')[-1] for item in data.split('&')}
+
+
+def to_string(data: Any) -> str:
+    """
+    将任意数据转换为字符串
+    :param data: data
+    :return: string
+    """
+    if isinstance(data, str):
+        return data
+    if isinstance(data, bytes):
+        return data.decode()
+    return str(data)