---
id: mongo-query-match
version: "2.0.0"
license: unclear
license_treatment: unclear
maintenance: dormant
---

# mongo-query-match — A utility library that provides a MongoDB-like query language for querying python collections. It's mainly intended to parse objects structured as fundamental types in a similar fashion to what is produced by JSON or YAML parsers.

License: unclear · Maintenance: dormant · Downloads: 182.0K/mo

## What it is and what it does

mongo-query-match is a standalone query engine that lets you write MongoDB-style queries to filter Python dictionaries and lists without connecting to a database. It parses query objects (dicts with operators like $eq, $regex, $elemMatch) and applies them to in-memory Python collections, following MongoDB version 3.4 query semantics. The library is intended for filtering JSON or YAML-like structured data—records with strings, numbers, booleans, nulls, and nested objects.

The package has no external dependencies and installs quickly. It supports most common MongoDB query operators but omits geospatial queries, text search, and projection operators. It's useful when you want MongoDB's expressive query syntax for local data processing, testing, or prototyping without database overhead.

Use it for:

- Filter test fixtures or mock data using MongoDB query syntax in unit tests.
- Query JSON or YAML configuration files and data exports without loading them into a database.
- Prototype query logic locally before migrating to a real MongoDB instance.
- Build in-memory query layers for applications that need flexible filtering on structured data.
- Match records against complex criteria in data pipelines or ETL workflows.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a MongoDB-like query language for filtering and matching Python dictionaries and collections, translating MongoDB query syntax into Python without requiring a database.

Yes, if you need MongoDB query syntax for local Python collections and can accept dormant maintenance. No external dependencies and low friction make it safe to add. However, verify the license before use in proprietary contexts, and be aware that the package has not been updated in over a year—do not expect active bug fixes or new features.

## Install

pip install mongo-query-match
uv add mongo-query-match
poetry add mongo-query-match

## Installing mongo-query-match

Before you install: Low install friction with no runtime dependencies. Package is marked dormant (558 days since release) with minimal maintenance activity.

License in practice: License treatment is unclear—no SPDX identifier or raw license text is available. Verify the actual license before use in proprietary or restricted contexts.

Quickstart:

from mongo_query_match import Query

records = [{"a": 5}, {"a": 3}]
query = Query({"a": 3})
matched = [r for r in records if query.match(r)]

Requires Python 3.9 or later (supports >=3.9,<4).

Verify before relying:

- Whether the package is actively maintained or accepting bug reports despite dormant status.
- Exact license terms—verify before using in commercial or restricted-license projects.
- Performance characteristics when filtering large collections or deeply nested documents.

## Package facts

- License: not declared (unclear)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 182.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

mongodb query language python, filter dictionaries with mongodb syntax, query python collections, mongodb-like matching, json document filtering, query-language, data-filtering, mongodb-compatible

[View on SkillFed](https://skillfed.io/packages/mongo-query-match) · [View on PyPI](https://pypi.org/project/mongo-query-match/)