es-query-builder 0.1.0

A lightweight Elasticsearch DSL query builder

es-query-builder

一个轻量、可扩展的 Elasticsearch DSL 查询构建器，适用于 FastAPI / Django / Flask 等后端服务。

特性

• 声明式查询参数
• 支持 eq / range / wildcard / fulltext / phrase
• 游标分页友好
• 与框架解耦

安装

pip install es-query-builder

使用

from es-query-builder import BaseQuery
from ... import RepositoryDocument


class RepoQuery(BaseQuery):
    stars__gte: int | None = None
    language: str | None = None
    search: list[str] | None = None

    class Constants:
        model = RepositoryDocument
        search = ["name", "description", "readme_content"]

query = RepoQuery(
    stars__gte=100,
    search=["fastapi async"],
)

conditions = query.to_es_conditions