from flask import Flask
import os

def create_app(env: str = None):
    """
    應(yīng)用工廠函數(shù)（支持指定環(huán)境：dev/prod/win）
    :param env: 環(huán)境標(biāo)識(shí)（dev=開發(fā)/Windows, prod=生產(chǎn)/Linux）
    """
    app = Flask(__name__)
    
    # 加載配置（根據(jù)環(huán)境自動(dòng)切換）
    env = env or os.getenv("FLASK_ENV", "dev")
    if env == "dev" or env == "win":
        app.config.from_object("app.config.win")
    elif env == "prod":
        app.config.from_object("app.config.prod")
    else:
        app.config.from_object("app.config.base")
    
    # 注冊(cè)多藍(lán)圖（拆分的接口模塊）
    from app.api.user import user_bp
    from app.api.order import order_bp
    app.register_blueprint(user_bp, url_prefix="/api/user")
    app.register_blueprint(order_bp, url_prefix="/api/order")
    
    return app

from flask import Blueprint, jsonify, request
from app.utils.common import encrypt_password  # 導(dǎo)入工具類（多py文件調(diào)用）

user_bp = Blueprint("user", __name__)

# 用戶登錄接口
@user_bp.post("/login")
def login():
    data = request.get_json()
    username = data.get("username")
    password = encrypt_password(data.get("password"))  # 調(diào)用工具類
    return jsonify({
        "code": 200,
        "msg": "登錄成功",
        "data": {"username": username, "token": f"token_{username}"}
    })

# 用戶信息接口
@user_bp.get("/info")
def get_user_info():
    user_id = request.args.get("id")
    return jsonify({
        "code": 200,
        "data": {"id": user_id, "name": "張三", "age": 25}
    })

from flask import Blueprint, jsonify
from app.utils.db import get_order_data  # 導(dǎo)入數(shù)據(jù)庫(kù)工具類

order_bp = Blueprint("order", __name__)

# 訂單列表接口
@order_bp.get("/list")
def get_order_list():
    orders = get_order_data()  # 調(diào)用工具類
    return jsonify({
        "code": 200,
        "data": orders
    })

import hashlib

def encrypt_password(password: str) -> str:
    """密碼加密工具"""
    return hashlib.md5((password + "salt123").encode()).hexdigest()

def check_params(params: dict, required: list) -> bool:
    """參數(shù)校驗(yàn)工具"""
    return all([p in params for p in required])

def get_order_data():
    """模擬數(shù)據(jù)庫(kù)查詢訂單數(shù)據(jù)"""
    return [
        {"order_id": "1001", "amount": 99.9, "status": "paid"},
        {"order_id": "1002", "amount": 199.9, "status": "unpaid"}
    ]

DEBUG = True  # Windows 開發(fā)環(huán)境開啟DEBUG
HOST = "127.0.0.1"  # Windows 本地訪問
PORT = 5000
SECRET_KEY = "win-secret-key-123"
# Windows 特有配置（如本地?cái)?shù)據(jù)庫(kù)路徑）
DB_PATH = "C:/flask-api/data.db"

DEBUG = False  # 生產(chǎn)環(huán)境關(guān)閉DEBUG
HOST = "0.0.0.0"  # 允許外部訪問
PORT = 5000
SECRET_KEY = "prod-secret-key-456"
# Linux 特有配置（如服務(wù)器數(shù)據(jù)庫(kù)地址）
DB_PATH = "/opt/flask-api/data.db"

import sys
from app import create_app

if __name__ == "__main__":
    # 識(shí)別運(yùn)行環(huán)境（Windows/Linux）
    env = "win" if sys.platform == "win32" else "prod"
    # 手動(dòng)指定環(huán)境：python run.py prod
    if len(sys.argv) > 1:
        env = sys.argv[1]
    
    app = create_app(env=env)
    app.run(
        host=app.config["HOST"],
        port=app.config["PORT"],
        debug=app.config["DEBUG"]
    )

# 核心依賴（跨平臺(tái)兼容）
Flask==2.3.3
gunicorn==21.2.0  # Linux/Docker用（Windows可選）
waitress==2.1.2   # Windows替代Gunicorn的WSGI服務(wù)器
requests==2.31.0
pywin32>=306      # Windows 進(jìn)程守護(hù)（可選）
supervisor==4.2.5 # Linux 進(jìn)程守護(hù)（Windows也可裝）

python --version  # 或 python3 --version
pip --version

