style: 移除设计不当的部分模块

src/heurams/context.py

@@ -9,29 +9,31 @@ from contextvars import ContextVar
 from heurams.services.config import ConfigFile
 from heurams.services.logger import get_logger
 
-# 默认配置文件路径规定: 以包目录为准
-# 用户配置文件路径规定: 以运行目录为准
-# 数据文件路径规定: 以运行目录为准
+# 默认数据目录, 以包目录下的 data 为准
+# 用户数据目录, 以运行目录下的 data 为准
+
+rootdir: pathlib.Path = pathlib.Path(__file__).parent
+"""包目录路径, 也就是 heurams 目录."""
 
-rootdir = pathlib.Path(__file__).parent
 workdir = pathlib.Path.cwd()
-#print(f"项目根目录: {rootdir}")
-#print(f"工作目录: {workdir}")
+"""工作目录路径."""
+
 logger = get_logger(__name__)
-logger.debug(f"项目根目录: {rootdir}")
+logger.debug(f"包目录: {rootdir}")
 logger.debug(f"工作目录: {workdir}")
 
 (workdir / "data" / "config").mkdir(parents=True, exist_ok=True)
 
-config_var: ContextVar[ConfigFile] = ContextVar(
+config_var: ContextVar[ConfigFile].get = ContextVar(
     "config_var",
     default=ConfigFile(workdir / "data" / "config" / "config.toml"),
 )
+"""配置对象的全局引用对象."""
 
 class ConfigContext:
     """
     功能完备的上下文管理器
-    用于临时切换配置的作用域, 支持嵌套使用
+    用于临时切换配置引用对象的作用域, 支持嵌套使用
 
     Example:
         >>> with ConfigContext(test_config):