Flask-ResponseBuilder 2.0.0

Implementations of flask response in many formats

Implementations of flask response in many formats: base64, csv, json, xml, html, yaml. You can create your own builder extending Builder class and registering it with register_builder method.

Every builders are registered as attribute of ResponseBuilder class so you can invoke method from this class with builder’s name and it automatically create a response with that builder.

Also you can used Builder without response by invoking static methods: to_me, to_dict.

Based on PyYAML, xmltodict, dicttoxml. See their documentation for other options.

• Decorator for http response status 204 NO_CONTENT

• Response based on Accept header of request

• Response based on format parameter (query string)

• template_or_json: response based on xhr request (deprecated: works only with old js library)

• Support for case notation checker and converter, see Case utility class.

Quickstart

Install flask_response_builder using pip:

$ pip install Flask-ResponseBuilder

Then import it into your project:

$ from flask_response_builder import ResponseBuilder

Example usage

app = Flask(__name__)
app.config['RB_HTML_DEFAULT_TEMPLATE'] = 'response.html'
rb = ResponseBuilder(app)

@_app.route('/nocontent')
@ResponseBuilder.no_content
def nocontent():
    pass

@_app.route('/xhr')
@rb.template_or_json('response.html')
def test_xhr():
    return data

@_app.route('/onaccept')
@rb.on_accept(acceptable=['application/json', 'application/xml'])
def test_accept():
    return data

@_app.route('/format')
@rb.on_format()
def test_format():
    return data

@_app.route('/decorator')
@rb.response('json')
def test_decorator():
    return data, 200, {'header': 'header'}

For advanced example usage see test.py file.

Configuration

1. RB_DEFAULT_RESPONSE_FORMAT: (default: ‘application/json’)

2. RB_DEFAULT_ACCEPTABLE_MIMETYPES: (default: a list of all supported mimetypes)

3. RB_DEFAULT_ENCODE: (default: ‘utf-8’)

4. RB_DEFAULT_DUMP_INDENT: (default: None)

5. RB_FORMAT_KEY: (default: ‘format’)

6. RB_BASE64_ALTCHARS: (default: None)

7. RB_HTML_DEFAULT_TEMPLATE: (default: None)

8. RB_HTML_AS_TABLE: (default: True)

9. RB_YAML_ALLOW_UNICODE: (default: True)

10. RB_CSV_DEFAULT_NAME: (default: ‘filename’)

11. RB_CSV_DELIMITER: (default: ‘;’)

12. RB_CSV_QUOTING_CHAR: (default: ‘”’)

13. RB_CSV_DIALECT: (default: ‘excel-tab’)

14. RB_XML_CDATA: (default: False)

15. RB_XML_ROOT: (default: ‘ROOT’)

16. RB_FLATTEN_PREFIX: (default: ‘’)

17. RB_FLATTEN_SEPARATOR: (default: ‘_’)

License MIT