h]KdZddlZddlZddlZddlZddlmZddlmZmZm Z ddl m Z m Z ddl mZddlmZddlZddlZddlmZmZdd lmZd d lmZej2eZd Zd ZdZdZddhZ d&de!de!de!fdZ" d'de#e$zde!de#e$zfdZ%d'de#de!de#fdZ&d'de#de!de#fdZ'dede!fdZ(GddZ)Gdde*Z+Gd d!e*Z,Gd"d#e*Z-Gd$d%e*Z.y)(z(Python 3 API wrapper for Garmin Connect.N)Callable)datedatetimetimezone)Enumauto)Path)Any)GarthExceptionGarthHTTPError) HTTPError)FitEncoderWeighti'z^\d{4}-\d{2}-\d{2}$z%Y-%m-%dkglbsdate_str param_namereturnc2t|tst|d|j}t j t |st|d| tj|t|S#t$r}td|d||d}~wwxYw)z'Validate date string format YYYY-MM-DD.z must be a stringz& must be in format 'YYYY-MM-DD', got: zinvalid : N) isinstancestr ValueErrorstripre fullmatchDATE_FORMAT_REGEXrstrptimeDATE_FORMAT_STR)rres Q/var/www/html/python/myenv/lib/python3.12/site-packages/garminconnect/__init__.py_validate_date_formatr#s h $J<'89::~~H <<)8 4l@ K  >(O4 O >8JsA66 B?BBvaluect|tjst|dt|trt|d|dkrt|d||S)z#Validate that a number is positive.z must be a numberz must be a number, not boolrz must be positive, got: )rnumbersRealrboolr$rs r"_validate_positive_numberr*5se eW\\ *J<'89::%J<'BCDD zJ<'?wGHH Lct|trt|trt|d|dkrt|d||S)z0Validate that a value is a non-negative integer. must be an integerrz must be non-negative, got: rintr(rr)s r"_validate_non_negative_integerr0EsK eS !Zt%<J<':;<< qyJ<'CE7KLL Lr+ct|trt|trt|d|dkrt|d||S)z,Validate that a value is a positive integer.r-rz" must be a positive integer, got: r.r)s r"_validate_positive_integerr2PsK eS !Zt%<J<':;<< zJ<'I%QRR Lr+dtcJ|jdjdddS)Ntzinfoz%Y-%m-%dT%H:%M:%S.%f)replacestrftime)r3s r"_fmt_tsr:Ys& ::T: " + +,B CCR HHr+c, eZdZdZ ddedzdedzdedegefdzdeddf d Zd ed edefd Z d ed edefd Z ddedzde edzedzffdZ de eefdede eeffdZdedzfdZdedzfdZdede eeffdZdede eeffdZdedee eeffdZdede eeffdZdededee eeffdZdede eeffdZdede eeffdZ dded edzde eeffd!Z dd"edzd#ed$edzd%edzd&edzd'edzd(edzd)edzd*edzd+edzd,edzd-edzd.edzde eeffd/Z dd#eezd0ed"ede eeffd1Z dd#eezd0ed2ed3ede eeff d4Zded ede eeffd5Zdede eeffd6Z d7ededefd8Z!dded9ededzfd:Z" dded edzdee eeffd;Z#dedee eeffd<Z$ dd=ed>ed?ed"ed@ede eeff dAZ% dded edzde eeffdBZ&dCedede eeffdDZ'dede eeffdEZ(dFdddGdHdIedJee)zdzdKee)zdzdLede eeff dMZ* ddNed"edzdedzde eeffdOZ+dede eeffdPZ,dede eeffdQZ-dede eeffdRZ.dede eeffdSZ/dede eeffdTZ0dede eeffdUZ1de eeffdVZ2dee eeffdWZ3dee eeffdXZ4dee eeffdYZ5dedZede eeffd[Z6dedZede eeffd\Z7dedZede eeffd]Z8dedZede eeffd^Z9dedZede eeffd_Z:dede eeffd`Z;dede eeffdaZdede eeffddZ? dded edzde eeffdeZ@ ddedzd edzdfedzde eeffdgZAdede eeffdhZBdede eeffdiZC dded edzde eeffdjZDdee eeffdkZEdlede eeffdmZFde eeffdnZG ddleded edzdee eeffdoZHdeefdpZIde eeffdqZJ ddedZedredzde eefeezfdsZKdtede eeffduZLdvedwedefdxZMdvedyedzed{edef d|ZNd}e eefdefd~ZOdededzededededefdZPde eefdzfdZQdedefdZRdvedefdZS dded edzdredzdedzdee eeff dZT dded ededede eeff dZUde eeffdZV ddededZedee eeffdZWdede eeffdZXdede eeffdZYdede eeffdZZ ddedededefdZ[Gdde\Z]Gdde\Z^e]jfdvede]de`fdZadvede eeffdZbdvede eeffdZcdvede eeffdZddvede eeffdZedvede eeffdZfdvede eeffdZg ddvededede eeffdZhdveezde eeffdZidveezde eeffdZj ddedZedee eeffdZkde eeffdZlde eeffdZmdede eeffdZnddedZede eeffdZodeezde eeffdZpdeezde`fdZqde eefeezezde eeffdZrdtede eeffdZsded ede eeffdZtde eeffdZude eefde eeffdZvddZwy)Garminz,Class for fetching data from Garmin Connect.Nemailpasswordis_cn prompt_mfa return_on_mfarc$|t|ts td|t|ts tdt|ts tdt|ts td||_||_||_||_||_d|_ d|_ d|_ d |_ d |_ d |_d |_d |_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_d|_ d|_!d|_"d |_#d!|_$d"|_%d#|_&d$|_'d%|_(d&|_)d'|_*d(|_+d)|_,d*|_-d+|_.d,|_/d-|_0d.|_1d/|_2d0|_3d1|_4d2|_5d3|_6d4|_7d5|_8d6|_9d7|_:d8|_;d9|_<d:|_=d;|_>d<|_?d=|_@d>|_Ad?|_Bd@|_CdA|_DdB|_EdC|_FdD|_Gd6|_HdE|_Itj|rdFndGdHdHI|_Jd|_Ld|_Md|_Ny)JzCreate a new class instance.Nzemail must be a string or Nonez!password must be a string or Nonezis_cn must be a booleanzreturn_on_mfa must be a booleanz./userprofile-service/userprofile/user-settingsz)/userprofile-service/userprofile/settingsz*/device-service/deviceregistration/devicesz/device-service/deviceservicez0/web-gateway/device-info/primary-training-devicez/web-gateway/solarz/weight-servicez&/usersummary-service/usersummary/dailyz%/metrics-service/metrics/maxmet/dailyz/biometric-service/biometricz/biometric-service/statsz0/usersummary-service/usersummary/hydration/dailyz./usersummary-service/usersummary/hydration/logz&/usersummary-service/stats/steps/dailyz*/personalrecord-service/personalrecord/prsz/badge-service/badge/earnedz/badge-service/badge/availablez1/adhocchallenge-service/adHocChallenge/historicalz0/badgechallenge-service/badgeChallenge/completedz0/badgechallenge-service/badgeChallenge/availablez4/badgechallenge-service/badgeChallenge/non-completedz3/badgechallenge-service/virtualChallenge/inProgressz)/wellness-service/wellness/dailySleepDataz&/wellness-service/wellness/dailyStressz"/metrics-service/metrics/hillscorez4/wellness-service/wellness/bodyBattery/reports/dailyz-/wellness-service/wellness/bodyBattery/eventsz*/bloodpressure-service/bloodpressure/rangez$/bloodpressure-service/bloodpressurez'/metrics-service/metrics/endurancescorez//periodichealth-service/menstrualcycle/calendarz./periodichealth-service/menstrualcycle/dayviewz8/periodichealth-service/menstrualcycle/pregnancysnapshotz/goal-service/goal/goalsz!/userstats-service/wellness/dailyz/hrv-service/hrvz*/metrics-service/metrics/trainingreadinessz(/metrics-service/metrics/racepredictionsz2/metrics-service/metrics/trainingstatus/aggregatedz,/wellness-service/wellness/dailySummaryChartz0/wellness-service/wellness/floorsChartData/dailyz)/wellness-service/wellness/dailyHeartRatez,/wellness-service/wellness/daily/respirationz%/wellness-service/wellness/daily/spo2z#/wellness-service/wellness/daily/imz&/wellness-service/wellness/dailyEventsz2/activitylist-service/activities/search/activitiesz!/activitylist-service/activities/z/activity-service/activityz(/activity-service/activity/activityTypesz!/mobile-gateway/heartRate/forDatez/fitnessstats-service/activityz/fitnessage-service/fitnessagez /download-service/files/activityz%/download-service/export/tcx/activityz%/download-service/export/gpx/activityz%/download-service/export/kml/activityz%/download-service/export/csv/activityz/upload-service/uploadz/gear-service/gear/filterGearz/gear-service/gear/z(/wellness-service/wellness/epoch/requestz/workout-servicezgraphql-gateway/graphqlz garmin.cnz garmin.com)domainpool_connections pool_maxsize)Orrrr(usernamer>r?r@rA garmin_connect_user_settings_url'garmin_connect_userprofile_settings_urlgarmin_connect_devices_urlgarmin_connect_device_url!garmin_connect_primary_device_urlgarmin_connect_solar_urlgarmin_connect_weight_url garmin_connect_daily_summary_urlgarmin_connect_metrics_urlgarmin_connect_biometric_url"garmin_connect_biometric_stats_url"garmin_connect_daily_hydration_url garmin_connect_set_hydration_url$garmin_connect_daily_stats_steps_url"garmin_connect_personal_record_url garmin_connect_earned_badges_url#garmin_connect_available_badges_url#garmin_connect_adhoc_challenges_url#garmin_connect_badge_challenges_url-garmin_connect_available_badge_challenges_url1garmin_connect_non_completed_badge_challenges_url0garmin_connect_inprogress_virtual_challenges_urlgarmin_connect_daily_sleep_urlgarmin_connect_daily_stress_urlgarmin_connect_hill_score_url%garmin_connect_daily_body_battery_url&garmin_connect_body_battery_events_url&garmin_connect_blood_pressure_endpoint*garmin_connect_set_blood_pressure_endpoint"garmin_connect_endurance_score_url%garmin_connect_menstrual_calendar_url$garmin_connect_menstrual_dayview_url%garmin_connect_pregnancy_snapshot_urlgarmin_connect_goals_urlgarmin_connect_rhr_urlgarmin_connect_hrv_url%garmin_connect_training_readiness_url!garmin_connect_race_predictor_url"garmin_connect_training_status_url!garmin_connect_user_summary_chart%garmin_connect_floors_chart_daily_url#garmin_connect_heartrates_daily_url$garmin_connect_daily_respiration_urlgarmin_connect_daily_spo2_url&garmin_connect_daily_intensity_minutesgarmin_daily_events_urlgarmin_connect_activities!garmin_connect_activities_baseurlgarmin_connect_activitygarmin_connect_activity_typesgarmin_connect_activity_fordategarmin_connect_fitnessstatsgarmin_connect_fitnessagegarmin_connect_fit_downloadgarmin_connect_tcx_downloadgarmin_connect_gpx_downloadgarmin_connect_kml_downloadgarmin_connect_csv_downloadgarmin_connect_uploadgarmin_connect_geargarmin_connect_gear_baseurlgarmin_request_reload_urlgarmin_workouts"garmin_connect_delete_activity_urlgarmin_graphql_endpointgarthClient display_name full_name unit_system)selfr=r>r?r@rAs r"__init__zGarmin.__init__asr  Zs%;=> >   8S(A@A A%&67 7-.>? ?    $* = - 8 4+W')H& ? .)=%):&0X-*Q',J)2L/ > / = - 5 1 9 /1N-3S0 ? 0 ? 0 ? : C > B = 8 +0X,-Q* C 2 < 3 9 3 3 7 6 / > 2 = 1 G 2)C%&I#&8# 9 2 7 . A / ; . ? 2 8 0 ; 1.U* 1 3(P$ @ &2U.'C$-W*/R,+K()I&+M(+R(+R(+R(+R(%="#B +@()S&12N/'@$\\"';\  !r+pathkwargsc F |jj|fi|S#ttf$r}t |tr#t t |j dddd}nt t |dddd}tj d||||dk(rtd|||dk(rtd|||r d |cxkrd krnntd |d ||td ||d}~wt$r*}tjd|td||d}~wwxYw)z1Wrapper for garth connectapi with error handling.responseN status_codez-API call failed for path '%s': %s (status=%s)Authentication failed: Rate limit exceeded: zAPI client error (): z HTTP error: z*Connection error during connectapi path=%szConnection error: ) r connectapir r rgetattrerrorlogger GarminConnectAuthenticationError!GarminConnectTooManyRequestsErrorGarminConnectConnectionError Exception exceptionrrrr!statuss r"rzGarmin.connectapisN P(4::((88 8>* N!^, AGGZ6 t!J!=}dS LL?q& }6-aS137+A3/C6/C/2(A373\!3EFAM P   I4 P.1CA3/GHa O Ps!D B* R!^, AGGZ6 t!J!=}dS   H$PV W}69I!7MNTUU37:J1#8NOUVVC6/C/2-fXS<35EaS3IJPQQ N   zGarmin.login..sKi9 )KzLogin failed: )rrauthenticationz login failedc3&K|]}|v ywrrrs r"rzGarmin.login..sX9 Y 6Xrz Login failed)$osgetenvlenrloadsloadrGr>rr?rAloginr@rrrgetrrrrHrr requests exceptionsr rrrrloweranyrFileNotFoundErrorrr) rrtoken1token2profr!settingsrauth_indicators is_auth_errorrs @r"rz Garmin.loginWs <299^#< q LFFz?S(JJ$$Z0JJOOJ/}}DMM:< zzdmm4==8P:7%%%)ZZ%5%5  &*&8&8&6&NFF "6>)%)ZZ%5%5  #'??&6&NFF4::y$7::00BD}D8:;WXX$(HH]$;!!%*!5$(JJ$6$6$:$:=$I!!%!3!3!7!7 !Czz,,T-R-RSH66)67TUU' 3778KLD 6> !3!:468..88.I LWQ D9=$OF LL7F C}6-aS137+A3/ A INOK?KK6-aS1 /s/CD! K    L!=>eg XOXXXM6-aS1   ^ ,.s/CD! K LsRC.J AJ "I-=C/J - J6 JJJ (O)2B&MO)-A7O$$O) client_statemfa_codec\|jj||\}}|jjr<|jjd|_|jjd|_|jj |j }|rd|vr |dd|_||fS)zResume login using Garth.rrrr)r resume_loginrrrrrHr)rrrresult1result2rs r"rzGarmin.resume_logins ::22<J ::   $ 2 2= AD !ZZ// ;DN::(()N)NO  h.' 34GHD r+c|jS)zReturn full name.)rrs r" get_full_namezGarmin.get_full_names~~r+c|jS)zReturn unit system.)rrs r"get_unit_systemzGarmin.get_unit_systemsr+cdatec$|j|S)zr Return user activity summary for 'cdate' format 'YYYY-MM-DD' (compat for garminconnect). )get_user_summary)rrs r" get_statszGarmin.get_statss $$U++r+ct|d}|jd|j}d|i}tj d|j ||}|s t d|jddur td |S) z=Return user activity summary for 'cdate' format 'YYYY-MM-DD'.r/ calendarDatezRequesting user summaryparamszNo data received from serverprivacyProtectedTzAuthentication error) r#rOrrdebugrrrrrrurlrrs r"rzGarmin.get_user_summarys&eW5667q9J9J8KL %( ./??3v?6./MN N <<* +t 323IJ Jr+ct|d}|jd|j}d|i}tj d|j ||}|tj dgS|S)z7Fetch available steps data 'cDate' format 'YYYY-MM-DD'.rrrzRequesting steps datarzNo steps data received)r#rorrrrwarningrs r"get_steps_datazGarmin.get_steps_data ss&eW5778$:K:K9LM% ,-??3v?6   NN3 4Ir+ct|d}|jd|}tjd|j |}| t d|S)z8Fetch available floors data 'cDate' format 'YYYY-MM-DD'.rrzRequesting floors datazNo floors data received)r#rprrrr)rrrrs r" get_floorszGarmin.get_floorssY&eW5;;CCE $$S/:??A  BC C::;1UG1SEJ 23s##r+ct|d}|jd|j}d|i}tj d|j ||}| t d|S)aFetch available heart rates data 'cDate' format 'YYYY-MM-DD'. Args: cdate: Date string in format 'YYYY-MM-DD' Returns: Dictionary containing heart rate data for the specified date Raises: ValueError: If cdate format is invalid GarminConnectConnectionError: If no data received GarminConnectAuthenticationError: If authentication fails rrrzRequesting heart ratesrzNo heart rate data received)r#rqrrrrrrs r"get_heart_rateszGarmin.get_heart_rates?sm &eW599:!D > @9>>@ A@A A//00AB"9~#g,G 23s622r+ timestampweight percent_fatpercent_hydrationvisceral_fat_mass bone_mass muscle_mass basal_met active_metphysique_rating metabolic_agevisceral_fat_ratingbmict|d}|rtj|ntj}t }|j |j |j||j||||||||| | | | |  |j|j}dd|jfi}|jjd||djS)Nr) rrrr r r r r rrrrfilezbody_composition.fitrTfilesapi)r*r fromisoformatnowrwrite_file_infowrite_file_creatorwrite_device_infowrite_weight_scalefinishrgetvaluerpostjson)rrrrrr r r r r rrrrr3 fitEncoderrrs r"add_body_compositionzGarmin.add_body_composition}s +68<2;X # #I .%' ""$%%'$$R(%% #//#!+' 3 &  (( +Z-@-@-BC zz|S4HMMOOr+unitKeyct|d}|tvrtdt|jd} |rt j |nt j }|jtj}t|t||d|d}tjd|jjd || jS#t$r}td||d}~wwxYw) zAdd a weigh-in (default to kg)runitKey must be one of /user-weightzinvalid timestamp format: NMANUAL dateTimestamp gmtTimestampr# sourceTyper$zAdding weigh-inrr )r*VALID_WEIGHT_UNITSrrNrrr astimezonerutcr:rrrrr ) rrr#rrr3r!dtGMTpayloads r" add_weigh_inzGarmin.add_weigh_ins +68< , ,67I6JKL L//0 = F6?'' 2X\\^B  hll+$R[#EN"    &'zz|Sw?DDFF F9!=>A E Fs+C C9%C44C9r)r*c|jd}|tvrtdt|r#tj|j n!tj j }|ratj|}|j |jtj}|j tj}n|j tj}t|d}t|t||d|d} tjd| |jj!d|| j#S) z7Add a weigh-in with explicit timestamps (default to kg)r&r%r5rr'r(z,Adding weigh-in with explicit timestamps: %srr,)rNr-rrrr.rr6r8rr/r*r:rrrrr ) rrr#r)r*rr3gr0r1s r"add_weigh_in_with_timestampsz#Garmin.add_weigh_in_with_timestampss$//0 = , ,67I6JKL L  " "= 1 < < >**, &&|4AxxIIX\\I2LL.EMM(,,/E+68<%R[#EN"    CWMzz|Sw?DDFFr+ct|d}t|d}|jd|d|}ddi}tjd|j ||S) zFGet weigh-ins between startdate and enddate using format 'YYYY-MM-DD'.rrz/weight/range/r includeAllTRequesting weigh-insrr#rNrrrrs r" get_weigh_inszGarmin.get_weigh_inssc*)[A ';//0yk7)T% +,s622r+ct|d}|jd|}ddi}tjd|j ||S)z.Get weigh-ins for 'cdate' format 'YYYY-MM-DD'.rz/weight/dayview/r7Tr8rr9rrrrs r"get_daily_weigh_inszGarmin.get_daily_weigh_inssR&eW5//00@H% +,s622r+ weight_pkct|d}|jd|d|}tjd|jj dd|dS) zDelete specific weigh-in.rz/weight/z /byversion/zDeleting weigh-inDELETErTr)r#rNrrrrequest)rr>rrs r"delete_weigh_inzGarmin.delete_weigh_in s`%eW5//0{9+V ()zz!!    "  r+ delete_allc~|j|}|jdg}|rt|dk(rtj d|yt|dkDr=tj d||s#tj dt|dy|D]}|j |d |t|S) z Delete weigh-in for 'cdate' format 'YYYY-MM-DD'. Includes option to delete all weigh-ins for that date. dateWeightListrzNo weigh-ins found on NrzMultiple weigh-ins found for z%Set delete_all to True to delete all z weigh-inssamplePk)r=rrrrrC)rrrDdaily_weigh_ins weigh_insws r"delete_weigh_inszGarmin.delete_weigh_inss 2259#''(8"= C Na/ NN3E7; < ^a  NN:5'B C;C N;K:V 7A  : 6 79~r+ct|d}||}n t|d}|j}t|t|d}tj d|j ||S)z| Return body battery values by day for 'startdate' format 'YYYY-MM-DD' through enddate 'YYYY-MM-DD' rrrzRequesting body battery datar)r#rarrrrrs r"get_body_batteryzGarmin.get_body_battery0sc*)[A ?G+GY?G88"9~#g,G 34s622r+ct|d}|jd|}tjd|j |S)a  Return body battery events for date 'cdate' format 'YYYY-MM-DD'. The return value is a list of dictionaries, where each dictionary contains event data for a specific event. Events can include sleep, recorded activities, auto-detected activities, and naps rrz"Requesting body battery event data)r#rbrrrrrrs r"get_body_battery_eventszGarmin.get_body_battery_eventsCsC&eW5<<=QugF 9:s##r+systolic diastolicpulsenotesc |j}|rtj|ntj}|j t j }t|t||||d|d} d|ddfd|ddfd |d d ffD]8\} } } } t| tr| | cxkr| kr$nt| d | d | dtjd|jjd|| jS)z0 Add blood pressure measurement r')measurementTimestampLocalmeasurementTimestampGMTrQrRrSr+rTrQFirR(rSrCz must be an int in [, ]zAdding blood pressurerr,)rdrrrr.rr/r:rr/rrrrrr )rrQrRrSrrTrr3r0r1namevallohis r"set_blood_pressurezGarmin.set_blood_pressurePs @@A2;X # #I . hll+)0'.u~ "" 2s + )R - eR %"  K D#r2 c3'cR D6)=bTB4q!IJJ  K  ,-zz|Sw?DDFFr+ct|d}||}n t|d}|jd|d|}ddi}tjd|j ||S)zx Returns blood pressure by day for 'startdate' format 'YYYY-MM-DD' through enddate 'YYYY-MM-DD' rrrr7TzRequesting blood pressure datar)r#rcrrrrs r"get_blood_pressurezGarmin.get_blood_pressuretsm*)[A ?G+GY?G<<=Qyk7)T% 56s622r+versionc|jd|d|}tjd|jj dd|dj S)z+Delete specific blood pressure measurement.rz#Deleting blood pressure measurementr@rTrA)rdrrrrBr )rrerrs r"delete_blood_pressurezGarmin.delete_blood_pressures]@@A5'7)T :;zz!!    " $&  r+ct|d}|jd|d|}tjd|j |S)zAReturn available max metric data for 'cdate' format 'YYYY-MM-DD'.rrzRequesting max metrics)r#rPrrrrOs r"get_max_metricszGarmin.get_max_metricssI&eW50015'5'B -.s##r+Tdaily)latestrr aggregationrkrrrlct|r|jd}|jdtjd}|j|}t |t r|r|d}nt |t r|}ni}|j|} dddddddd} | D]~} | jd} | %| d| d<| d | d <| d | d <| d | d <| | d<| jd xs| jd } | | | d <| jd}|z|| d<| |dS| td|"tjj}t |tr|j}n t|d}t |tr|j}n t|d}hd}||vrtd||jd|d|d|d}|jd|d|d|d}|jd|d|d|d}|j|} |j|}|j|}| ||dS)a Returns Running Lactate Threshold information, including heart rate, power, and speed :param bool (Required) - latest: Whether to query for the latest Lactate Threshold info or a range. False if querying a range :param date (Optional) - start_date: The first date in the range to query, format 'YYYY-MM-DD'. Required if `latest` is False. Ignored if `latest` is True :param date (Optional) - end_date: The last date in the range to query, format 'YYYY-MM-DD'. Defaults to current data. Ignored if `latest` is True :param str (Optional) - aggregation: How to aggregate the data. Must be one of `daily`, `weekly`, `monthly`, `yearly`. z/latestLactateThresholdz/powerToWeight/latest/z?sport=RunningrN) userProfilePKrersequencespeed heartRateheartRateCyclingrprnrerrorqhearRaterr)speed_and_heart_ratepowerz5you must either specify 'latest=True' or a start_daterr>rjweeklyyearlymonthlyzaggregation must be one of z/lactateThresholdSpeed/range/rz?sport=RUNNING&aggregation=z&aggregationStrategy=LATESTz!/lactateThresholdHeartRate/range/z /functionalThresholdPower/range/)rp heart_rateru) rQrtodayrrlistrrr isoformatr#rR)rrkrrrlspeed_and_heart_rate_url power_urlru power_dictrtspeed_and_heart_rate_dictentryrphrhrc_valid_aggregations speed_urlheart_rate_urlrys r"get_lactate_thresholdzGarmin.get_lactate_thresholds" 4455LM % <<==STXT^T^T`SaaopIOOI.E%&5"1X E4("  #'??3K#L "& $ !$() %. H '*$AFAW-o>;@;K-i8@En@U-n=-g6YY{+Duyy/D>=?-k:ii 23?DG-.@A# H&)B#   TU U  zz|--/H j$ '#--/J.z<HJ h %))+H,XzBHF 1 1:;N:OPQ Q>>??\]g\hhijristOP[O\\wx  CCDDefpeqqrs{r|}XYdXee@A>>??_`j_kklmulvwRS^R__z{  *__^4  *j5IIr+ value_in_mlct|tjs tdt |t kDrtdt d|j }|B|@tj}t|}tj}t|}n|4|2t|d}tj|t}t|}n|^|\t|ts td tj |}|jj#}t|}n~t|d}t|ts td tj |}|jj#}||k7rtd |d |d t|}|||d } t$j'd |j(j+d|| j-S#t$rtj|d}YwxYw#t$r}td|d}~wwxYw#t$rtj|d}YwxYw#t$rwxYw)aAdd hydration data in ml. Defaults to current date and current timestamp if left empty :param float required - value_in_ml: The number of ml of water you wish to add (positive) or subtract (negative) :param timestamp optional - timestamp: The timestamp of the hydration update, format 'YYYY-MM-DDThh:mm:ss.ms' Defaults to current timestamp :param date optional - cdate: The date of the weigh in, format 'YYYY-MM-DD'. Defaults to current date zvalue_in_ml must be a numberz&value_in_ml seems unreasonably high (>zml)Nrztimestamp must be a stringz%Y-%m-%dT%H:%M:%Sz,Invalid timestamp format (expected ISO 8601)ztimestamp date (z) doesn't match cdate ())rtimestampLocal valueInMLzAdding hydration datarr,)rr&r'rabsMAX_HYDRATION_MLrTrrzrrrr:r#rr rr|rrrputr ) rrrrrraw_dateraw_tsr!ts_dater1s r"add_hydration_datazGarmin.add_hydration_datasb+w||4;< < { . .89I8J#N 33  zz|HME\\^FI  9#4)%9E&&uo>FI ]y4i- !=>> XO%33I>F //1#FO *%9Ei- !=>> O%33I>F!++-113e#$*7)3J5'QRS$FO "'$   ,-zz~~lCg~>CCEEA"O%..y:MNFO X !OPVWW X"O%..y:MNFO  sa2G6)HH9/AI6HHHH H6% H11H69IIII I)ct|d}|jd|}tjd|j |S)zReturn available respiration data 'cdate' format 'YYYY-MM-DD'.rrzRequesting respiration data)r#rrrrrrOs r"get_respiration_datazGarmin.get_respiration_dataYsC&eW5::;1UGD 23s##r+ct|d}|jd|}tjd|j |S)z7Return available SpO2 data 'cdate' format 'YYYY-MM-DD'.rrzRequesting SpO2 data)r#rsrrrrOs r" get_spo2_datazGarmin.get_spo2_databsC&eW5334AeW= +,s##r+ct|d}|jd|}tjd|j |S)zDReturn available Intensity Minutes data 'cdate' format 'YYYY-MM-DD'.rrz!Requesting Intensity Minutes data)r#rtrrrrOs r"get_intensity_minutes_dataz!Garmin.get_intensity_minutes_dataksC&eW5<<=QugF 89s##r+ct|d}|jd|}tjd|j |S)zAReturn available all day stress data 'cdate' format 'YYYY-MM-DD'.rrzRequesting all day stress datar#r_rrrrOs r"get_all_day_stresszGarmin.get_all_day_stresstsC&eW5556aw? 56s##r+ct|d}|jd|}tjd|j |S)z Return available daily events data 'cdate' format 'YYYY-MM-DD'. Includes autodetected activities, even if not recorded on the watch rz?calendarDate=zRequesting all day events data)r#rurrrrOs r"get_all_day_eventszGarmin.get_all_day_events}sC &eW5--.nUGD 56s##r+c|jd|j}tjd|j |S)z)Return personal records for current user.rz$Requesting personal records for user)rVrrrrrrs r"get_personal_recordzGarmin.get_personal_records>8894;L;L:MN ;<s##r+cf|j}tjd|j|S)z&Return earned badges for current user.z!Requesting earned badges for user)rWrrrrs r"get_earned_badgeszGarmin.get_earned_badgess+33 89s##r+cn|j}tjd|j|ddiS)z)Return available badges for current user.z$Requesting available badges for usershowExclusiveBadgetruer)rXrrrrs r"get_available_badgeszGarmin.get_available_badgess566 ;<s,@&+IJJr+ctjd|j}|j}dtdt fd}t t||}t t||}|Dcic]}|d| }}|j|Dcic]}|d| c}t |jScc}wcc}w)z+Return in progress badges for current user.z&Requesting in progress badges for userbadgerc|jd}|sy|dk(ry|jd}||k(r*|jdy|jdd|dkSy)z(Return True if the badge is in progress.badgeProgressValueFrbadgeTargetValuebadgeLimitCountbadgeEarnedNumberT)r)rprogresstargets r"is_badge_in_progressz;Garmin.get_in_progress_badges..is_badge_in_progressskyy!56H1}YY12F6!99./7 yy!4a85AR;SSSr+badgeId) rrrrrr(r{filterupdatevalues)r earned_badgesavailable_badgesrearned_in_progress_badgesavailable_in_progress_badgesbcombineds r"get_in_progress_badgeszGarmin.get_in_progress_badgess  =>..0 446   %)0Dm)T$U!'+ ')9 :( $.GGAiL!OGG2NOQ9qOPHOO%&&HOs 4 B? Climitct|d}t|d}|j}t|t|d}tj d|j ||S)z)Return adhoc challenges for current user.rrrrz$Requesting adhoc challenges for userr)r0r2rYrrrrrrrrrs r"get_adhoc_challengeszGarmin.get_adhoc_challengesY/ug>*5':66u:E ; ;<s622r+ct|d}t|d}|j}t|t|d}tj d|j ||S)z)Return badge challenges for current user.rrr$Requesting badge challenges for userr)r0r2rZrrrrrs r"get_badge_challengeszGarmin.get_badge_challengesrr+ct|d}t|d}|j}t|t|d}tj d|j ||S)z"Return available badge challenges.rrrz%Requesting available badge challengesr)r0r2r[rrrrrs r"get_available_badge_challengesz%Garmin.get_available_badge_challengessY/ug>*5':@@u:E ; <=s622r+ct|d}t|d}|j}t|t|d}tj d|j ||S)z7Return badge non-completed challenges for current user.rrrrr)r0r2r\rrrrrs r""get_non_completed_badge_challengesz)Garmin.get_non_completed_badge_challengessY /ug>*5':DDu:E ; ;<s622r+ct|d}t|d}|j}t|t|d}tj d|j ||S)z7Return in-progress virtual challenges for current user.rrrz2Requesting in-progress virtual challenges for userr)r0r2r]rrrrrs r"!get_inprogress_virtual_challengesz(Garmin.get_inprogress_virtual_challengessY /ug>*5':CCu:E ; IJs622r+ct|d}|jd|j}|dd}tj d|j ||S)z#Return sleep data for current user.rr<)rnonSleepBufferMinuteszRequesting sleep datar)r#r^rrrrr<s r"get_sleep_datazGarmin.get_sleep_datasX&eW5445Qt7H7H6IJ"= ,-s622r+ct|d}|jd|}tjd|j |S)z$Return stress data for current user.rrzRequesting stress datarrOs r"get_stress_datazGarmin.get_stress_datasC&eW5556aw? -.s##r+ct|d}|jd|j}||dd}tj d|j ||S)z/Return resting heartrate data for current user.rrr)fromDate untilDatemetricIdz!Requesting resting heartrate datar)r#rjrrrrr<s r" get_rhr_dayzGarmin.get_rhr_days`&eW5,,-Qt/@/@.AB   89s622r+ct|d}|jd|}tjd|j |S)z:Return Heart Rate Variability (hrv) data for current user.rrz,Requesting Heart Rate Variability (hrv) data)r#rkrrrrOs r" get_hrv_datazGarmin.get_hrv_datasC&eW5,,-Qug6 CDs##r+ct|d}|jd|}tjd|j |S)z0Return training readiness data for current user.rrz"Requesting training readiness data)r#rlrrrrOs r"get_training_readinesszGarmin.get_training_readiness&sC&eW5;;Nrjrxzresults: _type must be one of .z/latest/rrinz5Startdate cannot be more than one year before enddater)fromCalendarDatetoCalendarDaterz7you must either provide all parameters or no parameters) rrmrrr#rrr rdays)rrrrvalidrrs r"get_race_predictionszGarmin.get_race_predictionsLs:(+  =eYaHI I =Y.7?668DDUDUCV9WW ??3' '  9#8W=P-iEI+GY?G!!'?;@@B##I?DDFGdS!K661UG1TEVEVDW9XX +4wOF??3v?6 6VW Wr+ct|d}|jd|}tjd|j |S)z-Return training status data for current user.rrzRequesting training status data)r#rnrrrrOs r"get_training_statuszGarmin.get_training_status}sC&eW58895'B 67s##r+ct|d}|jd|}tjd|j |S)z)Return Fitness Age data for current user.rrzRequesting Fitness Age data)r#r|rrrrOs r"get_fitnessage_datazGarmin.get_fitnessage_datasC&eW5//0%9 23s##r+cn|M|j}t|d}dt|i}tj d|j ||S|jd}t|d}t|d}t|t|dd}tj d |j ||S) zo Return hill score by day from 'startdate' format 'YYYY-MM-DD' to enddate 'YYYY-MM-DD' rrz+Requesting hill score data for a single dayrrrrjrz.Requesting hill score data for a range of days)r`r#rrrrrs r"get_hill_scorezGarmin.get_hill_scores ?44C-iEI$c)n5F LLF G??3v?6 6778?C-iEI+GY?G ^w<&F LLI J??3v?6 6r+cf|j}tjd|j|S)z6Return available devices for the current user account.zRequesting devices)rJrrrrs r" get_deviceszGarmin.get_devicess+-- )*s##r+ device_idcp|jd|}tjd|j|S)z3Return device settings for device with 'device_id'.z/device-info/settings/zRequesting device settingsrKrrr)rrrs r"get_device_settingszGarmin.get_device_settingss8//00FykR 12s##r+cf|j}tjd|j|S)zReturn detailed information around primary training devices, included the specified device and the priority of all devices. z.Requesting primary training device information)rLrrrrs r"get_primary_training_devicez"Garmin.get_primary_training_devices+ 44 EFs##r+c||}d}nd}t|d}t|d}d|i}|jd|d|d|}|j||}|rd|vr td |dS) z8Return solar data for compatible device with 'device_id'TFrr singleDayViewrrdeviceSolarInputz#No device solar input data received)r#rMrr)rrrr single_dayrrresps r"get_device_solar_datazGarmin.get_device_solar_datas ?GJJ))[A ';!:.../q 1YKq Rs62)5./TU U&''r+ctjdg}|j}|D]/}|j|d}|j d}|+||z }1|S)z+Get list of active alarms from all devices.zRequesting device alarmsdeviceIdalarms)rrrrr)rrdevicesdevicedevice_settings device_alarmss r"get_device_alarmszGarmin.get_device_alarmsso  /0""$ (F"66vj7IJO+//9M(-'  (  r+cl|jd}tjd|j|S)zReturn device last used.z /mylastusedzRequesting device last usedrrs r"get_device_last_usedzGarmin.get_device_last_useds3//0 < 23s##r+ activitytypecXt|d}t|d}|tkDrtdt|j}t |t |d}|rt ||d<t jd|||j||}|t jdgS|S) a, Return available activities. :param start: Starting activity offset, where 0 means the most recent activity :param limit: Number of activities to return :param activitytype: (Optional) Filter activities by type :return: List of activities from Garmin rrzlimit cannot exceed r activityTypez+Requesting activities from %d with limit %drzNo activities data received) r0r2MAX_ACTIVITY_LIMITrrvrrrrr)rrrrrr activitiess r"get_activitieszGarmin.get_activitiess/ug>*5': % %34F3GHI I,,u:E ; %(%6F> " BE5Q__S_8   NN8 9Ir+fordatect|d}|jd|}tjd||j |S)z%Return available activities for date.r rz!Requesting activities for date %s)r#rzrrrrr rs r"get_activities_fordatezGarmin.get_activities_fordatesE(;556ayA 8'Bs##r+ activity_idtitlecl|jd|}||d}|jjd||dS)zSet name for activity with id.r) activityId activityNamerTr r)rxrr)rrrrr1s r"set_activity_namezGarmin.set_activity_names@--.a }=!,eDzz~~lCg4~HHr+type_idtype_keyparent_type_idc|jd|}||||dd}tjd||jj d||dS)Nr)typeIdtypeKey parentTypeId)ractivityTypeDTOzChanging activity type: %srTr)rxrrrr)rrrrrrr1s r"set_activity_typezGarmin.set_activity_type&s_--.a }=%!# .    17;zz~~lCg4~HHr+r1c|j}tjdt||jj d||dS)NzUploading manual activity: %srTr)rxrrrrr)rr1rs r" create_manual_activity_from_jsonz'Garmin.create_manual_activity_from_json9s>--. 4c'lCzz|SwDIIr+start_datetime time_zone distance_km duration_min activity_namec \d|idddd|i|ddi||dz|d zd d }|j|S) a Create a private activity manually with a few basic parameters. type_key - Garmin field representing type of activity. See https://connect.garmin.com/modern/main/js/properties/activity_types/activity_types.properties Value to use is the key without 'activity_type_' prefix, e.g. 'resort_skiing' start_datetime - timestamp in this pattern "2023-12-02T10:00:00.000" time_zone - local timezone of the activity, e.g. 'Europe/Paris' distance_km - distance of the activity in kilometers duration_min - duration of the activity in minutes activity_name - the title rprivate)rrr#autoCalcCaloriesTrr)startTimeLocaldistanceduration)raccessControlRuleDTOtimeZoneUnitDTOr metadataDTO summaryDTO)r")rr#r$rr%r&r'r1s r"create_manual_activityzGarmin.create_manual_activity>s](!*84/0Y$G )95)"D#1'$.(2-  44W==r+c|jdd}|r#t|trt|dkDr|dS|r.t|trd|vr|d}|rt|dkDr|dSy)zReturn last activity.rr activityListN)r rr{rr)rr  activity_lists r"get_last_activityzGarmin.get_last_activityasq((A. *Z63z?Q;Nb> ! :j$7Nj >  xxz#&6}o$FG Gyy{3M?CD DDE E$))#. z?Q 5)-9 $B  "f&A&A&M&M M  " VVD\U[#nk%BCE44C::??<Et?TUU#ii(C(C(O(O(T(T(VWO5''77KOK\] UUU 2*=/A3? s0(F 91E<* F <FF F)F$$F)c|jd|}tjd||jj dd|dS)z!Delete activity with specified idrzDeleting activity with id %sr@rTrA)rrrrrBrrrs r"delete_activityzGarmin.delete_activitysR889;-H 3[Azz!!    "  r+ sortordercg}d}d}|j}t|d}| t|d}|t|t|d} |r|| d<|rt|| d<|rt|| d<tj d || t|| d <tj d |||z|j || } | r|j | ||z}n |SX) a Fetch available activities between specific dates :param startdate: String in the format YYYY-MM-DD :param enddate: (Optional) String in the format YYYY-MM-DD :param activitytype: (Optional) Type of activity you are searching Possible values are [cycling, running, swimming, multi_sport, fitness_equipment, hiking, walking, other] :param sortorder: (Optional) sorting direction. By default, Garmin uses descending order by startLocal field. Use "asc" to get activities from oldest to newest. :return: list of JSON activities rrCrr)rrrrr  sortOrderz+Requesting activities by date from %s to %srzRequesting activities %d to %dr)rvr#rrrrextend) rrrrrRr rrrracts r"get_activities_by_datezGarmin.get_activities_by_dates& ,,))[A  +GY?G"ZZ   'F9  %(%6F> " "%i.F;  BIwW!%jF7O LL95%%- P//#f/5C!!#& r+metricgroupbyactivitiesc|j}t|d}t|d}t|t|dt|t|d}tj d|||j ||S)a Fetch progress summary data between specific dates :param startdate: String in the format YYYY-MM-DD :param enddate: String in the format YYYY-MM-DD :param metric: metric to be calculated in the summary: "elevationGain", "duration", "distance", "movingDuration" :param groupbyactivities: group the summary by activity type :return: list of JSON activities with their aggregated progress summary rrlifetime)rrrlgroupByParentActivityTyperXz-Requesting fitnessstats by date from %s to %sr)r{r#rrrr)rrrrXrYrrs r""get_progress_summary_between_datesz)Garmin.get_progress_summary_between_datessy"..))[A ';Y7|%),->)?&k    ;Y s622r+cf|j}tjd|j|S)NzRequesting activity types)ryrrrrs r"get_activity_typeszGarmin.get_activity_types s)00 01s##r+rcg}|j}hd}||vrtd|t|d}t|d}|t|t|dd}tj d| t||d<tj d||||zd z |j || }|r|j|||z}n |S\) aj Fetch all goals based on status :param status: Status of goals (valid options are "active", "future", or "past") :type status: str :param start: Initial goal index :type start: int :param limit: Pagination limit when retrieving goals :type limit: int :return: list of goals in JSON format >pastactivefuturezstatus must be one of rrasc)rrrrTzRequesting %s goalszRequesting %s goals %d to %drr)rirr2rrrrrU) rrrrgoalsrvalid_statusesr goals_jsons r" get_goalszGarmin.get_goalss++5  '5n5EFG G*5':*5':ZZ    *F3!%jF7O LL.uu}q?P V*;)< > zz!!/<$!OOr+cVeZdZdZeZeZeZeZeZ y)Garmin.ActivityDownloadFormatzActivity variables.N) __name__ __module__ __qualname____doc__rORIGINALTCXGPXKMLCSVrr+r"ActivityDownloadFormatr{Ys(!6ffffr+rc6eZdZeZeZeZy)Garmin.ActivityUploadFormatN)r|r}r~rFITrrrr+r"rArbsfffr+rAdl_fmtc 4t|}tjj|jd|tjj |j d|tjj|jd|tjj|jd|tjj|jd|i}||vrtd|d||}tjd||j!|S)z Downloads activity in requested format and returns the raw bytes. For "Original" will return the zip file content, up to user to extract it. "CSV" will return a csv of the splits. rzunexpected value z for dl_fmtzDownloading activity from %s)rr<rrr}rr~rrrrrrrrrr)rrrurlsrs r"download_activityzGarmin.download_activitygs+&  ) ) 2 2t7W7W6XXYZeYf4g  ) ) - -$2R2R1SSTU`Ta/b  ) ) - -$2R2R1SSTU`Ta/b  ) ) - -$2R2R1SSTU`Ta/b  ) ) - -$2R2R1SSTU`Ta/b    0 DE E6l 3S9}}S!!r+ct|}|jd|d}tjd||j |S)zReturn activity splits.rz/splitsz$Requesting splits for activity id %srrxrrrrPs r"get_activity_splitszGarmin.get_activity_splitssE+& --.a }GD ;[Is##r+ct|}|jd|d}tjd||j |S)zReturn typed activity splits. Contains similar info to `get_activity_splits`, but for certain activity types (e.g., Bouldering), this contains more detail.rz /typedsplitsz*Requesting typed splits for activity id %srrPs r"get_activity_typed_splitsz Garmin.get_activity_typed_splitssE+& --.a }LI A;Os##r+ct|}|jd|d}tjd||j |S)z Return activity split summaries.rz/split_summariesz-Requesting split summaries for activity id %srrPs r"get_activity_split_summariesz#Garmin.get_activity_split_summariessF+& --.a }*5': @%O 51s622r+ workout_idcptt|d}|jd|}|j|S)zReturn workout by id.rz /workout/)r2r/rrrrrs r"get_workout_by_idzGarmin.get_workout_by_ids:0JN %%&i |<s##r+ctt|d}|jd|}tj d||j |S)zDownload workout by id.rz /workout/FIT/zDownloading workout from %s)r2r/rrrrrs r"download_workoutzGarmin.download_workoutsI0JN %%&mJ<@ 2C8}}S!!r+ workout_jsonc||jd}tjd|t|trddl} |j |}n|}t|ttzs td|jjd||d j S#t$r}td||d}~wwxYw) zUpload workout using json data.z/workoutzUploading workout using %srNzinvalid workout_json string: z+workout_json must be a JSON object or arrayrTr) rrrrrr rrrrr{rr)rrr_jsonr1r!s r"upload_workoutzGarmin.upload_workout"s %%&h/ 137 lC (  M++l3#G'4$;/JK Kzz|SwDINNPP  M #@!DE1L MsB B;'B66B;ct|d}|jd|}tjd||j |S)zReturn menstrual data for date.r rz%Requesting menstrual data for date %s)r#rgrrrrs r"get_menstrual_data_for_datez"Garmin.get_menstrual_data_for_date7sE(;::;1WIF $$$S#X$$$S#X$ $ $S#X $$T#s(^$$4S#X#7$Kd4S>&:K'T#s(^(<'@ 3# 3c 3d38n 3 3# 3c 3d38n 3 3C 3 3SRUX 3 3 3!$ 3 c3h 3 3 3!$ 3 c3h 33C3DcN3$S$T#s(^$ 3 3c3h 3$#$$sCx.4*?$$C$DcN$5977'*Tz7 c3h7>!%" /X:/Xt/XTz /X c3h /Xb$$c3h$$$c3h$5977'*Tz7 c3h7:$T$sCx.1$$S$T#s(^$$T#s(^$EI((),(7:Tz( d38n (* 49 $d38n$#' """Dj " c3h$s) # "H$c$d38n$ISIIIIII I  I I&JS#XJ3J !>!>!> !>  !>  !>!> !>F 4S>D#8 4S4S4l  3  3  ##' $ 44t4Dj 4 : 4 d38n  4t!"& 333 3  3 c3h 3B$DcN$ DF))-0)=@) d38n )V$#$$sCx.$$s$tCH~$ $3$4S>$EI P P+. P=A P  Pt*@)C)C""'"  "4$s$tCH~$$S$T#s(^$$$S#X$$$S#X$$$S#X$$$S#X$FJ 3 3*- 3?B 3 c3h 3$cCi$DcN$ 3S3Y 34S> 3+/$$$'$ d38n $"$$sCx.$$$sCx.$ CC CDcN C3#3#3S#X3$C#I$$sCx.$"39""Q cNT#Y6<Q c3hQ*$3$4S>$ $ $'* $ c3h $$tCH~$$sCx.T#s(^2 r+r<ceZdZdZy)rz)Raised when communication ended in error.Nr|r}r~rrr+r"rrws3r+rceZdZdZy)rz#Raised when rate limit is exceeded.Nrrr+r"rr{s-r+rceZdZdZy)rz%Raised when authentication is failed.Nrrr+r"rrs/r+rceZdZdZy)r?z7Raised when an invalid file format is passed to upload.Nrrr+r"r?r?sAr+r?)r)r$)/rloggingr&rrcollections.abcrrrrenumrrpathlibr typingr rr garth.excr r r fitr getLoggerr|rr rrr r-rr#r/rr*r0r2r:r<rrrrr?rr+r"rs8. $-- 4!   8 $*E]CSc.+2  ; $' 5[  #3ScsIISI V  V  r@494. .0y0B)Br+