rbi dZddlZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z d d l m Z d d l m Z d d l mZd dl mZd dl mZd dl mZd dlmZd dlmZ d)dededeefdZ d)dededeefdZdedefdZdedefdZ d)deededeeeeeffdZd eeefd!eeefdefd"Zd#eed$eeefdeefd%Z d&ed'edefd(Z!dS)*u5Helpers to be used with the Météo-France REST API .N)datetime)Dict)List)Optional)Tuple)timezone)utc)ALERT_COLOR_LIST_EN)ALERT_COLOR_LIST_FR)ALERT_TYPE_DICTIONARY_EN)ALERT_TYPE_DICTIONARY_FRCOASTAL_DEPARTMENT_LISTVALID_DEPARTMENT_LIST)Place)PhenomenonMaxColorfr int_colorlangreturncB|dkr t|St|S)aConvert the color code (in int) in readable text (Helper). Args: int_color: Color status in int. Value expected between 1 and 4. lang: Optional; If language is equal 'fr' (default value) results will be in French. All other value will give results in English. Returns: Color status in text. French or English according to the lang parameter. r)r r )rrs g/var/www/html/mdtn/previsions/meteo_cartes/venv/lib/python3.11/site-packages/meteofrance_api/helpers.py)get_warning_text_status_from_indice_colorrs# t||"9-- y ))int_phenomenoncB|dkr t|St|S)aConvert the phenomenon code in readable text (Helper). Args: int_phenomenon: ID of the phenomenon in int. Value expected between 1 and 9. lang: Optional; If language is equal "fr" (default value) results will be in French. All other value will give results in English. Returns: phenomenon in text. French or English according to the lang parameter. r)rr )rrs rget_phenomenon_name_from_indicer*s# t||'77 #N 33rdepartment_numberc|tvS)zIdentify when a second bulletin is available for coastal risks (Helper). Args: department_number: Department number on 2 characters Returns: True if the department have an additional coastal bulletin. False otherwise. rr s ris_coastal_departmentr#=s  7 77rc|tvS)a<Identify if there is a weather alert bulletin for this department (Helper). Weather alert bulletins are available only for metropolitan France and Andorre. Args: department_number: Department number on 2 characters. Returns: True if a department is metropolitan France or Andorre. rr"s ris_valid_warning_departmentr%Is  5 55rlist_phenomenonslanguagecni}|D]/}t|d||t|d|<0|S)aCreate a dictionary with human readable keys and values (Helper). Args: list_phenomenons: Dictionary with phenomenon ID and color code of status. language: Optional; If language is equal "fr" (default value) results will be in French. All other value will give results in English. Returns: Dictionary with keys and value human readable. phenomenon_max_color_id phenomenon_id)rr)r&r' readable_dict phenomenons rreadable_phenomenons_dictr-Ws]M'   6 0 18    +J,G R R  rcoord1coord2cd}|\}}|\}}tj|tj|}}tj||z } tj||z } tj| dz dztj|tj|ztj| dz dzzz} d|ztjtj| tjd| z zS)a|Compute distance in meters between to GPS coordinates using Harvesine formula. source: https://janakiev.com/blog/gps-points-distance-python/ Args: coord1: Tuple with latitude and longitude in degrees for first point coord2: Tuple with latitude and longitude in degrees for second point Returns: Distance in meters between the two points i=ar )mathradianssincosatan2sqrt) r.r/radiuslat1lon1lat2lon2phi1phi2dphidlambdaas r haversinerBqsFJD$JD$d##T\$%7%7$D <t $ $Dl4$;''G a (4..48D>> )DHWq[,A,AQ,F F G v: 49Q<<1q51A1ABB BBr list_places gps_coordc0t|fd}|S)u&Oder list of places according to the distance to a reference coordinates. Note: this helper is compensating the bad results of the API. Results in the API are generally sorted, but lot of cases identified where the order is inconsistent (example: Montréal) Args: list_places: List of Place instances to be ordered gps_coord: Tuple with latitude and longitude in degrees for the reference point Returns: List of Place instances ordered by distance to the reference point (nearest first) cptt|jt|jfS)N)rBfloatlatitude longitude)xrDs rz>sort_places_versus_distance_from_coordinates..s*iqz!2!2E!+4F4F GSSr)key)sorted)rCrD sorted_placess ` r,sort_places_versus_distance_from_coordinatesrOs0" S S S SM r timestamplocal_tzctjtj|}|t |S)zConvert timestamp in datetime (Helper). Args: timestamp: Timestamp. local_tz: Name of the timezone to be used to convert the timestamp. Returns: Datetime instance corresponding to the timestamp with a timezone. )r localizerutcfromtimestamp astimezoner)rPrQdt_utcs r$timestamp_to_datetime_with_locale_tzrWs:\(3I>> ? ?F   Xh// 0 00r)r)"__doc__r2rtypingrrrrpytzrr constr r r rrr model.placer model.warningrintstrrrboolr#r%r-rGrBrOrWrrrbs;; &&&&&&&&&&&&++++++++++++******((((((------!%**** c]****(&*444"4 c]4444& 8S 8T 8 8 8 8 63 64 6 6 6 6AE-.:= (3-# &'4CeE5L)C53FC5CCCC6e).ue|)< %[0 1C 13 18 1 1 1 1 1 1r