Metadata-Version: 2.1
Name: fastapi-sessions
Version: 0.1.0
Summary: Ready-to-use session cookies with custom backends for FastAPI
Home-page: https://github.com/jordanisaacs/fastapi-sessions
License: MIT
Keywords: sessions,cookies,authorization,fastapi
Author: Jordan Isaacs
Requires-Python: >=3.6
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.63.0,<0.64.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: itsdangerous (>=1.1.0,<2.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[standard] (>=0.13.4,<0.14.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/)

---

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


## Features

- [x] Dependency injection to protect the routes you want
- [x] Timestamp signed session IDs with [itsdangerous](https://itsdangerous.palletsprojects.com/en/1.1.x/)
- [x] Compabitibility with OpenAPI docs using [APIKeyCookie](https://swagger.io/docs/specification/authentication/cookie-authentication/)
- [x] Pydantic models for verifying session data
- [x] Abstract session backend so you can build one that fits your needs
- [x] Currently included backends
    - [x] In memory

Notes:

* Currently working on CSRF tokens
* Plan is to implement more backends

## Installation

```py
pip install fastapi-sessions
```

## Guide

Check out the guide to building and using session based authentication with fastapi-sessions: [https://jordanisaacs.github.io/fastapi-sessions/guide/getting_started/]()

