# Copyright (c) 2020 Jeff Irion and contributors
#
# This file is part of the aio-adb-shell package. It incorporates work
# covered by the following license notice:
#
#
# 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.
"""ADB-related exceptions.
"""
from . import constants
[docs]class AdbCommandFailureException(Exception):
"""A ``b'FAIL'`` packet was received.
"""
[docs]class AdbConnectionError(Exception):
"""ADB command not sent because a connection to the device has not been established.
"""
[docs]class DeviceAuthError(Exception):
"""Device authentication failed.
"""
def __init__(self, message, *args):
message %= args
super(DeviceAuthError, self).__init__(message, *args)
[docs]class InterleavedDataError(Exception):
"""We only support command sent serially.
"""
[docs]class InvalidChecksumError(Exception):
"""Checksum of data didn't match expected checksum.
"""
[docs]class InvalidCommandError(Exception):
"""Got an invalid command.
"""
def __init__(self, message, response_header, response_data):
if response_header == constants.FAIL:
message = 'Command failed, device said so. (%s)' % message
super(InvalidCommandError, self).__init__(message, response_header, response_data)
[docs]class InvalidHandleError(Exception):
"""The provided handle does not implement the necessary methods: ``close``, ``connect``, ``bulk_read``, and ``bulk_write``.
"""
[docs]class InvalidResponseError(Exception):
"""Got an invalid response to our command.
"""
[docs]class PushFailedError(Exception):
"""Pushing a file failed for some reason.
"""
[docs]class TcpTimeoutException(Exception):
"""TCP connection timed read/write operation exceeded the allowed time.
"""