fastapi-filters - GitLite

KO | EN

gitlite — search

#python #ai #go #android #rust #linux #nodejs #macos #windows #awesome #kubernetes #mcp #openai #open-source

fastapi-filters

(★ 100)

FastAPI filters🍸

File Explorer

Download Latest Version (.zip)

- - automerge.yml
  - lint.yml
  - publish.yml
  - test.yml
- dependabot.yml
- contributing.md
- index.md
- license.md
- __init__.py
- app.py
- beanie_app.py
- - __init__.py
  - beanie.py
  - raw_sql.py
  - sqlalchemy.py
  - tortoise.py
- __init__.py
- config.py
- configs.py
- docs.py
- errors.py
- fields.py
- filter_set.py
- filters.py
- op.py
- operators.py
- py.typed
- schemas.py
- sorters.py
- types.py
- utils.py
- - __init__.py
  - arr_op.py
  - bool_op.py
  - conftest.py
  - enum_op.py
  - field_set_decl.py
  - num_op.py
  - str_op.py
- - __init__.py
  - test_sqalchemy.py
- __init__.py
- conftest.py
- test_config.py
- test_docs.py
- test_filter_set.py
- test_filters.py
- test_op.py
- test_operators.py
- test_raw_sql.py
- test_schemas.py
- test_sorters.py
- test_utils.py
- utils.py
.gitignore
.pre-commit-config.yaml
LICENSE
logo.png
mkdocs.yml
netlify.toml
pyproject.toml
README.md
ROADMAP.md
runtime.txt
uv.lock

# Installation Guide

1. Get the code

git clone https://github.com/uriyyo/fastapi-filters

Downloads the entire project code from GitHub to your computer.

cd fastapi-filters

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install fastapi-filters

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install fastapi-filters

Installs the package published on PyPI directly — no need to clone the source.

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
<img alt="logo" src="https://raw.githubusercontent.com/uriyyo/fastapi-filters/main/logo.png">
</h1>

<div align="center">
<img alt="license" src="https://img.shields.io/badge/License-MIT-lightgrey">
<img alt="test" src="https://github.com/uriyyo/fastapi-filters/workflows/Test/badge.svg">
<img alt="codecov" src="https://codecov.io/gh/uriyyo/fastapi-filters/branch/main/graph/badge.svg?token=QqIqDQ7FZi">
<a href="https://pepy.tech/project/fastapi-filters"><img alt="downloads" src="https://pepy.tech/badge/fastapi-filters"></a>
<a href="https://pypi.org/project/fastapi-filters"><img alt="pypi" src="https://img.shields.io/pypi/v/fastapi-filters"></a>
<img alt="black" src="https://img.shields.io/badge/code%20style-black-000000.svg">
</div>

## Introduction

`fastapi-filters` is a library that provides filtering/sorting feature for [FastAPI](https://fastapi.tiangolo.com/)
applications.

----

## Installation

```bash
pip install fastapi-filters
```

## Quickstart

Define filters using a `FilterSet` class:

```py
from fastapi import Depends, FastAPI
from pydantic import BaseModel

from fastapi_filters import FilterField, FilterSet, SortingValues, create_sorting

app = FastAPI()

class UserOut(BaseModel):
    name: str
    surname: str
    age: int

class UserFilters(FilterSet):
    name: FilterField[str]
    surname: FilterField[str]
    age: FilterField[int]

@app.get("/users")
async def get_users(
    filters: UserFilters = Depends(),
    sorting: SortingValues = Depends(create_sorting("name", "age")),
) -> list[UserOut]:
    pass
```

Query parameters are auto-generated based on field types:

```
GET /users?name[eq]=Steve&age[gt]=30&sort=+age
```

`fastapi-filters` supports `SQLAlchemy`, `Tortoise ORM`, `Beanie` (MongoDB), and raw SQL integrations.

```py
from sqlalchemy import select
from sqlalchemy.ext.asyncio import AsyncSession

from fastapi_filters.ext.sqlalchemy import apply_filters_and_sorting

@app.get("/users")
async def get_users(
    db: AsyncSession = Depends(get_db),
    filters: UserFilters = Depends(),
    sorting: SortingValues = Depends(create_sorting("name", "age")),
) -> list[UserOut]:
    stmt = apply_filters_and_sorting(select(User), filters, sorting)
    return (await db.scalars(stmt)).all()
```