# Cezzis OAuth

[![Python Version](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI version](https://img.shields.io/pypi/v/cezzis-oauth-fastapi.svg)](https://pypi.org/project/cezzis-oauth-fastapi/)
[![CI/CD](https://github.com/mtnvencenzo/cezzis-pycore/actions/workflows/cezzis-oauth-fastapi-cicd.yaml/badge.svg)](https://github.com/mtnvencenzo/cezzis-pycore/actions/workflows/cezzis-oauth-fastapi-cicd.yaml)

A lightweight, production-ready Python library for OAuth 2.0 authentication. Provides both **token acquisition** and **JWT verification** with enterprise-grade features including automatic token caching, refresh management, JWKS-based verification, and scope validation.

## 🚀 Installation

Install `cezzis-oauth-fastapi` from PyPI:

```bash
pip install cezzis-oauth-fastapi
```

Or using Poetry:

```bash
poetry add cezzis-oauth-fastapi
```

## 📋 Requirements

- Python 3.12 or higher

## 📖 Documentation & Examples

Complete documentation, examples, and guides are available in the GitHub repository:

[Full Documentation & Examples](https://github.com/mtnvencenzo/cezzis-pycore/blob/main/cezzis-oauth-fastapi/README.md)


## 📄 License

This project is licensed under the MIT License. See the [LICENSE](https://github.com/mtnvencenzo/cezzis-pycore/blob/main/LICENSE) file for details.

---