# 進(jìn)入項(xiàng)目目錄
cd D:\flask-multi-api
# 創(chuàng)建虛擬環(huán)境
python -m venv venv
# 激活虛擬環(huán)境（Windows 命令行）
venv\Scripts\activate.bat
# 如果是PowerShell，執(zhí)行：
# venv\Scripts\Activate.ps1
# 安裝依賴
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 方式1：直接啟動(dòng)（自動(dòng)識(shí)別Windows環(huán)境）
python run.py

# 方式2：手動(dòng)指定win環(huán)境
python run.py win

# 測(cè)試用戶接口
curl "http://127.0.0.1:5000/api/user/info?id=1"
# 測(cè)試訂單接口
curl "http://127.0.0.1:5000/api/order/list"

pip install supervisor

[unix_http_server]
file = NUL  # Windows 無需unix socket

[inet_http_server]
port = 127.0.0.1:9001  # Supervisor 管理端口
username = admin
password = 123456

[supervisord]
logfile = D:\flask-multi-api\logs\supervisord.log
logfile_maxbytes = 50MB
logfile_backups = 10
loglevel = info
pidfile = D:\flask-multi-api\supervisord.pid
nodaemon = false  # 后臺(tái)運(yùn)行
minfds = 1024
minprocs = 200
environment = FLASK_ENV="win"

