陜im#UdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl mZddlmZmZmZddlmZdd lmZej.eZej4d ZdZd ed <Gd dej<ZGddeZ GddZ!Gdde!Z"ddZ#eddZ$GddZ%y)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. cht|||||j|jyN)super__init__ _register"_validate_username_in_set_password)clsnamebasesdict __class__s K/mnt/e/genesis-system/.venv/lib/python3.12/site-packages/keyring/backend.pyrzKeyringBackendMeta.__init__'s) ud+  ..0ct|dst|_|j}|js|j |yy)N_classes)hasattrsetr__abstractmethods__add)rclassess rrzKeyringBackendMeta._register,s8sJ'5CL,,&& KK 'rcf|jtjfd}||_y)zM Wrap ``set_password`` such to validate the passed username. cB|j||||g|i|Sr)_validate_username)selfsystemusernameargskwargsorigs rwrapperzFKeyringBackendMeta._validate_username_in_set_password..wrapper9s*  # #H -fh@@@ @rN) set_password functoolswraps)rr-r,s @rrz5KeyringBackendMeta._validate_username_in_set_password3s7   A  A#r)__name__ __module__ __qualname____doc__rrr __classcell__)rs@rrrs1  #rrcTeZdZdZdZej ddZejZ ej e dZ e ddZ ej ddZ ddZej ddZdd Zej dd Zdd Z dd Zdd ZddZy)KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. c$|jyr)set_properties_from_envr's rrzKeyringBackend.__init__Fs $$&rct)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|jyr)r rs rviablezKeyringBackend.viable^s  rcTttjd|jS)z6 Return all subclasses deemed viable. r?)filteroperator attrgetterrr>s rget_viable_backendsz"KeyringBackend.get_viable_backendscs h))(3S\\BBrc|jjd\}}}|jdd}dj||jgS)zr The keyring name, suitable for display. The name is derived from module and class name. ._ )r2 rpartitionreplacejoinr1)rparentsepmod_names rrzKeyringBackend.namelsI!$ 9 9# >X##C-xx3<<011rclt|}|jd|jd|jddS)NrFz (priority: g))typer2r1r )r' keyring_classs r__str__zKeyringBackend.__str__xs>T **+1]-C-C,DLQ^QgQghiPjjkllrcy)z,Get password of the username for the serviceNr'servicer)s r get_passwordzKeyringBackend.get_password|srcB|stjdtdyy)z3 Ensure the username is not empty. z(Empty usernames are deprecated. See #668) stacklevelN)warningswarnDeprecationWarning)r'r)s rr&z!KeyringBackend._validate_usernames! MM:" rc,tjd)zSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rPasswordSetErrorr'rXr)passwords rr.zKeyringBackend.set_passwords%%h//rc,tjd)zDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. ra)rPasswordDeleteErrorrWs rdelete_passwordzKeyringBackend.delete_passwords ((22rc\|*|j||}|tj||Sy)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)rYrSimpleCredentialrcs rget_credentialzKeyringBackend.get_credentials8  (((;H#"33HhGGrcdd}tdt|tjj }|D]\}}t |||y)z6For all KEYRING_PROPERTY_* env var, set that property.cb|\}}|jd\}}}|xr|j|fS)NKEYRING_PROPERTY_) partitionlower)itemkeyvalueprerMrs rparsez5KeyringBackend.set_properties_from_env..parses6JC ]]+>?NCd0DJJL%0 0rN)rpztuple[str, str])rAmaposenvironitemssetattr)r'rtpropsrrrs rr9z&KeyringBackend.set_properties_from_envsH 1 *0c%AQAQAS6T)U  'KD% D$ & 'rc dtj|}t|j||Sr)copyvarsupdate)r'r+alts rwith_propertieszKeyringBackend.with_propertiess&iio S   rN)returnfloat)rztype[KeyringBackend]rzfilter[type[KeyringBackend]])rstr)rXrr)rr str | None)r)rrNone)rXrr)rrdrrr)rXrr)rrr)rXrr)rrzcredentials.Credential | Nonerr)r+ typing.Anyrr7)r1r2r3r4rr classpropertyr rpassesr? classmethodrDrrTabcabstractmethodrYr&r.rgrjr9rrVrrr7r7As'""$_ # #F  C !C %CC 2 2m   003 ' & 'rr7) metaclasscXeZdZdZej dZej dZy)Crypterz.Base class providing encryption and decryptioncy)zEncrypt the value.NrVr'rrs rencryptzCrypter.encrypt rcy)zDecrypt the value.NrVrs rdecryptzCrypter.decryptrrN)r1r2r3r4rrrrrVrrrrs78     rrceZdZdZdZdZy) NullCrypterzA crypter that does nothingc|SrrVrs rrzNullCrypter.encrypt rc|SrrVrs rrzNullCrypter.decryptrrN)r1r2r3r4rrrVrrrrs%rrctjdD]E} tjd|j|j }t |r|Gy#t$rtjd|dYmwxYw)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 rFN) r entry_pointslogdebugrloadcallable Exception exception)ep init_funcs r _load_pluginsrsv ##*<=> > IIlBGG , I " >  > MM6rd!< = >sAA  "BBcttj}tj|t }t |S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rr7rDr suppress_exceptions TypeErrorlist)viable_classesringss rget_all_keyringrs3 O#779N  $ $^ JE ;rcbeZdZdZdZeeddeddZ d d d Zy ) 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)rX)r)rXUserNameTitle)r KeePassXCNc r|j|j}t| |d||d|in|d|ifi|S)Nr)rX)schemesschemer)r'rXr)basers r_queryzSchemeSelectable._querysadkk* #z"Hy!7  y!7    rr)rXrr)rrrrzdict[str, str])r1r2r3r4rrrrrVrrrrsV Fj)< G<G 48  &0 AK  rrr)rzlist[KeyringBackend])&r4 __future__rrr|r/loggingrBrvtypingr]jaraco.contextrjaraco.functoolsrrrr compatr compat.py312r getLoggerr1rrC by_priorityr __annotations__ABCMetarr7rrrrrrVrrrs#  (!''"g!"h!!*- 9=6= # #FE1EP   '>4% % r