.Phm#UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZmZmZddlmZdd lmZejeZejd ZdZd ed <Gd dejZGddeZ GddZ!Gdde!Z"ddZ#eddZ$GddZ%dS)z Keyring implementation support ) annotationsN) ExceptionTrap)once) credentialserrorsutil) properties)metadatapriorityz.typing.Callable[[KeyringBackend], bool] | None_limitc.eZdZdZfdZdZdZxZS)KeyringBackendMetaz Specialized subclass behavior. Keeps a registry of all (non-abstract) types. Wraps set_password to validate the username. ct|||||dSN)super__init__ _register"_validate_username_in_set_password)clsnamebasesdict __class__s O/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/keyring/backend.pyrzKeyringBackendMeta.__init__'sD ud+++  ..00000ct|dst|_|j}|js||dSdS)N_classes)hasattrsetr__abstractmethods__add)rclassess rrzKeyringBackendMeta._register,sSsJ'' !55CL,&  KK       rcb|jtjfd}||_dS)zM Wrap ``set_password`` such to validate the passed username. cJ|||||g|Ri|Sr)_validate_username)selfsystemusernameargskwargsorigs rwrapperzFKeyringBackendMeta._validate_username_in_set_password..wrapper9s;  # #H - - -4fh@@@@@@ @rN) set_password functoolswraps)rr-r,s @rrz5KeyringBackendMeta._validate_username_in_set_password3sP    A A A A   A#r)__name__ __module__ __qualname____doc__rrr __classcell__)rs@rrrs`11111  # # # # # # #rrc6eZdZdZdZejddZej Z eje dZ e dd Z ejd d Z d d Zejd!dZd"dZejd#dZd$dZd%dZd&dZd'dZdS)(KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. c.|dSr)set_properties_from_envr's rrzKeyringBackend.__init__Fs $$&&&&&rreturnfloatct)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. )NotImplementedErrorr:s rr zKeyringBackend.priorityIs "!rc|jdSr)r rs rviablezKeyringBackend.viable^s rrtype[KeyringBackend]filter[type[KeyringBackend]]cPttjd|jS)z6 Return all subclasses deemed viable. rA)filteroperator attrgetterrr@s rget_viable_backendsz"KeyringBackend.get_viable_backendscs!h)(33S\BBBrstrc|jd\}}}|dd}d||jgS)zr The keyring name, suitable for display. The name is derived from module and class name. ._ )r2 rpartitionreplacejoinr1)rparentsepmod_names rrzKeyringBackend.namelsN!$ 9 9# > >X##C--xx3<0111rcVt|}|jd|jd|jddS)NrKz (priority: g))typer2r1r )r' keyring_classs r__str__zKeyringBackend.__str__xs9T *ll]-CllQ^Qglllllrservicer) str | NonecdS)z,Get password of the username for the serviceNr'rZr)s r get_passwordzKeyringBackend.get_password|s trNonecF|stjdtddSdS)z3 Ensure the username is not empty. z(Empty usernames are deprecated. See #668) stacklevelN)warningswarnDeprecationWarning)r'r)s rr&z!KeyringBackend._validate_usernamesB  M:"        rpasswordc*tjd)zSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr'rZr)rgs rr.zKeyringBackend.set_passwords%h///rc*tjd)zDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. ri)rPasswordDeleteErrorr^s rdelete_passwordzKeyringBackend.delete_passwords (222rcredentials.Credential | Nonecd|-|||}|tj||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)r_rSimpleCredentialrks rget_credentialzKeyringBackend.get_credentials=  (((;;H#"3HhGGGtrcdd}tdt|tj}|D]\}}t |||dS)z6For all KEYRING_PROPERTY_* env var, set that property.itemtuple[str, str]cn|\}}|d\}}}|o||fS)NKEYRING_PROPERTY_) partitionlower)rtkeyvalueprerRrs rparsez5KeyringBackend.set_properties_from_env..parses;JC ]]+>??NCd0DJJLL%0 0rN)rtru)rEmaposenvironitemssetattr)r'r}propsrr{s rr9z&KeyringBackend.set_properties_from_envsq 1 1 1 1 *0c%AQAQASAS6T6T)U)U  ' 'KD% D$ & & & & ' 'rr+ typing.Anyc rtj|}t|||Sr)copyvarsupdate)r'r+alts rwith_propertieszKeyringBackend.with_propertiess.ioo S     rN)r;r<)rrBr;rC)r;rI)rZrIr)rIr;r[)r)rIr;r`)rZrIr)rIrgrIr;r`)rZrIr)rIr;r`)rZrIr)r[r;ror;r`)r+rr;r7)r1r2r3r4rr classpropertyr rpassesrA classmethodrHrrYabcabstractmethodr_r&r.rnrrr9rr]rrr7r7As'''""""$]__ #F  VCCC[C 2 2 2 2mmmm      00003333& ' ' ' 'rr7) metaclasscReZdZdZejdZejdZdS)Crypterz.Base class providing encryption and decryptioncdS)zEncrypt the value.Nr]r'r{s rencryptzCrypter.encrypt  rcdS)zDecrypt the value.Nr]rs rdecryptzCrypter.decryptrrN)r1r2r3r4rrrrr]rrrrsV88         rrceZdZdZdZdZdS) NullCrypterzA crypter that does nothingc|Srr]rs rrzNullCrypter.encrypt rc|Srr]rs rrzNullCrypter.decryptrrN)r1r2r3r4rrr]rrrrs8%%rrr;r`c.tjdD]~} td|j|}t |r |Q#t$r!td|dY{wxYwdS)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 rKN) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcs r _load_pluginsrs #*<===>> > IIlBG , , , I ""   > > > MM >>sA A''(BBlist[KeyringBackend]ctt}tj|t }t |S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr7rHr suppress_exceptions TypeErrorlist)viable_classesringss rget_all_keyringrs? OOO#7799N  $^ J J JE ;;rcheZdZdZdZeeddeddZ dddZd 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)rZ)r)rZUserNameTitle)r KeePassXCNrIr[baserr;dict[str, str]c x|j|j}t||d||d|in |d|ifi|S)Nr)rZ)schemesschemer)r'rZr)rrs r_queryzSchemeSelectable._querysldk* #z"Hy!7   y!7      rr)rZrIr)r[rrr;r)r1r2r3r4rrrrr]rrrrs} Fdj)<<<$ G<<<G 48       rrr)r;r)&r4 __future__rrrr/loggingrFrtypingrdjaraco.contextrjaraco.functoolsrrrr compatr compat.py312r getLoggerr1rrG by_priorityr __annotations__ABCMetarr7rrrrrr]rrrs/#"""""  ((((((!!!!!!''''''''''""""""g!!"h!*-- 9===== # # # # # # # #FEEEEE1EEEEP         '>>>>4% % % % % % % % % % r