Flask-ResponseBuilder

download version

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.
Transformer: utility class for data notation conversion

NOTE: From 2.1.11 the dicttoxml package seems to be abandoned, so a copy of module dicttoxml is ported in this package to fix deprecation warning, but if dicttoxml is installed it has priority. In future will be removed and the internal module will be improved.

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')
@rb.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

For every registered builder you can explicitly use them in two ways:

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

@_app.route('/csv')
def index_csv():
    builder = rb.csv(filename='file.csv')
    return builder((data, 200))

Configuration

RB_DEFAULT_RESPONSE_FORMAT: (default: ‘application/json’)

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

RB_DEFAULT_ENCODE: (default: ‘utf-8’)

RB_DEFAULT_DUMP_INDENT: (default: None)

RB_FORMAT_KEY: (default: ‘format’)

RB_BASE64_ALTCHARS: (default: None)

RB_HTML_DEFAULT_TEMPLATE: (default: None)

RB_HTML_AS_TABLE: (default: True)

RB_YAML_ALLOW_UNICODE: (default: True)

RB_CSV_DEFAULT_NAME: (default: ‘filename’)

RB_CSV_DELIMITER: (default: ‘;’)

RB_CSV_QUOTING_CHAR: (default: ‘”’)

RB_CSV_DIALECT: (default: ‘excel-tab’)

RB_XML_CDATA: (default: False)

RB_XML_ROOT: (default: ‘ROOT’)

RB_FLATTEN_PREFIX: (default: ‘’)

RB_FLATTEN_SEPARATOR: (default: ‘_’)

RB_JSONP_PARAM: (default: ‘callback’) if empty or None jsonp is disabled

License MIT

Metadata

Release files for Flask-ResponseBuilder 2.0.16

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for Flask-ResponseBuilder 2.0.16
File	Size	Uploaded
Flask-ResponseBuilder-2.0.16.tar.gz	15.6 kB	Oct 16, 2021	Details

Release files / Flask-ResponseBuilder-2.0.16.tar.gz

Download URL	Flask-ResponseBuilder-2.0.16.tar.gz
Size	15.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`920ec94bd5791c3db23d1d4a9c64657951e81d3156a0bf056c60ef4cd34ab317`
BLAKE2b-256 checksum How to use checksums	`c549ad618741557f04679f313b2b44e8b8c1303811de9a29fa62eddb1a77ad5a`
Upload date	Oct 16, 2021
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.4.2 importlib_metadata/4.8.1 pkginfo/1.7.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10`