https://github.com/arthurio/fastapi-filter

Filter and order your endpoints
https://github.com/arthurio/fastapi-filter

fastapi filter python

Last synced: 7 days ago
JSON representation

Filter and order your endpoints

• Host: GitHub
• URL: https://github.com/arthurio/fastapi-filter
• Owner: arthurio
• License: mit
• Created: 2022-05-14T06:07:23.000Z (almost 3 years ago)
• Default Branch: main
• Last Pushed: 2025-04-10T18:41:28.000Z (11 days ago)
• Last Synced: 2025-04-14T22:15:59.236Z (7 days ago)
• Topics: fastapi, filter, python
• Language: Python
• Homepage: https://fastapi-filter.netlify.app/
• Size: 1.63 MB
• Stars: 259
• Watchers: 6
• Forks: 33
• Open Issues: 44
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
[![pypi downloads](https://img.shields.io/pypi/dm/fastapi-filter?color=%232E73B2&logo=python&logoColor=%23F9D25F)](https://pypi.org/project/fastapi-filter)

[![codecov](https://codecov.io/gh/arthurio/fastapi-filter/branch/main/graph/badge.svg?token=I1DVBL1682)](https://codecov.io/gh/arthurio/fastapi-filter)

[![Netlify Status](https://api.netlify.com/api/v1/badges/83451c4f-76dd-4154-9b2d-61f654eb0704/deploy-status)](https://fastapi-filter.netlify.app/)

[![CodeQL](https://github.com/arthurio/fastapi-filter/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/arthurio/fastapi-filter/actions/workflows/codeql-analysis.yml)

# FastAPI filter

## Compatibility

**Required:**

- Python: >=3.9, <4.0

- Fastapi: >=0.100, <1.0

- Pydantic: >=2.0.0, <3.0.0

**Optional**

- MongoEngine: >=0.24.1, <0.28.0

- SQLAlchemy: >=1.4.36, <2.1.0

## Installation

```bash

# Basic version

pip install fastapi-filter

# With backends

pip install fastapi-filter[all]

# More selective

pip install fastapi-filter[sqlalchemy]

pip install fastapi-filter[mongoengine]

```

## Documentation

Please visit: [https://fastapi-filter.netlify.app/](https://fastapi-filter.netlify.app/)

## Examples

![Swagger UI](https://raw.githubusercontent.com/arthurio/fastapi-filter/main/docs/swagger-ui.png)

You can play with examples:

```bash

pip install poetry

poetry install

python examples/fastapi_filter_sqlalchemy.py

```

### Filter

https://user-images.githubusercontent.com/950449/176737541-0e36b72f-38e2-4368-abfa-8bbc0c82e8ae.mp4

### Order by

https://user-images.githubusercontent.com/950449/176747056-ea82d6b9-cb3b-43eb-aec7-96ba0bc79e8b.mp4

## Contribution

You can run tests with `pytest`.

```bash

pip install poetry

poetry install --extras all

pytest

```