File: //usr/lib/python3/dist-packages/twisted/cred/__pycache__/strcred.cpython-38.pyc
U
W[� � @ s� d Z ddlmZmZ ddlZddlmZmZ ddlm Z ddl
m Z G dd� de�Z G d d
� d
e
�ZG d d � d e�ZG d
d� de�ZG dd� de�ZdZdd� Zdd� Zdd� ZG dd� d�ZdS )z�
Support for resolving command-line strings that represent different
checkers available to cred.
Examples:
- passwd:/etc/passwd
- memory:admin:asdf:user:lkj
- unix
� )�absolute_import�divisionN)� Interface� Attribute)�
getPlugins)�usagec @ s8 e Zd ZdZed�Zed�Zed�Zed�Zdd� Z dS ) �ICheckerFactoryz�
A factory for objects which provide
L{twisted.cred.checkers.ICredentialsChecker}.
It's implemented by twistd plugins creating checkers.
z0A tag that identifies the authentication method.zmA detailed (potentially multi-line) description of precisely what functionality this CheckerFactory provides.z=A short (one-line) description of the argument string format.z@A list of credentials interfaces that this factory will support.c C s dS )z}
Return an L{twisted.cred.checkers.ICredentialsChecker} provider using the supplied
argument string.
N� )� argstringr r �6/usr/lib/python3/dist-packages/twisted/cred/strcred.py�generateChecker5 s z ICheckerFactory.generateCheckerN)
�__name__�
__module__� __qualname__�__doc__r �authType�authHelp�argStringFormat�credentialInterfacesr r r r r r s ����r c @ s e Zd ZdZdS )�StrcredExceptionz+
Base exception class for strcred.
N�r
r r r r r r r r = s r c @ s e Zd ZdZdS )�InvalidAuthTypezv
Raised when a user provides an invalid identifier for the
authentication plugin (known as the authType).
Nr r r r r r D s r c @ s e Zd ZdZdS )�InvalidAuthArgumentStringzl
Raised by an authentication plugin when the argument string
provided is formatted incorrectly.
Nr r r r r r L s r c @ s e Zd ZdZdS )�UnsupportedInterfacesz�
Raised when an application is given a checker to use that does not
provide any of the application's supported credentials interfaces.
Nr r r r r r T s r z<WARNING: This authType is not supported by this application.c C s t t�S )z=
Find all objects that implement L{ICheckerFactory}.
)r r r r r r �findCheckerFactoriesc s r c C s* t � D ]}|j| kr| S qt| ��dS )zJ
Find the first checker factory that supports the given authType.
N)r r r )r �factoryr r r �findCheckerFactoryk s
r c C s0 d| kr| � dd�\}}n| }d}t|��|�S )z�
Returns an L{twisted.cred.checkers.ICredentialsChecker} based on the
contents of a descriptive string. Similar to
L{twisted.application.strports}.
�:� � )�splitr r )� descriptionr r
r r r � makeCheckerv s
r" c @ sR e Zd ZdZdZejZdd� Zdd� Z dd� Z
d d
� Z d d � Z d
d� Z
dd� ZdS )�AuthOptionMixinak
Defines helper methods that can be added on to any
L{usage.Options} subclass that needs authentication.
This mixin implements three new options methods:
The opt_auth method (--auth) will write two new values to the
'self' dictionary: C{credInterfaces} (a dict of lists) and
C{credCheckers} (a list).
The opt_help_auth method (--help-auth) will search for all
available checker plugins and list them for the user; it will exit
when finished.
The opt_help_auth_type method (--help-auth-type) will display
detailed help for a particular checker plugin.
@cvar supportedInterfaces: An iterable object that returns
credential interfaces which this application is able to support.
@cvar authOutput: A writeable object to which this options class
will send all help-related output. Default: L{sys.stdout}
Nc C s | j dkp|| j kS )zR
Returns whether a particular credentials interface is supported.
N)�supportedInterfaces)�self� interfacer r r �supportsInterface� s
�z!AuthOptionMixin.supportsInterfacec C s |j D ]}| �|�r dS qdS )z�
Returns whether a checker factory will provide at least one of
the credentials interfaces that we care about.
TF)r r' �r% r r& r r r �supportsCheckerFactory� s
z&AuthOptionMixin.supportsCheckerFactoryc C s� g }| j dkr|j}n |jD ]}| �|�r |�|� q |sDt|j��d| krTi | d< d| krdg | d< | d �|� |D ]}| d �|g ��|� qvdS )zM
Supply a supplied credentials checker to the Options class.
NZcredInterfacesZ credCheckers)r$ r r' �appendr �
setdefault)r% ZcheckerZ supportedr& r r r �
addChecker� s
zAuthOptionMixin.addCheckerc
C s� z| � t|�� W n� tk
rH } zt�d|jd ��W 5 d}~X Y nd tk
r| } zt�d|jd ��W 5 d}~X Y n0 tk
r� } zt�d| ��W 5 d}~X Y nX dS )zB
Specify an authentication method for the server.
z Auth plugin not supported: %sr Nz Auth plugin not recognized: %szUnexpected error: %s)r, r" r r �
UsageError�argsr � Exception)r% r! �er r r �opt_auth� s � �zAuthOptionMixin.opt_authc c s0 t � D ]$}|jD ]}| �|�r|V qqqdS )z�
Return a list of which authTypes will be displayed by --help-auth.
This makes it a lot easier to test this module.
N)r r r' r( r r r � _checkerFactoriesForOptHelpAuth� s
z/AuthOptionMixin._checkerFactoriesForOptHelpAuthc C s� | j �d� | j �d� | j �d� d}| �� D ] }t|j�|kr0t|j�}q0d| }| j �|d � | j �|d � | �� D ] }| j �||j|jf � q~| j �d� td��dS ) z<
Show all authentication methods available.
z#Usage: --auth AuthType[:ArgString]
z-For detailed help: --help-auth-type AuthType
�
r z
%%-%is %%s
)ZAuthTypezArgString format)z========z================N)�
authOutput�writer2 �lenr r �
SystemExit)r% Z firstLengthr Z formatStringr r r �
opt_help_auth� s � z AuthOptionMixin.opt_help_authc C s� z t |�}W n" tk
r. t�d| ��Y nX | j�d| � | j�d|j � | j�d� |j�� � � D ]}| j�d|�
� � ql| j�d� | � |�s�| j�dt � | j�d� t
d��dS )zA
Show help for a particular authentication type.
zInvalid auth type: %sz Usage: --auth %s[:ArgString]
zArgString format: %s
r3 z %s
r N)r r r r- r4 r5 r r �strip�
splitlines�rstripr) �notSupportedWarningr7 )r% r Zcf�liner r r �opt_help_auth_type� s
z"AuthOptionMixin.opt_help_auth_type)r
r r r r$ �sys�stdoutr4 r' r) r, r1 r2 r8 r> r r r r r# � s r# )r Z
__future__r r r? Zzope.interfacer r Ztwisted.pluginr Ztwisted.pythonr r r/ r r r r r< r r r" r# r r r r �<module> s
!