prefect.server.utilities.text_search_parser

Text search query parser Parses text search queries according to the following syntax:
  • Space-separated terms → OR logic (include)
  • Prefix with - or ! → Exclude term
  • Prefix with + → Required term (AND logic, future)
  • Quote phrases → Match exact phrase
  • Backslash escapes → Allow quotes within phrases (”)
  • Case-insensitive, substring matching
  • 200 character limit

Functions

parse_text_search_query

parse_text_search_query(query: str) -> TextSearchQuery
Parse a text search query string into structured components Args:
  • query: The query string to parse
Returns:
  • TextSearchQuery with parsed include/exclude/required terms

Classes

TextSearchQuery

Parsed text search query structure