fastapi-filters - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #go #android #deep-learning #linux #nodejs #macos #java #awesome #pytorch #mcp #openai

fastapi-filters

(★ 100)

FastAPI filters🍸

파일 탐색기

최종 버전 다운로드 (.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

# 설치 가이드

1. 코드 내려받기

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

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd fastapi-filters

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Python 3 pip 명령어를 쓰려면 Python이 필요합니다.

pip install fastapi-filters

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

pip install fastapi-filters

PyPI에 배포된 패키지를 바로 설치합니다. 소스 클론이 필요 없습니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 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()
```