import{_ as i,c as a,a7 as n,o as t}from"./chunks/framework.Z6UMW4JZ.js";const c=JSON.parse('{"title":"liteyuki.utils","description":"","frontmatter":{"title":"liteyuki.utils"},"headers":[],"relativePath":"en/dev/api/utils.md","filePath":"en/dev/api/utils.md","lastUpdated":1725101868000}'),l={name:"en/dev/api/utils.md"};function e(h,s,p,k,r,o){return t(),a("div",null,s[0]||(s[0]=[n(`
liteyuki.utils
一些常用的工具类,部分来源于 nonebot 并遵循其许可进行修改
is_coroutine_callable(call: Callable[..., Any]) -> bool
Description: 判断是否为协程可调用对象
Arguments:
- call: 可调用对象
Return: bool: 是否为协程可调用对象
def is_coroutine_callable(call: Callable[..., Any]) -> bool:
if inspect.isroutine(call):
return inspect.iscoroutinefunction(call)
if inspect.isclass(call):
return False
func_ = getattr(call, '__call__', None)
return inspect.iscoroutinefunction(func_)
run_coroutine(*coro: Coroutine)
Description: 运行协程
Arguments:
- coro:
def run_coroutine(*coro: Coroutine):
try:
loop = asyncio.get_running_loop()
if loop.is_running():
for c in coro:
asyncio.ensure_future(c)
else:
for c in coro:
loop.run_until_complete(c)
except RuntimeError:
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
loop.run_until_complete(asyncio.gather(*coro))
loop.close()
except Exception as e:
logger.error(f'Exception occurred: {e}')
run_coroutine_in_thread(*coro: Coroutine)
Description: 在新线程中运行协程
Arguments:
- coro:
def run_coroutine_in_thread(*coro: Coroutine):
threading.Thread(target=run_coroutine, args=coro, daemon=True).start()
path_to_module_name(path: Path) -> str
Description: 转换路径为模块名
Arguments:
- path: 路径a/b/c/d -> a.b.c.d
Return: str: 模块名
def path_to_module_name(path: Path) -> str:
rel_path = path.resolve().relative_to(Path.cwd().resolve())
if rel_path.stem == '__init__':
return '.'.join(rel_path.parts[:-1])
else:
return '.'.join(rel_path.parts[:-1] + (rel_path.stem,))
async_wrapper(func: Callable[..., Any]) -> Callable[..., Coroutine]
Description: 异步包装器
Arguments:
- func: Sync Callable
Return: Coroutine: Asynchronous Callable
def async_wrapper(func: Callable[..., Any]) -> Callable[..., Coroutine]:
async def wrapper(*args, **kwargs):
return func(*args, **kwargs)
wrapper.__signature__ = inspect.signature(func)
return wrapper