o a@sdZddlZddlZddlZddlZddlmZddlZddl m Z m Z m Z ddl m Z eeZedZdZGdd d ejZGd d d ed ZGd ddZGdddeZddZe jddZdS)z Keyring implementation support N)Optional) credentialserrorsutil) propertiesprioritycs eZdZdZfddZZS)KeyringBackendMetazn A metaclass that's both an ABCMeta and a type that keeps a registry of all (non-abstract) types. cs@t|||t|dst|_|j}|js||dSdS)N_classes)super__init__hasattrsetr __abstractmethods__add)clsnamebasesdictZclasses __class__1/usr/lib/python3/dist-packages/keyring/backend.pyr s zKeyringBackendMeta.__init__)__name__ __module__ __qualname____doc__r __classcell__rrrrr sr c @seZdZdZddZddZejeddZ edd Z ejed d Z d d Z e jdededeefddZe jdedededdfddZdededdfddZdedeedeejfddZddZdS)KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. cCs |dSN)set_properties_from_env)selfrrrr ,s zKeyringBackend.__init__cCdS)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. Nrrrrrr0szKeyringBackend.prioritycCs8t }|jWd| S1swY| Sr)rZExceptionRaisedContextr)rexcrrrviable@s  zKeyringBackend.viablecCsttd|jS)z6 Return all subclasses deemed viable. r%)filteroperator attrgetterr r#rrrget_viable_backendsGsz"KeyringBackend.get_viable_backendscCs.|jd\}}}|dd}d||jgS)zr The keyring name, suitable for display. The name is derived from module and class name. ._ )r rpartitionreplacejoinr)rparentsepmod_namerrrrNs zKeyringBackend.namecCst|}d|j|j|jS)Nz{}.{} (priority: {:g}))typeformatrrr)r!Z keyring_classrrr__str__Zs zKeyringBackend.__str__serviceusernamereturncCr")z,Get password of the username for the serviceNrr!r6r7rrr get_password`zKeyringBackend.get_passwordpasswordNcC td)zSet password for the username of the service. If the backend cannot store passwords, raise PasswordSetError. reason)rZPasswordSetErrorr!r6r7r<rrr set_passwordes zKeyringBackend.set_passwordcCr=)zDelete the password for the username of the service. If the backend cannot delete passwords, raise PasswordDeleteError. r>)rZPasswordDeleteErrorr9rrrdelete_passwordqs zKeyringBackend.delete_passwordcCs,|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)r:rZSimpleCredentialr?rrrget_credential|s   zKeyringBackend.get_credentialcCs<dd}tdt|tj}|D] \}}t|||qdS)z6For all KEYRING_PROPERTY_* env var, set that property.cSs(|\}}|d\}}}|o||fS)NZKEYRING_PROPERTY_) partitionlower)itemkeyvalueZprer1rrrrparsesz5KeyringBackend.set_properties_from_env..parseN)r&maposenvironitemssetattr)r!rHZpropsrrGrrrr s  z&KeyringBackend.set_properties_from_env)rrrrr rrZ ClassProperty classmethodr%r)rr5abcabstractmethodstrrr:r@rArZ CredentialrBr rrrrr's4       r) metaclassc@s,eZdZdZejddZejddZdS)Crypterz.Base class providing encryption and decryptioncCr")zEncrypt the value.Nrr!rGrrrencryptr;zCrypter.encryptcCr")zDecrypt the value.NrrTrrrdecryptr;zCrypter.decryptN)rrrrrOrPrUrVrrrrrSs  rSc@s eZdZdZddZddZdS) NullCrypterzA crypter that does nothingcC|SrrrTrrrrUzNullCrypter.encryptcCrXrrrTrrrrVrYzNullCrypter.decryptN)rrrrrUrVrrrrrWs rWc 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 r*N) metadataZ entry_pointslogdebugrloadcallable ExceptionZ exception)ZepZ init_funcrrr _load_pluginss racCs$tt}tj|td}t|S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rarr)rZsuppress_exceptions TypeErrorlist)Zviable_classesZringsrrrget_all_keyringsre)rrJrOZloggingr'typingrZimportlib_metadatar[rrrrZ getLoggerrr\r(Z by_priorityZ_limitABCMetar rrSrWraoncererrrrs&    u