yjrdZddlmZmZdZdedefdZdedefdZdefd Zd edefd Zd ed ededefdZ dS)z Shared formatting utility functions for both dialectic and deriver modules. This module contains helper functions for processing observations, formatting context, handling temporal metadata, and string escaping for the reasoning system. )datetimetimezone\textreturnc|tttzdtdzdtdzS)aH Escape SQL ILIKE/LIKE pattern special characters in user-provided text. SQL LIKE/ILIKE patterns treat '%' as "match any sequence" and '_' as "match any single character". Without escaping, a user searching for "100%" would match "100" followed by anything, not the literal "100%". This function escapes these wildcards so user input is treated literally. The escape character itself (backslash) is also escaped. Args: text: User-provided search text that may contain %, _, or backslash Returns: Escaped text safe for use in ILIKE patterns. Use with escape='\' parameter. Example: >>> escape_ilike_pattern("100%") '100\%' >>> escape_ilike_pattern("file_name") 'file\_name' >>> escape_ilike_pattern("path\to\file") 'path\\to\\file' %_)replaceILIKE_ESCAPE_CHAR)rs >> dt = datetime(2023, 1, 1, 12, 0, 0, tzinfo=timezone.utc) >>> format_datetime_utc(dt) '2023-01-01T12:00:00Z' Ntzinfor) microsecond+00:00Z)rr rutc astimezone isoformat)rs r format_datetime_utcr-sz& y ZZx|Z , , yHL  ]]8< ( (  " "B <<>> ! !(C 0 00rcXttjtjS)z Get current UTC time as ISO 8601 string with Z suffix. Removes subsecond precision. Returns: Current UTC time in ISO 8601 format with Z suffix Example: >>> utc_now_iso() '2023-01-01T12:34:56Z' )rrnowrrrr utc_now_isorOs x|HL99 : ::r iso_stringc|stdt|}d|vsd|vsd|vrtdtd|Drtd|}|std|d r |d d d z} t j|}|j |tj }|S#t$r}td||d }~wwxYw)a Parse ISO 8601 datetime string, handling various timezone formats. This function properly handles Z suffix, timezone offsets, and naive timestamps. It validates input and always returns a timezone-aware datetime object. Args: iso_string: ISO 8601 formatted datetime string Returns: datetime object with timezone information Raises: ValueError: If the input string is invalid or contains suspicious content Example: >>> parse_datetime_iso('2023-01-01T12:00:00Z') datetime.datetime(2023, 1, 1, 12, 0, tzinfo=datetime.timezone.utc) >>> parse_datetime_iso('2023-01-01T12:00:00+05:00') datetime.datetime(2023, 1, 1, 12, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=18000))) z)Invalid input: must be a non-empty string  z1Invalid input: contains null bytes or line breaksc3DK|]}t|dko|dvVdS)  N)ord).0cs r z%parse_datetime_iso..s5 = =Q3q66B; (1D= = = = = = =rz0Invalid input: contains non-printable charactersz/Invalid input: empty after stripping whitespace)rzNrrz"Invalid ISO 8601 datetime format: ) ValueErrorstranystripendswithr fromisoformatrr rr)rresultes r parse_datetime_isor5^sS. FDEEEZJtz11TZ5G5GLMMM = =* = = ===MKLLL!!##J LJKKK:&&0_x/  J' 33 = ^^8<^88F JJJAaAABBIJs,r?s('''''''ss@1H11111D ;S ; ; ; ;7J37J87J7J7J7Jt77!)7477777777r