"""
Gunicorn 配置文件
=============================================================

生产环境启动：gunicorn -c gunicorn.conf.py src.wsgi:app

设计要点：
    - 使用 gevent worker：单 worker 内协程并发，适合 I/O 密集型
    - worker 数默认按 CPU 核心数动态计算（2 * cpu + 1）
    - 所有可调参数通过环境变量覆盖，便于 docker-compose 注入
"""

import os
import multiprocessing

# ============================================================
# 网络配置
# ============================================================

# 监听地址（0.0.0.0 表示所有网卡，Docker 容器内必须）
bind = os.getenv('GUNICORN_BIND', f'0.0.0.0:{os.getenv("FLASK_PORT", "8021")}')

# ============================================================
# Worker 配置
# ============================================================

# worker 数量（默认 2 * CPU 核心数 + 1，可通过环境变量覆盖）
workers = int(os.getenv('GUNICORN_WORKERS', multiprocessing.cpu_count() * 2 + 1))

# worker 类型：gevent 协程模型，支持高并发
worker_class = 'gevent'

# 每个 worker 的协程数（gevent 并发上限）
worker_connections = int(os.getenv('GUNICORN_WORKER_CONNECTIONS', 1000))

# worker 处理指定请求数后重启（防内存泄漏，默认 10000）
max_requests = int(os.getenv('GUNICORN_MAX_REQUESTS', 1000))

# max_requests 的随机抖动，避免所有 worker 同时重启
max_requests_jitter = int(os.getenv('GUNICORN_MAX_REQUESTS_JITTER', 50))

# worker 启动超时（秒）
timeout = int(os.getenv('GUNICORN_TIMEOUT', 120))

# 优雅关闭超时（秒），超时后强制 kill
graceful_timeout = int(os.getenv('GUNICORN_GRACEFUL_TIMEOUT', 30))

# ============================================================
# 进程管理
# ============================================================

# 守护进程模式（生产环境建议配合 systemd/supervisor 使用，保持 False）
daemon = False

# PID 文件路径
pidfile = os.getenv('GUNICORN_PIDFILE', '/tmp/gunicorn.pid')

# 预加载应用（启动时加载，worker fork 后共享，节省内存）
# 注意：开启后 worker 间不共享运行时状态
preload_app = False

# ============================================================
# 日志配置
# ============================================================

# 日志级别：debug / info / warning / error / critical
loglevel = os.getenv('GUNICORN_LOG_LEVEL', 'info')

# 访问日志路径（- 表示输出到 stdout）
accesslog = os.getenv('GUNICORN_ACCESS_LOG', '-')

# 错误日志路径（- 表示输出到 stderr）
errorlog = os.getenv('GUNICORN_ERROR_LOG', '-')

# 访问日志格式
access_log_format = '%(h)s %(l)s %(u)s %(t)s "%(r)s" %(s)s %(b)s "%(f)s" "%(a)s" %(D)s'

# ============================================================
# 其他
# ============================================================

# 启动时是否在控制台打印配置
print_config = False

# 启动时是否检查配置有效性
check_config = False