fastapi-scaff 0.3.0

This is a fastapi scaff.

fastapi-scaff

What is this?

• by: axiner
• fastapi-scaff
• This is a fastapi scaff.
  • new project
  • add api
  • about project:
    • auto init project (conf, db, log...)
    • auto register router
    • auto register middleware
    • ...
    • integrated sqlalchemy
    • integrated jwt\api-key
    • integrated celery
    • ...
  • more documents: 请点击链接

Project structure

• ASM: ASM模式

  • A api
  • S services(&schemas)
  • M models

• 调用过程: main.py(initializer) -> (middleware) - api - services(&schemas) - (models)

• 结构如下: (命名经过多次修改敲定，简洁易懂)

  └── fastapi-scaff
      ├── app                         (应用)
      │   ├── api                     ├── (api)
      │   │   └── v1                  │   └── (v1)
      │   ├── initializer             ├── (初始化)
      │   │   ├── conf                │   ├── (配置)
      │   │   ├── db                  │   ├── (数据库)
      │   │   ├── log                 │   ├── (日志)
      │   │   └── ...                 │   └── (...)
      │   ├── middleware              ├── (中间件)
      │   ├── models                  ├── (数据模型)
      │   ├── schemas                 ├── (数据结构)
      │   ├── services                ├── (业务逻辑)
      │   ├── utils                   ├── (utils)
      │   └── main.py                 └── (main.py)
      ├── app_celery                  (应用-celery)
      ├── config                      (配置目录)
      ├── deploy                      (部署目录)
      ├── docs                        (文档目录)
      ├── logs                        (日志目录)
      ├── tests                       (测试目录)
      ├── .gitignore
      ├── LICENSE
      ├── README.md
      ├── requirements.txt
      └── runcbeat.py
      └── runcworker.py
      └── runserver.py
  

• 【另：轻量版 > 完整结构 】请自行创建查看（new项目时指定参数--light）

Installation

This package can be installed using pip (Python>=3.11):

pip install fastapi-scaff

Scaff usage

• 1）help document
  • fastapi-scaff -h
• 2）new project
  • fastapi-scaff new <myproj>
  • light structure: fastapi-scaff new <myproj> --light
• 3）add api
  • cd to project root dir
  • fastapi-scaff add <myapi>

Project run

• 1）cd to project root dir
• 2）modify the configuration, such as for the database
• 3）pip install -r requirements.txt
• 4）python runserver.py
  • more parameters see:
    • about uvicorn: click here
    • about gunicorn: click here

License

This project is released under the MIT License (MIT). See LICENSE