def test_process_document_field_headers(): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials() ) # Any value that is part of the HTTP/1.1 URI should be sent as # a field header. Set these to a non-empty value. request = document_understanding.ProcessDocumentRequest() request.parent = "parent/value" # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object( type(client._transport.process_document), "__call__" ) as call: call.return_value = document.Document() client.process_document(request) # Establish that the underlying gRPC stub method was called. assert len(call.mock_calls) == 1 _, args, _ = call.mock_calls[0] assert args[0] == request # Establish that the field header was sent. _, _, kw = call.mock_calls[0] assert ("x-goog-request-params", "parent=parent/value") in kw["metadata"]
def test_process_document(transport: str = "grpc"): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), transport=transport ) # Everything is optional in proto3 as far as the runtime is concerned, # and we are mocking out the actual API, so just send an empty request. request = document_understanding.ProcessDocumentRequest() # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object( type(client._transport.process_document), "__call__" ) as call: # Designate an appropriate return value for the call. call.return_value = document.Document( uri="uri_value", content=b"content_blob", mime_type="mime_type_value", text="text_value", ) response = client.process_document(request) # Establish that the underlying gRPC stub method was called. assert len(call.mock_calls) == 1 _, args, _ = call.mock_calls[0] assert args[0] == request # Establish that the response is the type that we expect. assert isinstance(response, document.Document) assert response.uri == "uri_value" assert response.content == b"content_blob" assert response.mime_type == "mime_type_value" assert response.text == "text_value"
def test_batch_process_documents_flattened(): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials() ) # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object( type(client._transport.batch_process_documents), "__call__" ) as call: # Designate an appropriate return value for the call. call.return_value = operations_pb2.Operation(name="operations/op") # Call the method with a truthy value for each flattened field, # using the keyword arguments to the method. client.batch_process_documents( requests=[ document_understanding.ProcessDocumentRequest(parent="parent_value") ] ) # Establish that the underlying call was made with the expected # request object values. assert len(call.mock_calls) == 1 _, args, _ = call.mock_calls[0] assert args[0].requests == [ document_understanding.ProcessDocumentRequest(parent="parent_value") ]
def test_credentials_transport_error(): # It is an error to provide credentials and a transport instance. transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials(), ) with pytest.raises(ValueError): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), transport=transport, ) # It is an error to provide a credentials file and a transport instance. transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials(), ) with pytest.raises(ValueError): client = DocumentUnderstandingServiceClient( client_options={"credentials_file": "credentials.json"}, transport=transport, ) # It is an error to provide scopes and a transport instance. transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials(), ) with pytest.raises(ValueError): client = DocumentUnderstandingServiceClient( client_options={"scopes": ["1", "2"]}, transport=transport, )
def test_batch_process_documents(transport: str = "grpc"): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), transport=transport ) # Everything is optional in proto3 as far as the runtime is concerned, # and we are mocking out the actual API, so just send an empty request. request = document_understanding.BatchProcessDocumentsRequest() # Mock the actual call within the gRPC stub, and fake the request. with mock.patch.object( type(client._transport.batch_process_documents), "__call__" ) as call: # Designate an appropriate return value for the call. call.return_value = operations_pb2.Operation(name="operations/spam") response = client.batch_process_documents(request) # Establish that the underlying gRPC stub method was called. assert len(call.mock_calls) == 1 _, args, _ = call.mock_calls[0] assert args[0] == request # Establish that the response is the type that we expect. assert isinstance(response, future.Future)
def test_parse_common_folder_path(): expected = { "folder": "octopus", } path = DocumentUnderstandingServiceClient.common_folder_path(**expected) # Check that the path construction is reversible. actual = DocumentUnderstandingServiceClient.parse_common_folder_path(path) assert expected == actual
def test_document_understanding_service_client_get_transport_class(): transport = DocumentUnderstandingServiceClient.get_transport_class() available_transports = [ transports.DocumentUnderstandingServiceGrpcTransport, ] assert transport in available_transports transport = DocumentUnderstandingServiceClient.get_transport_class("grpc") assert transport == transports.DocumentUnderstandingServiceGrpcTransport
def test_parse_common_organization_path(): expected = { "organization": "nudibranch", } path = DocumentUnderstandingServiceClient.common_organization_path(**expected) # Check that the path construction is reversible. actual = DocumentUnderstandingServiceClient.parse_common_organization_path(path) assert expected == actual
def test_parse_common_project_path(): expected = { "project": "mussel", } path = DocumentUnderstandingServiceClient.common_project_path(**expected) # Check that the path construction is reversible. actual = DocumentUnderstandingServiceClient.parse_common_project_path(path) assert expected == actual
def test_parse_common_billing_account_path(): expected = { "billing_account": "clam", } path = DocumentUnderstandingServiceClient.common_billing_account_path(**expected) # Check that the path construction is reversible. actual = DocumentUnderstandingServiceClient.parse_common_billing_account_path(path) assert expected == actual
def test_batch_process_documents_flattened_error(): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials() ) # Attempting to call a method with both a request object and flattened # fields is an error. with pytest.raises(ValueError): client.batch_process_documents( document_understanding.BatchProcessDocumentsRequest(), requests=[ document_understanding.ProcessDocumentRequest(parent="parent_value") ], )
def test_document_understanding_service_client_from_service_account_file(): creds = credentials.AnonymousCredentials() with mock.patch.object(service_account.Credentials, "from_service_account_file") as factory: factory.return_value = creds client = DocumentUnderstandingServiceClient.from_service_account_file( "dummy/file/path.json") assert client._transport._credentials == creds client = DocumentUnderstandingServiceClient.from_service_account_json( "dummy/file/path.json") assert client._transport._credentials == creds assert client._transport._host == "us-documentai.googleapis.com:443"
def test_document_understanding_service_auth_adc(): # If no credentials are provided, we should use ADC credentials. with mock.patch.object(auth, "default") as adc: adc.return_value = (credentials.AnonymousCredentials(), None) DocumentUnderstandingServiceClient() adc.assert_called_once_with( scopes=("https://www.googleapis.com/auth/cloud-platform", ))
def test_document_understanding_service_host_with_port(): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), client_options=client_options.ClientOptions( api_endpoint="us-documentai.googleapis.com:8000"), ) assert client._transport._host == "us-documentai.googleapis.com:8000"
def test_transport_instance(): # A client may be instantiated with a custom transport instance. transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials() ) client = DocumentUnderstandingServiceClient(transport=transport) assert client._transport is transport
def test_credentials_transport_error(): # It is an error to provide credentials and a transport instance. transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials()) with pytest.raises(ValueError): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), transport=transport)
def test_transport_grpc_default(): # A client should use the gRPC transport by default. client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials() ) assert isinstance( client._transport, transports.DocumentUnderstandingServiceGrpcTransport )
def test_common_location_path(): project = "winkle" location = "nautilus" expected = "projects/{project}/locations/{location}".format( project=project, location=location, ) actual = DocumentUnderstandingServiceClient.common_location_path(project, location) assert expected == actual
def test_client_withDEFAULT_CLIENT_INFO(): client_info = gapic_v1.client_info.ClientInfo() with mock.patch.object( transports.DocumentUnderstandingServiceTransport, "_prep_wrapped_messages" ) as prep: client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), client_info=client_info, ) prep.assert_called_once_with(client_info) with mock.patch.object( transports.DocumentUnderstandingServiceTransport, "_prep_wrapped_messages" ) as prep: transport_class = DocumentUnderstandingServiceClient.get_transport_class() transport = transport_class( credentials=credentials.AnonymousCredentials(), client_info=client_info, ) prep.assert_called_once_with(client_info)
def test_common_billing_account_path(): billing_account = "squid" expected = "billingAccounts/{billing_account}".format( billing_account=billing_account, ) actual = DocumentUnderstandingServiceClient.common_billing_account_path( billing_account ) assert expected == actual
def test_document_understanding_service_client_from_service_account_info(): creds = credentials.AnonymousCredentials() with mock.patch.object( service_account.Credentials, "from_service_account_info" ) as factory: factory.return_value = creds info = {"valid": True} client = DocumentUnderstandingServiceClient.from_service_account_info(info) assert client.transport._credentials == creds assert client.transport._host == "us-documentai.googleapis.com:443"
def test_document_understanding_service_grpc_lro_client(): client = DocumentUnderstandingServiceClient( credentials=credentials.AnonymousCredentials(), transport="grpc" ) transport = client._transport # Ensure that we have a api-core operations client. assert isinstance(transport.operations_client, operations_v1.OperationsClient) # Ensure that subsequent calls to the property send the exact same object. assert transport.operations_client is transport.operations_client
def test__get_default_mtls_endpoint(): api_endpoint = "example.googleapis.com" api_mtls_endpoint = "example.mtls.googleapis.com" sandbox_endpoint = "example.sandbox.googleapis.com" sandbox_mtls_endpoint = "example.mtls.sandbox.googleapis.com" non_googleapi = "api.example.com" assert DocumentUnderstandingServiceClient._get_default_mtls_endpoint(None) is None assert ( DocumentUnderstandingServiceClient._get_default_mtls_endpoint(api_endpoint) == api_mtls_endpoint ) assert ( DocumentUnderstandingServiceClient._get_default_mtls_endpoint(api_mtls_endpoint) == api_mtls_endpoint ) assert ( DocumentUnderstandingServiceClient._get_default_mtls_endpoint(sandbox_endpoint) == sandbox_mtls_endpoint ) assert ( DocumentUnderstandingServiceClient._get_default_mtls_endpoint( sandbox_mtls_endpoint ) == sandbox_mtls_endpoint ) assert ( DocumentUnderstandingServiceClient._get_default_mtls_endpoint(non_googleapi) == non_googleapi )
def test_document_understanding_service_client_client_options_from_dict(): with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.transports.DocumentUnderstandingServiceGrpcTransport.__init__" ) as grpc_transport: grpc_transport.return_value = None client = DocumentUnderstandingServiceClient( client_options={"api_endpoint": "squid.clam.whelk"}) grpc_transport.assert_called_once_with( api_mtls_endpoint=None, client_cert_source=None, credentials=None, host="squid.clam.whelk", )
def test_document_understanding_service_client_client_options_from_dict(): with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.transports.DocumentUnderstandingServiceGrpcTransport.__init__" ) as grpc_transport: grpc_transport.return_value = None client = DocumentUnderstandingServiceClient( client_options={"api_endpoint": "squid.clam.whelk"}) grpc_transport.assert_called_once_with( credentials=None, credentials_file=None, host="squid.clam.whelk", scopes=None, ssl_channel_credentials=None, quota_project_id=None, client_info=transports.base.DEFAULT_CLIENT_INFO, )
def test_common_project_path(): project = "cuttlefish" expected = "projects/{project}".format(project=project,) actual = DocumentUnderstandingServiceClient.common_project_path(project) assert expected == actual
def test_common_folder_path(): folder = "whelk" expected = "folders/{folder}".format(folder=folder,) actual = DocumentUnderstandingServiceClient.common_folder_path(folder) assert expected == actual
def test_document_understanding_service_client_client_options(): # Check that if channel is provided we won't create a new one. with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.DocumentUnderstandingServiceClient.get_transport_class" ) as gtc: transport = transports.DocumentUnderstandingServiceGrpcTransport( credentials=credentials.AnonymousCredentials()) client = DocumentUnderstandingServiceClient(transport=transport) gtc.assert_not_called() # Check mTLS is not triggered with empty client options. options = client_options.ClientOptions() with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.DocumentUnderstandingServiceClient.get_transport_class" ) as gtc: transport = gtc.return_value = mock.MagicMock() client = DocumentUnderstandingServiceClient(client_options=options) transport.assert_called_once_with(credentials=None, host=client.DEFAULT_ENDPOINT) # Check mTLS is not triggered if api_endpoint is provided but # client_cert_source is None. options = client_options.ClientOptions(api_endpoint="squid.clam.whelk") with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.transports.DocumentUnderstandingServiceGrpcTransport.__init__" ) as grpc_transport: grpc_transport.return_value = None client = DocumentUnderstandingServiceClient(client_options=options) grpc_transport.assert_called_once_with( api_mtls_endpoint=None, client_cert_source=None, credentials=None, host="squid.clam.whelk", ) # Check mTLS is triggered if client_cert_source is provided. options = client_options.ClientOptions( client_cert_source=client_cert_source_callback) with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.transports.DocumentUnderstandingServiceGrpcTransport.__init__" ) as grpc_transport: grpc_transport.return_value = None client = DocumentUnderstandingServiceClient(client_options=options) grpc_transport.assert_called_once_with( api_mtls_endpoint=client.DEFAULT_MTLS_ENDPOINT, client_cert_source=client_cert_source_callback, credentials=None, host=client.DEFAULT_ENDPOINT, ) # Check mTLS is triggered if api_endpoint and client_cert_source are provided. options = client_options.ClientOptions( api_endpoint="squid.clam.whelk", client_cert_source=client_cert_source_callback) with mock.patch( "google.cloud.documentai_v1beta2.services.document_understanding_service.transports.DocumentUnderstandingServiceGrpcTransport.__init__" ) as grpc_transport: grpc_transport.return_value = None client = DocumentUnderstandingServiceClient(client_options=options) grpc_transport.assert_called_once_with( api_mtls_endpoint="squid.clam.whelk", client_cert_source=client_cert_source_callback, credentials=None, host="squid.clam.whelk", )
def test_common_organization_path(): organization = "oyster" expected = "organizations/{organization}".format(organization=organization,) actual = DocumentUnderstandingServiceClient.common_organization_path(organization) assert expected == actual