[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
serverurl = http://127.0.0.1:9001

# Flask 應(yīng)用配置
[program:flask-api]
directory = D:\flask-multi-api
command = D:\flask-multi-api\venv\Scripts\waitress-serve.exe --host=0.0.0.0 --port=5000 run:create_app('win')
autostart = true
autorestart = true
startretries = 3
stdout_logfile = D:\flask-multi-api\logs\flask-api.log
stdout_logfile_maxbytes = 50MB
stdout_logfile_backups = 10
redirect_stderr = true

mkdir D:\flask-multi-api\logs

# 生成默認(rèn)配置（可選）
echo_supervisord_conf > supervisord.conf
# 啟動(dòng)Supervisor
supervisord -c supervisord.conf
# 管理命令
supervisorctl -c supervisord.conf status  # 查看狀態(tài)
supervisorctl -c supervisord.conf start flask-api  # 啟動(dòng)應(yīng)用
supervisorctl -c supervisord.conf restart flask-api  # 重啟

# 進(jìn)入NSSM目錄
cd D:\nssm\win64
# 注冊(cè)服務(wù)（名稱：FlaskAPI）
nssm install FlaskAPI D:\flask-multi-api\venv\Scripts\python.exe
# 設(shè)置服務(wù)參數(shù)
nssm set FlaskAPI AppParameters "run.py win"
nssm set FlaskAPI AppDirectory D:\flask-multi-api
nssm set FlaskAPI Start SERVICE_AUTO_START  # 開機(jī)自啟
nssm set FlaskAPI AppStdout D:\flask-multi-api\logs\stdout.log
nssm set FlaskAPI AppStderr D:\flask-multi-api\logs\stderr.log

nssm start FlaskAPI  # 啟動(dòng)
nssm stop FlaskAPI   # 停止
nssm restart FlaskAPI # 重啟
nssm remove FlaskAPI confirm  # 卸載

# 查看5000端口占用
netstat -ano | findstr :5000
# 殺死占用進(jìn)程（PID替換為實(shí)際值）
taskkill /F /PID 1234

# 創(chuàng)建目錄
mkdir -p /opt/flask-multi-api
# 上傳項(xiàng)目（用scp/rz/git）
scp -r D:\flask-multi-api root@<LinuxIP>:/opt/
cd /opt/flask-multi-api

python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 直接啟動(dòng)（自動(dòng)識(shí)別Linux環(huán)境）
gunicorn -w 4 -b 0.0.0.0:5000 "run:create_app('prod')"

[program:flask-api]
directory=/opt/flask-multi-api
command=/opt/flask-multi-api/venv/bin/gunicorn -w 4 -b 0.0.0.0:5000 "run:create_app('prod')"
autostart=true
autorestart=true
user=root
stdout_logfile=/var/log/flask-api.log

supervisorctl reload
supervisorctl start flask-api

# 基礎(chǔ)鏡像（跨平臺(tái)兼容）
FROM python:3.9-slim

# 設(shè)置工作目錄
WORKDIR /app

# 環(huán)境變量（生產(chǎn)環(huán)境）
ENV PYTHONDONTWRITEBYTECODE=1
ENV PYTHONUNBUFFERED=1
ENV FLASK_ENV=prod

# 安裝系統(tǒng)依賴
RUN apt update && apt install -y --no-install-recommends gcc \
    && rm -rf /var/lib/apt/lists/*

# 復(fù)制依賴清單
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 復(fù)制所有多文件代碼（關(guān)鍵：保留目錄結(jié)構(gòu)）
COPY . .

# 暴露端口
EXPOSE 5000

# 啟動(dòng)命令（多文件入口）
CMD ["gunicorn", "-w", "4", "-b", "0.0.0.0:5000", "run:create_app('prod')"]

docker build -t flask-multi-api:v1 .

# Windows/Linux 通用命令
docker run -d \
  --name flask-multi-api \
  -p 5000:5000 \
  --restart=always \
  -v /var/log/flask-api:/app/logs \  # 掛載日志（Linux）
  # Windows 掛載日志：-v D:\flask-multi-api\logs:/app/logs
  flask-multi-api:v1

version: '3.8'
services:
  flask-api:
    build: .
    ports:
      - "5000:5000"
    restart: always
    volumes:
      - ./logs:/app/logs  # 掛載日志（跨平臺(tái)）
    environment:
      - FLASK_ENV=prod
    networks:
      - flask-network

networks:
  flask-network:
    driver: bridge

# Windows
docker-compose up -d
# Linux
docker-compose up -d

pywin32>=306 ; sys_platform == "win32"
gunicorn==21.2.0 ; sys_platform != "win32"
waitress==2.1.2 ; sys_platform == "win32"

# 無 __init__.py 的情況（普通文件夾）
flask-api/
└── app/          # 普通文件夾，無法 import
    ├── user.py
    └── order.py

# 導(dǎo)入報(bào)錯(cuò)（Python 不識(shí)別 app 為包）
from app import user  # ModuleNotFoundError: No module named 'app'

# 有 __init__.py 的情況（包）
flask-api/
└── app/          # Python 包
    ├── __init__.py  # 空文件也生效
    ├── user.py
    └── order.py

# 導(dǎo)入成功
from app import user
from app.user import user_bp

# app/__init__.py
# 從子模塊導(dǎo)出核心對(duì)象
from app.user import user_bp
from app.order import order_bp
from app.utils.common import encrypt_password

# 定義 __all__（配合 from app import * 時(shí)生效）
__all__ = ["user_bp", "order_bp", "encrypt_password"]

# 外部導(dǎo)入（簡(jiǎn)化前）
from app.user import user_bp
from app.order import order_bp
from app.utils.common import encrypt_password

# 外部導(dǎo)入（簡(jiǎn)化后）
from app import user_bp, order_bp, encrypt_password
# 或
from app import *  # 僅導(dǎo)入 __all__ 中的對(duì)象

# app/__init__.py
from flask import Flask
import os

# 包導(dǎo)入時(shí)自動(dòng)執(zhí)行的初始化邏輯
def create_app(env: str = None):
    app = Flask(__name__)
    
    # 加載配置
    env = env or os.getenv("FLASK_ENV", "dev")
    if env == "prod":
        app.config.from_object("app.config.prod")
    else:
        app.config.from_object("app.config.dev")
    
    # 統(tǒng)一注冊(cè)所有藍(lán)圖（無需在 run.py 中逐個(gè)導(dǎo)入）
    from app.user import user_bp
    from app.order import order_bp
    app.register_blueprint(user_bp, url_prefix="/api/user")
    app.register_blueprint(order_bp, url_prefix="/api/order")
    
    return app

# 可選：初始化數(shù)據(jù)庫(kù)連接（全局生效）
from app.utils.db import init_db
init_db()

# run.py（只需導(dǎo)入 create_app，無需關(guān)心內(nèi)部模塊）
from app import create_app

app = create_app()
app.run()

# 問題場(chǎng)景：循環(huán)導(dǎo)入
# app/user.py
from app.utils.db import db  # 導(dǎo)入 db
db.add_user(...)

# app/utils/db.py
from app.user import user_bp  # 又導(dǎo)入 user_bp → 循環(huán)導(dǎo)入報(bào)錯(cuò)

# 解決方案：在 __init__.py 中延遲導(dǎo)入
# app/__init__.py
def create_app():
    app = Flask(__name__)
    
    # 延遲導(dǎo)入（直到函數(shù)調(diào)用時(shí)才導(dǎo)入，避免初始化時(shí)循環(huán)）
    from app.user import user_bp
    from app.utils.db import init_db
    
    init_db(app)  # 把 app 傳入 db 模塊，避免 db 導(dǎo)入 user
    app.register_blueprint(user_bp)
    return app

# app/__init__.py
__version__ = "1.0.0"
__author__ = "xxx"
__description__ = "Flask 多文件 API 項(xiàng)目"

# 外部獲取元數(shù)據(jù)
import app
print(app.__version__)  # 1.0.0
print(app.__author__)   # xxx