Ɔc4dZddlZddlZddlmZmZddlmZddlZddl m Z ddl m Z m Z mZeZGdd eZGd d ZdS) zL Helpers to interact with the ERFA library, in particular for leap seconds. N)datetime timedelta)warn) ErfaWarning)get_leap_secondsset_leap_secondsdt_eraLEAPSECONDcbeZdZdZd fd Zd fd ZdZfdZdZd Z e d Z xZ S) classpropertya Similar to `property`, but allows class-level properties. That is, a property whose getter is like a `classmethod`. The wrapped method may explicitly use the `classmethod` decorator (which must become before this decorator), or the `classmethod` may be omitted (it is implicit through use of this decorator). .. note:: classproperty only works for *read-only* properties. It does not currently allow writeable/deletable properties, due to subtleties of how Python descriptors work. In order to implement such properties on a class a metaclass for that class must be implemented. Parameters ---------- fget : callable The function that computes the value of this property (in particular, the function when this is used as a decorator) a la `property`. doc : str, optional The docstring for the property--by default inherited from the getter function. lazy : bool, optional If True, caches the value returned by the first call to the getter function, so that it is only called once (used for lazy evaluation of an attribute). This is analogous to `lazyproperty`. The ``lazy`` argument can also be used when `classproperty` is used as a decorator (see the third example below). When used in the decorator syntax this *must* be passed in as a keyword argument. Examples -------- :: >>> class Foo: ... _bar_internal = 1 ... @classproperty ... def bar(cls): ... return cls._bar_internal + 1 ... >>> Foo.bar 2 >>> foo_instance = Foo() >>> foo_instance.bar 2 >>> foo_instance._bar_internal = 2 >>> foo_instance.bar # Ignores instance attributes 2 As previously noted, a `classproperty` is limited to implementing read-only attributes:: >>> class Foo: ... _bar_internal = 1 ... @classproperty ... def bar(cls): ... return cls._bar_internal ... @bar.setter ... def bar(cls, value): ... cls._bar_internal = value ... Traceback (most recent call last): ... NotImplementedError: classproperty can only be read-only; use a metaclass to implement modifiable class-level properties When the ``lazy`` option is used, the getter is only called once:: >>> class Foo: ... @classproperty(lazy=True) ... def bar(cls): ... print("Performing complicated calculation") ... return 1 ... >>> Foo.bar Performing complicated calculation 1 >>> Foo.bar 1 If a subclass inherits a lazy `classproperty` the property is still re-evaluated for the subclass:: >>> class FooSub(Foo): ... pass ... >>> FooSub.bar Performing complicated calculation 1 >>> FooSub.bar 1 NFc^|fd}|StS)Nc|S)N)lazy)funcclsrs ,lib/python3.11/site-packages/erfa/helpers.pywrapperz&classproperty.__new__..wrapper}ss4d++++)super__new__)rfgetdocrr __class__s` ` rrzclassproperty.__new__ysH   , , , , , ,Nwws###rc||_|rtj|_i|_||}t ||| ||_dSdS)N)rr) _lazy threadingRLock_lock_cache _wrap_fgetr__init____doc__)selfrrrrs rr"zclassproperty.__init__su  "**DJDKt$$ d,,,  DLLL  rct|jr|j|t}|turl|j5|j|t}|tur$|j|}||j|<dddn #1swxYwYn|j|}|SN)rr get _NotFoundrr __wrapped__)r$objobjtypevals r__get__zclassproperty.__get__s : 1+//'955Ci 3Z33+//'9==Ci'3"i33G<</2 G, 333333333333333)''00C sABBBclt||Sr&)rgetterr!)r$rrs rr/zclassproperty.getters%ww~~dood33444rc tdNzcclassproperty can only be read-only; use a metaclass to implement modifiable class-level propertiesNotImplementedError)r$fsets rsetterzclassproperty.setter! :;; ;rc tdr1r2)r$fdels rdeleterzclassproperty.deleterr6rc~ttrjtjfd}|S)Nc$|jSr&r)r* orig_fgets rrz&classproperty._wrap_fget..fgets9S]++ +r) isinstance classmethod__func__ functoolswraps)r=rs` rr!zclassproperty._wrap_fgetsT i - - +!*I  # # , , , , $ # , r)NNF)NF) __name__ __module__ __qualname__r#rr"r-r/r5r9 staticmethodr! __classcell__r<s@rr r s__B $ $ $ $ $ $""55555;;; ;;;   \     rr ceZdZdZdZ dZ dZedZedZ ed dZ e dZ e d Z ed ZdS) leap_secondsaNLeap second management. This singleton class allows access to ERFA's leap second table, using the methods 'get', 'set', and 'update'. One can also check expiration with 'expires' and 'expired'. Note that usage of the class is similar to a ``ScienceState`` class, but it cannot be used as a context manager. Nc td)Nz/This class is a singleton. Do not instantiate.) RuntimeError)r$s rr"zleap_seconds.__init__sLMMMrctS)z2Get the current leap-second table used internally.)rrs rr'zleap_seconds.gets !!!rc |d}n#t$rd}YnwxYwt|dd}|t|tst|dd} |/tj|ddd}ntj|d }n4#t$r'}t d |d |td}Yd}~nd}~wwxYwt|d r1| ttj }tj|td d}|jdkrt!dtj|dk|ddkz|ddkz|ddkzst!dtj|ddddktj|ddkzrt!d||fS)aValidate a leap-second table. Parameters ---------- table : array_like Must have 'year', 'month', and 'tai_utc' entries. If a 'day' entry is present, it will be checked that it is always 1. If ``table`` has an 'expires' attribute, it will be interpreted as an expiration date. Returns ------- array : `~numpy.ndarray` Structures array with 'year', 'month', 'tai_utc'. expires: `~datetime.datetime` or None Possible expiration date inferred from the table. `None` if not present or if not a `~datetime.datetime` or `~astropy.time.Time` instance and not parsable as a 'dd month yyyy' string. Raises ------ ValueError If the leap seconds in the table are not on the 1st of January or July, or if the sorted TAI-UTC do not increase in increments of 1. dayrexpiresNisotTrz%Y-%m-%dz%d %B %Yz!ignoring non-datetime expiration z; parsing it raised __array__F)dtypecopyndminz(can only pass in one-dimensional tables.monthyearizDleap seconds inferred that are not on 1st of January or 1st of July.itai_utcz+jump in TAI-UTC by something else than one.) Exceptiongetattrr>rstrptime partitionrrhasattrrTlistr namesnparrayndim ValueErrorallanydiff)rtablerPrQrRexcs rvalidatezleap_seconds.validatesb6 ,CC   CCC %D11  z'8'D'D 7FD11D E&/s0C0CA0F0:<@@@  5+ & & DOO%%d+;+A&B&BCE&6U """ :> IGHH Hvqg!+-05g!0CEV}t+-.. ?>?? ? 65="%,75+,,13 4 4 LJKK Kg~s% AB C(C  Ccl|d}n||\}}t|||_dS)aHSet the ERFA leap second table. Note that it is generally safer to update the leap-second table than to set it directly, since most tables do not have the pre-1970 changes in TAI-UTC that are part of the built-in ERFA table. Parameters ---------- table : array_like or `None` Leap-second table that should at least hold columns of 'year', 'month', and 'tai_utc'. Only simple validation is done before it is being used, so care need to be taken that entries are correct. If `None`, reset the ERFA table to its built-in values. Raises ------ ValueError If the leap seconds in the table are not on the 1st of January or July, or if the sorted TAI-UTC do not increase in increments of 1. N)rmr _expires)rrkrQs rsetzleap_seconds.set#sA,  1GG \\%00NE7 rc|jL|d}t|d|ddt|jzS|jS)zThe expiration date of the current ERFA table. This is either a date inferred from the last table used to update or set the leap-second array, or a number of days beyond the last leap second. Nr[rZrXr)ror'rr_expiration_days)rlasts rrQzleap_seconds.expiresAsX < 7799R=DT&\4=!<<c2334 5< rc:|jtjkS)z:Whether the leap second table is valid beyond the present.)rQrnowrNs rexpiredzleap_seconds.expiredPs{X\^^++rc0||\}} ||\}}n8#t$r+||}YnwxYwt j||}|| |||jkr||_n<#t$r/}tdt|ztYd}~nd}~wwxYwt|t|z S)a]Add any leap seconds not already present to the ERFA table. This method matches leap seconds with those present in the ERFA table, and extends the latter as necessary. If the ERFA leap seconds file was corrupted, it will be reset. If the table is corrupted, the ERFA file will be unchanged. Parameters ---------- table : array_like or `~astropy.utils.iers.LeapSeconds` Array or table with TAI-UTC from leap seconds. Should have 'year', 'month', and 'tai_utc' columns. Returns ------- n_update : int Number of items updated. Raises ------ ValueError If the leap seconds in the table are not on the 1st of January or July, or if the sorted TAI-UTC do not increase in increments of 1. NzStable 'expires' attribute ignored as comparing it with a datetime raised an error: ) rmr'r]rprdunion1drQrorstrrlen)rrkrQerfa_ls_lsrls rupdatezleap_seconds.updateUs58e,,w cggii00JGQQ   GGIIIggiiGGG Z ' '    'w'< '&     68;CA          2wwW%%s)*A2A:9A:(B== C6%C11C6r&)rCrDrEr#rorrr"r?r'rmrpr rQrvr~rrrrIrIs  HCHNNN""["FF[FP[:   ]  ,,],4&4&[4&4&4&rrI)r#rArrrwarningsrnumpyrdcorerufuncrr r objectr(propertyr rIrrrrs ((((((((GGGGGGGGGG FHH hhhhhHhhhVH&H&H&H&H&H&H&H&H&H&r