Metadata-Version: 2.1
Name: Flask-ResponseBuilder
Version: 2.0.3
Summary: Implementations of flask response in many format notation
Home-page: https://github.com/cs91chris/flask_response_builder
Author: cs91chris
Author-email: cs91chris@voidbrain.me
License: MIT
Platform: any
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: Flask (==1.0.2)
Requires-Dist: PyYAML (==5.1)
Requires-Dist: xmltodict (==0.12.0)
Requires-Dist: dicttoxml (==1.7.4)

Flask-ResponseBuilder
=====================

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

Quickstart
~~~~~~~~~~

Install ``flask_response_builder`` using ``pip``:

::

   $ pip install Flask-ResponseBuilder

Then import it into your project:

::

   $ from flask_response_builder import ResponseBuilder


.. _section-1:

Example usage
^^^^^^^^^^^^^

.. code:: python

    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

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


For advanced example usage see ``test.py`` file.

.. _section-2:

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


