Flask-Script 模块使用指南:命令创建与参数传递

陆遥
陆遥
发布时间:2026-10-14| 3人浏览过
原创

本文详细介绍 Flask-Script 模块的安装与核心用法。该模块允许通过命令行执行 Flask 脚本,如启动开发服务器或执行数据库操作。文章演示了三种创建命令的方式:继承 Command 子类、使用 @manager.command 装饰器以及使用 @manager.option 装饰器处理带参命令,帮助开发者构建灵活的 Flask 命令行工具。

1 作用

利用 flask-script 模块,开发者能够以命令行指令的形式来执行 Flask 相关的语句。

该模块提供了将外部脚本集成到 Flask 应用中的能力,例如启动开发服务器、运行交互式 Shell 或执行数据库迁移脚本等。

2 安装


pip install flask-script

3 所有要运行的命令都放在 manager.py 中


from flask import Flask
from flask_script import Manager, Command
from loguru import logger
 
# [ 生成一个 Flask 实例 ]
app = Flask(__name__)  
 
# [ Manager 构造方法,只接受一个参数,
# 就是 Flask 实例,Manager 负责追踪整个 命令 的处理过程 ]
manager = Manager(app)  

4 三种方式 创建命令

4.1 方式一 创建 Command子类


# 定义要执行的命令类型 Hello 继承 Command
class Hello(Command):
    # 重写 Command 类的 run() 方法
    def run(self):  
        ''' 要执行的命令 '''
        logger.info('sub class of Command')  
 
if __name__ == '__main__':
    '''
    将 hello 命令加入到 manager ,
    第一个参数为自己起的的命令简称,
    第二个参数为 Command 子类 Hello 的实例
    '''
    manager.add_command('hello', Hello())  
    manager.run()

在命令行终端执行 python manager.py hello [ hello 就是自己的 命令的简称 ]

这样就会打印出 sub class of Command

4.2 方式二 使用装饰器 @manager.command


'''
@manager.command 其实 manager 就是上面初始化出来的 Manager 类的实例,
如果 Manager 类的实例名称为 manager_1 ,则装饰器也要改成 @manager_1.command
'''
 
 
'''
使用 装饰器 @manager.command 后,命令的简称就是 函数的名字 hello_command,
在 __main__ 中 就不需要 在 通过 manager.add_command() 将 命令简称加入到 command 实例中了
'''
@manager.command
def hello_command(): 
    logger.info('@manager.command')
 
if __name__ == '__main__':
    '''
    在 __main__ 中 就不需要 在 通过 manager.add_command() 将 命令简称加入到 command 实例中了
    '''
    manager.run()  

在 cmd 执行 python manager.py hello_command [ hello_command 就是自己的 命令的简称 ]

这样就会打印出 @manager.command

4.3 方式三 使用装饰器 @manager.option


'''
-u 为命令参数的 简写,--username 为命令参数的 全称
(类似于 Linux 命令的参数,参数简写 为一个 -,参数全称为 -- ),
无论是参数的 简写、还是 全称 都必须以 - 开头,但是 全称也可以只以 一个 - 开头,
但建议以 两个 - 开头,因为更符合编码规范,dest 的值必须与 hello_option 函数(也就是命令)的 入参名
称 完全相同,因为 dest 就是表示这个参数值,传递给 hello_option 命令函数的那个入参的;default 表示
参数的默认值,也就是如果执行 python manager.py hello_option 执行命令时,不带参数,就用参数的默认
值
'''
@manager.option('-u', '--username', dest='username', default='zhangsan')  
@manager.option('-p', '--password', dest='password', default='123456')
def hello_option(username, password):
    logger.info('@manage.option')
    logger.info(f'username = {username}, password = {password}')
 
if __name__ == '__main__':
    '''
    在 __main__ 中 就不需要 在 通过 manager.add_command() 将 命令简称加入到 command 实例中了
    '''

到此这篇关于flask-script模块的具体使用的文章就介绍到这了,更多相关flask-script模块内容请搜索本站以前的文章或继续浏览下面的相关文章希望大家以后多多支持本站!

相关标签:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。