/autoboot-web

Web starter build with autoboot and FastAPI

Primary LanguagePythonMIT LicenseMIT

autoboot web starter

基于 autoboot 框架的插件机制扩展,集成了FastAPI框架,专注于web开发方向。

Version Python Downloads License

Quick Start

Install

pip install autoboot-web

Usage

配置

  • 启动配置文件.env
# 环境名称(默认值:dev,框架根据这个配置项来加载当前的环境配置)
ENV_NAME=dev

APPLICATION_NAME=web-runner
  • 环境配置文件.env.dev
APPLICATION_NAME=web-runner-dev
  • 主配置文件autoboot.yaml
autoboot:
  application:
    name: !env $APPLICATION_NAME
    module: api

  web:
    http:
      gzip:
        enable: true
        # 小于1KB不压缩
        minimum_size: 1KB
      session:
        enable: true
        cookie_name: "session_id"
        max_age: 120m
    security:
      cors:
        cross_origin: true

    # 扫描控制器包
    scan_controller_packages:
      - controller

创建目录controller

  • 在该目录下创建__init__.py
from .controller import IndexController

__all__=["IndexController"]
  • 在该目录创建index.py
from autoboot_web.mvc.annotation import Controller, Get


@Controller(path="/", tag="index")
class IndexController:
  
  @Get("/")
  def index(self, name):
    return f"Hello: {name}"

创建并启动容器

  • 创建main.py
from autoboot import AutoBoot, AutoBootConfig
from autoboot_web import WebRunner

context = Autoboot(AutoBootConfig(config_dir="."))
# 注册插件
context.apply(WebRunner())
# 暴露插件的Runner到全局变量(FastAPI使用的unicorn启动时会用到)
app = context.run(lambda: WebRunner.get_context())

# 其它使用 FastAPI 实例 app 的代码
# ...

启动服务器

uvicorn example.main:app --host 127.0.0.1 --port 8000 --env-file .env

Contributors

有问题可以在issues开话题讨论,如果你有新的想法,创建新的featpref分支并提交PR。

License

MIT License