Function parse_query_string

beets/library/queries.py:46–58

Given a beets query string, return the `Query` and `Sort` they represent. The string is split into components using shell-like syntax.

(s, model_cls)

def parse_query_string(s, model_cls):
    """Given a beets query string, return the `Query` and `Sort` they
    represent.

    The string is split into components using shell-like syntax.
    """
    message = f"Query is not unicode: {s!r}"
    assert isinstance(s, str), message
    try:
        parts = shlex.split(s)
    except ValueError as exc:
        raise dbcore.InvalidQueryError(s, exc)
    return parse_query_parts(parts, model_cls)