/dhdZddlZddlZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z ddlmZejeZejdZdZGd d ejZGd d e ZGddZGddeZdZe jdZGddZdS)z Keyring implementation support N)Optional)metadata) credentialserrorsutil) propertiespriorityc"eZdZdZfdZxZS)KeyringBackendMetazn A metaclass that's both an ABCMeta and a type that keeps a registry of all (non-abstract) types. ct|||t|dst|_|j}|js||dSdS)N_classes)super__init__hasattrsetr__abstractmethods__add)clsnamebasesdictclasses __class__s /lib/python3.11/site-packages/keyring/backend.pyrzKeyringBackendMeta.__init__sp ud+++sJ'' !55CL,&  KK       )__name__ __module__ __qualname____doc__r __classcell__)rs@rr r sB rr c <eZdZdZdZdZejdZe dZ ejdZ dZ e jded ed eefd Ze jded ed ed d fdZded ed d fdZded eed eejfdZdZdZd S)KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. c.|dSN)set_properties_from_env)selfs rrzKeyringBackend.__init__,s $$&&&&&rcdS)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. Nrs rr zKeyringBackend.priority0srcltj5}|jdddn #1swxYwY| Sr%)rExceptionRaisedContextr )rexcs rviablezKeyringBackend.viable@sq  * , ,  LL               ws (,,cPttjd|jS)z6 Return all subclasses deemed viable. r.)filteroperator attrgetterrr*s rget_viable_backendsz"KeyringBackend.get_viable_backendsFs! h)(33S\BBBrc|jd\}}}|dd}d||jgS)zr The keyring name, suitable for display. The name is derived from module and class name. ._ )r rpartitionreplacejoinr)rparentsepmod_names rrzKeyringBackend.nameMsN!$ 9 9# > >X##C--xx3<0111rclt|}d|j|j|jS)Nz{}.{} (priority: {:g}))typeformatrrr )r' keyring_classs r__str__zKeyringBackend.__str__Xs5T '..  $m&T   rserviceusernamereturncdS)z,Get password of the username for the serviceNr)r'rCrDs r get_passwordzKeyringBackend.get_password^s trpasswordNc*tjd)zSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr'rCrDrIs r set_passwordzKeyringBackend.set_passwordcs%h///rc*tjd)zDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. rK)rPasswordDeleteErrorrGs rdelete_passwordzKeyringBackend.delete_passwordos (222rcd|-|||}|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)rHrSimpleCredentialrMs rget_credentialzKeyringBackend.get_credentialzsC  H(((;;H H"3HhGGGtrcd}tdt|tj}|D]\}}t |||dS)z6For all KEYRING_PROPERTY_* env var, set that property.cn|\}}|d\}}}|o||fS)NKEYRING_PROPERTY_) partitionlower)itemkeyvalueprer<rs rparsez5KeyringBackend.set_properties_from_env..parses;JC ]]+>??NCd0DJJLL%0 0rN)r0maposenvironitemssetattr)r'r^propsrr\s rr&z&KeyringBackend.set_properties_from_envsl 1 1 1 tS (8(8(:(:;;<<  ' 'KD% D$ & & & & ' 'rc rtj|}t|||Sr%)copyvarsupdate)r'kwargsalts rwith_propertieszKeyringBackend.with_propertiess.ioo S     r)rrrr rr r classpropertyr. classmethodr3rrBabcabstractmethodstrrrHrNrQr CredentialrTr&rkr)rrr#r#'s'''    CC[C 222    C38C= 0C030#0$00003s3c3d33333- +( ) & ' ' 'rr#) metaclasscReZdZdZejdZejdZdS)Crypterz.Base class providing encryption and decryptioncdS)zEncrypt the value.Nr)r'r\s rencryptzCrypter.encrypt  rcdS)zDecrypt the value.Nr)rvs rdecryptzCrypter.decryptrxrN)rrrr rnrorwrzr)rrrtrtsV88         rrtceZdZdZdZdZdS) NullCrypterzA crypter that does nothingc|Sr%r)rvs rrwzNullCrypter.encrypt rc|Sr%r)rvs rrzzNullCrypter.decryptr~rN)rrrr rwrzr)rrr|r|s8%%rr|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 r5N) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcs r _load_pluginsrs #*<===>> > IIlBG , , , I ""   > > > MM >>sA A''(BBctt}tj|t }t |S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr#r3rsuppress_exceptions TypeErrorlist)viable_classesringss rget_all_keyringrs? OOO#7799N  $^ J J JE ;;rcdeZdZdZdZeeddeddZd d Zd 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'} defaultrDrC)rDrCUserNameTitle)r KeePassXCNc x|j|j}t||d||d|in |d|ifi|S)NrDrC)schemesschemer)r'rCrDbasers r_queryzSchemeSelectable._querysjdk*   z"Hy!7   y!7      rr%)rrrr rrrrr)rrrrss Fdj)<<<$ G<<<G       rr)r r`rnloggingr1rftypingr py312compatrrrr_compatr getLoggerrrr2 by_priority_limitABCMetar r#rtr|roncerrr)rrrs  !!!!!!''''''''''g!!"h!*--         uuuuu1uuuup         '>>>4 # # # # # # # # # # r