Metadata-Version: 2.1
Name: falcon-crossorigin
Version: 1.0.0
Summary: Falcon cross-origin middleware
Home-page: https://github.com/alexferl/falcon-crossorigin
Author: Alexandre Ferland
Author-email: me@alexferl.com
License: MIT
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: falcon >=2.0.0

# falcon-crossorigin [![codecov](https://codecov.io/gh/alexferl/falcon-crossorigin/branch/master/graph/badge.svg)](https://codecov.io/gh/alexferl/falcon-crossorigin)

A simple [Falcon](https://github.com/falconry/falcon) module for Cross-Origin Resource Sharing (CORS).


## Install
```shell script
pip install falcon-crossorigin
```

## Usage
```python
import falcon
from falcon_crossorigin import CrossOrigin

cross_origin = CrossOrigin(
    allow_origins="https://app.example.com",
    allow_methods="GET,POST",
    allow_headers="Pragma,Expires,Cache-Control",
    allow_credentials=True,
    expose_headers="Link",
    max_age=3600,
)

api = falcon.API(middleware=[cross_origin])
```

## Credits
Port of [Echo's](https://github.com/labstack/echo) [CORS middleware](https://github.com/labstack/echo/blob/1f6cc362cc91b22e5889b2674e45cf3545d6ee21/middleware/cors.go).
