funcron 0.5.10__tar.gz

funcron-0.5.10/.env.example

@@ -0,0 +1,29 @@
+# funcron 运行时环境变量模板。
+#
+# 用法：复制为仓库根目录的 .env（该文件已在 .gitignore 里，不会进版本库），
+# 按需填写后由 scripts/setup.sh 启动的服务自动加载。
+# 也可以用 FUNCRON_ENV_FILE 指向别处的文件。
+#
+# 注意：这里只放 Airflow 的配置。funcron 自身的数据库密码、Web 登录口令、Redis 密码、
+# 通知 API key、API access token、Flask secret key 走 funsecret 下发，不在本文件里，
+# 具体密钥路径见 README「凭据配置」一节。
+
+# ---- Airflow 元数据库（prod 必填，dev 留空则回落到 AIRFLOW_HOME 下的 SQLite）----
+# AIRFLOW__DATABASE__SQL_ALCHEMY_CONN=mysql+pymysql://<user>:<password>@<host>:3306/<db>?charset=utf8
+
+# ---- Airflow 凭据（没有默认值，留空即不启用）----
+# 用 `python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"` 生成
+# AIRFLOW__CORE__FERNET_KEY=
+# 用 `python -c "import secrets; print(secrets.token_urlsafe(32))"` 生成
+# AIRFLOW__API__SECRET_KEY=
+
+# ---- Celery（默认连本机 Redis，无口令）----
+# AIRFLOW__CELERY__BROKER_URL=redis://:<password>@127.0.0.1:6379/0
+# AIRFLOW__CELERY__RESULT_BACKEND=redis://:<password>@127.0.0.1:6379/0
+
+# ---- 其余可选覆盖项（不配就用 scripts/lib/funcron-airflow-env.sh 里的默认值）----
+# AIRFLOW_HOME_PROD=$HOME/airflow
+# AIRFLOW_HOME_DEV=<仓库目录>/.run/airflow-dev-home
+# AIRFLOW__CORE__EXECUTOR=CeleryExecutor
+# AIRFLOW__CORE__DEFAULT_TIMEZONE=Asia/Shanghai
+# AIRFLOW__CORE__DAGS_FOLDER=<绝对路径，留空则按运行环境自动解析>

funcron-0.5.10/.gitignore

