B oh\@sdZddlmZddlZddlZddlZddlZddlmZm Z m Z ddl m Z ddl m Z mZeZeeZedZdZGd d d ejZe eGd d d ZGd ddZGdddeZddZe jddZdS)z Keyring implementation support )absolute_importN) credentialserrorsutil) properties) add_metaclassfilterprioritycs eZdZdZfddZZS)KeyringBackendMetazn A metaclass that's both an ABCMeta and a type that keeps a registry of all (non-abstract) types. cs@tt||||t|ds&t|_|j}|js<||dS)N_classes)superr __init__hasattrsetr __abstractmethods__add)clsnamebasesdictclasses) __class__.lib/python3.7/site-packages/keyring/backend.pyrs  zKeyringBackendMeta.__init__)__name__ __module__ __qualname____doc__r __classcell__rr)rrr sr c@s|eZdZdZddZejeddZeddZ ejedd Z d d Z e j d d Ze j ddZddZddZdS)KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. cCsdS)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. Nr)rrrrr /szKeyringBackend.priorityc Cs$t }|jWdQRXt| S)N)rZExceptionRaisedContextr bool)rexcrrrviable?s zKeyringBackend.viablecCsttd|jS)z6 Return all subclasses deemed viable. r#)r operator attrgetterr )rrrrget_viable_backendsFsz"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_namerrrrMs zKeyringBackend.namecCst|}d|j|j|jfS)Nz%s.%s (priority: %g))typerrr )selfZ keyring_classrrr__str__YszKeyringBackend.__str__cCsdS)z5Get password of the username for the service Nr)r1serviceusernamerrr get_password_szKeyringBackend.get_passwordcCstddS)zSet password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. reasonN)rZPasswordSetError)r1r3r4passwordrrr set_passwordeszKeyringBackend.set_passwordcCstddS)zDelete the password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. r6N)rZPasswordDeleteError)r1r3r4rrrdelete_passwordqszKeyringBackend.delete_passwordcCs,|dk r(|||}|dk r(t||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)r5rZSimpleCredential)r1r3r4r7rrrget_credential|s  zKeyringBackend.get_credentialN)rrrrr rZ ClassProperty classmethodr#r&rr2abcabstractmethodr5r8r9r:rrrrr (s    r c@s,eZdZdZejddZejddZdS)Crypterz3Base class providing encryption and decryption cCsdS)zEncrypt the value. Nr)r1valuerrrencryptszCrypter.encryptcCsdS)zDecrypt the value. Nr)r1r?rrrdecryptszCrypter.decryptN)rrrrr<r=r@rArrrrr>sr>c@s eZdZdZddZddZdS) NullCrypterz A crypter that does nothing cCs|S)Nr)r1r?rrrr@szNullCrypter.encryptcCs|S)Nr)r1r?rrrrAszNullCrypter.decryptN)rrrrr@rArrrrrBsrBc Csnd}tj|d}xX|D]P}y(td|j|}t|r@|Wqtk rdtd|YqXqWdS)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.py:: 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 %s.N) entrypointsZ get_group_allloginforloadcallable ExceptionZ exception)rCZ entry_pointsZepZ init_funcrrr _load_pluginss   rJcCs$tt}tj|td}t|S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rJr r&rZsuppress_exceptions TypeErrorlist)Zviable_classesZringsrrrget_all_keyringsrN)rZ __future__rr<Zloggingr$rDrrrrZ py27compatrr r0Z __metaclass__Z getLoggerrrEr%Z by_priorityZ_limitABCMetar r r>rBrJoncerNrrrrs$    g