Metadata-Version: 2.1
Name: bareasgi-cors
Version: 3.1.2
Summary: CORS support for bareasgi
Home-page: https://github.com/rob-blackbourn/bareasgi-cors
License: Apache-2.0
Author: Rob Blackbourn
Author-email: rob.blackbourn@gmail.com
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: bareasgi (>=3.5,<4.0)
Project-URL: Repository, https://github.com/rob-blackbourn/bareasgi-cors
Description-Content-Type: text/markdown

# bareASGI-cors

CORS support for [bareASGI](http://github.com/rob-blackbourn/bareasgi) (read the
[docs](https://rob-blackbourn.github.io/bareASGI-cors/))

## Usage

Simply create the `CORSMiddleware` class and put is as the first middleware.

```python
import json
import uvicorn
from bareasgi import (
    Application,
    text_reader,
    text_writer
)
from bareasgi_cors import CORSMiddleware

async def get_info(scope, info, matches, content):
    text = json.dumps(info)
    return 200, [(b'content-type', b'application/json')], text_writer(text)


async def set_info(scope, info, matches, content):
    text = await text_reader(content)
    data = json.loads(text)
    info.update(data)
    return 204, None, None

# Create the CORS middleware class
cors_middleware = CORSMiddleware()

# Use the CORS middleware as the first middleware.
app = Application(info={'name': 'Michael Caine'}, middlewares=[cors_middleware])

app.http_router.add({'GET'}, '/info', get_info)
app.http_router.add({'POST', 'OPTIONS'}, '/info', set_info)

uvicorn.run(app, port=9010)
```

## The POST method

In the above example an OPTION method is included with the POST. This
is always required with a POST as a browser will try first with an OPTION.

