Qfg#dZddlZddlZddlmZmZddlmZddlm Z m Z ddl m Z m Z mZ ddlZn#e$r ddlmZYnwxYwgdZd Zd Ze ejejfZeee eeffZeZeZeZd"d e ejd ejfd Zd"d e ejd ejfdZ d"deeeefde ed efdZ ded ej!fdZ"dej!d efdZ#dej!d efdZ$ded efdZ%GddeZ&GddeZ'eGddZ(eGddZ)eGd d!Z*dS)#aCalculations for the position of the sun and moon. The :mod:`astral` package provides the means to calculate the following times of the sun * dawn * sunrise * noon * midnight * sunset * dusk * daylight * night * twilight * blue hour * golden hour * rahukaalam * moon rise, set, azimuth and zenith plus solar azimuth and elevation at a specific latitude/longitude. It can also calculate the moon phase for a specific date. The package also provides a self contained geocoder to turn a small set of location names into timezone, latitude and longitude. The lookups can be perfomed using the :func:`~astral.geocoder.lookup` function defined in :mod:`astral.geocoder` N) dataclassfield)Enum)radianstan)OptionalTupleUnion)zoneinfo) Depression SunDirectionObserver LocationInfoAstralBodyPositionnowtoday dms_to_floatrefraction_at_zenithz3.2z(Simon Kennedy tzreturnctjtjj}||S||S)z3Returns the current time in the specified time zone)datetimertimezoneutc astimezone)rnow_utcs N/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/astral/__init__.pyrrPs<##H$5$9::G z   b ! !!cDt|S)z3Returns the current date in the specified time zone)rdate)rs rrrYs r77<<>>rdmslimitcz t|}n#ttf$r}d}tj|t |tj}|r|dpd}|dpd}|dpd}|dpd} t|}|r|t|d z z }|r|t|d z z }| d vr| }ntd |Yd }~nd }~wwxYw|||kr|}n || kr| }|S)uRConverts as string of the form `degrees°minutes'seconds"[N|S|E|W]`, or a float encoded as a string, to a float N and E return positive values S and W return negative values Args: dms: string to convert limit: Limit the value between ± `limit` Returns: The number of degrees as a float uW(?P\d{1,3})[°]((?P\d{1,2})[′'])?((?P\d{1,2})[″\"])?(?P[NSEW])?)flagsdegminsecdirE<)SWz2Unable to convert degrees/minutes/seconds to floatN) float ValueError TypeErrorrematchstr IGNORECASEgroupupper) r!r"resexc_dms_re dms_matchr%min_r(dir_s rrr^sg"Cjj  "lHWc#hhbmDDD  //%((/CC??5))0SD//%((/CC??5))0SD**C (uT{{R'' )uSzzD((zz||z))dD %,  ;;CC E6\\&C JsD#C5DD#valuect|}||z}|dz}t|}||z}|dz}t|}||z}t|dz}tj||||S)z;Convert a floating point number of hours to a datetime.timer+@B)intrtime)r>hourminutesecond microseconds r hours_to_timerGsy u::D TME RKE ZZF VOE RKE ZZF VOEego&&K =vv{ ; ;;rcld}||jz }||jdz z }||jdz z }||jdz z }|S)z;Convert a datetime.time to a floating point number of hoursr&r+r,r@)rCrDrErFr>hourss r time_to_hoursrKsN E UZE U\B E U\D  E U  ((E Lrc*t|}|dzS)z=Convert a datetime.time to a floating point number of secondsr,)rKrIs rtime_to_secondsrMs % E 4<rzenithcd|z }|dkrdSd}tt|}|dkr$d|z d||z|zz z d||z|z|z|zz z}n,|d kr!d |d zz}d ||zz}d ||zz}d||zz}nd|z }|dz }|S)zJCalculate the degrees of refraction of the sun due to the sun's elevation.Zg@U@rr&g@g M@gQ?g6w\?gffffffgGz)gn?gY@g1g@g/$4g @)rr)rN elevationrefraction_correctiontestep1step2step3s rrrsV IDq WY   B3 2IR" - -BGbL2The depression angle in degrees for the dawn/dusk calculations N)__name__ __module__ __qualname____doc__CIVILNAUTICAL ASTRONOMICALrrr r s#HH EHLLLrr ceZdZdZdZdZdS)r z-Direction of the sun either RISING or SETTINGN)r[r\r]r^RISINGSETTINGrbrrr r s77 FGGGrr czeZdZUdZeeZeed<eeZ eed<eeZ eed<dS)rz1The position of an astral body as seen from earth)default_factoryright_ascension declinationdistanceN) r[r\r]r^rr/rjRadians__annotations__rkrlrbrrrrso;;$uU;;;OW;;; 5777K777e444Hg44444rrcjeZdZUdZdZeed<dZeed<dZe ed<de d e e e e fffd Z xZS) ru'Defines the location of an observer on Earth. Latitude and longitude can be set either as a float or as a string. For strings they must be of the form degrees°minutes'seconds"[N|S|E|W] e.g. 51°31'N `minutes’` & `seconds”` are optional. Elevations are either * A float that is the elevation in metres above a location, if the nearest obscuring feature is the horizon * or a tuple of the elevation in metres and the distance in metres to the nearest obscuring feature. Args: latitude: Latitude - Northern latitudes should be positive longitude: Longitude - Eastern longitudes should be positive elevation: Elevation and/or distance to nearest obscuring feature in metres above/below the location. 1*I@latitude~:NK longituder&rQnamer>cR|dkrt|d}nl|dkrt|d}nU|dkrOt|tr+t|dt|df}nt|}t ||dS)NrqV@rsf@rQrrd)r isinstancetupler/super __setattr__selfrtr> __class__s rr{zObserver.__setattr__s :   --EE [  ..EE [ %'' %uQx%a//:e  D%(((((r)r[r\r]r^rqDegreesrnrsrQ Elevationr4r r/r{ __classcell__r~s@rrrs. Hg#Iw###Iy ) )E#ui2G,H ) ) ) ) ) ) ) ) ) )rrceZdZUdZdZeed<dZeed<dZeed<dZ e ed <d Z e ed <ded e e efffd Z edZedZedZxZS)ruDefines a location on Earth. Latitude and longitude can be set either as a float or as a string. For strings they must be of the form degrees°minutes'seconds"[N|S|E|W] e.g. 51°31'N `minutes’` & `seconds”` are optional. Args: name: Location name (can be any string) region: Region location is in (can be any string) timezone: The location's time zone (a list of time zone names can be obtained from `zoneinfo.available_timezones`) latitude: Latitude - Northern latitudes should be positive longitude: Longitude - Eastern longitudes should be positive GreenwichrtEnglandregionz Europe/Londonrrprqrrrsr>c|dkrt|d}n|dkrt|d}t||dS)Nrqrvrsrw)rrzr{r|s rr{zLocationInfo.__setattr__)sY :   --EE [  ..E D%(((((rc8t|j|jdS)z#Return an Observer at this locationr&)rrqrsr}s robserverzLocationInfo.observer0s t~s;;;rc4tj|jS)z,Return a zoneinfo.ZoneInfo for this location)r ZoneInforrs rtzinfozLocationInfo.tzinfo5s ///rcF|jdddS)z!Return the group a timezone is in/rd)maxsplitr)rsplitrs rtimezone_groupzLocationInfo.timezone_group:s$}""3"33A66r)r[r\r]r^rtr4rnrrrqrrsr r{propertyrrrrrs@rrrs$D#FC#Hc###Hg#Iw###))E'3,,?))))))<<X<00X077X77777rr)N)+r^rr2 dataclassesrrenumrmathrrtypingrr r r ImportError backports__all__ __version__ __author__ TimePeriodr/rrrmMinutesrrr rr4rrBrGrKrMrr r rrrrbrrrsT"6 (((((((())))))))))#OOOO###""""""""#    7 8$h&77 8 %ue|,, -   ""HX_ %"1B""""hx'8= AE// sE9$ %/.6uo/ ////d < <8= < < < <  5    8=U!!5!!!!44 5555555 5 &)&)&)&)&)&)&) &)R -7-7-7-7-7-7-7 -7-7-7s 1 ??