async-asgi-testclient

KO | EN

gitlite — search

#javascript #python #react #golang #android #rust #deep-learning #linux #nodejs #awesome #cli #awesome-list #ios #openai

async-asgi-testclient

(★ 161)

A framework-agnostic library for testing ASGI web applications

File Explorer

Download Latest Version (.zip)

- - test_testing.py
- __init__.py
- compatibility.py
- multipart.py
- response.py
- testing.py
- utils.py
- websocket.py
.coveragerc
.gitignore
.isort.cfg
.travis.yml
CHANGELOG.md
LICENSE
MANIFEST.in
README.md
requirements.txt
setup.cfg
setup.py
test-requirements.txt

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# 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

async-asgi-testclient

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

async-asgi-testclient

File Explorer

Today's picks

Was this content helpful?

Recent Feedback

Download README