U

KD�g�;�@svdd
lZddl
mZ
ddlmZ
ddlmZ
ddlmZm	Z	m
Z
mZ
ddlm
Z

Gdd�d�Ze�ZGd	d
�d
�Zd
S)�N)
�deque)
�pformat)
�AWSResponse)�ParamValidationError�StubAssertionError�StubResponseError�UnStubbedResponseError)
�validate_parametersc@s(eZ
dZd
Zdd�Zdd�Zdd�ZdS)	�_ANYzZ
    A helper object that compares equal to everything. Copied from
    unittest.mock
    c
Csd
S)NT���self�otherrr�:/opt/cppython/lib/python3.8/site-packages/botocore/stub.py�__eq__!s
z_ANY.__eq__c
Csd
S)NFrrrrr�__ne__$s
z_ANY.__ne__c


Csd
S)Nz<ANY>r�
r
rrr�__repr__'s
z
_ANY.__repr__N)�__name__�
__module__�__qualname__�__doc__rrrrrrrr
s
r
c@s�eZ
dZd
Zdd�Zdd�Zdd�Zdd	�Zd
d�Zd#d
d�
Z	dd�Z
d$dd�
Zdd�Zdd�Z
dd�Zdd�Zdd�Zdd �Zd!d"�ZdS)%�Stubbera�

    This class will allow you to stub out requests so you don't have to hit
    an endpoint to write tests. Responses are returned first in, first out.
    If operations are called out of order, or are called with no remaining
    queued responses, an error will be raised.

    **Example:**
    ::
        import datetime
        import botocore.session
        from botocore.stub import Stubber


        s3 = botocore.session.get_session().create_client('s3')
        stubber = Stubber(s3)

        response = {
            'IsTruncated': False,
            'Name': 'test-bucket',
            'MaxKeys': 1000, 'Prefix': '',
            'Contents': [{
                'Key': 'test.txt',
                'ETag': '"abc123"',
                'StorageClass': 'STANDARD',
                'LastModified': datetime.datetime(2016, 1, 20, 22, 9),
                'Owner': {'ID': 'abc123', 'DisplayName': 'myname'},
                'Size': 14814
            }],
            'EncodingType': 'url',
            'ResponseMetadata': {
                'RequestId': 'abc123',
                'HTTPStatusCode': 200,
                'HostId': 'abc123'
            },
            'Marker': ''
        }

        expected_params = {'Bucket': 'test-bucket'}

        stubber.add_response('list_objects', response, expected_params)
        stubber.activate()

        service_response = s3.list_objects(Bucket='test-bucket')
        assert service_response == response


    This class can also be called as a context manager, which will handle
    activation / deactivation for you.

    **Example:**
    ::
        import datetime
        import botocore.session
        from botocore.stub import Stubber


        s3 = botocore.session.get_session().create_client('s3')

        response = {
            "Owner": {
                "ID": "foo",
                "DisplayName": "bar"
            },
            "Buckets": [{
                "CreationDate": datetime.datetime(2016, 1, 20, 22, 9),
                "Name": "baz"
            }]
        }


        with Stubber(s3) as stubber:
            stubber.add_response('list_buckets', response, {})
            service_response = s3.list_buckets()

        assert service_response == response


    If you have an input parameter that is a randomly generated value, or you
    otherwise don't care about its value, you can use ``stub.ANY`` to ignore
    it in validation.

    **Example:**
    ::
        import datetime
        import botocore.session
        from botocore.stub import Stubber, ANY


        s3 = botocore.session.get_session().create_client('s3')
        stubber = Stubber(s3)

        response = {
            'IsTruncated': False,
            'Name': 'test-bucket',
            'MaxKeys': 1000, 'Prefix': '',
            'Contents': [{
                'Key': 'test.txt',
                'ETag': '"abc123"',
                'StorageClass': 'STANDARD',
                'LastModified': datetime.datetime(2016, 1, 20, 22, 9),
                'Owner': {'ID': 'abc123', 'DisplayName': 'myname'},
                'Size': 14814
            }],
            'EncodingType': 'url',
            'ResponseMetadata': {
                'RequestId': 'abc123',
                'HTTPStatusCode': 200,
                'HostId': 'abc123'
            },
            'Marker': ''
        }

        expected_params = {'Bucket': ANY}
        stubber.add_response('list_objects', response, expected_params)

        with stubber:
            service_response = s3.list_objects(Bucket='test-bucket')

        assert service_response == response
    cCs|
|_d
|_
d|_t�|_dS)zA
        :param client: The client to add your stubs to.
        Zboto_stubberZboto_stubber_expected_paramsN)�client�	_event_id�_expected_params_event_idr�_queue)r
rrrr�__init__�s


zStubber.__init__c

Cs|��
|S�
N)
�activaterrrr�	__enter__�s

zStubber.__enter__cCs|��
dSr)
�
deactivate)r
Zexception_typeZexception_value�	tracebackrrr�__exit__�s
zStubber.__exit__c

Cs8|jj
jjd
|j|jd�
|jj
jjd|j|jd�
dS)z5
        Activates the stubber on the client
        �before-parameter-build.*.*�
�	unique_id�before-call.*.*N)	r�meta�eventsZregister_first�_assert_expected_paramsr�register�_get_response_handlerrrrrrr�s



�



�zStubber.activatec

Cs8|jj
jjd
|j|jd�
|jj
jjd|j|jd�
dS)z7
        Deactivates the stubber on the client
        r$r%r'N)rr(r)�
unregisterr*rr,rrrrrr!�s



�



