"""
整个API的介绍，以@开头的YAML文本表示共享的数据格式

@message:
    hello?str: 欢迎信息
"""
from fighting import Fighting

app = Fighting(__name__)   # Fighting是Flask的子类


@app.res('resource')       # 添加路由，URL为'/resource/action'
def action(name):
    """
    文档字符串中，以$开头的YAML文本表示指令

    $input:
        name?str&default="world": 你的名字
    $output: @message
    """
    return {'hello': name}   # 自动序列化为JSON格式


if __name__ == '__main__':
    app.run(debug=True)

from fighting import abort

abort(message)  # 状态码为400，内容为"message"

def my_directive(f, meta, app):
    """
    自定义`$my`指令
    
    Args:
        f:    使用指令的函数
        meta: 指令附带的数据
        app:  Fighting对象
    """
    def view():
        pass
    return view
app = Fighting(__name__, directives={'name': my_directive})

def my_validator(*args, **kwargs):
    def validator(value):
        pass
    return validator
app = Fighting(__name__, validators={'name': my_validator})

from fighting import Res, ResError                  # 请求失败会抛出ResError

res = Res('http://127.0.0.1:5000/')                 # 设置URL前缀
data = res.post('resource/action', {'name': 'kk'})  # 发送请求
print(data)                                         # {'hello': 'kk'}