o V hm#@s"UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZmZmZddlmZdd lmZeeZed ZdZd ed <Gd ddejZGdddedZ GdddZ!Gddde!Z"dddZ#ed ddZ$GdddZ%dS)!z Keyring implementation support ) annotationsN) ExceptionTrap)once) credentialserrorsutil) properties)metadatapriorityz.typing.Callable[[KeyringBackend], bool] | None_limitcs0eZdZdZfddZddZddZZS)KeyringBackendMetaz Specialized subclass behavior. Keeps a registry of all (non-abstract) types. Wraps set_password to validate the username. cs$t|||||dSN)super__init__ _register"_validate_username_in_set_password)clsnamebasesdict __class__c/var/www/html/construction_image-detection-poc/venv/lib/python3.10/site-packages/keyring/backend.pyr's zKeyringBackendMeta.__init__cCs0t|ds t|_|j}|js||dSdS)N_classes)hasattrsetr__abstractmethods__add)rclassesrrrr,s zKeyringBackendMeta._registercs&|jtfdd}||_dS)zM Wrap ``set_password`` such to validate the passed username. cs$|||||g|Ri|Sr)_validate_username)selfsystemusernameargskwargsorigrrwrapper9s zFKeyringBackendMeta._validate_username_in_set_password..wrapperN) set_password functoolswraps)rr)rr'rr3s z5KeyringBackendMeta._validate_username_in_set_password)__name__ __module__ __qualname____doc__rrr __classcell__rrrrr s  r c@seZdZdZddZejd+ddZej Z eje dd Z e d,d dZ ejd-ddZ d-ddZejd.ddZd/ddZejd0ddZd1dd Zd2d"d#Zd3d$d%Zd4d(d)Zd*S)5KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. cCs |dSr)set_properties_from_envr"rrrrFs zKeyringBackend.__init__returnfloatcCst)a Each backend class must supply a priority, a number (float or integer) indicating the priority of the backend relative to all other backends. The priority need not be static -- it may (and should) vary based attributes of the environment in which is runs (platform, available packages, etc.). A higher number indicates a higher priority. The priority should raise a RuntimeError with a message indicating the underlying cause if the backend is not suitable for the current environment. As a rule of thumb, a priority between zero but less than one is suitable, but a priority of one or greater is recommended. )NotImplementedErrorr4rrrr IszKeyringBackend.prioritycCs |jdSr)r rrrrviable^s zKeyringBackend.viablertype[KeyringBackend]filter[type[KeyringBackend]]cCsttd|jS)z6 Return all subclasses deemed viable. r9)filteroperator attrgetterrr8rrrget_viable_backendscsz"KeyringBackend.get_viable_backendsstrcCs.|jd\}}}|dd}d||jgS)zr The keyring name, suitable for display. The name is derived from module and class name. ._ )r. rpartitionreplacejoinr-)rparentsepmod_namerrrrls zKeyringBackend.namecCs&t|}|jd|jd|jddS)NrAz (priority: g))typer.r-r )r" keyring_classrrr__str__xszKeyringBackend.__str__servicer$ str | NonecCdS)z,Get password of the username for the serviceNrr"rOr$rrr get_password|zKeyringBackend.get_passwordNonecCs|s tjdtdddSdS)z3 Ensure the username is not empty. z(Empty usernames are deprecated. See #668) stacklevelN)warningswarnDeprecationWarning)r"r$rrrr!s z!KeyringBackend._validate_usernamepasswordcC td)zSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr"rOr$r[rrrr*s zKeyringBackend.set_passwordcCr\)zDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. r])rPasswordDeleteErrorrRrrrdelete_passwords zKeyringBackend.delete_passwordcredentials.Credential | NonecCs,|dur|||}|durt||SdS)aGets the username and password for the service. Returns a Credential instance. The *username* argument is optional and may be omitted by the caller or ignored by the backend. Callers must use the returned username. N)rSrSimpleCredentialr_rrrget_credentials   zKeyringBackend.get_credentialcCs>ddd}tdt|tj}|D] \}}t|||qdS)z6For all KEYRING_PROPERTY_* env var, set that property.itemtuple[str, str]cSs(|\}}|d\}}}|o||fS)NKEYRING_PROPERTY_) partitionlower)rekeyvalueprerHrrrrparsesz5KeyringBackend.set_properties_from_env..parseN)rerf)r<maposenvironitemssetattr)r"rmpropsrrkrrrr3s  z&KeyringBackend.set_properties_from_envr& typing.AnycKst|}t|||Sr)copyvarsupdate)r"r&altrrrwith_propertiess zKeyringBackend.with_propertiesN)r5r6)rr:r5r;)r5r@)rOr@r$r@r5rP)r$r@r5rU)rOr@r$r@r[r@r5rU)rOr@r$r@r5rU)rOr@r$rPr5rbr5rU)r&rtr5r2)r-r.r/r0rr classpropertyr rpassesr9 classmethodr?rrNabcabstractmethodrSr!r*rardr3ryrrrrr2As.          r2) metaclassc@s,eZdZdZejddZejddZdS)Crypterz.Base class providing encryption and decryptioncCrQ)zEncrypt the value.Nrr"rkrrrencryptrTzCrypter.encryptcCrQ)zDecrypt the value.NrrrrrdecryptrTzCrypter.decryptN)r-r.r/r0r~rrrrrrrrs  rc@s eZdZdZddZddZdS) NullCrypterzA crypter that does nothingcC|SrrrrrrrzNullCrypter.encryptcCrrrrrrrrrzNullCrypter.decryptN)r-r.r/r0rrrrrrrs rr5rUc CsbtjddD](}ztd|j|}t|r|Wqty.td|dYqwdS)a Locate all setuptools entry points by the name 'keyring backends' and initialize them. Any third-party library may register an entry point by adding the following to their setup.cfg:: [options.entry_points] keyring.backends = plugin_name = mylib.mymodule:initialize_func `plugin_name` can be anything, and is only used to display the name of the plugin at initialization time. `initialize_func` is optional, but will be invoked if callable. zkeyring.backends)groupz Loading %szError initializing plugin rAN) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcrrr _load_pluginss rlist[KeyringBackend]cCs$tt}tj|td}t|S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr2r?rsuppress_exceptions TypeErrorlist)viable_classesringsrrrget_all_keyringsrc@s>eZdZdZdZeedddeddddZ ddddZd S)SchemeSelectablea Allow a backend to select different "schemes" for the username and service. >>> backend = SchemeSelectable() >>> backend._query('contoso', 'alice') {'username': 'alice', 'service': 'contoso'} >>> backend._query('contoso') {'service': 'contoso'} >>> backend.scheme = 'KeePassXC' >>> backend._query('contoso', 'alice') {'UserName': 'alice', 'Title': 'contoso'} >>> backend._query('contoso', 'alice', foo='bar') {'UserName': 'alice', 'Title': 'contoso', 'foo': 'bar'} defaultr$rO)r$rOUserNameTitle)r KeePassXCNr@rPbasertr5dict[str, str]cKs@|j|j}t|dur|d||d|in|d|ifi|S)Nr$rO)schemesschemer)r"rOr$rrrrr_querys  zSchemeSelectable._queryr)rOr@r$rPrrtr5r)r-r.r/r0rrrrrrrrrs  rrz)r5r)&r0 __future__rr~rur+loggingr=rotypingrXjaraco.contextrjaraco.functoolsrrrrcompatr compat.py312r getLoggerr-rr> by_priorityr __annotations__ABCMetar r2rrrrrrrrrs6        #