config.py 1.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. """工具服务配置(全部可通过环境变量覆盖,便于一键部署与离线迁移)。"""
  2. from __future__ import annotations
  3. import os
  4. from dataclasses import dataclass, field
  5. from pathlib import Path
  6. def _env(name: str, default: str) -> str:
  7. value = os.environ.get(name)
  8. return value if value not in (None, "") else default
  9. @dataclass
  10. class Settings:
  11. """运行时设置。"""
  12. #: 数据根目录(对象库、台账、处理产物都放在这里)
  13. data_dir: Path = field(default_factory=lambda: Path(_env("CDA_DATA_DIR", "data")))
  14. host: str = field(default_factory=lambda: _env("CDA_TOOLS_HOST", "127.0.0.1"))
  15. port: int = field(default_factory=lambda: int(_env("CDA_TOOLS_PORT", "8788")))
  16. #: data_read 单次返回行数上限
  17. max_rows: int = field(default_factory=lambda: int(_env("CDA_MAX_ROWS", "200")))
  18. query_timeout_ms: int = field(default_factory=lambda: int(_env("CDA_QUERY_TIMEOUT_MS", "5000")))
  19. query_max_offset: int = field(default_factory=lambda: int(_env("CDA_QUERY_MAX_OFFSET", "10000")))
  20. query_max_bytes: int = field(default_factory=lambda: int(_env("CDA_QUERY_MAX_BYTES", "1048576")))
  21. #: 单文件上传上限(字节)
  22. max_upload_bytes: int = field(default_factory=lambda: int(_env("CDA_MAX_UPLOAD_MB", "512")) * 1024 * 1024)
  23. #: 台账 JSONL 是否落盘
  24. ledger_jsonl: bool = field(default_factory=lambda: _env("CDA_LEDGER_JSONL", "1") == "1")
  25. @property
  26. def db_path(self) -> Path:
  27. return self.data_dir / "app.sqlite"
  28. @property
  29. def objects_dir(self) -> Path:
  30. return self.data_dir / "objects"
  31. @property
  32. def runs_dir(self) -> Path:
  33. return self.data_dir / "runs"
  34. @property
  35. def ledger_path(self) -> Path:
  36. return self.data_dir / "ledger.jsonl"
  37. def ensure(self) -> None:
  38. for path in (self.data_dir, self.objects_dir, self.runs_dir):
  39. path.mkdir(parents=True, exist_ok=True)
  40. settings = Settings()