Metadata-Version: 2.1
Name: fastapi-sessions
Version: 0.3.0
Summary: Ready-to-use session library for FastAPI
Home-page: https://github.com/jordanisaacs/fastapi-sessions
License: MIT
Keywords: sessions,cookies,authorization,fastapi
Author: Jordan Isaacs
Requires-Python: >=3.6.1,<4.0
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
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: Topic :: Internet :: WWW/HTTP :: Session
Provides-Extra: dev
Provides-Extra: docs
Requires-Dist: black (>=20.8b1,<21.0); extra == "dev"
Requires-Dist: fastapi (>=0.65.1,<0.66.0)
Requires-Dist: flake8 (>=3.9.0,<4.0.0); extra == "dev"
Requires-Dist: flake8-docstrings (>=1.6.0,<2.0.0); extra == "dev"
Requires-Dist: isort[dev] (>=5.9.3,<6.0.0)
Requires-Dist: itsdangerous (>=2.0.1,<3.0.0)
Requires-Dist: markdown-include (>=0.6.0,<0.7.0); extra == "docs"
Requires-Dist: mkdocs-material (>=7.1.0,<8.0.0); extra == "docs"
Requires-Dist: pytest (>=6.2.3,<7.0.0); extra == "dev"
Requires-Dist: uvicorn (>=0.14.0,<0.15.0); extra == "dev"
Project-URL: Documentation, https://jordanisaacs.github.io/fastapi-sessions/
Description-Content-Type: text/markdown

# FastAPI-Sessions


---

Documentation: [https://jordanisaacs.github.io/fastapi-sessions/](https://jordanisaacs.github.io/fastapi-sessions/)

Source Code: [https://github.com/jordanisaacs/fastapi-sessions/](https://github.com/jordanisaacs/fastapi-sessions/)

PyPI: [https://pypi.org/project/fastapi-session/](https://pypi.org/project/fastapi-session/)

---

Quickly add session authentication to your FastAPI project. **FastAPI Sessions** is designed to be user friendly and customizable.


## Features

- [x] Dependency injection to protect routes
- [x] Compatible with FastAPI's auto generated docs
- [x] Pydantic models for verifying session data
- [x] Abstract session backend so you can build one that fits your needs
- [x] Abstract frontends to choose how you extract the session ids (cookies, header, etc.)
- [x] Create verifiers based on the session data
- [x] Mix and match frontends and backends

Currently Included Backends/Frontends:

- [x] Backends
    - [x] In memory dictionary
- [x] Frontends
    - [x] Signed cookies


Upcoming:

* Documentation and user guides
* More backends and frontends

## Installation

```python
pip install fastapi-sessions
```

## Getting Started

Check out the guide to using fastapi-sessions: [https://jordanisaacs.github.io/fastapi-sessions/guide/getting_started/](https://jordanisaacs.github.io/fastapi-sessions/guide/getting_started/)