@@ -0,0 +1,43 @@
+__pycache__/
+*.pyc
+*.db
+*.rar
+logs/
+temp/
+build/
+dist/
+.venv/
+.run/
+# 运行时凭据（Airflow 元数据库连接串、fernet key 等），模板见 .env.example
+.env
+.env.local
+.idea/
+.vscode/
+node_modules/
+
+# ---- AI 编码助手 ----
+# 只忽略本地状态；团队有意共享的 agent / 命令 / 规则定义仍然版本化。
+# 必须写 `dir/*` 而不是 `dir/`：父目录被整体排除后 git 不会下探，
+# 下面的 `!` 取消规则就永远不会生效。
+.claude/*
+!.claude/agents/
+!.claude/commands/
+!.claude/skills/
+!.claude/settings.json
+.codex/*
+!.codex/prompts/
+.cursor/*
+!.cursor/agents/
+!.cursor/rules/
+
+# 其余助手：目前没有共享内容，整体忽略
+.aider*
+.gemini/
+.continue/
+.windsurf/
+.roo/
+.cline/
+.specstory/
+CLAUDE.local.md
+AGENTS.local.md
+uv.lock

funcron-0.5.10/CHANGELOG.md

@@ -0,0 +1,240 @@
+# CHANGELOG
+
+本文件记录 funcron 的版本变更，按版本倒序排列。
+
+## [0.5.10] - 2026-11-12
+
+### 修复
+
+- 构建时排除本机生成的 `src/funcron/airflow/airflow.cfg`，避免配置中的密钥再次进入 wheel 或 sdist；0.5.9 已发布产物仍需单独处置。
+- `server/port_manage.py`、`tasks/core.py`、`tool/mail.py` 的日志调用误用 stdlib
+  logging 的 `%s` 占位符，farlog（loguru）不支持该语法，参数被静默丢弃；统一改为
+  loguru 的 `{}` 占位符。`center/common/scheduler/cu_gevent_scheduler.py`、
+  `cu_background_scheduler.py`（源自 apscheduler，用 stdlib logging）与
+  `center/pages/crons/core.py` 的 `current_app.logger`（Flask 的 stdlib logger）
+  `%s` 用法本身正确，未改动。
+- **`JobLog.to_json()` 调用必抛 `AttributeError`**：它返回 `job_id` / `remark` /
+  `traces` / `status` 四个字段，而 `job_log` 表早已不存在这些列。现按实际列
+  （`id`/`log_id`/`cron_info_id`/`content`/`create_time`/`take_time`）重写，
+  并加测试断言返回键集合与表列定义一致，拦住后续字段漂移。
+- **`RedisCache.delete()` 永远删不掉键**：`set()`/`get()` 都按 `f"{prefix}{key}"`
+  读写带前缀的键，只有 `delete()` 直接 `delete(key)`，前缀被漏掉。现统一走
+  `full_key()` 拼接；`clear()` 也改为一次 `delete(*keys)` 并返回实际删除数量。
+- **`RedisCache` 的连接池在不同目标库之间串用**：`hasattr(RedisCache, "pool")`
+  是全类单例，第二次用不同 host/port/db 构造出的实例会静默连到第一次那个库。
+  现按 `(host, port, db)` 分别缓存连接池。
+- `JobLog.job_log_list()` 的参数 `id` 遮蔽内置函数，改名为 `cron_info_id`，
+  并与 `cron_list()` 一致支持 `page_size` 与空页码回落；调用方同步更新。
+- **`src/funcron/airflow/airflow.cfg` 随包发布了明文凭据与开发机绝对路径**：
+  `sql_alchemy_conn` 带明文 `funcron:funcron` 账号密码，`[webserver] secret_key`
+  是一个真实值，`dags_folder` / `plugins_folder` / `base_log_folder` 分别指向三台
+  不同机器上的固定路径（其中 `plugins_folder` 指的目录在本仓库根本不存在），而
+  `scripts/services/airflow.sh` 从来没有引用过这个文件，等于只泄露、不生效。
+  现已整文件删除，改由 `scripts/lib/funcron-airflow-env.sh` 按
+  `AIRFLOW__<SECTION>__<KEY>` 环境变量注入配置：目录类配置按脚本自身位置 / 已安装包
+  位置解析，凭据从不进版本库的 `.env` 读取（模板 `.env.example`），prod 缺少
+  `AIRFLOW__DATABASE__SQL_ALCHEMY_CONN` 时直接拒绝启动而不是回落到 SQLite。
+- **`airflow-webserver` 服务在当前依赖下必然起不来**：脚本执行 `airflow webserver`，
+  而 Airflow 3 已移除该子命令（本仓库声明 `apache-airflow>=3.3.1`），运行会直接报
+  `Command 'airflow webserver' has been removed`。改为 `airflow api-server`，
+  对外的服务名保持 `airflow-webserver` 不变。
+- **`src/funcron/airflow/init.sh` 整个跑不通**：`cp airflow.cfg ~/airflow/airflow.cfg`
+  用相对路径（只有恰好 cd 到该目录才成立），`airflow db init` 在 Airflow 3 已移除，
+  后面还串着 `airflow webserver`、`airflow worker` 等早已改名的命令。已重写并移到 `scripts/airflow-init.sh`
+  （放在包里的话，装到 site-packages 后相对路径就不成立了），用法 `scripts/airflow-init.sh <dev|prod>`，
+  复用统一的配置推导并执行 `airflow db migrate`。
+- **默认时区 `GMT+8` 是错的**：那不是 IANA 时区名，按 POSIX TZ 语义解释反而是 UTC-8。
+  新默认值为 `Asia/Shanghai`。
+
+### 移除
+
+- `funcron.airflow.create_account`：`from airflow.contrib.auth.backends.password_auth
+  import PasswordUser` 自 Airflow 2.0 起即不存在（`airflow.contrib` 已整包移除），
+  `airflow.models.User` 同样已删，该模块 import 即 `ModuleNotFoundError`，从未能运行。
+  替代方式：Airflow 3 默认的 SimpleAuthManager 用
+  `AIRFLOW__CORE__SIMPLE_AUTH_MANAGER_USERS` 配置管理员；装了
+  `apache-airflow-providers-fab` 则用 `airflow fab-manager create-user`。
+- `funcron.airflow.webserver_config`：未作任何 funcron 定制的 Airflow 2 模板文件，
+  顶部 `from airflow.www.fab_security.manager import AUTH_DB` 在 Airflow 3 下
+  `ModuleNotFoundError`（`airflow.www` 已移入 FAB provider），且 Airflow 只从
+  `$AIRFLOW_HOME/webserver_config.py` 加载，包里这份从来没被读过。
+  需要定制鉴权时请在 `AIRFLOW_HOME` 下自行放置该文件。
+
+### 新增
+
+- `.env.example`：Airflow 元数据库连接串、fernet key、Celery broker 等运行时凭据的
+  配置模板；实际的 `.env` 已加入 `.gitignore`。
+- `scripts/lib/funcron-airflow-env.sh`：Airflow 配置推导的唯一入口，被
+  `scripts/services/airflow.sh` 与 `scripts/airflow-init.sh` 共享，
+  保证「初始化」与「运行」用的是同一套配置。
+- `scripts/lib/funcron-common.sh` 新增 `funcron_installed_package_dir`，
+  以与 `funcron_installed_package_file` 相同的隔离方式解析已安装包内的目录。
+- 新增 `tests/test_airflow_env.py`，覆盖「仓库内不得再出现明文连接串与开发机绝对路径」、
+  各 `AIRFLOW__*` 默认值推导、`.env` 与显式环境变量的优先级、prod 缺连接串时拒绝启动，
+  并实跑 `airflow` CLI 确认 `api-server` 存在、`webserver` 确已移除。
+- `center/models.py`、`center/utils/times.py`、`center/utils/redis_cache.py`
+  的公开类、函数、方法补齐位于定义体首句的中文 docstring（原先只有游离在
+  模块/方法之间的三引号文本，不构成 docstring）。
+- 新增 `tests/test_models.py`、`tests/test_redis_cache.py`、`tests/test_times.py`，
+  覆盖上述修复的正常路径、边界与失败路径（Redis 用内存假客户端，不连真实服务）。
+
+## [0.5.9] - 2026-10-02
+
+### 修复
+
+- **`funcron` 命令行此前完全不可用**：`funcron/server/script.py` 顶部
+  `from funbuild.manage import BaseServer`，而 funbuild 已不再提供 `manage` 模块
+  （当前及 pyproject 声明下限 1.6.75 均无），控制台脚本一启动就
+  `ModuleNotFoundError: No module named 'funbuild.manage'`。已发布的 0.5.7 带着这个缺陷。
+  现已重写 CLI，去掉对 funbuild/supervisor 的依赖。
+- **README 示例与实现不一致**：旧 CLI 要求同时给 `cmd` 和 `service` 两个位置参数，
+  README 里的 `funcron server` / `funcron status` 实际都以用法错误退出；
+  `scripts/setup.sh status all` 也因为缺第三个参数退出码 1。现在 CLI 提供
+  `status` / `services` 两个子命令，`scripts/setup.sh status` 的环境参数可省略
+  （省略时报告 dev 与 prod 两个环境），README 示例已逐条实测可运行。
+- **`db.session.execute()` 传裸字符串 SQL 在 SQLAlchemy 2.x 下直接报错**：
+  `funcron/center/pages/main/views.py` 的 `cron_del`、
+  `funcron/center/pages/crons/core.py` 的 `cron_check_db_sleep` / `cron_del_job_log`
+  会抛 `ObjectNotExecutableError`（本仓库声明 flask-sqlalchemy>=3.1.1，即 SQLAlchemy 2.x）。
+  现统一改为 `sqlalchemy.text()` + 参数绑定。
+- **SQL 字符串插值改为参数绑定**：`cu_background_scheduler.py` / `cu_gevent_scheduler.py`
+  的 `update_cron_info` 原先用 `"... where id='%s'" % cron_id` 拼 SQL，任务 ID 来自任务数据；
+  现改为绑定参数，并在解析出的主键不是数字时拒绝执行并记日志。
+  `cron_del_job_log` 的 `delete ... limit` 同样改为绑定参数。
+- **prod 启动的生产包校验此前被 editable 安装架空**：`scripts/services/server.sh` 用
+  `python3 -c "import funcron"` 判定「已安装」，但 `uv sync` 装的是 editable（`.pth` 指回源码），
+  从仓库目录运行时裸 import 也会命中工作树，校验恒为真，`start prod` 实际在跑源码。
+  现改为清空 `PYTHONPATH` + Python 隔离模式（`-I`）+ 切到 `.run/` + 断言模块文件落在
+  `site-packages`/`dist-packages`；校验下沉到各服务脚本的 `command_for`，使 `run prod`
+  这条路径同样被覆盖；airflow 与 coin 服务也补上了同样的 prod 校验。
+  `prod` 下 gunicorn 的配置文件改为从已安装包内解析，不再引用仓库源码目录。
+- **重复启动检查会把任意存活 PID 当成本服务**：`funcron_is_running` 原先只 `kill -0` PID 文件里的
+  数字。现在 PID 文件旁多记一份 `.meta`（进程启动时刻 + 命令特征串），状态细分为
+  `missing`/`invalid`/`stale`/`mismatch`/`running`：陈旧文件清理后继续，PID 被其他进程复用时
+  拒绝操作并提示人工确认（`stop` 也不会去 kill 未通过身份校验的进程）。
+- **`default` / `testing` 配置默认开着 DEBUG**：`config_dict` 的 `default` 原先指向
+  `DevelopmentConfig`（`DEBUG = True`）。现在 `default` 指向 `ProductionConfig`，新增
+  `TestingConfig`（只开 `TESTING`，不开 `DEBUG`），`DEBUG` 只在显式选 `development` 时开启。
+- **`create_app()` 无条件改写调用方传入的配置名**：函数体第一行 `config_name = "production"`
+  让参数形同虚设。现在尊重入参，未知配置名直接抛 `KeyError` 而不是静默回落。
+- **`api_deal_return` 对不支持的返回值隐式返回 None**：视图返回 `None` 或其他未覆盖类型时
+  装饰器什么都不返回，Flask 随后报 "did not return a valid response"，排查不到真正原因。
+  现在返回带类型名的明确错误响应。顺带把 `type(x) == str` 这类判断改为 `isinstance`。
+- **缺失的运行时依赖补齐声明**：`requests`、`six`、`sqlalchemy` 在代码里直接 import，
+  此前完全没有声明，靠传递依赖"运气好"装上。`fundata` 下限提到 1.0.3（1.0.1/1.0.2 的
+  wheel 里带着失效的 notetool/notebuild import）。
+- `funcron status` 的 IP 探测失败不再让命令整体崩溃，改为回落到 `127.0.0.1` / `unknown`
+  并记录警告。端口清单里移除了已不再使用的 supervisor 条目，补上 funcron 管理后台自身端口。
+- **非 root 环境 `import funcron.center.common.config` 直接 PermissionError**：配置模块在
+  import 期间就 `WorkApp("funcron").create()`，而 `fundata` 的默认工作目录写死在
+  `/opt/farfarfun/apps/funcron`，普通用户下 `os.makedirs` 抛 `PermissionError`，
+  连测试收集都会整体失败。现在工作目录按
+  `FUNCRON_APP_DIR` → `FUNDATA_APP_DIR` → `/opt/farfarfun/apps/funcron`（可写才用）
+  → `~/.funcron` 的顺序解析，并有 4 个测试覆盖这条优先级链。
+- **404 / 500 错误页以 HTTP 200 返回**：`funcron/center/pages/main/errors.py` 的
+  `app_errorhandler` 只返回一个字符串，Flask 不会自动套上异常的状态码，于是「找不到页面」
+  和「服务端异常」在 HTTP 层都表现为成功，探活与调用方无法区分。现在显式返回
+  `(正文, 404)` / `(正文, 500)`，并有测试断言状态码。
+- **`funcron.tool.mail` 里写死的真实邮箱地址与收件人**：发件账号 `15068733021@163.com`
+  与默认收件人（两个个人 QQ 邮箱）直接写在源码里，随包发布到 PyPI。现在发件账号、
+  口令、默认收件人全部经 `funsecret` 下发，缺配置时抛 `ValueError` 而不是静默发往写死的
+  地址；顺带修掉「多个收件人时只有第一个出现在 `To` 头里」以及异常时 `smtp.close()`
+  不会被执行（改用 `with`）两个问题。
+
+### 变更
+
+- **源码改为 src 布局**：`funcron/` → `src/funcron/`（SPEC 4.1），同步调整 hatch 构建配置
+  与服务脚本路径。包名、发布名、import 路径都不变（仍是 `funcron`），对使用方无影响；
+  附带好处是在仓库根目录不会再误把工作树源码当成已安装包 import 到。
+- **不再依赖 supervisor 做进程守护**：进程托管统一由 `scripts/setup.sh` + `.run/` 负责，
+  `supervisor` 与 `funbuild` 已从运行时依赖中移除（`funbuild` 本就只是构建/发布工具）。
+- 新增 `[tool.ruff]` 配置（line-length 120、显式 select 规则集）与 `[tool.pytest.ini_options]`，
+  `ruff` 加入 dev 依赖组；补上 `[project.urls]`。`ruff check` 与 `ruff format --check`
+  现已全仓库通过（存量问题逐条修掉或带理由标注豁免，不是靠放宽规则集蒙过去）。
+- `uv.lock` 中的传递依赖升级，修掉 Dependabot 报出的安全告警（纯锁文件升级，本包代码未变，
+  测试全绿）：
+  - `urllib3` 2.7.0 → 2.8.0：2 HIGH + 1 MEDIUM（`HTTPResponse.stream()/read_chunked()`
+    无界缓冲、HTTPS 代理的 TLS 配置可能被忽略、chunked deflate 响应可能无限循环）。
+  - `pyjwt` 2.13.0 → 2.15.1：1 CRITICAL + 5 HIGH + 多个 MEDIUM（非对称 PEM 检测绕过、
+    公钥被当作 HMAC 密钥、BOM 绕过、空 HMAC 密钥、`PyJWKClient` 跟随重定向等）。
+  - `tornado` 6.5.8 → 6.5.10：2 HIGH（`CurlAsyncHTTPClient` 解压无响应大小上限、
+    `StaticFileHandler` 跟随软链接越出静态根目录）。
+  - 仍未修复的 `diskcache`（unsafe pickle 反序列化）上游无可用修复版本，funcron 只把它
+    当本地缓存用、不反序列化外部输入，暂维持现状。
+- 把 `script/__version__.md` 与 `pyproject.toml` 的 `[project].version` 对齐（此前漂成
+  0.5.8 / 0.5.7：funbuild 的 `sync_all_manifest_versions()` 不同步 `script/__version__.md`）。
+  新增 `tests/test_version_consistency.py` 断言两处一致，拦截后续漂移。
+
+### 新增
+
+- `funcron` CLI 新增 `services` 子命令，列出 `scripts/setup.sh` 能托管的服务名；
+  并有测试断言这份名单与 `scripts/setup.sh` 的 `ALL_SERVICES` 一致。
+- 测试从 3 个文件 / 1 条断言扩充到 10 个文件 / 74 条，新增：CLI 子命令与参数解析、
+  `scripts/setup.sh` 的动作/服务/环境参数校验与 `status` 行为、重复启动检查五种状态的
+  逐一验证、prod 生产包校验对源码树/editable 的拒绝（含「朴素 import 确实会通过」的
+  前置断言，避免测试空跑）、`api_deal_return`/`login_required` 的正常与边界路径、
+  配置默认值的安全性与工作目录解析优先级、邮件发送的缺配置/多收件人路径、
+  404/500 错误页的状态码。原先两个用 `pytest.importorskip` 兜住 fundata 问题的测试
+  已改为真实 import，环境退化时直接失败而不是静默跳过。
+- Web/API 视图函数、蓝图模块与错误处理器补齐中文 docstring；`api/views.py` 里
+  `except Exception` 收窄为 `(TypeError, ValueError)`。
+
+### 废弃
+
+- **移除 `funcron.core` 模块（`JobScheduler` 与 `funcron.core.funcron`）**。
+  替代品：`scripts/setup.sh {start|stop|restart|status|run} <service> <dev|prod>`。
+  移除原因：该模块通过 `subprocess(..., shell=True)` 执行 `nohup funcron _start ...`、
+  并用 `ps x | grep funcron` 的文本输出拼 `kill -9 <pid>` 来停服务——既不安全（命令拼接、
+  按进程名文本匹配可能误杀），也早已跑不通（它调用的 `funcron _start` 子命令在已注册的
+  控制台脚本里并不存在）。迁移方法：
+  原 `funcron.core.JobScheduler().start()/stop()/restart()`
+  → `scripts/setup.sh start|stop|restart <service> <dev|prod>`。
+- **移除 `funcron.tasks.ba` 模块**。该模块是 2020 年给某德国电商站点写的个人抢购脚本：
+  funcron 内部没有任何调用点，与「定时任务调度中心」这个定位无关，且源码里带着一整份
+  写死的第三方站点会话 Cookie（`frontend`、`bfd_sid`、`sensorsdata2015jssdkcross` 等）
+  和两个个人 QQ 邮箱地址，随包发布到 PyPI。随之移除仅由它使用的 `demjson3` 运行时依赖。
+  无迁移路径——它从未被 funcron 的任何入口暴露。
+
+## [0.5.8] - 未发布（未推送到 PyPI，内容已并入 0.5.9）
+
+### 新增
+
+- 新增 `scripts/setup.sh` + `scripts/services/*.sh`，统一管理 server / airflow-webserver /
+  airflow-scheduler / airflow-worker / airflow-flower / coin 等长期运行服务，支持
+  `start`/`stop`/`restart`/`status`/`run`，区分 `dev`/`prod` 环境，运行时文件统一放在 `.run/`。
+- README 补充安装命令、最小可运行示例、服务启动说明及组织介绍区块。
+
+### 修复
+
+- 修复 `pyproject.toml` 中依赖 `redi`（无关的 REDCap 导入工具）误当作 `redis` 声明的问题，
+  改为正确声明 `redis`；为全部运行时依赖补充经验证的最低版本号，并提交 `uv.lock`。
+- 删除 `funcron/core/core.py` 里 `from funbuild.shell import run_shell, run_shell_list`
+  这行死 import（funcron 从未调用过这两个函数，且 funbuild 已不再提供 `shell` 模块，
+  对应能力在独立的 `funshell` 包里）。这是 funcron 内部的未使用 import，不是 funcron
+  自己对外暴露过的入口，使用方无需做任何迁移。
+- `funcron/center/common/config/config.py`、`funcron/tool/mail.py`、`funcron/airflow/create_account.py`
+  中硬编码的登录口令、Redis 密码、通知 API key、API access token、Airflow 管理员账号密码
+  改为通过 `funsecret`/环境变量下发，代码中不再出现明文真实凭据。
+- `funcron/center/pages/main/views.py`、`funcron/center/common/scheduler/cu_background_scheduler.py`、
+  `cu_gevent_scheduler.py` 中吞掉异常的裸 `except`/`except Exception: pass` 改为记录带上下文的错误日志。
+- `funcron/tasks/core.py`、`funcron/center/common/functions.py` 中用于诊断的 `print` 改为
+  `farlog` 日志输出。
+
+### 变更
+
+- 统一日志入口为 `farlog.getLogger`，移除 `funcron/center/app.py` 中手写的 `logging`
+  handler 配置，以及 `funtool.tool.log` 的使用。
+- 模块文件名改为 snake_case：`CuBackgroundScheduler.py` → `cu_background_scheduler.py`、
+  `CuGeventScheduler.py` → `cu_gevent_scheduler.py`、`RedisCache.py` → `redis_cache.py`
+  （类名保持不变，仅重命名文件并同步更新导入）。
+- `.gitignore` 补充 `*.pyc`、`*.db`、`*.rar`、`.venv/`、`.run/`、`.idea/`、`.vscode/`、
+  `node_modules/`。
+
+### 废弃
+
+- 无。
+
+## 历史版本
+
+0.5.8 之前的版本未维护本文件，历史变更请参考 Git 提交记录。
+PyPI 上的最后一个已发布版本是 0.5.7；0.5.8 只在仓库里打了版本号、没有发布。

funcron-0.5.10/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 farfarfun
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

funcron-0.5.10/PKG-INFO

@@ -0,0 +1,192 @@
+Metadata-Version: 2.5
+Name: funcron
+Version: 0.5.10
+Summary: 基于 Flask 与 Airflow 的定时任务调度管理中心，提供 Web 管理后台及 server/scheduler/worker/flower 等后台服务
+Project-URL: Organization, https://github.com/farfarfun
+Project-URL: Repository, https://github.com/farfarfun/funcron
+Project-URL: Releases, https://github.com/farfarfun/funcron/releases
+Author-email: 牛哥 <niuliangtao@qq.com>, farfarfun <farfarfun@qq.com>
+Maintainer-email: 牛哥 <niuliangtao@qq.com>, farfarfun <farfarfun@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Requires-Dist: apache-airflow-providers-celery>=3.23.1
+Requires-Dist: apache-airflow>=3.3.1
+Requires-Dist: apscheduler>=3.11.3
+Requires-Dist: farlog>=1.1.8
+Requires-Dist: flask-apscheduler>=1.13.1
+Requires-Dist: flask-migrate>=4.1.0
+Requires-Dist: flask-sqlalchemy>=3.1.1
+Requires-Dist: flask>=3.1.3
+Requires-Dist: funcoin>=1.0.51
+Requires-Dist: fundata>=1.0.3
+Requires-Dist: funsecret>=1.4.96
+Requires-Dist: gevent>=26.8.0
+Requires-Dist: gunicorn>=26.2.0
+Requires-Dist: pymysql>=1.2.0
+Requires-Dist: records>=0.6.0
+Requires-Dist: redis>=6.4.0
+Requires-Dist: requests>=2.32.0
+Requires-Dist: six>=1.17.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: typer>=0.12
+Description-Content-Type: text/markdown
+
+# funcron
+
+基于 Flask 与 Airflow 的定时任务调度管理中心，提供 Web 管理后台，以及 server（管理后台）/
+scheduler/webserver/worker/flower（Airflow 各角色）/coin（行情下载）等长期运行服务。
+
+## 安装
+
+```bash
+uv add funcron
+# 或
+pip install funcron
+```
+
+## 最小可运行示例
+
+安装完成后，基于 Typer 的 `funcron` 命令行提供两个查询类子命令：
+
+```bash
+# 查看本机常用服务端口的可访问状态
+funcron status
+
+# 列出 scripts/setup.sh 支持托管的服务名
+funcron services
+```
+
+长期运行服务的启停不走 CLI，统一由 `scripts/setup.sh` 管理，见下一节。
+
+`scripts/` 是源码仓库和 source distribution 附带的运维脚本，不会安装到 PyPI
+wheel 中。通过 `pip install funcron` 或 `uv add funcron` 安装后只能使用上述
+`funcron` CLI；需要运行服务脚本时，请获取源码并在仓库根目录执行：
+
+```bash
+git clone https://github.com/farfarfun/funcron.git
+cd funcron
+scripts/setup.sh install-dev
+```
+
+## 服务启动（scripts/setup.sh）
+
+生产环境或本地长期运行各服务，统一通过 `scripts/setup.sh` 管理。先安装所需版本，再按 `动作 → 服务` 解析运行参数：
+
+```bash
+# 用法: scripts/setup.sh {start|stop|restart|run|status} <service>
+#   <service>: server | airflow-webserver | airflow-scheduler | airflow-worker
+#              | airflow-flower | coin | all
+
+# 构建并安装当前源码，然后后台启动 Web 管理后台
+scripts/setup.sh install-dev
+scripts/setup.sh start server
+
+# 生产机可安装指定正式版本
+scripts/setup.sh install-prod 0.5.10
+
+# 前台运行 Airflow scheduler，方便调试
+scripts/setup.sh run airflow-scheduler
+
+# 查看所有服务状态
+scripts/setup.sh status all
+```
+
+`start`/`stop`/`restart` 管理后台进程，`run` 是前台阻塞运行，方便调试单个服务，不支持 `all`。
+运行命令不接受 `dev`/`prod` 参数；当前安装的是本地构建还是正式版本，分别由
+`install-dev` 和 `install-prod [version]` 决定。
+
+PID、进程身份记录与日志统一放在仓库根目录的 `.run/` 下（按服务名区分）。重复启动检查会
+校验 PID 对应进程的启动时刻与命令特征：进程已退出的陈旧 PID 文件会被清理后继续启动；PID 已被
+其他进程复用时拒绝操作并提示人工确认，不会误杀无关进程。
+
+运行服务要求 funcron / airflow / funcoin 已安装为非 editable 包：校验会清空 `PYTHONPATH`、用
+Python 隔离模式导入，并断言模块文件落在 `site-packages` 下，因此 editable 安装（`pip install -e`、
+`uv sync`）或直接从源码工作树运行都会被拒绝；gunicorn 的配置文件也从已安装包内解析，
+不引用仓库源码。
+
+## Airflow
+
+仓库内**不保存 `airflow.cfg`**：配置文件一旦写上元数据库连接串，账号密码就会随版本库和
+PyPI 包一起发出去；而 Airflow 的 `dags_folder` / `plugins_folder` / `base_log_folder`
+必须是绝对路径，写进包里就只在某一台机器上成立。
+
+funcron 需要覆盖的配置项统一由 `scripts/lib/funcron-airflow-env.sh` 以
+`AIRFLOW__<SECTION>__<KEY>` 环境变量注入，取值顺序为
+「调用方已导出的环境变量 → `.env` 文件 → 按运行环境推导的默认值」：
+
+| 配置项 | dev 默认值 | prod 默认值 |
+|---|---|---|
+| `AIRFLOW_HOME` | `.run/airflow-dev-home` | `$AIRFLOW_HOME_PROD`（默认 `$HOME/airflow`） |
+| `AIRFLOW__CORE__DAGS_FOLDER` | 源码树 `src/funcron/airflow/dags` | 已安装 funcron 包内的 `airflow/dags` |
+| `AIRFLOW__CORE__PLUGINS_FOLDER` | `$AIRFLOW_HOME/plugins` | 同左 |
+| `AIRFLOW__LOGGING__BASE_LOG_FOLDER` | `$AIRFLOW_HOME/logs` | 同左 |
+| `AIRFLOW__DATABASE__SQL_ALCHEMY_CONN` | 不设置（回落到 `AIRFLOW_HOME` 下的 SQLite） | **必填**，缺失直接拒绝启动 |
+
+凭据写在仓库根目录的 `.env`（不进版本库），模板见 `.env.example`；也可用
+`FUNCRON_ENV_FILE` 指向别处。
+
+首次部署先初始化元数据库，再按上一节启动各角色服务：
+
+```bash
+scripts/airflow-init.sh prod
+scripts/setup.sh start airflow-scheduler
+```
+
+管理员账号由所选 auth manager 负责创建（Airflow 3 默认的 SimpleAuthManager 用
+`AIRFLOW__CORE__SIMPLE_AUTH_MANAGER_USERS` 配置；装了 `apache-airflow-providers-fab`
+时用 `airflow fab-manager create-user`），funcron 不再自带建账号脚本。
+
+`airflow-webserver` 服务底层执行的是 `airflow api-server`——Airflow 3 已移除
+`airflow webserver` 子命令，承载 Web UI 的组件改名为 api-server；对外的服务名保持不变。
+
+## 凭据配置
+
+数据库密码、Web 登录密码、Redis 密码、通知 API key、API access token、Flask session key
+均从 `funsecret` 读取，不提供默认凭据。对应路径位于 `funcron/database/mysql/password`、
+`funcron/web/login/password`、`funcron/redis/password`、`funcron/notice/error_api_key`、
+`funcron/api/access_token` 和 `funcron/web/flask/secret_key`。缺少登录密码时 Web 登录会拒绝访问；
+缺少 API access token 时 API 会返回配置错误；可选的 Redis 密码和通知 API key 为空时不启用相应认证或通知。
+
+Flask 配置名可取 `development` / `testing` / `production` / `default`，由 `create_app(config_name)`
+显式选择。只有 `development` 会开启 `DEBUG`；`default` 指向生产配置，`testing` 只开 `TESTING`。
+
+## 工作目录
+
+数据库文件、日志与中间文件放在工作目录下，按以下顺序解析：`FUNCRON_APP_DIR` 环境变量 →
+`FUNDATA_APP_DIR` 环境变量 → `/opt/farfarfun/apps/funcron`（当前用户可写时）→ `~/.funcron`。
+显式设置环境变量时按设置值使用，不再做可写性回落。
+
+## 开发
+
+```bash
+uv sync
+uv run pytest
+uv run ruff check
+uv run ruff format --check
+```
+
+源码采用 src 布局（`src/funcron/`），因此在仓库根目录直接 `import funcron` 不会命中工作树，
+需要先 `uv sync` 安装。
+
+---
+
+## 关于 farfarfun
+
+[farfarfun](https://github.com/farfarfun) 是一个专注于实用工具库的开源组织，
+涵盖云存储、数据处理、AI、多媒体与开发工具链等方向。
+
+- 🏠 组织主页：<https://github.com/farfarfun>
+- 📦 PyPI：<https://pypi.org/user/niuliangtao/>
+- 📧 联系：farfarfun@qq.com
+
+本项目基于 [MIT](LICENSE) 协议开源。
+
+## 第三方组件
+
+| 组件 | 版本 | 来源 | 原始许可证 |
+| --- | --- | --- | --- |
+| artDialog | 4.1.6 | [artDialog 项目](http://code.google.com/p/artdialog/)（TangBin，2009-2012） | [GNU LGPL-2.1-or-later](http://creativecommons.org/licenses/LGPL/2.1/) |
+
+artDialog 的分发文件位于 `src/funcron/center/static/js/artDialog/`；其中保留了原始
+版权与许可证声明。