U ۦ\@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__1/usr/lib/python3/dist-packages/keyring/backend.pyrs  zKeyringBackendMeta.__init__)__name__ __module__ __qualname____doc__r __classcell__rrrrr 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. Nrrrrrr /szKeyringBackend.priorityc Cs$t }|jW5QRXt| SN)rZExceptionRaisedContextr bool)rexcrrrviable?s zKeyringBackend.viablecCsttd|jS)z6 Return all subclasses deemed viable. r&)r operator attrgetterr r"rrrget_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__Ys zKeyringBackend.__str__cCsdS)z5Get password of the username for the service Nrr4serviceusernamerrr get_password_szKeyringBackend.get_passwordcCstddS)zSet password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. reasonN)rZPasswordSetErrorr4r7r8Zpasswordrrr set_passwordeszKeyringBackend.set_passwordcCstddS)zDelete the password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. r:N)rZPasswordDeleteErrorr6rrrdelete_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)r9rZSimpleCredentialr;rrrget_credential|s  zKeyringBackend.get_credentialN)rrrrr rZ ClassProperty classmethodr&r)rr5abcabstractmethodr9r<r=r>rrrrr!(s"      r!c@s,eZdZdZejddZejddZdS)Crypterz3Base class providing encryption and decryption cCsdS)zEncrypt the value. Nrr4valuerrrencryptszCrypter.encryptcCsdS)zDecrypt the value. NrrCrrrdecryptszCrypter.decryptN)rrrrr@rArErFrrrrrBs  rBc@s eZdZdZddZddZdS) NullCrypterz A crypter that does nothing cCs|Sr#rrCrrrrEszNullCrypter.encryptcCs|Sr#rrCrrrrFszNullCrypter.decryptN)rrrrrErFrrrrrGsrGc Csjd}tj|d}|D]P}z(td|j|}t|r>|Wqtk rbtd|YqXqdS)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)rHZ entry_pointsZepZ init_funcrrr _load_pluginss  rOcCs$tt}tj|td}t|S)zc Return a list of all implemented keyrings that can be constructed without parameters. ) exceptions)rOr!r)rZsuppress_exceptions TypeErrorlist)Zviable_classesZringsrrrget_all_keyringsrS)rZ __future__rr@Zloggingr'rIrrrrZ py27compatrr r3Z __metaclass__Z getLoggerrrJr(Z by_priorityZ_limitABCMetar r!rBrGrOoncerSrrrrs(    f