mgqpy 0.5.1

mongo query as a predicate function

mgqpy

MongoDB query as a predicate function

This aims to be consistent with how MongoDB's matches documents. This includes traversal across nested dicts and lists, None and field-presence/absence handling.

Installation

pip install mgqpy

Usage

from mgqpy import Query

predicate = Query({"foo.bar": {"$gt": 1}})

inputs = [
    {"foo": [{"bar": [1, 2]}]},
    {"foo": {"bar": 1}},
    {"foo": {"bar": 2}},
    {"foo": None},
]

filtered = filter(predicate.match, inputs)

assert list(filtered) == [
    {"foo": [{"bar": [1, 2]}]},
    {"foo": {"bar": 2}},
]

Supported operators

Comparison query operators

• $eq
• $eq (implicit), e.g. {"foo": None}
• $ne
• $gt
• $gte
• $lt
• $lte
• $in
• $nin

Logical query operators

• $and
• $and (implicit), e.g. {"foo": 1, "bar": "baz"}
• $or
• $not
• $nor

Evaluation query operators

• $regex
• $regex (implicit), e.g. {"foo": re.compile('^bar')}
• $mod

Array query operators

• $all
• $elemMatch
• $size