# nginx-http-asgi-module

**Repository Path**: rim99/nginx-http-asgi-module

## Basic Information

- **Project Name**: nginx-http-asgi-module
- **Description**: It would allow ASGI python app running inside Nginx
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-10-02
- **Last Updated**: 2022-07-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# nginx-http-asgi-module

The `nginx-http-asgi-module` is to allow Python [ASGI](https://asgi.readthedocs.io/en/latest/introduction.html) apps to take advantage of the power of Nginx. Nginx is a high performance nonblocking server and contains a well-implemented event loop mechanism, which can be also used by Python's `asyncio` lib.

Currently, the module only supports HTTP protocal. The WebSocket protocal is not supported.

**Python Version**: CPython(3.9) 

## How to use 

This module is only take one parameter `asgi_app` at location config level. For example, inside the nginx config file:

```
...
    location /asgi_example {
        asgi_app example.py app 
    }

```

And in the `example.py`, it is holding an ASGI app in variable `app`.

```
app = SomeASGIAplication()
```

## LICENSE

MIT