�zStubber.deactivateNcCs|�|
||�
d
S)ax
        Adds a service response to the response queue. This will be validated
        against the service model to ensure correctness. It should be noted,
        however, that while missing attributes are often considered correct,
        your code may not function properly if you leave them out. Therefore
        you should always fill in every value you see in a typical response for
        your particular request.

        :param method: The name of the client method to stub.
        :type method: str

        :param service_response: A dict response stub. Provided parameters will
            be validated against the service model.
        :type service_response: dict

        :param expected_params: A dictionary of the expected parameters to
            be called for the provided service response. The parameters match
            the names of keyword arguments passed to that client call. If
            any of the parameters differ a ``StubResponseError`` is thrown.
            You can use stub.ANY to indicate a particular parameter to ignore
            in validation. stub.ANY is only valid for top level params.
        N)
�
_add_response)r
�method�service_response�expected_paramsrrr�add_response�szStubber.add_responsecCsrt|j
|
�s(td
|j
jjj�d|
���
�
tddid�}|j
jj�|
�
}|�	||�
|||f|d�}|j
�|�

dS)NzClient z does not have method: ����operation_name�responser1)�hasattrr�
ValueErrorr(�
service_model�service_namer�method_to_api_mapping�get�_validate_operation_responser�append)r
r/r0r1�
http_responser5r6rrrr.�s


�


�zStubber._add_response��
c	Cs�td
|id
�}	d|i
||d�d�}
|d
k	r8|
d�
|�

|d
k	rN|
d�
|�

|d
k	r�|jjj}|�|�
}|�||�
|
�
|�

|jjj�|
�
}
|
|	|
f|d�}|j	�
|�

d
S)aG
        Adds a ``ClientError`` to the response queue.

        :param method: The name of the service method to return the error on.
        :type method: str

        :param service_error_code: The service error code to return,
                                   e.g. ``NoSuchBucket``
        :type service_error_code: str

        :param service_message: The service message to return, e.g.
                        'The specified bucket does not exist.'
        :type service_message: str

        :param http_status_code: The HTTP status code to return, e.g. 404, etc
        :type http_status_code: int

        :param service_error_meta: Additional keys to be added to the
            service Error
        :type service_error_meta: dict

        :param expected_params: A dictionary of the expected parameters to
            be called for the provided service response. The parameters match
            the names of keyword arguments passed to that client call. If
            any of the parameters differ a ``StubResponseError`` is thrown.
            You can use stub.ANY to indicate a particular parameter to ignore
            in validation.

        :param response_meta: Additional keys to be added to the
            response's ResponseMetadata
        :type response_meta: dict

        :param modeled_fields: Additional keys to be added to the response
            based on fields that are modeled for the particular error code.
            These keys will be validated against the particular error shape
            designated by the error code.
        :type modeled_fields: dict

        NZHTTPStatusCode)�MessageZCode)�ResponseMetadata�ErrorrDrCr4)r�updaterr(r9Zshape_for_error_code�_validate_responser;r<rr>)r
r/Zservice_error_codeZservice_messageZhttp_status_codeZservice_error_metar1Z
response_metaZmodeled_fieldsr?Zparsed_responser9�shaper5r6rrr�add_client_error
s&2
�










�zStubber.add_client_errorc
Cs$t|j
�
}
|
d
kr t|
�d��
�
dS)z<
        Asserts that all expected calls were made.
        r
z responses remaining in queue.N)�lenr�AssertionError)r
�	remainingrrr�assert_no_pending_responsesV
s


z#Stubber.assert_no_pending_responsescCsF|jst
|
jd
d��
|jdd}||
jkrBt|
jd|�d�d��
dS)Nz�Unexpected API Call: A call was made but no additional calls expected. Either the API Call was not stubbed or it was called multiple times.�r5�reasonr
r5z'Operation mismatch: found response for �
.)rr�namer)r
�model�paramsrPrrr�_assert_expected_call_order^
s


�	





�z#Stubber._assert_expected_call_ordercKs|�|
|�
|j
��d
S)Nr6)rSr�popleft)r
rQrR�context�kwargsrrrr,p
s
zStubber._get_response_handlercKs�|�|�
rdS|�
|
|�
|jd
d}|dkr4dS|��D]B\}}||ks\||||kr<t|
jdt|�
�dt|�
��d��
q<t|���
t|���
kr�t|
jdt|�
�dt|�
��d��
dS)Nr
r1zExpected parameters:
z,
but received:
rM)	�_should_not_stubrSr�itemsrrPr�sorted�keys)r
rQrRrUrVr1�param�valuerrrr*u
s"









�	

�zStubber._assert_expected_paramscCs|
r|
�d
�
rdSdS)NZis_presign_requestT)
r<)r
rUrrrrW�
s
zStubber._should_not_stubcCsF|jj
j}|�|
�
}|j}|}d
|kr6t�|�
}|d
=|�||�
dS)NrC)rr(r9�operation_model�output_shape�copyrF)r
r5r0r9r]r^r6rrrr=�
s








z$Stubber._validate_operation_responsecCs&|
dk	rt||
�
n|r"t
d
d�
�
dS)Nz6Service response should only contain ResponseMetadata.)
�report)r	r)r
rGr6rrrrF�
s


�zStubber._validate_response)
N)r@r@rANNNN)rrrrrr r#rr!r2r.rHrLrSr,r*rWr=rFrrrrr.s.
y	






�
Rr)r_�collectionsr�pprintrZbotocore.awsrequestrZbotocore.exceptionsrrrrZbotocore.validater	r
�ANYrrrrr�<module>
s