iti-flask-cli

iticli 是 iTi-Flask 框架项目和模板生成业务项目共用的命令行工具。

它是独立工具。 框架项目和新生成的业务项目都不需要内置 .sh / .cmd 脚本。

安装

私有 Git 安装：

uv tool install git+https://git.noahlan.cn/iti-framework/iti-flask-cli.git

或：

pipx install git+https://git.noahlan.cn/iti-framework/iti-flask-cli.git

本地开发安装：

cd iti-flask-cli
uv tool install -e .

项目识别

iticli 会从当前目录向上查找 pyproject.toml，并识别两类项目：

• 框架项目：project.name = "iti-flask"，且包含 iti/app.py、copier.yml。
• 业务项目：包含 main.py、app/、migrations/alembic.ini，且依赖 iti-flask。

create 不要求当前目录是项目目录。 默认从私有 Git 里的 iTi-Flask Copier 模板生成业务项目。

常用命令

iticli help
iticli install
iticli install dev
iticli install odbc
iticli test
iticli run dev 8000
iticli serve dev 8000
iticli run prod 8000
iticli migrate
iticli migrate heads
iticli migrate current
iticli migrate revision "alice add order table"

业务项目：

iticli update framework
iticli update system
iticli update all
iticli template check
iticli template update
iticli init
iticli init system
iticli docker build
iticli docker up
iticli docker up --db
iticli docker logs
iticli docker down

framework 和 system 独立更新。 带 iti-system 的业务项目会以项目顶层声明的 iti-flask 为准。

CLI 自身：

iticli update self

框架项目：

iticli release
iticli release v0.2.5

任意目录生成业务项目：

iticli create my-business-app
iticli create --with-system my-system-app

使用当前框架工作区作为模板源：

cd iTi-Flask
iticli create --local ../my-business-app

旧项目迁移

旧仓库或旧业务项目里如果还保留脚本，可以按下面迁移：

旧命令	新命令
./iti.sh install / ./app.sh install	iticli install
./iti.sh test / ./app.sh test	iticli test
./iti.sh serve 8000 / ./app.sh serve dev 8000	iticli run dev 8000 或 iticli serve dev 8000
./iti.sh migrate / ./app.sh migrate	iticli migrate
./iti.sh heads / ./app.sh heads	iticli migrate heads
./iti.sh current / ./app.sh current	iticli migrate current
./iti.sh migration "msg" / ./app.sh migration "msg"	iticli migrate revision "msg"
./iti.sh make-app ../app app	iticli create app
./iti.sh make-system-app ../app app	iticli create --with-system app
./iti.sh release	iticli release
./app.sh framework-sync	iticli update framework
./app.sh system-sync	iticli update system
./app.sh template-check	iticli template check
./app.sh template-update	iticli template update
./app.sh init	iticli init
./app.sh init-system	iticli init system
./app.sh docker-up	iticli docker up
./app.sh docker-up-db	iticli docker up --db

install odbc 会同步开发依赖，并把 pyodbc 安装进当前项目虚拟环境。 ODBC 系统驱动仍由操作系统或镜像负责安装。