python-adminui 的安装和配置教程

项目基础介绍

python-adminui 是一个使用 Python 语言编写的开源项目，旨在帮助开发者快速构建专业的 Web 界面。它适用于数据项目、工具和脚本、小型 IT 系统和管理系统等场景。项目基于 Flask/FastApi 框架，并且前端采用了 Ant Design Pro 设计语言。

项目使用的关键技术和框架

• 后端框架: Flask/FastApi，这两个都是流行的 Python Web 框架，支持快速开发和部署 Web 应用。
• 前端框架: Ant Design Pro，这是一个基于 React 的 UI 设计语言，提供了一系列高质量的 React 组件。
• 认证系统: 使用 JWT（JSON Web Token）实现用户认证和登录。
• 数据库: 项目设计为数据库无关，可以与各种数据库系统（如 MySQL、SQLite、Excel、Firebase 或 IoT 硬件）配合使用。

项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已经安装了以下软件：

• Python（建议版本 3.6 及以上）
• Node.js（建议版本 12.0 及以上）
• npm（Node.js 的包管理工具）

详细安装步骤

步骤 1：安装 Python 包

首先，使用 pip 命令安装 python-adminui 包：

pip install adminui

步骤 2：创建一个简单的 Flask 应用

在您的项目文件夹中，创建一个新的 Python 文件，例如 app.py，并写入以下基本代码：

from adminui import *

app = AdminApp()

def on_submit(form_data):
    print(form_data)

@app.page('/', 'form')
def form_page():
    return [
        Form(on_submit=on_submit, content=[
            TextField('Title', required_message="标题是必须的！"),
            TextArea('描述'),
            FormActions(content=[
                SubmitButton('提交')
            ])
        ])
    ]

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

步骤 3：运行 Flask 应用

在命令行中，运行以下命令来启动应用：

python app.py

步骤 4：安装前端依赖并启动

在项目根目录下，打开一个新的命令行窗口，执行以下命令安装前端依赖：

npm install

接着，启动前端服务：

npm start

步骤 5：访问应用

在浏览器中输入 http://127.0.0.1:5000/，您应该能够看到由 python-adminui 生成的表单页面。

以上步骤即为 python-adminui 的基础安装和配置流程。您可以进一步根据项目需求进行更多配置和定制。