a i/@sdZddlZddlZddlZddlZd.ddZddZddZd d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZddZddZdd Zd!d"Zd#Zd$Zd%Zd&Zd'Zd(d)Zd*d+Zd,d-ZdS)/a Utility Helper Functions for BaoLife Game This module contains general-purpose utility functions extracted from functions.py to improve code organization and maintainability. Functions: - Array manipulation: getFromArray, randArray - Search utilities: find_by_id, find_where, find, find_where_test, findCharacters - Random number generation: rand - String manipulation: remove_text_before_first_colon, ordinal_suffix - Date/time utilities: getWeekDay, upcoming_saturday, generate_random_date, get_season - Location utilities: parseLocations - Game utilities: getOppositeSex - JWT/Authentication: create_jwt_token - Pickle compatibility: _unpickle_health_condition, _reduce_health_condition NcCs\g}tdt|D] }||j|kr|||q|dkr@|St|dkrT|dSdSdS)a Filter array by object type attribute. Args: array: List of objects with 'type' attribute type: Value to match against object.type amount: If 0, return all matches; if 1, return first match value: Unused parameter (kept for compatibility) Returns: List of matching objects if amount=0, single object if amount=1, False if none found rFN)rangelentypeappend)arrayramountvalueresultir ./var/www/lichun.app/lichun/ws/utils/helpers.py getFromArrays  r cCs|tdt|dS)z Return a random element from an array. Args: array: List to select from Returns: Random element from the array r)randomrandintr)rr r r randArray8s rcCs |D]}|j|kr|SqdS)z Find an object in iterable by its id attribute. Args: iterable: Collection of objects with 'id' attribute id: ID value to search for Returns: First matching object or None if not found N)id)iterableritemr r r find_by_idIs   rcs0|D]&tfdd|DrSqdS)z Find first object where all key-value pairs match. Args: iterable: Collection of objects to search dct: Dictionary of attribute names and values to match Returns: First matching object or None if not found c3s"|]\}}t|d|kVqdSN)getattr.0keyrrr r fzfind_where..N)allitemsrdctr rr find_whereZs  r"cCs"g}|jD]}|r ||q |S)z Filter player relationships based on a check condition. Args: player: Player object with 'r' (relationships) attribute check: Boolean condition to filter by Returns: List of matching person objects )rr)playercheckresultspersonr r r findCharactersks   r(c#s4|D]*jtfdd|DrVqdS)a< Generator that yields objects where all key-value pairs match. Converts objects to dictionaries for comparison. Args: iterable: Collection of objects to search dct: Dictionary of attribute names and values to match Yields: Dictionary representation of matching objects c3s|]\}}||kVqdSrr rrr r rrzfind..N)__dict__rrr r rr find}s r*ccs|D]}|j}d}|D]\}}d|vrT|dd}||td|krd}qqd|vr|dd}||td|krd}qq|||krd}qq|r|VqdS) a Generator that yields objects with advanced comparison operators. Supports __gt (greater than) and __lt (less than) suffixes in keys. Args: iterable: Collection of objects to search dct: Dictionary with keys like 'age__gt': 23 or 'score__lt': 100 Yields: Matching objects Example: find_where_test(my_list, {'age__gt': 23, 'name': 'John'}) TZ__gtz-infFZ__ltinfN)r)rreplacegetfloat)rr!rZ item_dictmatchrrZattr_keyr r r find_where_tests&  r1cCs t||S)z Generate random integer between num1 and num2 (inclusive). Args: num1: Minimum value num2: Maximum value Returns: Random integer in range [num1, num2] rr)Znum1Znum2r r r rands r3cCs,|dd}t|dkr$|dS|dS)z Remove text before the first colon in a message. Args: message: String that may contain a colon Returns: Text after first colon (stripped), or original message if no colon :rr)splitrstrip)messagepartsr r r remove_text_before_first_colons   r9cCsPd|dkrdkr(nn t|dSdddd}t|||ddSd S) z Add ordinal suffix to a number (1st, 2nd, 3rd, 4th, etc.). Args: num: Integer to add suffix to Returns: String with number and ordinal suffix (e.g., "1st", "22nd") dthstndrd)rN)strr.)numsuffixesr r r ordinal_suffixs   rFcCsd|jjd}|dkrdS|dkr$dS|dkr0dS|dkrs8 (