# Source code for hypothesis.errors

# This file is part of Hypothesis, which may be found at
# https://github.com/HypothesisWorks/hypothesis/
#
# Most of this work is copyright (C) 2013-2021 David R. MacIver
# (david@drmaciver.com), but it contains contributions by others. See
# CONTRIBUTING.rst for a full list of people who may hold copyright, and
# consult the git log if you need to determine who owns an individual
# contribution.
#
# This Source Code Form is subject to the terms of the Mozilla Public License,
# v. 2.0. If a copy of the MPL was not distributed with this file, You can
# obtain one at https://mozilla.org/MPL/2.0/.
#

class HypothesisException(Exception):
"""Generic parent class for exceptions thrown by Hypothesis."""

class _Trimmable(HypothesisException):
"""Hypothesis can trim these tracebacks even if they're raised internally."""

class CleanupFailed(HypothesisException):
"""At least one cleanup task failed and no other exception was raised."""

class UnsatisfiedAssumption(HypothesisException):
"""An internal error raised by assume.

If you're seeing this error something has gone wrong.
"""

class NoSuchExample(HypothesisException):
"""The condition we have been asked to satisfy appears to be always false.

This does not guarantee that no example exists, only that we were
unable to find one.
"""

def __init__(self, condition_string, extra=""):
super().__init__(f"No examples found of condition {condition_string}{extra}")

class Unsatisfiable(_Trimmable):
"""We ran out of time or examples before we could find enough examples
which satisfy the assumptions of this hypothesis.

This could be because the function is too slow. If so, try upping
the timeout. It could also be because the function is using assume
in a way that is too hard to satisfy. If so, try writing a custom
strategy or using a better starting point (e.g if you are requiring
a list has unique values you could instead filter out all duplicate
values from the list)
"""

class Flaky(_Trimmable):
"""This function appears to fail non-deterministically: We have seen it
fail when passed this example at least once, but a subsequent invocation
did not fail.

Common causes for this problem are:
1. The function depends on external state. e.g. it uses an external
random number generator. Try to make a version that passes all the
relevant state in from Hypothesis.
2. The function is suffering from too much recursion and its failure
depends sensitively on where it's been called from.
3. The function is timing sensitive and can fail or pass depending on
how long it takes. Try breaking it up into smaller functions which
don't do that and testing those instead.
"""

class InvalidArgument(_Trimmable, TypeError):
"""Used to indicate that the arguments to a Hypothesis function were in
some manner incorrect."""

class ResolutionFailed(InvalidArgument):
"""Hypothesis had to resolve a type to a strategy, but this failed.

Type inference is best-effort, so this only happens when an
annotation exists but could not be resolved for a required argument
to the target of builds(), or where the user passed infer.
"""

class InvalidState(HypothesisException):
"""The system is not in a state where you were allowed to do that."""

class InvalidDefinition(_Trimmable, TypeError):
"""Used to indicate that a class definition was not well put together and
has something wrong with it."""

class HypothesisWarning(HypothesisException, Warning):
"""A generic warning issued by Hypothesis."""

class FailedHealthCheck(_Trimmable):
"""Raised when a test fails a preliminary healthcheck that occurs before
execution."""

def __init__(self, message, check):
super().__init__(message)
self.health_check = check

class NonInteractiveExampleWarning(HypothesisWarning):
"""SearchStrategy.example() is designed for interactive use,
but should never be used in the body of a test.
"""

[docs]class HypothesisDeprecationWarning(HypothesisWarning, FutureWarning):
"""A deprecation warning issued by Hypothesis.

Actually inherits from FutureWarning, because DeprecationWarning is
hidden by the default warnings filter.

You can configure the Python :mod:python:warnings to handle these
warnings differently to others, either turning them into errors or
suppressing them entirely.  Obviously we would prefer the former!
"""

class Frozen(HypothesisException):
"""Raised when a mutation method has been called on a ConjectureData object
after freeze() has been called."""

class MultipleFailures(_Trimmable):
"""Indicates that Hypothesis found more than one distinct bug when testing

"""Raised when an individual test body has taken too long to run."""

super().__init__(
"Test took %.2fms, which exceeds the deadline of %.2fms"
% (runtime.total_seconds() * 1000, deadline.total_seconds() * 1000)
)
self.runtime = runtime

class StopTest(BaseException):
"""Raised when a test should stop running and return control to
the Hypothesis engine, which should then continue normally.
"""

def __init__(self, testcounter):
super().__init__(repr(testcounter))
self.testcounter = testcounter

class DidNotReproduce(HypothesisException):
pass

class Found(Exception):
"""Signal that the example matches condition. Internal use only."""

hypothesis_internal_never_escalate = True