#!/usr/bin/env python # # Copyright 2014 Google Inc. All Rights Reserved. # # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """Http tests Unit tests for the googleapiclient.http. """ from __future__ import absolute_import __author__ = "jcgregorio@google.com (Joe Gregorio)" from io import FileIO # Do not remove the httplib2 import import json import httplib2 import io import logging import mock import os import unittest import urllib import random import socket import ssl import time from googleapiclient.discovery import build from googleapiclient.errors import BatchError from googleapiclient.errors import HttpError from googleapiclient.errors import InvalidChunkSizeError from googleapiclient.http import build_http from googleapiclient.http import BatchHttpRequest from googleapiclient.http import HttpMock from googleapiclient.http import HttpMockSequence from googleapiclient.http import HttpRequest from googleapiclient.http import MAX_URI_LENGTH from googleapiclient.http import MediaFileUpload from googleapiclient.http import MediaInMemoryUpload from googleapiclient.http import MediaIoBaseDownload from googleapiclient.http import MediaIoBaseUpload from googleapiclient.http import MediaUpload from googleapiclient.http import _StreamSlice from googleapiclient.http import set_user_agent from googleapiclient.model import JsonModel from oauth2client.client import Credentials class MockCredentials(Credentials): """Mock class for all Credentials objects.""" def __init__(self, bearer_token, expired=False): super(MockCredentials, self).__init__() self._authorized = 0 self._refreshed = 0 self._applied = 0 self._bearer_token = bearer_token self._access_token_expired = expired @property def access_token(self): return self._bearer_token @property def access_token_expired(self): return self._access_token_expired def authorize(self, http): self._authorized += 1 request_orig = http.request # The closure that will replace 'httplib2.Http.request'. def new_request( uri, method="GET", body=None, headers=None, redirections=httplib2.DEFAULT_MAX_REDIRECTS, connection_type=None, ): # Modify the request headers to add the appropriate # Authorization header. if headers is None: headers = {} self.apply(headers) resp, content = request_orig( uri, method, body, headers, redirections, connection_type ) return resp, content # Replace the request method with our own closure. http.request = new_request # Set credentials as a property of the request method. setattr(http.request, "credentials", self) return http def refresh(self, http): self._refreshed += 1 def apply(self, headers): self._applied += 1 headers["authorization"] = self._bearer_token + " " + str(self._refreshed) class HttpMockWithErrors(object): def __init__(self, num_errors, success_json, success_data): self.num_errors = num_errors self.success_json = success_json self.success_data = success_data def request(self, *args, **kwargs): if not self.num_errors: return httplib2.Response(self.success_json), self.success_data elif self.num_errors == 5: ex = ConnectionResetError # noqa: F821 elif self.num_errors == 4: ex = httplib2.ServerNotFoundError() elif self.num_errors == 3: ex = OSError() ex.errno = socket.errno.EPIPE elif self.num_errors == 2: ex = ssl.SSLError() else: # Initialize the timeout error code to the platform's error code. try: # For Windows: ex = OSError() ex.errno = socket.errno.WSAETIMEDOUT except AttributeError: # For Linux/Mac: ex = socket.timeout() self.num_errors -= 1 raise ex class HttpMockWithNonRetriableErrors(object): def __init__(self, num_errors, success_json, success_data): self.num_errors = num_errors self.success_json = success_json self.success_data = success_data def request(self, *args, **kwargs): if not self.num_errors: return httplib2.Response(self.success_json), self.success_data else: self.num_errors -= 1 ex = OSError() # set errno to a non-retriable value try: # For Windows: ex.errno = socket.errno.WSAEHOSTUNREACH except AttributeError: # For Linux/Mac: ex.errno = socket.errno.EHOSTUNREACH # Now raise the correct timeout error. raise ex DATA_DIR = os.path.join(os.path.dirname(__file__), "data") def datafile(filename): return os.path.join(DATA_DIR, filename) def _postproc_none(*kwargs): pass class TestUserAgent(unittest.TestCase): def test_set_user_agent(self): http = HttpMockSequence([({"status": "200"}, "echo_request_headers")]) http = set_user_agent(http, "my_app/5.5") resp, content = http.request("http://example.com") self.assertEqual("my_app/5.5", content["user-agent"]) def test_set_user_agent_nested(self): http = HttpMockSequence([({"status": "200"}, "echo_request_headers")]) http = set_user_agent(http, "my_app/5.5") http = set_user_agent(http, "my_library/0.1") resp, content = http.request("http://example.com") self.assertEqual("my_app/5.5 my_library/0.1", content["user-agent"]) class TestMediaUpload(unittest.TestCase): def test_media_file_upload_closes_fd_in___del__(self): file_desc = mock.Mock(spec=io.TextIOWrapper) opener = mock.mock_open(file_desc) with mock.patch("builtins.open", return_value=opener): upload = MediaFileUpload(datafile("test_close"), mimetype="text/plain") self.assertIs(upload.stream(), file_desc) del upload file_desc.close.assert_called_once_with() def test_media_file_upload_mimetype_detection(self): upload = MediaFileUpload(datafile("small.png")) self.assertEqual("image/png", upload.mimetype()) upload = MediaFileUpload(datafile("empty")) self.assertEqual("application/octet-stream", upload.mimetype()) def test_media_file_upload_to_from_json(self): upload = MediaFileUpload(datafile("small.png"), chunksize=500, resumable=True) self.assertEqual("image/png", upload.mimetype()) self.assertEqual(190, upload.size()) self.assertEqual(True, upload.resumable()) self.assertEqual(500, upload.chunksize()) self.assertEqual(b"PNG", upload.getbytes(1, 3)) json = upload.to_json() new_upload = MediaUpload.new_from_json(json) self.assertEqual("image/png", new_upload.mimetype()) self.assertEqual(190, new_upload.size()) self.assertEqual(True, new_upload.resumable()) self.assertEqual(500, new_upload.chunksize()) self.assertEqual(b"PNG", new_upload.getbytes(1, 3)) def test_media_file_upload_raises_on_file_not_found(self): with self.assertRaises(FileNotFoundError): MediaFileUpload(datafile("missing.png")) def test_media_file_upload_raises_on_invalid_chunksize(self): self.assertRaises( InvalidChunkSizeError, MediaFileUpload, datafile("small.png"), mimetype="image/png", chunksize=-2, resumable=True, ) def test_media_inmemory_upload(self): media = MediaInMemoryUpload( b"abcdef", mimetype="text/plain", chunksize=10, resumable=True ) self.assertEqual("text/plain", media.mimetype()) self.assertEqual(10, media.chunksize()) self.assertTrue(media.resumable()) self.assertEqual(b"bc", media.getbytes(1, 2)) self.assertEqual(6, media.size()) def test_http_request_to_from_json(self): http = build_http() media_upload = MediaFileUpload( datafile("small.png"), chunksize=500, resumable=True ) req = HttpRequest( http, _postproc_none, "http://example.com", method="POST", body="{}", headers={"content-type": 'multipart/related; boundary="---flubber"'}, methodId="foo", resumable=media_upload, ) json = req.to_json() new_req = HttpRequest.from_json(json, http, _postproc_none) self.assertEqual( {"content-type": 'multipart/related; boundary="---flubber"'}, new_req.headers, ) self.assertEqual("http://example.com", new_req.uri) self.assertEqual("{}", new_req.body) self.assertEqual(http, new_req.http) self.assertEqual(media_upload.to_json(), new_req.resumable.to_json()) self.assertEqual(random.random, new_req._rand) self.assertEqual(time.sleep, new_req._sleep) class TestMediaIoBaseUpload(unittest.TestCase): def test_media_io_base_upload_from_file_io(self): fd = FileIO(datafile("small.png"), "r") upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) self.assertEqual("image/png", upload.mimetype()) self.assertEqual(190, upload.size()) self.assertEqual(True, upload.resumable()) self.assertEqual(500, upload.chunksize()) self.assertEqual(b"PNG", upload.getbytes(1, 3)) def test_media_io_base_upload_from_file_object(self): f = open(datafile("small.png"), "rb") upload = MediaIoBaseUpload( fd=f, mimetype="image/png", chunksize=500, resumable=True ) self.assertEqual("image/png", upload.mimetype()) self.assertEqual(190, upload.size()) self.assertEqual(True, upload.resumable()) self.assertEqual(500, upload.chunksize()) self.assertEqual(b"PNG", upload.getbytes(1, 3)) f.close() def test_media_io_base_upload_serializable(self): f = open(datafile("small.png"), "rb") upload = MediaIoBaseUpload(fd=f, mimetype="image/png") try: json = upload.to_json() self.fail("MediaIoBaseUpload should not be serializable.") except NotImplementedError: pass def test_media_io_base_upload_from_bytes(self): f = open(datafile("small.png"), "rb") fd = io.BytesIO(f.read()) upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) self.assertEqual("image/png", upload.mimetype()) self.assertEqual(190, upload.size()) self.assertEqual(True, upload.resumable()) self.assertEqual(500, upload.chunksize()) self.assertEqual(b"PNG", upload.getbytes(1, 3)) def test_media_io_base_upload_raises_on_invalid_chunksize(self): f = open(datafile("small.png"), "rb") fd = io.BytesIO(f.read()) self.assertRaises( InvalidChunkSizeError, MediaIoBaseUpload, fd, "image/png", chunksize=-2, resumable=True, ) def test_media_io_base_upload_streamable(self): fd = io.BytesIO(b"stuff") upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) self.assertEqual(True, upload.has_stream()) self.assertEqual(fd, upload.stream()) def test_media_io_base_next_chunk_retries(self): f = open(datafile("small.png"), "rb") fd = io.BytesIO(f.read()) upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) # Simulate errors for both the request that creates the resumable upload # and the upload itself. http = HttpMockSequence( [ ({"status": "500"}, ""), ({"status": "500"}, ""), ({"status": "503"}, ""), ({"status": "200", "location": "location"}, ""), ({"status": "403"}, USER_RATE_LIMIT_EXCEEDED_RESPONSE_NO_STATUS), ({"status": "403"}, RATE_LIMIT_EXCEEDED_RESPONSE), ({"status": "429"}, ""), ({"status": "200"}, "{}"), ] ) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/upload/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, headers={}, resumable=upload ) sleeptimes = [] request._sleep = lambda x: sleeptimes.append(x) request._rand = lambda: 10 request.execute(num_retries=3) self.assertEqual([20, 40, 80, 20, 40, 80], sleeptimes) def test_media_io_base_next_chunk_no_retry_403_not_configured(self): fd = io.BytesIO(b"i am png") upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) http = HttpMockSequence( [({"status": "403"}, NOT_CONFIGURED_RESPONSE), ({"status": "200"}, "{}")] ) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/upload/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, headers={}, resumable=upload ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute(num_retries=3) request._sleep.assert_not_called() def test_media_io_base_empty_file(self): fd = io.BytesIO() upload = MediaIoBaseUpload( fd=fd, mimetype="image/png", chunksize=500, resumable=True ) http = HttpMockSequence( [ ({"status": "200", "location": "https://www.googleapis.com/someapi/v1/upload?foo=bar"}, "{}"), ({"status": "200", "location": "https://www.googleapis.com/someapi/v1/upload?foo=bar"}, "{}") ] ) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/upload/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, headers={}, resumable=upload ) request.execute() # Check that "Content-Range" header is not set in the PUT request self.assertTrue("Content-Range" not in http.request_sequence[-1][-1]) self.assertEqual("0", http.request_sequence[-1][-1]["Content-Length"]) class TestMediaIoBaseDownload(unittest.TestCase): def setUp(self): http = HttpMock(datafile("zoo.json"), {"status": "200"}) zoo = build("zoo", "v1", http=http, static_discovery=False) self.request = zoo.animals().get_media(name="Lion") self.fd = io.BytesIO() def test_media_io_base_download(self): self.request.http = HttpMockSequence( [ ({"status": "200", "content-range": "0-2/5"}, b"123"), ({"status": "200", "content-range": "3-4/5"}, b"45"), ] ) self.assertEqual(True, self.request.http.follow_redirects) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(self.fd, download._fd) self.assertEqual(3, download._chunksize) self.assertEqual(0, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(False, download._done) self.assertEqual(self.request.uri, download._uri) status, done = download.next_chunk() self.assertEqual(self.fd.getvalue(), b"123") self.assertEqual(False, done) self.assertEqual(3, download._progress) self.assertEqual(5, download._total_size) self.assertEqual(3, status.resumable_progress) status, done = download.next_chunk() self.assertEqual(self.fd.getvalue(), b"12345") self.assertEqual(True, done) self.assertEqual(5, download._progress) self.assertEqual(5, download._total_size) def test_media_io_base_download_range_request_header(self): self.request.http = HttpMockSequence( [ ( {"status": "200", "content-range": "0-2/5"}, "echo_request_headers_as_json", ), ] ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) status, done = download.next_chunk() result = json.loads(self.fd.getvalue().decode("utf-8")) self.assertEqual(result.get("range"), "bytes=0-2") def test_media_io_base_download_custom_request_headers(self): self.request.http = HttpMockSequence( [ ( {"status": "200", "content-range": "0-2/5"}, "echo_request_headers_as_json", ), ( {"status": "200", "content-range": "3-4/5"}, "echo_request_headers_as_json", ), ] ) self.assertEqual(True, self.request.http.follow_redirects) self.request.headers["Cache-Control"] = "no-store" download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(download._headers.get("Cache-Control"), "no-store") status, done = download.next_chunk() result = json.loads(self.fd.getvalue().decode("utf-8")) # assert that that the header we added to the original request is # sent up to the server on each call to next_chunk self.assertEqual(result.get("Cache-Control"), "no-store") download._fd = self.fd = io.BytesIO() status, done = download.next_chunk() result = json.loads(self.fd.getvalue().decode("utf-8")) self.assertEqual(result.get("Cache-Control"), "no-store") def test_media_io_base_download_handle_redirects(self): self.request.http = HttpMockSequence( [ ( { "status": "200", "content-location": "https://secure.example.net/lion", }, b"", ), ({"status": "200", "content-range": "0-2/5"}, b"abc"), ] ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) status, done = download.next_chunk() self.assertEqual("https://secure.example.net/lion", download._uri) def test_media_io_base_download_handle_4xx(self): self.request.http = HttpMockSequence([({"status": "400"}, "")]) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) try: status, done = download.next_chunk() self.fail("Should raise an exception") except HttpError: pass # Even after raising an exception we can pick up where we left off. self.request.http = HttpMockSequence( [({"status": "200", "content-range": "0-2/5"}, b"123")] ) status, done = download.next_chunk() self.assertEqual(self.fd.getvalue(), b"123") def test_media_io_base_download_retries_connection_errors(self): self.request.http = HttpMockWithErrors( 5, {"status": "200", "content-range": "0-2/3"}, b"123" ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) download._sleep = lambda _x: 0 # do nothing download._rand = lambda: 10 status, done = download.next_chunk(num_retries=5) self.assertEqual(self.fd.getvalue(), b"123") self.assertEqual(True, done) def test_media_io_base_download_retries_5xx(self): self.request.http = HttpMockSequence( [ ({"status": "500"}, ""), ({"status": "500"}, ""), ({"status": "500"}, ""), ({"status": "200", "content-range": "0-2/5"}, b"123"), ({"status": "503"}, ""), ({"status": "503"}, ""), ({"status": "503"}, ""), ({"status": "200", "content-range": "3-4/5"}, b"45"), ] ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(self.fd, download._fd) self.assertEqual(3, download._chunksize) self.assertEqual(0, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(False, download._done) self.assertEqual(self.request.uri, download._uri) # Set time.sleep and random.random stubs. sleeptimes = [] download._sleep = lambda x: sleeptimes.append(x) download._rand = lambda: 10 status, done = download.next_chunk(num_retries=3) # Check for exponential backoff using the rand function above. self.assertEqual([20, 40, 80], sleeptimes) self.assertEqual(self.fd.getvalue(), b"123") self.assertEqual(False, done) self.assertEqual(3, download._progress) self.assertEqual(5, download._total_size) self.assertEqual(3, status.resumable_progress) # Reset time.sleep stub. del sleeptimes[0 : len(sleeptimes)] status, done = download.next_chunk(num_retries=3) # Check for exponential backoff using the rand function above. self.assertEqual([20, 40, 80], sleeptimes) self.assertEqual(self.fd.getvalue(), b"12345") self.assertEqual(True, done) self.assertEqual(5, download._progress) self.assertEqual(5, download._total_size) def test_media_io_base_download_empty_file(self): self.request.http = HttpMockSequence( [({"status": "200", "content-range": "0-0/0"}, b"")] ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(self.fd, download._fd) self.assertEqual(0, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(False, download._done) self.assertEqual(self.request.uri, download._uri) status, done = download.next_chunk() self.assertEqual(True, done) self.assertEqual(0, download._progress) self.assertEqual(0, download._total_size) self.assertEqual(0, status.progress()) def test_media_io_base_download_empty_file_416_response(self): self.request.http = HttpMockSequence( [({"status": "416", "content-range": "0-0/0"}, b"")] ) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(self.fd, download._fd) self.assertEqual(0, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(False, download._done) self.assertEqual(self.request.uri, download._uri) status, done = download.next_chunk() self.assertEqual(True, done) self.assertEqual(0, download._progress) self.assertEqual(0, download._total_size) self.assertEqual(0, status.progress()) def test_media_io_base_download_unknown_media_size(self): self.request.http = HttpMockSequence([({"status": "200"}, b"123")]) download = MediaIoBaseDownload(fd=self.fd, request=self.request, chunksize=3) self.assertEqual(self.fd, download._fd) self.assertEqual(0, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(False, download._done) self.assertEqual(self.request.uri, download._uri) status, done = download.next_chunk() self.assertEqual(self.fd.getvalue(), b"123") self.assertEqual(True, done) self.assertEqual(3, download._progress) self.assertEqual(None, download._total_size) self.assertEqual(0, status.progress()) EXPECTED = """POST /someapi/v1/collection/?foo=bar HTTP/1.1 Content-Type: application/json MIME-Version: 1.0 Host: www.googleapis.com content-length: 2\r\n\r\n{}""" NO_BODY_EXPECTED = """POST /someapi/v1/collection/?foo=bar HTTP/1.1 Content-Type: application/json MIME-Version: 1.0 Host: www.googleapis.com content-length: 0\r\n\r\n""" NO_BODY_EXPECTED_GET = """GET /someapi/v1/collection/?foo=bar HTTP/1.1 Content-Type: application/json MIME-Version: 1.0 Host: www.googleapis.com\r\n\r\n""" RESPONSE = """HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/pony"\r\n\r\n{"answer": 42}""" BATCH_RESPONSE = b"""--batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/pony"\r\n\r\n{"foo": 42} --batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/sheep"\r\n\r\n{"baz": "qux"} --batch_foobarbaz--""" BATCH_ERROR_RESPONSE = b"""--batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/pony"\r\n\r\n{"foo": 42} --batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 403 Access Not Configured Content-Type: application/json Content-Length: 245 ETag: "etag/sheep"\r\n\r\n{ "error": { "errors": [ { "domain": "usageLimits", "reason": "accessNotConfigured", "message": "Access Not Configured", "debugInfo": "QuotaState: BLOCKED" } ], "code": 403, "message": "Access Not Configured" } } --batch_foobarbaz--""" BATCH_RESPONSE_WITH_401 = b"""--batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 401 Authorization Required Content-Type: application/json Content-Length: 14 ETag: "etag/pony"\r\n\r\n{"error": {"message": "Authorizaton failed."}} --batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/sheep"\r\n\r\n{"baz": "qux"} --batch_foobarbaz--""" BATCH_SINGLE_RESPONSE = b"""--batch_foobarbaz Content-Type: application/http Content-Transfer-Encoding: binary Content-ID: HTTP/1.1 200 OK Content-Type: application/json Content-Length: 14 ETag: "etag/pony"\r\n\r\n{"foo": 42} --batch_foobarbaz--""" USER_RATE_LIMIT_EXCEEDED_RESPONSE_NO_STATUS = """{ "error": { "errors": [ { "domain": "usageLimits", "reason": "userRateLimitExceeded", "message": "User Rate Limit Exceeded" } ], "code": 403, "message": "User Rate Limit Exceeded" } }""" USER_RATE_LIMIT_EXCEEDED_RESPONSE_WITH_STATUS = """{ "error": { "errors": [ { "domain": "usageLimits", "reason": "userRateLimitExceeded", "message": "User Rate Limit Exceeded" } ], "code": 403, "message": "User Rate Limit Exceeded", "status": "PERMISSION_DENIED" } }""" RATE_LIMIT_EXCEEDED_RESPONSE = """{ "error": { "errors": [ { "domain": "usageLimits", "reason": "rateLimitExceeded", "message": "Rate Limit Exceeded" } ], "code": 403, "message": "Rate Limit Exceeded" } }""" NOT_CONFIGURED_RESPONSE = """{ "error": { "errors": [ { "domain": "usageLimits", "reason": "accessNotConfigured", "message": "Access Not Configured" } ], "code": 403, "message": "Access Not Configured" } }""" LIST_NOT_CONFIGURED_RESPONSE = """[ "error": { "errors": [ { "domain": "usageLimits", "reason": "accessNotConfigured", "message": "Access Not Configured" } ], "code": 403, "message": "Access Not Configured" } ]""" class Callbacks(object): def __init__(self): self.responses = {} self.exceptions = {} def f(self, request_id, response, exception): self.responses[request_id] = response self.exceptions[request_id] = exception class TestHttpRequest(unittest.TestCase): def test_unicode(self): http = HttpMock(datafile("zoo.json"), headers={"status": "200"}) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request.execute() self.assertEqual(uri, http.uri) self.assertEqual(str, type(http.uri)) self.assertEqual(method, http.method) self.assertEqual(str, type(http.method)) def test_empty_content_type(self): """Test for #284""" http = HttpMock(None, headers={"status": 200}) uri = u"https://www.googleapis.com/someapi/v1/upload/?foo=bar" method = u"POST" request = HttpRequest( http, _postproc_none, uri, method=method, headers={"content-type": ""} ) request.execute() self.assertEqual("", http.headers.get("content-type")) def test_no_retry_connection_errors(self): model = JsonModel() request = HttpRequest( HttpMockWithNonRetriableErrors(1, {"status": "200"}, '{"foo": "bar"}'), model.response, u"https://www.example.com/json_api_endpoint", ) request._sleep = lambda _x: 0 # do nothing request._rand = lambda: 10 with self.assertRaises(OSError): response = request.execute(num_retries=3) def test_retry_connection_errors_non_resumable(self): model = JsonModel() request = HttpRequest( HttpMockWithErrors(5, {"status": "200"}, '{"foo": "bar"}'), model.response, u"https://www.example.com/json_api_endpoint", ) request._sleep = lambda _x: 0 # do nothing request._rand = lambda: 10 response = request.execute(num_retries=5) self.assertEqual({u"foo": u"bar"}, response) def test_retry_connection_errors_resumable(self): with open(datafile("small.png"), "rb") as small_png_file: small_png_fd = io.BytesIO(small_png_file.read()) upload = MediaIoBaseUpload( fd=small_png_fd, mimetype="image/png", chunksize=500, resumable=True ) model = JsonModel() request = HttpRequest( HttpMockWithErrors( 5, {"status": "200", "location": "location"}, '{"foo": "bar"}' ), model.response, u"https://www.example.com/file_upload", method="POST", resumable=upload, ) request._sleep = lambda _x: 0 # do nothing request._rand = lambda: 10 response = request.execute(num_retries=5) self.assertEqual({u"foo": u"bar"}, response) def test_retry(self): num_retries = 6 resp_seq = [({"status": "500"}, "")] * (num_retries - 4) resp_seq.append(({"status": "403"}, RATE_LIMIT_EXCEEDED_RESPONSE)) resp_seq.append(({"status": "403"}, USER_RATE_LIMIT_EXCEEDED_RESPONSE_NO_STATUS)) resp_seq.append(({"status": "403"}, USER_RATE_LIMIT_EXCEEDED_RESPONSE_WITH_STATUS)) resp_seq.append(({"status": "429"}, "")) resp_seq.append(({"status": "200"}, "{}")) http = HttpMockSequence(resp_seq) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) sleeptimes = [] request._sleep = lambda x: sleeptimes.append(x) request._rand = lambda: 10 request.execute(num_retries=num_retries) self.assertEqual(num_retries, len(sleeptimes)) for retry_num in range(num_retries): self.assertEqual(10 * 2 ** (retry_num + 1), sleeptimes[retry_num]) def test_no_retry_succeeds(self): num_retries = 5 resp_seq = [({"status": "200"}, "{}")] * (num_retries) http = HttpMockSequence(resp_seq) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) sleeptimes = [] request._sleep = lambda x: sleeptimes.append(x) request._rand = lambda: 10 request.execute(num_retries=num_retries) self.assertEqual(0, len(sleeptimes)) def test_no_retry_fails_fast(self): http = HttpMockSequence([({"status": "500"}, ""), ({"status": "200"}, "{}")]) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute() request._sleep.assert_not_called() def test_no_retry_403_not_configured_fails_fast(self): http = HttpMockSequence( [({"status": "403"}, NOT_CONFIGURED_RESPONSE), ({"status": "200"}, "{}")] ) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute() request._sleep.assert_not_called() def test_no_retry_403_fails_fast(self): http = HttpMockSequence([({"status": "403"}, ""), ({"status": "200"}, "{}")]) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute() request._sleep.assert_not_called() def test_no_retry_401_fails_fast(self): http = HttpMockSequence([({"status": "401"}, ""), ({"status": "200"}, "{}")]) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute() request._sleep.assert_not_called() def test_no_retry_403_list_fails(self): http = HttpMockSequence( [ ({"status": "403"}, LIST_NOT_CONFIGURED_RESPONSE), ({"status": "200"}, "{}"), ] ) model = JsonModel() uri = u"https://www.googleapis.com/someapi/v1/collection/?foo=bar" method = u"POST" request = HttpRequest( http, model.response, uri, method=method, body=u"{}", headers={"content-type": "application/json"}, ) request._rand = lambda: 1.0 request._sleep = mock.MagicMock() with self.assertRaises(HttpError): request.execute() request._sleep.assert_not_called() def test_null_postproc(self): resp, content = HttpRequest.null_postproc("foo", "bar") self.assertEqual(resp, "foo") self.assertEqual(content, "bar") class TestBatch(unittest.TestCase): def setUp(self): model = JsonModel() self.request1 = HttpRequest( None, model.response, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body="{}", headers={"content-type": "application/json"}, ) self.request2 = HttpRequest( None, model.response, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="GET", body="", headers={"content-type": "application/json"}, ) def test_id_to_from_content_id_header(self): batch = BatchHttpRequest() self.assertEqual("12", batch._header_to_id(batch._id_to_header("12"))) def test_invalid_content_id_header(self): batch = BatchHttpRequest() self.assertRaises(BatchError, batch._header_to_id, "[foo+x]") self.assertRaises(BatchError, batch._header_to_id, "foo+1") self.assertRaises(BatchError, batch._header_to_id, "") def test_serialize_request(self): batch = BatchHttpRequest() request = HttpRequest( None, None, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body=u"{}", headers={"content-type": "application/json"}, methodId=None, resumable=None, ) s = batch._serialize_request(request).splitlines() self.assertEqual(EXPECTED.splitlines(), s) def test_serialize_request_media_body(self): batch = BatchHttpRequest() f = open(datafile("small.png"), "rb") body = f.read() f.close() request = HttpRequest( None, None, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body=body, headers={"content-type": "application/json"}, methodId=None, resumable=None, ) # Just testing it shouldn't raise an exception. s = batch._serialize_request(request).splitlines() def test_serialize_request_no_body(self): batch = BatchHttpRequest() request = HttpRequest( None, None, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body=b"", headers={"content-type": "application/json"}, methodId=None, resumable=None, ) s = batch._serialize_request(request).splitlines() self.assertEqual(NO_BODY_EXPECTED.splitlines(), s) def test_serialize_get_request_no_body(self): batch = BatchHttpRequest() request = HttpRequest( None, None, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="GET", body=None, headers={"content-type": "application/json"}, methodId=None, resumable=None, ) s = batch._serialize_request(request).splitlines() self.assertEqual(NO_BODY_EXPECTED_GET.splitlines(), s) def test_deserialize_response(self): batch = BatchHttpRequest() resp, content = batch._deserialize_response(RESPONSE) self.assertEqual(200, resp.status) self.assertEqual("OK", resp.reason) self.assertEqual(11, resp.version) self.assertEqual('{"answer": 42}', content) def test_new_id(self): batch = BatchHttpRequest() id_ = batch._new_id() self.assertEqual("1", id_) id_ = batch._new_id() self.assertEqual("2", id_) batch.add(self.request1, request_id="3") id_ = batch._new_id() self.assertEqual("4", id_) def test_add(self): batch = BatchHttpRequest() batch.add(self.request1, request_id="1") self.assertRaises(KeyError, batch.add, self.request1, request_id="1") def test_add_fail_for_over_limit(self): from googleapiclient.http import MAX_BATCH_LIMIT batch = BatchHttpRequest() for i in range(0, MAX_BATCH_LIMIT): batch.add( HttpRequest( None, None, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body="{}", headers={"content-type": "application/json"}, ) ) self.assertRaises(BatchError, batch.add, self.request1) def test_add_fail_for_resumable(self): batch = BatchHttpRequest() upload = MediaFileUpload(datafile("small.png"), chunksize=500, resumable=True) self.request1.resumable = upload with self.assertRaises(BatchError) as batch_error: batch.add(self.request1, request_id="1") str(batch_error.exception) def test_execute_empty_batch_no_http(self): batch = BatchHttpRequest() ret = batch.execute() self.assertEqual(None, ret) def test_execute(self): batch = BatchHttpRequest() callbacks = Callbacks() batch.add(self.request1, callback=callbacks.f) batch.add(self.request2, callback=callbacks.f) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_RESPONSE, ) ] ) batch.execute(http=http) self.assertEqual({"foo": 42}, callbacks.responses["1"]) self.assertEqual(None, callbacks.exceptions["1"]) self.assertEqual({"baz": "qux"}, callbacks.responses["2"]) self.assertEqual(None, callbacks.exceptions["2"]) def test_execute_request_body(self): batch = BatchHttpRequest() batch.add(self.request1) batch.add(self.request2) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, "echo_request_body", ) ] ) try: batch.execute(http=http) self.fail("Should raise exception") except BatchError as e: boundary, _ = e.content.split(None, 1) self.assertEqual("--", boundary[:2]) parts = e.content.split(boundary) self.assertEqual(4, len(parts)) self.assertEqual("", parts[0]) self.assertEqual("--", parts[3].rstrip()) header = parts[1].splitlines()[1] self.assertEqual("Content-Type: application/http", header) def test_execute_request_body_with_custom_long_request_ids(self): batch = BatchHttpRequest() batch.add(self.request1, request_id="abc" * 20) batch.add(self.request2, request_id="def" * 20) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, "echo_request_body", ) ] ) try: batch.execute(http=http) self.fail("Should raise exception") except BatchError as e: boundary, _ = e.content.split(None, 1) self.assertEqual("--", boundary[:2]) parts = e.content.split(boundary) self.assertEqual(4, len(parts)) self.assertEqual("", parts[0]) self.assertEqual("--", parts[3].rstrip()) for partindex, request_id in ((1, "abc" * 20), (2, "def" * 20)): lines = parts[partindex].splitlines() for n, line in enumerate(lines): if line.startswith("Content-ID:"): # assert correct header folding self.assertTrue(line.endswith("+"), line) header_continuation = lines[n + 1] self.assertEqual( header_continuation, " %s>" % request_id, header_continuation, ) def test_execute_initial_refresh_oauth2(self): batch = BatchHttpRequest() callbacks = Callbacks() cred = MockCredentials("Foo", expired=True) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_SINGLE_RESPONSE, ) ] ) cred.authorize(http) batch.add(self.request1, callback=callbacks.f) batch.execute(http=http) self.assertEqual({"foo": 42}, callbacks.responses["1"]) self.assertIsNone(callbacks.exceptions["1"]) self.assertEqual(1, cred._refreshed) self.assertEqual(1, cred._authorized) self.assertEqual(1, cred._applied) def test_execute_refresh_and_retry_on_401(self): batch = BatchHttpRequest() callbacks = Callbacks() cred_1 = MockCredentials("Foo") cred_2 = MockCredentials("Bar") http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_RESPONSE_WITH_401, ), ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_SINGLE_RESPONSE, ), ] ) creds_http_1 = HttpMockSequence([]) cred_1.authorize(creds_http_1) creds_http_2 = HttpMockSequence([]) cred_2.authorize(creds_http_2) self.request1.http = creds_http_1 self.request2.http = creds_http_2 batch.add(self.request1, callback=callbacks.f) batch.add(self.request2, callback=callbacks.f) batch.execute(http=http) self.assertEqual({"foo": 42}, callbacks.responses["1"]) self.assertEqual(None, callbacks.exceptions["1"]) self.assertEqual({"baz": "qux"}, callbacks.responses["2"]) self.assertEqual(None, callbacks.exceptions["2"]) self.assertEqual(1, cred_1._refreshed) self.assertEqual(0, cred_2._refreshed) self.assertEqual(1, cred_1._authorized) self.assertEqual(1, cred_2._authorized) self.assertEqual(1, cred_2._applied) self.assertEqual(2, cred_1._applied) def test_http_errors_passed_to_callback(self): batch = BatchHttpRequest() callbacks = Callbacks() cred_1 = MockCredentials("Foo") cred_2 = MockCredentials("Bar") http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_RESPONSE_WITH_401, ), ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_RESPONSE_WITH_401, ), ] ) creds_http_1 = HttpMockSequence([]) cred_1.authorize(creds_http_1) creds_http_2 = HttpMockSequence([]) cred_2.authorize(creds_http_2) self.request1.http = creds_http_1 self.request2.http = creds_http_2 batch.add(self.request1, callback=callbacks.f) batch.add(self.request2, callback=callbacks.f) batch.execute(http=http) self.assertEqual(None, callbacks.responses["1"]) self.assertEqual(401, callbacks.exceptions["1"].resp.status) self.assertEqual( "Authorization Required", callbacks.exceptions["1"].resp.reason ) self.assertEqual({u"baz": u"qux"}, callbacks.responses["2"]) self.assertEqual(None, callbacks.exceptions["2"]) def test_execute_global_callback(self): callbacks = Callbacks() batch = BatchHttpRequest(callback=callbacks.f) batch.add(self.request1) batch.add(self.request2) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_RESPONSE, ) ] ) batch.execute(http=http) self.assertEqual({"foo": 42}, callbacks.responses["1"]) self.assertEqual({"baz": "qux"}, callbacks.responses["2"]) def test_execute_batch_http_error(self): callbacks = Callbacks() batch = BatchHttpRequest(callback=callbacks.f) batch.add(self.request1) batch.add(self.request2) http = HttpMockSequence( [ ( { "status": "200", "content-type": 'multipart/mixed; boundary="batch_foobarbaz"', }, BATCH_ERROR_RESPONSE, ) ] ) batch.execute(http=http) self.assertEqual({"foo": 42}, callbacks.responses["1"]) expected = ( "" ) self.assertEqual(expected, str(callbacks.exceptions["2"])) class TestRequestUriTooLong(unittest.TestCase): def test_turn_get_into_post(self): def _postproc(resp, content): return content http = HttpMockSequence( [ ({"status": "200"}, "echo_request_body"), ({"status": "200"}, "echo_request_headers"), ] ) # Send a long query parameter. query = {"q": "a" * MAX_URI_LENGTH + "?&"} req = HttpRequest( http, _postproc, "http://example.com?" + urllib.parse.urlencode(query), method="GET", body=None, headers={}, methodId="foo", resumable=None, ) # Query parameters should be sent in the body. response = req.execute() self.assertEqual(b"q=" + b"a" * MAX_URI_LENGTH + b"%3F%26", response) # Extra headers should be set. response = req.execute() self.assertEqual("GET", response["x-http-method-override"]) self.assertEqual(str(MAX_URI_LENGTH + 8), response["content-length"]) self.assertEqual("application/x-www-form-urlencoded", response["content-type"]) class TestStreamSlice(unittest.TestCase): """Test _StreamSlice.""" def setUp(self): self.stream = io.BytesIO(b"0123456789") def test_read(self): s = _StreamSlice(self.stream, 0, 4) self.assertEqual(b"", s.read(0)) self.assertEqual(b"0", s.read(1)) self.assertEqual(b"123", s.read()) def test_read_too_much(self): s = _StreamSlice(self.stream, 1, 4) self.assertEqual(b"1234", s.read(6)) def test_read_all(self): s = _StreamSlice(self.stream, 2, 1) self.assertEqual(b"2", s.read(-1)) class TestResponseCallback(unittest.TestCase): """Test adding callbacks to responses.""" def test_ensure_response_callback(self): m = JsonModel() request = HttpRequest( None, m.response, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="POST", body="{}", headers={"content-type": "application/json"}, ) h = HttpMockSequence([({"status": 200}, "{}")]) responses = [] def _on_response(resp, responses=responses): responses.append(resp) request.add_response_callback(_on_response) request.execute(http=h) self.assertEqual(1, len(responses)) class TestHttpMock(unittest.TestCase): def test_default_response_headers(self): http = HttpMock(datafile("zoo.json")) resp, content = http.request("http://example.com") self.assertEqual(resp.status, 200) def test_error_response(self): http = HttpMock(datafile("bad_request.json"), {"status": "400"}) model = JsonModel() request = HttpRequest( http, model.response, "https://www.googleapis.com/someapi/v1/collection/?foo=bar", method="GET", headers={}, ) self.assertRaises(HttpError, request.execute) class TestHttpBuild(unittest.TestCase): original_socket_default_timeout = None @classmethod def setUpClass(cls): cls.original_socket_default_timeout = socket.getdefaulttimeout() @classmethod def tearDownClass(cls): socket.setdefaulttimeout(cls.original_socket_default_timeout) def test_build_http_sets_default_timeout_if_none_specified(self): socket.setdefaulttimeout(None) http = build_http() self.assertIsInstance(http.timeout, int) self.assertGreater(http.timeout, 0) def test_build_http_default_timeout_can_be_overridden(self): socket.setdefaulttimeout(1.5) http = build_http() self.assertAlmostEqual(http.timeout, 1.5, delta=0.001) def test_build_http_default_timeout_can_be_set_to_zero(self): socket.setdefaulttimeout(0) http = build_http() self.assertEqual(http.timeout, 0) def test_build_http_default_308_is_excluded_as_redirect(self): http = build_http() self.assertTrue(308 not in http.redirect_codes) if __name__ == "__main__": logging.getLogger().setLevel(logging.ERROR) unittest.main()