Metadata-Version: 2.1
Name: async-asgi-testclient
Version: 1.4.11
Summary: Async client for testing ASGI web applications
Home-page: https://github.com/vinissimus/async-asgi-testclient
Author: Jordi Masip
Author-email: jordi@masip.cat
License: MIT license
Description: # async-asgi-testclient
        
        [![Build Status](https://travis-ci.com/vinissimus/async-asgi-testclient.svg?branch=master)](https://travis-ci.com/vinissimus/async-asgi-testclient) [![PyPI version](https://badge.fury.io/py/async-asgi-testclient.svg)](https://badge.fury.io/py/async-asgi-testclient) ![](https://img.shields.io/pypi/pyversions/async-asgi-testclient.svg) [![Codcov](https://codecov.io/gh/vinissimus/async-asgi-testclient/branch/master/graph/badge.svg)](https://codecov.io/gh/vinissimus/async-asgi-testclient/branch/master) ![](https://img.shields.io/github/license/vinissimus/async-asgi-testclient)
        
        Async ASGI TestClient is a library for testing web applications that implements ASGI specification (version 2 and 3).
        
        The motivation behind this project is building a common testing library that doesn't depend on the web framework ([Quart](https://gitlab.com/pgjones/quart), [Startlette](https://github.com/encode/starlette), ...).
        
        It works by calling the ASGI app directly. This avoids the need to run the app with a http server in a different process/thread/asyncio-loop. Since the app and test run in the same asyncio loop, it's easier to write tests and debug code.
        
        This library is based on the testing module provided in [Quart](https://gitlab.com/pgjones/quart).
        
        ## Quickstart
        
        Requirements: Python 3.6+
        
        Installation:
        
        ```bash
        pip install async-asgi-testclient
        ```
        
        ## Usage
        
        `my_api.py`:
        ```python
        from quart import Quart, jsonify
        
        app = Quart(__name__)
        
        @app.route("/")
        async def root():
            return "plain response"
        
        @app.route("/json")
        async def json():
            return jsonify({"hello": "world"})
        
        if __name__ == '__main__':
            app.run()
        ```
        
        `test_app.py`:
        ```python
        from async_asgi_testclient import TestClient
        
        import pytest
        
        @pytest.mark.asyncio
        async def test_quart_app():
            from .my_api import app
        
            async with TestClient(app) as client:
                resp = await client.get("/")
                assert resp.status_code == 200
                assert resp.text == "plain response"
        
                resp = await client.get("/json")
                assert resp.status_code == 200
                assert resp.json() == {"hello": "world"}
        ```
        
        ## Supports
        
         - [X] cookies
         - [X] multipart/form-data
         - [X] follow redirects
         - [X] response streams
         - [X] request streams
         - [X] websocket support
        
Keywords: async asgi testclient
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
