# =============================================================================
# version_handler_python.txt — Python (FastAPI/Flask) /__version__ 探针 (gongkong L2)
# =============================================================================
# 复制本片段到你的 FastAPI/Flask 应用代码, 适配框架即可。
#
# 作用: 暴露 GET /__version__ 路由, 返回当前进程的 commit/build_time/service。
# build-deploy-python.sh 通过 systemd EnvironmentFile 注入 GIT_COMMIT/BUILD_TIME,
# 部署后 curl 校验服务器跑的 commit == 本地 HEAD, 对得上才说明真的部署生效
# (gongce 协议0)。
#
# 接入步骤:
#   1. 把本片段贴到你的 app 入口文件
#   2. systemd unit 加: EnvironmentFile=-/etc/<service>/version.env
#      (build-deploy-python.sh 会自动写这个文件)
#   3. 部署脚本跑 bash build-deploy-python.sh
# =============================================================================

# ---- FastAPI 版本 ----
import os
import time
from datetime import datetime

# 全局启动时间(只在进程启动时记录一次)
_START_TIME = datetime.utcnow().isoformat() + "Z"


def _version_info():
    """返回当前进程的版本信息, 供 /__version__ 路由使用"""
    return {
        "service": os.environ.get("SERVICE_TAG", "your-service-name"),
        "commit": os.environ.get("GIT_COMMIT", "unknown"),
        "build_time": os.environ.get("BUILD_TIME", "unknown"),
        "start_time": _START_TIME,
    }


# FastAPI 路由:
from fastapi import FastAPI
app = FastAPI()

@app.get("/__version__")
def version_handler():
    return _version_info()


# ---- Flask 版本(若用 Flask, 注释掉上面 FastAPI 部分, 用下面的) ----
# from flask import Flask, jsonify
# app = Flask(__name__)
#
# @app.route("/__version__")
# def version_handler():
#     return jsonify(_version_info())


# =============================================================================
# systemd unit 必须加(否则环境变量读不到, /__version__ 返回 unknown):
#   EnvironmentFile=-/etc/<service>/version.env
# build-deploy-python.sh 会自动写这个文件:
#   GIT_COMMIT=abc1234
#   BUILD_TIME=2026-08-21T06:42:06Z
#   SERVICE_TAG=yourapp
# =============================================================================
