rbi dZddlmZddlmZddlmZddlmZddlmZGddeZGd d eZGd d eZ Gd dZ GddZ dS)uWeather alert bulletin Python model for the Météo-France REST API. For getting weather alerts in metropolitan France and Andorre. )Any)Dict)List)Optional) TypedDictc(eZdZUdZeed<eed<dS)PhenomenonMaxColoraDescribing a meteorological phenomenon and its maximum color code. Attributes: phenomenon_id (str): A unique identifier for the meteorological phenomenon. This is kept as a string to match the format provided by the API and could represent various types of weather phenomena (e.g., storms, heavy rain, etc.). phenomenon_max_color_id (int): An integer representing the maximum alert color code associated with the phenomenon. The color codes typically indicate the severity or urgency of the weather-related alerts or warnings, with each color corresponding to a specific level of alert. phenomenon_idphenomenon_max_color_idN)__name__ __module__ __qualname____doc__str__annotations__intm/var/www/html/mdtn/previsions/meteo_cartes/venv/lib/python3.11/site-packages/meteofrance_api/model/warning.pyr r s6       rr cHeZdZUdZeed<eed<eed<eeed<dS)WarningCurrentPhenomenonsDatazMDescribing the data structure of CurrentPhenomenons object from the REST API. update_timeend_validity_time domain_idphenomenons_max_colorsN) r r rrrrrrr rrrrr#sKWWNNN !3444444rrc0eZdZUdZeed<eed<eed<eed<eeee fed<ee ed<e eeee fed<e eeee fed <e ed <eee fed <e eee fed <e ed <dS)WarningFullDataz?Describing the data structure of full object from the REST API.rrr color_maxtimelapsphenomenons_itemsadvices consequencesmax_count_itemscommentstexttext_avalancheN) r r rrrrrrrrr rrrrrr,sIINNNNNN4S>"""".//// d4S>* ++++4S#X/000038n 4S> """"rrceZdZdZdeddfdZedefdZedefdZ ede fdZ ede e fd Z d d Zdefd ZdS)CurrentPhenomenonsaClass to access the results of a `warning/currentPhenomenons` REST API request. For coastal department two bulletins are available corresponding to two different domains. Attributes: update_time: A timestamp (as integer) corresponding to the latest update of the phenomenons. end_validity_time: A timestamp (as integer) corresponding to expiration date of the phenomenons. domain_id: A string corresponding do the domain ID of the bulletin. Value is 'France' or a department number. phenomenons_max_colors: A list of dictionaries with type of phenomenons and the current alert level. raw_datareturnNc||_dS)aInitialize a CurrentPhenomenons object. Args: raw_data: A dictionary representing the JSON response from 'warning/currentPhenomenons' REST API request. The structure is described by the WarningCurrentPhenomenonsData class. Nr)selfr)s r__init__zCurrentPhenomenons.__init__N! rc|jdS)z*Return the update time of the phenomenons.rr,r.s rrzCurrentPhenomenons.update_timeX}]++rc|jdS)z3Return the end of validity time of the phenomenons.rr,r2s rrz$CurrentPhenomenons.end_validity_time]}011rc|jdS)z(Return the domain ID of the phenomenons.rr,r2s rrzCurrentPhenomenons.domain_idb}[))rc|jdS)z.Return the list and colors of the phenomenons.rr,r2s rrz)CurrentPhenomenons.phenomenons_max_colorsgs}566rcoastal_phenomenonscP|jd|jdS)aMMerge the classical phenomenons bulleting with the coastal one. Extend the phenomenons_max_colors property with the content of the coastal weather alert bulletin. Args: coastal_phenomenons: CurrentPhenomenons instance corresponding to the coastal weather alert bulletin. rN)r)extendrr.r9s rmerge_with_coastal_phenomenonsz1CurrentPhenomenons.merge_with_coastal_phenomenonsls4 ./66  6     rcBtd|jD}|S)zGet the maximum level of alert of a given domain (class helper). Returns: An integer corresponding to the status code representing the maximum alert. c3&K|] }|dV dS)r Nr).0xs r z:CurrentPhenomenons.get_domain_max_color..s9  -.A' (      r)maxr)r. max_int_colors rget_domain_max_colorz'CurrentPhenomenons.get_domain_max_color}s:   262M     r)r9r(r*N)r r rrrr/propertyrrrrrrr rr=rErrrr(r(=s" !!>!4!!!!,S,,,X,23222X2*3***X*7-?(@777X7 #7     " c      rr(ceZdZdZdeddfdZedefdZedefdZ ede fdZ edefd Z ede ee effd Zede efd Zdd ZdS)FullaThis class allows to access the results of a `warning/full` API command. For a given domain we can access the maximum alert, a timelaps of the alert evolution for the next 24 hours, and a list of alerts. For coastal department two bulletins are available corresponding to two different domains. Attributes: update_time: A timestamp (as integer) corresponding to the latest update of the phenomenons. end_validity_time: A timestamp (as integer) corresponding to expiration date of the phenomenons. domain_id: A string corresponding do the domain ID of the bulletin. Value is 'France' or a department number. color_max: An integer representing the maximum alert level in the domain. timelaps: A list of dictionaries corresponding to the schedule of each phenomenons in the next 24 hours. phenomenons_items: list of dictionaries corresponding the alert level for each phenomenons type. r)r*Nc||_dS)zInitialize a Full object. Args: raw_data: A dictionary representing the JSON response from'warning/full' REST API request. The structure is described by the WarningFullData class. Nr,r-s rr/z Full.__init__r0rc|jdS)z,Return the update time of the full bulletin.rr,r2s rrzFull.update_timer3rc|jdS)z5Return the end of validity time of the full bulletin.rr,r2s rrzFull.end_validity_timer5rc|jdS)z.Return the domain ID of the the full bulletin.rr,r2s rrzFull.domain_idr7rc|jdS)z#Return the color max of the domain.rr,r2s rrzFull.color_maxr7rc|jdS)z6Return the timelaps of each phenomenon for the domain.rr,r2s rrz Full.timelapss}Z((rc|jdS)z)Return the phenomenon list of the domain.r r,r2s rr zFull.phenomenons_itemsr5rr9ct|j|j|jd<|jd|j|jd|jdS)aVMerge the classical phenomenon bulletin with the coastal one. Extend the color_max, timelaps and phenomenons_items properties with the content of the coastal weather alert bulletin. Args: coastal_phenomenons: Full instance corresponding to the coastal weather alert bulletin. rrr N)rCrr)r;rr r<s rr=z#Full.merge_with_coastal_phenomenonssi&)9L9V%W%W k" j!(()<)EFFF )*112E2WXXXXXr)r9rHr*N)r r rrrr/rFrrrrrrrrrrr r r=rrrrHrHsW,!!T!!!!,S,,,X,23222X2*3***X**3***X*)$tCH~.)))X)24(:#;222X2YYYYYYrrHN) rtypingrrrrrr rrr(rHrrrrRs` !!!!!!!!*55555I555i"IIIIIIIIXSYSYSYSYSYSYSYSYSYSYr