← Back
Editing: backend.cpython-38.pyc
U ۦ�\� � @ s� d Z ddlmZ ddlZddlZddlZddlZddlmZm Z m Z ddl m Z ddl m Z mZ eZe�e�Ze�d�ZdZG d d � d ej�Ze e�G d d � d ��ZG d d� d�ZG dd� de�Zdd� Z e j dd� �Z dS )z Keyring implementation support � )�absolute_importN� )� credentials�errors�util)� properties)� add_metaclass�filter�priorityc s e Zd ZdZ� fdd�Z� ZS )�KeyringBackendMetazn A metaclass that's both an ABCMeta and a type that keeps a registry of all (non-abstract) types. c s@ t t| ��|||� t| d�s&t� | _| j}| js<|�| � d S )N�_classes)�superr �__init__�hasattr�setr �__abstractmethods__�add)�cls�name�bases�dict�classes�� __class__� �1/usr/lib/python3/dist-packages/keyring/backend.pyr s zKeyringBackendMeta.__init__)�__name__� __module__� __qualname__�__doc__r � __classcell__r r r r r s r c @ s| e Zd ZdZdd� Zejedd� ��Zedd� �Z ejedd � ��Z d d � Z e j d d � �Ze j dd� �Zdd� Zdd� ZdS )�KeyringBackendz]The abstract base class of the keyring, every backend must implement this interface. c C s dS )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 �r r r r r / s zKeyringBackend.priorityc C s$ t �� � }| j W 5 Q R X t|� S �N)r ZExceptionRaisedContextr �bool)r �excr r r �viable? s zKeyringBackend.viablec C s t t�d�| j�S )z6 Return all subclasses deemed viable. r& )r �operator� attrgetterr r" r r r �get_viable_backendsF s z"KeyringBackend.get_viable_backendsc C s. | j �d�\}}}|�dd�}d�|| jg�S )zr The keyring name, suitable for display. The name is derived from module and class name. �.�_� )r � rpartition�replace�joinr )r �parent�sep�mod_namer r r r M s zKeyringBackend.namec C s t | �}d|j|j|jf S )Nz%s.%s (priority: %g))�typer r r )�selfZ keyring_classr r r �__str__Y s �zKeyringBackend.__str__c C s dS )z5Get password of the username for the service Nr �r4 �service�usernamer r r � get_password_ s zKeyringBackend.get_passwordc C s t �d��dS )z�Set password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. �reasonN)r ZPasswordSetError�r4 r7 r8 Zpasswordr r r � set_passworde s zKeyringBackend.set_passwordc C s t �d��dS )z�Delete the password for the username of the service. If the backend cannot store passwords, raise NotImplementedError. r: N)r ZPasswordDeleteErrorr6 r r r �delete_passwordq s z KeyringBackend.delete_passwordc C s, |dk r(| � ||�}|dk r(t�||�S dS )a Gets 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)r9 r ZSimpleCredentialr; r r r �get_credential| s �z KeyringBackend.get_credentialN)r r r r r r Z ClassProperty� classmethodr& r) r r5 �abc�abstractmethodr9 r< r= r> r r r r r! ( s" r! c @ s, e Zd ZdZejdd� �Zejdd� �ZdS )�Crypterz3Base class providing encryption and decryption c C s dS )zEncrypt the value. Nr �r4 �valuer r r �encrypt� s zCrypter.encryptc C s dS )zDecrypt the value. Nr rC r r r �decrypt� s zCrypter.decryptN)r r r r r@ rA rE rF r r r r rB � s rB c @ s e Zd ZdZdd� Zdd� ZdS )� NullCrypterz A crypter that does nothing c C s |S r# r rC r r r rE � s zNullCrypter.encryptc C s |S r# r rC r r r rF � s zNullCrypter.decryptN)r r r r rE rF r r r r rG � s rG c C sj d} t j| d�}|D ]P}z(t�d|j� |�� }t|�r>|� W q tk rb t�d| � Y qX qdS )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 %sz Error initializing plugin %s.N) � entrypointsZ get_group_all�log�infor �load�callable� ExceptionZ exception)rH Z entry_pointsZepZ init_funcr r r � _load_plugins� s rO c C s$ t � t�� } tj| td�}t|�S )zc Return a list of all implemented keyrings that can be constructed without parameters. )� exceptions)rO r! r) r Zsuppress_exceptions� TypeError�list)Zviable_classesZringsr r r �get_all_keyring� s rS ) r Z __future__r r@ Zloggingr' rI � r r r r Z py27compatr r r3 Z __metaclass__Z getLoggerr rJ r( Z by_priorityZ_limit�ABCMetar r! rB rG rO �oncerS r r r r �<module> s( f
Save File
Cancel