{ "info": { "author": "Jakub Tes\u00e1rek", "author_email": "jakub@tesarek.me", "bugtrack_url": null, "classifiers": [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", "License :: OSI Approved :: Apache Software License" ], "description": "DBGR: HTTP client that gives you full control\n=============================================\n\n|PyPI version| |License| |Build Status| |Code Coverage| |Documentation Status|\n\n.. |PyPI version| image:: https://badge.fury.io/py/dbgr.svg\n :target: https://badge.fury.io/py/dbgr\n.. |License| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg\n :target: https://opensource.org/licenses/Apache-2.0\n.. |Build Status| image:: https://travis-ci.org/JakubTesarek/dbgr.svg?branch=master\n :target: https://travis-ci.org/JakubTesarek/dbgr\n.. |Code Coverage| image:: https://codecov.io/gh/JakubTesarek/dbgr/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/JakubTesarek/dbgr\n.. |Documentation Status| image:: https://readthedocs.org/projects/dbgr/badge/?version=latest\n :target: https://dbgr.readthedocs.io/en/latest/?badge=latest\n\nDbgr [read '\u02ccdi\u02d0\u02c8b\u028c\u0261\u0259r'] is a interactive terminal tool to test and debug HTTP APIs.\nIt offers alternative to Postman_, Insomnia_ and other HTTP clients. It is designed\nfor programmers that prefer to use code instead of graphical tools and want full control\nover their HTTP requests.\n\n.. _postman: https://www.getpostman.com/\n.. _insomnia: https://insomnia.rest/\n\n `Full documentation can be found on Read the Docs`_\n\n.. _`full documentation can be found on read the docs`: https://dbgr.readthedocs.io/en/latest/\n\nFeatures\n--------\n- `Terminal interface with autocomplete and bash history`_\n- `Full control over your requests with Python`_\n- `Recursive calls`_\n- `Local caching of responses`_\n- `Customizable interface`_\n\n.. _`Terminal interface with autocomplete and bash history`: https://dbgr.readthedocs.io/en/latest/terminal-interface.html\n.. _`Full control over your requests with Python`: https://dbgr.readthedocs.io/en/latest/requests.html#requests\n.. _`Recursive calls`: https://dbgr.readthedocs.io/en/latest/recursive-calls.html#recursive-calls\n.. _`Local caching of responses`: https://dbgr.readthedocs.io/en/latest/caching.html\n.. _`Customizable interface`: https://dbgr.readthedocs.io/en/latest/types.html#types\n\n|screencast|\n\n.. |screencast| image:: https://asciinema.org/a/uNs262JVwxY2d1BGZTdRvDsWH.svg\n :alt: DBGR Basic Usage Example\n :target: https://asciinema.org/a/uNs262JVwxY2d1BGZTdRvDsWH\n\nInstallation\n------------\nThe easiest way to install DBGR is via PyPi_:\n\n.. _pypi: https://pypi.org/project/dbgr/\n\n.. code-block:: bash\n\n $ pip install dbgr\n $ dbgr -v\n 1.1.0\n\nDBGR requires Python >=3.6.\n\nQuick Start\n-----------\nFirst step when working with DBGR is to create a directory which will DBGR search\nfor requests and environment settings.\n\n You can also `download the quickstart from Github`_.\n\n.. _download the quickstart from github: https://github.com/JakubTesarek/dbgr/tree/master/examples/quickstart\n\n\n.. code-block:: bash\n\n $ mkdir quickstart\n $ cd quickstart\n\nInside create your default environment file ``default.ini``. For now just place\na section header inside:\n\n.. code-block:: ini\n\n [default]\n\nNow create another file, call it ``quickstart.py`` and place create your first request:\n\n.. code-block:: python\n\n from dbgr import request\n\n @request\n async def get_example(session):\n await session.get('http://example.com')\n\nYou can check that DBGR registered the request by running ``dbgr list``:\n\n.. code-block:: bash\n\n $ dbgr list\n quickstart:\n - get_example\n\nTo execute it, run ``dbgr request get_example``:\n\n.. code-block:: bash\n\n # Output in this example is shortened\n > GET http://example.com\n > 200 OK\n >\n > Request headers:\n > Host: example.com\n > Accept: */*\n > Accept-Encoding: gzip, deflate\n > User-Agent: Python/3.6 aiohttp/3.5.4\n <\n < Response headers:\n < Content-Encoding: gzip\n < Accept-Ranges: bytes\n < Cache-Control: max-age=604800\n < Content-Type: text/html; charset=UTF-8\n < Date: Sun, 16 Jun 2019 15:29:41 GMT\n < Last-Modified: Fri, 09 Aug 2013 23:54:35 GMT\n < Content-Length: 606\n <\n < Response data (text/html):\n \n \n
\nThis domain is established to be used for illustrative examples in documents. You may use this\n domain in examples without prior coordination or asking for permission.
\n \n