from flask import Flask
from flask_script import Manager, Command
from loguru import logger
# [ 生成一個 Flask 實例 ]
app = Flask(__name__)  
# [ Manager 構造方法，只接受一個參數(shù)，
# 就是 Flask 實例，Manager 負責追蹤整個 命令 的處理過程 ]
manager = Manager(app)  

# 定義要執(zhí)行的命令類型 Hello 繼承 Command
class Hello(Command):
    # 重寫 Command 類的 run() 方法
    def run(self):  
        ''' 要執(zhí)行的命令 '''
        logger.info('sub class of Command')  
if __name__ == '__main__':
    '''
    將 hello 命令加入到 manager ，
    第一個參數(shù)為自己起的的命令簡稱，
    第二個參數(shù)為 Command 子類 Hello 的實例
    '''
    manager.add_command('hello', Hello())  
    manager.run()

'''
@manager.command 其實 manager 就是上面初始化出來的 Manager 類的實例，
如果 Manager 類的實例名稱為 manager_1 ，則裝飾器也要改成 @manager_1.command
'''
'''
使用 裝飾器 @manager.command 后，命令的簡稱就是 函數(shù)的名字 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()  

'''
-u 為命令參數(shù)的 簡寫，--username 為命令參數(shù)的 全稱
（類似于 Linux 命令的參數(shù)，參數(shù)簡寫 為一個 -，參數(shù)全稱為 -- ），
無論是參數(shù)的 簡寫、還是 全稱 都必須以 - 開頭，但是 全稱也可以只以 一個 - 開頭，
但建議以 兩個 - 開頭，因為更符合編碼規(guī)范，dest 的值必須與 hello_option 函數(shù)（也就是命令）的 入參名
稱 完全相同，因為 dest 就是表示這個參數(shù)值，傳遞給 hello_option 命令函數(shù)的那個入參的；default 表示
參數(shù)的默認值，也就是如果執(zhí)行 python manager.py hello_option 執(zhí)行命令時，不帶參數(shù)，就用參數(shù)的默認
值
'''
@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 實例中了
    '''
    manager.run()