jddlmZddlZddlZddlZddlmZddlm Z ej rddl m Z eGddZ dd ZGd dejZGddejZdS)) annotationsN) dataclass) Neo4jError)_TAuthc4eZdZUdZded<dZded<d d ZdS) ExpiringAuthaRepresents potentially expiring authentication information. This class is used with :meth:`.AuthManagers.expiration_based` and :meth:`.AsyncAuthManagers.expiration_based`. :param auth: The authentication information. :param expires_at: Unix timestamp (seconds since 1970-01-01 00:00:00 UTC) indicating when the authentication information expires. If :data:`None`, the authentication information is considered to not expire until the server explicitly indicates so. .. seealso:: :meth:`.AuthManagers.expiration_based`, :meth:`.AsyncAuthManagers.expiration_based` .. versionadded:: 5.8 .. versionchanged:: 5.9 * Removed parameter and attribute ``expires_in`` (relative expiration time). Replaced with ``expires_at`` (absolute expiration time). * :meth:`.expires_in` can be used to create an :class:`.ExpiringAuth` with a relative expiration time. .. versionchanged:: 5.14 Stabilized from preview. rauthNzt.Optional[float] expires_atsecondsfloatreturncTt|jtj|zS)a6Return a (flat) copy of this object with a new expiration time. This is a convenience method for creating an :class:`.ExpiringAuth` for a relative expiration time ("expires in" instead of "expires at"). >>> import time, freezegun >>> with freezegun.freeze_time("1970-01-01 00:00:40"): ... ExpiringAuth(("user", "pass")).expires_in(2) ExpiringAuth(auth=('user', 'pass'), expires_at=42.0) >>> with freezegun.freeze_time("1970-01-01 00:00:40"): ... ExpiringAuth(("user", "pass"), time.time() + 2) ExpiringAuth(auth=('user', 'pass'), expires_at=42.0) :param seconds: The number of seconds from now until the authentication information expires. .. versionadded:: 5.9 )r r time)selfr s `/lsinfo/ai/hellotax_ai/base_platform/venv/lib/python3.11/site-packages/neo4j/_auth_management.py expires_inzExpiringAuth.expires_in?s!(DIty{{W'<===)r r rr )__name__ __module__ __qualname____doc____annotations__r rrrr r sP6LLL$(J((((>>>>>>rr r rboolcF|j}|duo|tjkS)N)r r)r r s rexpiring_auth_has_expiredrVs$J T ! >j49;;&>>rcVeZdZdZejd dZejd d Zd S) AuthManageraBaseclass for authentication information managers. The driver provides some default implementations of this class in :class:`.AuthManagers` for convenience. Custom implementations of this class can be used to provide more complex authentication refresh functionality. .. warning:: The manager **must not** interact with the driver in any way as this can cause deadlocks and undefined behaviour. Furthermore, the manager is expected to be thread-safe. The token returned must always belong to the same identity. Switching identities using the `AuthManager` is undefined behavior. You may use session-level authentication for such use-cases :ref:`session-auth-ref`. .. seealso:: :class:`.AuthManagers` .. versionadded:: 5.8 .. versionchanged:: 5.12 ``on_auth_expired`` was removed from the interface and replaced by :meth:`handle_security_exception`. The new method is called when the server returns any `Neo.ClientError.Security.*` error. It's signature differs in that it additionally receives the error returned by the server and returns a boolean indicating whether the error was handled. rrcdS)a Return the current authentication information. The driver will call this method very frequently. It is recommended to implement some form of caching to avoid unnecessary overhead. .. warning:: The method must only ever return auth information belonging to the same identity. Switching identities using the `AuthManager` is undefined behavior. You may use session-level authentication for such use-cases :ref:`session-auth-ref`. Nrrs rget_authzAuthManager.get_auth|s  rr errorrrcdS)aHandle the server indicating authentication failure. The driver will call this method when the server returns any `Neo.ClientError.Security.*` error. The error will then be processed further as usual. :param auth: The authentication information that was used when the server returned the error. :param error: The error returned by the server. :returns: Whether the error was handled (:const:`True`), in which case the driver will mark the error as retryable (see :meth:`.Neo4jError.is_retryable`). .. versionadded:: 5.12 Nrrr r#s rhandle_security_exceptionz%AuthManager.handle_security_exceptions . rNrrr rr#rrrrrrrabcabstractmethodr"r&rrrrr[sg@            rr) metaclasscVeZdZdZejd dZejd d Zd S) AsyncAuthManageraAsync version of :class:`.AuthManager`. .. seealso:: :class:`.AuthManager` .. versionadded:: 5.8 .. versionchanged:: 5.12 ``on_auth_expired`` was removed from the interface and replaced by :meth:`handle_security_exception`. See :class:`.AuthManager`. rrc KdS)zlAsync version of :meth:`.AuthManager.get_auth`. .. seealso:: :meth:`.AuthManager.get_auth` Nrr!s rr"zAsyncAuthManager.get_auths rr r#rrc KdS)zzAsync version of :meth:`.AuthManager.on_auth_expired`. .. seealso:: :meth:`.AuthManager.on_auth_expired` Nrr%s rr&z*AsyncAuthManager.handle_security_exceptions  rNr'r(r)rrrr.r.sf              rr.)r r rr) __future__rr*rtypingt dataclassesr exceptionsr TYPE_CHECKINGapirr rABCMetarr.rrrr9s8"#""""" !!!!!!""""""? 3>3>3>3>3>3>3> 3>l???? I I I I I CKI I I I X           r