Wanda 项目启动与配置教程

1. 项目目录结构及介绍

Wanda 项目的目录结构如下：

wanda/
├── apps/                  # 应用程序目录
│   ├── common/            # 公共模块
│   ├── web/               # Web 应用模块
│   └── api/               # API 应用模块
├── config/                # 配置文件目录
│   ├── default.py         # 默认配置文件
│   └── production.py      # 生产环境配置文件
├── data/                  # 数据存储目录
├── logs/                  # 日志目录
├── scripts/               # 脚本目录
├── templates/             # 模板文件目录
├── tests/                 # 测试代码目录
├── utils/                 # 工具模块
├── main.py                # 项目入口文件
└── requirements.txt       # 项目依赖文件

• apps/: 包含项目的所有应用模块。
• config/: 包含项目配置文件，包括默认配置和生产环境配置。
• data/: 用于存储项目所需的数据文件。
• logs/: 存储项目运行日志。
• scripts/: 包含项目运行过程中可能需要的脚本文件。
• templates/: 存储项目的模板文件，如 HTML、Jinja2 模板等。
• tests/: 包含项目测试代码。
• utils/: 包含项目通用的工具模块。
• main.py: 项目的主要入口文件，用于启动整个项目。
• requirements.txt: 列出项目依赖的第三方库。

2. 项目启动文件介绍

项目的启动文件为 main.py，其主要功能如下：

• 加载配置文件。
• 初始化应用程序。
• 设置数据库连接。
• 启动服务器，监听请求。

以下是 main.py 的简化示例代码：

from apps import create_app

app = create_app()

if __name__ == "__main__":
    app.run()

3. 项目配置文件介绍

项目配置文件位于 config/ 目录下，主要包括 default.py 和 production.py。

• default.py: 默认配置文件，适用于开发环境，其中包含了大部分的默认设置。
• production.py: 生产环境配置文件，包含了针对生产环境的特定配置，如数据库连接信息、日志设置等。

以下是 default.py 的简化示例：

import os

class Config:
    SECRET_KEY = os.environ.get('SECRET_KEY') or 'you-will-never-guess'
    DATABASE_URI = 'sqlite:///default.db'
    DEBUG = True
    # 其他配置项...

而 production.py 可能会这样配置：

from default import Config

class ProductionConfig(Config):
    DATABASE_URI = 'mysql://user:password@host/dbname'
    DEBUG = False
    # 其他生产环境配置项...

在实际使用时，可以根据环境变量或命令行参数来选择使用哪个配置文件。