}Dj*%>dZddlmZddlmZddlmZddlmZddl m Z ddl m Z m Z ddlmZmZmZdd lmZeeZe d d z Zd Zehd ZdedefdZGddZedk(r/ ddlmZededdZ e!e jEyy)zS Author: Giacomo Battaglia Copyright: (C) 2025 Kerykeion Project License: AGPL-3.0 ) getLogger) timedelta)JSONDecodeError)getenv)Path)OptionalUnion)RequestRequestExceptionResponse) CachedSessioncachekerykeion_geonames_cacheKERYKEION_GEONAMES_CACHE_NAME> responsereturnc |j}d|vrH|djdd}|tvr+tj d||djddyy#t t f$rYywxYw) a Filter function for requests-cache to prevent caching transient error responses. GeoNames API returns errors with HTTP 200 status code but with a 'status' key in the JSON response. This function checks for transient errors (rate limits, timeouts, server overload) and returns False to prevent caching them. Args: response: The HTTP response to evaluate. Returns: True if the response should be cached, False otherwise. statusvaluerz9GeoNames transient error (code %d) will not be cached: %smessagez unknown errorFT)jsongetTRANSIENT_GEONAMES_ERROR_CODESloggerdebug ValueErrorr)rdata error_codes d/var/www/html/Astrologybackend/backend/venv/lib/python3.12/site-packages/kerykeion/fetch_geonames.py_should_cache_geonames_responser%(s~}} t h++GQ7J;; ON&&y/B   (sAAA10A1c &eZdZUdZeZeed< ddededede e eeffdZ e de eefd dfd Z e de e eefd efd Zd e eeefd e eeefd eeeffdZdeded eeeffdZdeded eeeffdZd eeeffdZy) FetchGeonamesaw Class to handle requests to the GeoNames API for location data and timezone information. This class provides cached access to the GeoNames API to retrieve location coordinates, timezone information, and other geographical data for astrological calculations. Args: city_name: Name of the city to search for. country_code: Two-letter country code (ISO 3166-1 alpha-2). username: GeoNames username for API access, defaults to "century.boy". cache_expire_after_days: Number of days to cache responses, defaults to 30. cache_name: Optional path (directory or filename stem) used by requests-cache. Defaults to "cache/kerykeion_geonames_cache" and may also be overridden via the environment variable ``KERYKEION_GEONAMES_CACHE_NAME`` or by calling :meth:`FetchGeonames.set_default_cache_name`. default_cache_nameN city_name country_codeusername cache_namectt|j|dt|t|_||_||_||_d|_ d|_ y)Nsqlite)days)r,backend expire_after filter_fnz"http://api.geonames.org/searchJSONz$http://api.geonames.org/timezoneJSON) r str_resolve_cache_namerr%sessionr+r)r*base_url timezone_url)selfr)r*r+cache_expire_after_daysr,s r$__init__zFetchGeonames.__init__[s[%433J?@"(?@5   ! "(= Brc$t||_y)z;Override the default cache name used when none is provided.N)rr()clsr,s r$set_default_cache_namez$FetchGeonames.set_default_cache_namess"&j!1r;cl| t|Stt}|r t|S|jS)zDReturn the resolved cache name applying overrides in priority order.)rrGEONAMES_CACHE_ENV_VARr()r=r, env_overrides r$r4z!FetchGeonames._resolve_cache_nameys:  ! # #45  % %%%%r;latlonci}|||jd}td|j|j}tj d|j  |jj|}|j} |d|d <t|d r|j |d <|S#t$r-}tjd|j|icYd}~Sd}~wt$r"}tjd|icYd}~Sd}~wwxYw#ttf$r"}tjd |icYd}~Sd}~wwxYw) a Get timezone information for a given latitude and longitude. Args: lat: Latitude coordinate. lon: Longitude coordinate. Returns: dict: Timezone data including timezone string and cache status. )rBlngr+GETparamszGeoNames timezone lookup url=%sz*GeoNames timezone network error for %s: %sNz+GeoNames timezone invalid JSON response: %s timezoneId timezonestrz3GeoNames timezone payload missing expected keys: %s from_cache from_tz_cache)r+r r7preparerr urlr5sendrr errorrKeyError TypeErrorhasattrrK) r8rBrC timezone_datarHprepared_requestr response_jsones r$__get_timezonezFetchGeonames.__get_timezones SdmmD"5$*;*;FKSSU 68H8L8LM ||(()9:H$MMOM +8+FM- ( 8\ *-5-@-@M/ *#   LLEtGXGXZ[ \I  LLF JI )$  LLNPQ RI sN+B+D + D 4"CD  D (D?D D  D>D93D>9D>cBi}|||jddddgd}td|j|j}tj d|j  |jj|}|j|j}tj d | |d dd|d<|d dd|d<|d dd|d<|d dd|d<t#|dr|j$|d<|S#t$r-}tjd |j|icYd }~Sd }~wt$r"}tjd |icYd }~Sd }~wwxYw#ttt f$r"}tjd|icYd }~Sd }~wwxYw)a' Get city location data without timezone for a given city and country. Args: city_name: Name of the city to search for. country_code: Two-letter country code. Returns: dict: City location data excluding timezone information. SHORTAP)qcountryr+maxRowsstyle featureClassrFrGzGeoNames search url=%szGeoNames search response: %sz(GeoNames search network error for %s: %sNz)GeoNames search invalid JSON response: %sgeonamesrnamerBrE countryCodez1GeoNames search payload missing expected keys: %srKfrom_country_cache)r+r r6rMrr rNr5rOraise_for_statusrr rPrrQ IndexErrorrRrSrK) r8r)r*city_data_without_tzrHrUrrVrWs r$__get_country_dataz FetchGeonames.__get_country_datas "#  #J  #5$--GOOQ -/?/C/CD ||(()9:H  % % '$MMOM LL7 G +8+DQ+G+O  (*7 *CA*Fu*M  '*7 *CA*Fu*M  '2? 2KA2N}2]  / 8\ *9A9L9L !5 6##)   LLCT]]TU VI  LLDa HI *i0  LLLa PI sOAD18E( E%"D71E%7 E%E E% E%(F<FFFc&|j||S)N) _FetchGeonames__get_country_data)r8r)r*s r$__get_contry_datazFetchGeonames.__get_contry_datas&&y,??r;c|j|j|j} |j|d|d}i||S#t$r"}t j d|icYd}~Sd}~wwxYw)z Returns all the data necessary for the Kerykeion calculation. Returns: dict[str, str]: Dictionary containing city name, latitude, longitude, country code, timezone, and cache status information. rBrEz1Unable to fetch timezone details, missing key: %sN)rlr)r*_FetchGeonames__get_timezonerQrrP)r8city_data_responsetimezone_responserWs r$get_serialized_dataz!FetchGeonames.get_serialized_datas"44T^^TEVEVW  $ 3 34Fu4MOabgOh i  ;#:'9::   LLLa PI sA A1A,&A1,A1)z century.boyN)__name__ __module__ __qualname____doc__DEFAULT_GEONAMES_CACHE_NAMEr(r__annotations__r3rr r: classmethodr>r4floatintdictrorl_FetchGeonames__get_contry_datarrr;r$r'r'GsV" ;: & "15 CCC C U39-. C02c4i0@2T22  &XeCI6F-G &D & &(%UC"8(uS%QT_?U(Z^_bdg_gZh(T4$C4$s4$tCQTH~4$l@3@c@d3PS8n@;T#s(^;r;r'__main__) setup_loggingr MontichiariITN)#rwloggingrdatetimerrrosrpathlibrtypingrr requestsr r r requests_cacher rtrrxr@ frozensetrboolr%r'kerykeion.utilitiesrconfigure_loggingrcprintrrrr;r$rs  "88( 8 #7m.HH8 "+"h4>r;r;j zFFg]D1H ( & & () r;