Metadata-Version: 2.4
Name: fastapi-role
Version: 0.1.0.dev1
Summary: Role-Based Access Control (RBAC) library for FastAPI applications, powered by Casbin.
Project-URL: Homepage, https://github.com/alaamer12/fastapi-role
Project-URL: Documentation, https://github.com/alaamer12/fastapi-role#readme
Project-URL: Repository, https://github.com/alaamer12/fastapi-role
Project-URL: Issues, https://github.com/alaamer12/fastapi-role/issues
Author-email: Alaamer <ahmedmuhmmed239@gmail.com>
License: MIT
License-File: LICENSE
Keywords: authorization,casbin,fastapi,rbac,role-based-access-control,security
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Security
Classifier: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: casbin
Requires-Dist: fastapi
Requires-Dist: platformdirs
Requires-Dist: pydantic
Requires-Dist: pydantic-settings
Requires-Dist: sqlalchemy
Requires-Dist: uvicorn
Description-Content-Type: text/markdown

# fastapi-role (Core Library)

**fastapi-role** is a flexible, pluggable Role-Based Access Control library for FastAPI applications, powered by [Casbin](https://casbin.org/).

## Features

*   **🔒 Decorator-based Security**: Secure endpoints with `@require`.
*   **🛠️ Framework Agnostic**: Works with *any* User model via Protocol.
*   **🧩 Pluggable Architecture**: Customize Policy Storage, Role Extraction, etc.
*   **🔄 Sync & Async Support**: Full SQLAlchemy support.
*   **📦 Zero-Config Defaults**: Works out of the box.

## Installation

```bash
pip install fastapi-role
```

## Documentation

Full documentation is available in the [GitHub Repository](https://github.com/alaamer12/fastapi-role).

## Usage

See the [Quick Start](https://github.com/alaamer12/fastapi-role#quick-start) guide on the main repository.

## License

MIT License
