=================
Falcon API Browse
=================
This project provides a middleware for `Falcon Web Framework
<https://falcon.readthedocs.io/en/stable/index.html>`_ that will render the
response in an HTML form for documentation purpose. It uses the docstring from
the Resource object and all the supported HTTP methods for the resource.
It is inspired by Django Rest Framework's `Browsable API
<https://www.django-rest-framework.org/topics/browsable-api/>`_ and is written
using jinja2 templating language.
Installing
----------
This project is currently in early stages of development. Once it is stable
enough to be used by other projects, it will be provided via PyPI.
::
pip install git+https://github.com/maxking/falcon-api-browse
Using
-----
Since this is a middleware for Falcon, you can use it by passing an initialized
instance during Falcon App creation.
::
from falcon import App
from falcon_api_browse import HTMLResponseMiddleware
app = App(middleware=HTMLResponseMiddleware())
Examples
--------
There are some runnable examples in `examples/ <examples/>`_ directory.
LICENSE
-------
This project and contents of this repo are licensed under Apache 2.0 License.
Raw data
{
"_id": null,
"home_page": "https://github.com/maxking/falcon-api-browse",
"name": "falcon-api-browse",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "falcon",
"author": "Abhilash Raj",
"author_email": "raj.abhilash1@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/b5/8f/8986f94fbe4cd73ed746177e94c3c7b77ebd0683259f98c4c918afe74105/falcon_api_browse-0.1.1.tar.gz",
"platform": null,
"description": "=================\nFalcon API Browse\n=================\n\nThis project provides a middleware for `Falcon Web Framework\n<https://falcon.readthedocs.io/en/stable/index.html>`_ that will render the\nresponse in an HTML form for documentation purpose. It uses the docstring from\nthe Resource object and all the supported HTTP methods for the resource.\n\nIt is inspired by Django Rest Framework's `Browsable API\n<https://www.django-rest-framework.org/topics/browsable-api/>`_ and is written\nusing jinja2 templating language.\n\nInstalling\n----------\n\nThis project is currently in early stages of development. Once it is stable\nenough to be used by other projects, it will be provided via PyPI.\n\n::\n\n pip install git+https://github.com/maxking/falcon-api-browse\n\nUsing\n-----\n\nSince this is a middleware for Falcon, you can use it by passing an initialized\ninstance during Falcon App creation.\n\n::\n\n from falcon import App\n from falcon_api_browse import HTMLResponseMiddleware\n\n app = App(middleware=HTMLResponseMiddleware())\n\n\nExamples\n--------\n\nThere are some runnable examples in `examples/ <examples/>`_ directory.\n\nLICENSE\n-------\n\nThis project and contents of this repo are licensed under Apache 2.0 License.\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Middleware for Falcon web framework to browse JSON API in HTML",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/maxking/falcon-api-browse",
"Repository": "https://github.com/maxking/falcon-api-browse"
},
"split_keywords": [
"falcon"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "69063f42e582e80d5f4eabdf2782b7bf58928187fc17e8b569412a44d9905e99",
"md5": "748532f27392e9bfad216a9441fa2027",
"sha256": "ac84a98929abc2ac58cc3a2f9ee2c243437cab3a96f5aa72daba6d30d1252e53"
},
"downloads": -1,
"filename": "falcon_api_browse-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "748532f27392e9bfad216a9441fa2027",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 8162,
"upload_time": "2023-07-02T04:58:40",
"upload_time_iso_8601": "2023-07-02T04:58:40.608146Z",
"url": "https://files.pythonhosted.org/packages/69/06/3f42e582e80d5f4eabdf2782b7bf58928187fc17e8b569412a44d9905e99/falcon_api_browse-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b58f8986f94fbe4cd73ed746177e94c3c7b77ebd0683259f98c4c918afe74105",
"md5": "b2fc66328fbfff7fe520008f49b5004b",
"sha256": "3e8589ccaa0a5d5a2380ae020696be7fa8e267d3893a6be446f53b9315b3b91c"
},
"downloads": -1,
"filename": "falcon_api_browse-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "b2fc66328fbfff7fe520008f49b5004b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 6811,
"upload_time": "2023-07-02T04:58:41",
"upload_time_iso_8601": "2023-07-02T04:58:41.893854Z",
"url": "https://files.pythonhosted.org/packages/b5/8f/8986f94fbe4cd73ed746177e94c3c7b77ebd0683259f98c4c918afe74105/falcon_api_browse-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-02 04:58:41",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "maxking",
"github_project": "falcon-api-browse",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "falcon-api-browse"
}
JSON
